I needed a tool to utilise the ~/.aws/config file to launch a session via AWS Systems Manager to an instance in the cloud.

Written in Go, this tool allows you to launch the aws cli ssm components.

if you do not set an environment variable for the AWS_PROFILE it will interrogate the ones found in ~/.aws/config and provide you a list to pick from before .

Once the profile is set, it will get a list of the EC2 instances.

usage: AWS_PROFILE=<profile_name> gossm

1. The list of instances to pick from.

2. The command prompt to enter the number representing the list above.

Once you select the instance, it will launch the session via the command line application, in the following way : aws --profile <AWS_PROFILE> ssm start-session --target <i-BBBBBBBBBBBBBBBBBB>

You can further filter the list by specifying tag values, that will eb checked.

eg gossm prd web will look for machines tagged with both prd and web and present you a list of instances.

Not really in scope for this tool, but I have a list of AWS profiles in ~/.aws/config and the connection credentials are stored in ~/.aws/credentials

see AWS Documentation for more information on the ~/.aws/* files.

1. Name of the profile, used by gossm.

2. The region to use for the profile.

3. The role to use for the profile. This is the role in the account you want to utilise.

4. The account from the ~/.aws/credentials you want to use.

1. the name you specify for the config, also used for the connection, eg gossm sample-admin-acount

2. access key from AWS

3. the secre from AWS

To grab the latest build from github, run the following command.

go install github.com/bovinemagnet/gossm@latest

This will install the latest built version.

Remember to install AWS CLI and AWS SSM before using this tool.

On arch linux, I ran the following: