AWS coco (console container)
Easily manage AWS Console Sessions
Quickstart
Install
Usage
You should now have a new browser tab with your aws session!
Continue reading for a more in-depth walkthrough of the setup.
If coco is too generic, this package also exposes aws_coco.
Requirements
There are two different modes for coco. Normal and Firefox Containers.
Container Mode (default)
If you don't wish to install the extension through the marketplace, you can install from source here.
Normal Mode
- Any browser supported by webbrowser
- Python >= 3.7
If you do not wish to use containers, make sure to specify the --no-container flag.
Installation
Usage
This section explains how to use coco and covers some of the options available to you.
Basic Usage
Container Mode Example
$ coco --color green --icon fingerprint --name testThis will open the url in a green firefox container tab named test with a fingerprint icon.
This can be annoying to type, so it's recommended to build aliases for your accounts.
Example alias:
alias coco-test=coco --color green --icon fingerprint --name test
Now you can just run:
Normal Mode Example
This will open your session in your default browser.
Credential Resolution
This project uses boto3. You can learn more about how boto3 resolves credentials here.
If you specify the --profile flag, coco will pass that value into the boto3 session and it will attempt to use the corresponding section in the ~/.aws/credentials file for the session.
Options
This section contains a description of the various options available to you. You can also pass the -h flag to print the help.
| Flag | Description | Default | Required |
|---|---|---|---|
--color, -c |
The container tab's color | false | |
--container, --no-container |
Determines if the url should be opened in a firefox container | true | |
--destination, -d |
The destination URL to open in the AWS console | false | |
--icon, -i |
The container tab's icon | false | |
--name, -n |
The container tab's name | The profile name if passed | false |
--open, --no-open |
Determines if the url should be automatically opened in the browser | true | |
--profile, -p |
The AWS profile to use | false |
Available Colors
| value |
|---|
| blue |
| turquoise |
| green |
| yellow |
| orange |
| red |
| pink |
| purple |
Available Icons
| value |
|---|
| fingerprint |
| briefcase |
| dollar |
| cart |
| vacation |
| gift |
| food |
| fruit |
| pet |
| tree |
| chill |
| circle |
| fence |
Contributing
For more information on contributing, check out the doc