AWS coco (console container)

This tool allows you to manage AWS Console Sessions with Firefox Containers

Quickstart

Ensure you've met the requirements.

$ pip install aws-coco

Usage

$ coco -c green -i fingerprint

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

If using containers:

• Firefox
• Firefox Multi-Account Containers
• Open URL in Container Extension

If you don't wish to install the extension through the marketplace, the source for the extension can be found here.

If not:

• 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

$ pip install aws-coco

Usage

This section explains how to use coco and covers some of the options available to you.

Basic Usage

$ coco --color green --icon fingerprint --name test

This 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:

$ coco-test

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.

Available Colors

Available Icons

Development

$ git clone https://github.com/wulfmann/aws-coco.git
$ git clone git@github.com:wulfmann/aws-coco.git

Install Dependencies

$ poetry install

Run the command

$ poetry run coco -c green -i fingerprint

Run tests

$ poetry run pytest