aws-ssm-juggle 26.3.0

AWS SSM tool for ECS/EC2 (Shell, SSH/SCP, Port Forwarding, ...)

aws-ssm-juggle

Installation

pip install aws-ssm-juggle

Pre-requisites

session-manager-plugin

Linux

Repo

With updates (recommended): See aws-session-manager-plugin

Manual

curl https://s3.amazonaws.com/session-manager-downloads/plugin/latest/ubuntu_64bit/session-manager-plugin.deb -o "/tmp/session-manager-plugin.deb"
mkdir -p ~/bin
dpkg-deb --fsys-tarfile /tmp/session-manager-plugin.deb | tar --strip-components=4 -C ~/bin/ -xvf - usr/local/sessionmanagerplugin/bin/session-manager-plugin

MacOS

brew install --cask session-manager-plugin

Infrastructure

Use ecs-exec-checker to check for the pre-requisites to use ECS exec.

ecs-juggle

Inspired by ecsgo.

Provides a tool to interact with AWS ECS tasks.

Currently provides:

• interactive execute-command (e.g. shell)
• port-forwarding

You can supply command-line arguments to specify which cluster/service/task/... to use or will be prompted with a nice menu.

Usage

See ecs-juggle --help for all features.

Execute command

Select all from menu:

ecs-juggle command

Port forwarding

Select all from menu:

ecs-juggle forward

Specify port and select the rest from menu:

ecs-juggle forward --remote-port 8080

ec2-juggle

Inspired by gossm.

Provides a tool to interact with AWS EC2 instances.

Currently provides:

• interactive shell (e.g. shell)
• ssh shell
• port-forwarding

Usage

See ec2-juggle --help for all features.

Start session

ec2-juggle start

ec2-juggle start --document AWS-StartInteractiveCommand --command '{"command": ["sudo -i"]}'

Start ssh session

Default:

ec2-juggle ssh

With extra arguments:

ec2-juggle ssh --ssh-args="-o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -l ubuntu"

Copy files with scp

Default:

ec2-juggle scp --source '{instance}:/tmp/foo' --target './bar'

With extra arguments:

ec2-juggle scp --scp-args="-o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -l ubuntu" --source '{instance}:/tmp/foo' --target './bar'

Port forwarding

ecs-juggle forward --remote-port 80