Skip to main content

A tool to help switching between multiple AWS environments easy and seamless

Project description

aws-sessions-switcher: Manage multiple aws sessions and switch between them seamlessly

Working with multiple AWS Accounts from the command like can sometimes be difficult if you have to switch between multiple projects or between environments of the same project.

aws-sessions-switcher is a tool I developed to help myself to make switching between accounts / roles across projects easier. I don't see why such a tool cannot be of help to someone like me and hence decided to make it available to everyone who might be interested.

I hope it helps someone someday!

If you have any suggestions or want to contribute to this tool, you are very welcome !

PS: This is a work in progress, and there is definitely a LOT to improve / optimize.

Installation:

pip install aws-sessions-switcher

Basic setup

Setup 1: Configure a project

aws-sessions-switcher configure

Type the details about your AWS Environment, the role you would like to assume, project name etc... You can configure additional projects by executing aws-sessions-switcher projects add command

configure

Setup 2: Update your AWS Credentials file

The previous command will tell you under what profile name your AWS credentials must be placed, in the default ~/.aws/credentials file

Setup 3: Now see all the assumptions you can make

Running aws-sessions-switcher or aws-sessions-switcher -l will tell you how to assume the different roles that you have configured using this tool!

assumptions

Some Example commands

command description
aws-sessions-switcher configure Sets up the tool
aws-sessions-switcher reset Deletes the configuration file created by this tool
aws-sessions-switcher -l List all the assumptions that can be made
aws-sessions-switcher projects Lists all the configured projects
aws-sessions-switcher environments Lists all environments for all projects
aws-sessions-switcher environments -n ABCD Lists only the environments configured for the project named ABCD
aws-sessions-switcher sessions Lists all the sessions you have created using this tool
aws-sessions-switcher sessions switch Gives the ability to switch between multiple sessions
aws-sessions-switcher projects add Add an additional project
aws-sessions-switcher projects delete -n ABCD Deletes the configuration of the project named ABCD
aws-sessions-switcher environments add -n ABCD TODO:
aws-sessions-switcher environment delete -n ABCD -e dev TODO:
aws-sessions-switcher my\_project dev admin Attempts to assume 'admin' role on the 'dev' environment of the project named 'my_project'

Sample Outputs

Configuring your first project

configure

All the assumptions you can make

assumptions

Assuming a role from one of the configured projects

role_assumption

All the active sessions

sessions.png

Switching between active sessions

switching_sessions.png

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aws_sessions_switcher-0.0.16.tar.gz (13.0 kB view details)

Uploaded Source

Built Distribution

aws_sessions_switcher-0.0.16-py2.py3-none-any.whl (14.5 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file aws_sessions_switcher-0.0.16.tar.gz.

File metadata

File hashes

Hashes for aws_sessions_switcher-0.0.16.tar.gz
Algorithm Hash digest
SHA256 f8dbbcf7cfe925d883f79ae20ab3c5aa7e48be683e8ae579ab51ceaf3cbab9ff
MD5 5a21bb5a68fb9537af0486ff69855c2e
BLAKE2b-256 51dc254f8000b94a444a791e996cbed13f151b9275aba1bfb757191b63e5cc40

See more details on using hashes here.

File details

Details for the file aws_sessions_switcher-0.0.16-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for aws_sessions_switcher-0.0.16-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 089868cd8467d6b14481431431fcb79d66025d8a3b66d6f8f3c08f10393aa48f
MD5 53a1d5605a6fd12c3852f31e76285661
BLAKE2b-256 6d97b65625368a6b3c77ae19f0569cd6d96c4dbb15ccd4206fa2f82cd7f6dab5

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page