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 hashes)

Uploaded Source

Built Distribution

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

Uploaded Python 2 Python 3

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