- Awsume requires Python 3.5 or greater.
- Awsume can be installed via pip, so make sure that the location that pip installs binaries is included on your
Awsume can be installed via the following command:
pip install awsume
Awsume uses Python's extras_require to add additional functionality with different dependencies.
awsume[saml]- Install dependencies required to support SAML assertion handling
awsume[fuzzy]- Install dependencies required to support fuzzy profile name matching
If you're running on a unix-like system, you must have an alias setup for awsume, that may or may not look something like this:
alias awsume=". awsume"
Awsume will make an attempt to place this in a login script such as your
~/.bashrc when it's being installed, so you may need to restart your terminal or re-source your login file.
If this automatic installation is causing you problems, you can disable it through setting an environment variable like this:
AWSUME_SKIP_ALIAS_SETUP=true pip install awsume
Sometimes, however, things (such as file permission issues) can prevent awsume from injecting the alias. If this is the case, we provided a utility to setup the alias after the fact, so check out the
awsume-configure guide here.
For debug purposes, in order to get output from the post_install setup, you must use pip's
-v flag like this:
pip install awsume -v
Once you have your alias setup, awsume can now work.
Run the following command and you'll be able to execute commands and run scripts with that profile's credentials.
Read more about awsume's usage here.