AWS Remote is a command line tool to view and interact with AWS instances via SSM
- AWS CLI (https://docs.aws.amazon.com/cli/latest/userguide/install-macos.html)
- AWS CLI Session Manager Plugin (https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html)
aws-remote will list all your EC2 instances in the specified account/region, and display helpful information like state and SSM management status. aws-remote is also a wrapper for the AWS CLI that makes starting remote sessions and port-forwarding easier. Remote sessions and port-forwarding can be started using the EC2 Instance ID or the friendly name.
Examples:
$ aws-remote --help
Usage: aws-remote [OPTIONS] COMMAND [ARGS]...
AWS Remote is a simple, command line tool to view and interact with AWS
instances via SSM. Requires the AWS CLI and Session Manager Plugin to be
installed locally.
Options:
--profile TEXT Specify AWS profile
--region TEXT Specify AWS region
--help Show this message and exit.
Commands:
list List EC2 instances and SSM management status
port-forward Start SSM port forward to instance id/name
session Start SSM session with instance id/name
$ aws-remote list
ID AZ Type State SSM Name
i-01234567890987654 us-east-1a r4.xlarge running true instance1-example.domain.com
i-02345678909876543 us-east-1b t3.micro running false instance2-example.domain.com
i-03456789098765432 us-east-1c t3.medium running true instance3-example.domain.com
$ aws-remote --profile my_profile session i-02345678909876543
$ aws-remote --profile my_profile session instance2-example.domain.com
$ aws-remote --profile my_profile --region us-west-2 port-forward 8080 80 instance2-example.domain.com
-
Verify Python3.6 or later is installed:
python --versionorpython3 --version -
Verify AWS CLI version 1.16.12 or later is installed:
aws --version -
Verify Session Manager plugin is installed:
session-manager-plugin -
Clone repo to your computer:
git clone https://github.com/dkuchenski/aws-remote.git -
Install script packages:
pip install -r aws-remote/requirements.txt -
Verify script works:
python3 aws-remote/aws-remote --help -
If desired, add alias to bash_profile and then restart terminal:
vi ~/.bash_profile
alias aws-remote='python3 ~/your-script-directory/aws-remote/aws-remote'
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent