SSH into your EC2 instances.
Project description
awssh
SSH boto3 utility for AWS
Installation
$ aws configure
$ pip install ssh-aws # or pip install --user ssh-aws
Note: The awssh
utility is installed in $HOME/Library/Python/2.7/bin
which may not be on PATH.
Consider adding this directory to PATH.
Requirements
- Python 2.7
Features
The awssh
utility gives you a list of hosts you have access to and preconfigures ssh
with the proper key and user.
You can filter by instance name. If it matches only one instance you will be logged into it.
This utility also allows local and remote port forwarding for SSH tunneling (e.g. ssh -L 9000:imgur.com:80 user@ip_address
).
By default, ssh occurs with the -A option, which enables forwarding of the authentication agent connection. This is particularly
useful when using a single access point such as a jump server of a bastion host.
Usage
usage: awsh [-h] [--region REGION] [--users USERS [USERS ...]]
[-i KEY_PATH] [-c COMMAND] [-r REMOTE_HOST]
[-p REMOTE_PORT] [-l LOCAL_PORT] [--keys KEYS]
[--timeout TIMEOUT] [--console-output] [--version]
[instance name key word]
SSH into AWS instances. The default user list assumes that your user is centos, ubuntu, or ec2-user.
positional arguments:
filter Optional instance name or key word as filter. If only one instance is found,
it will connect to it directly.
optional arguments:
-h, --help Show usage message and exit.
--users USERS [USERS ...]
Users to try (centos, ubuntu, and ec2-user are defaults).
--region REGION AWS region (us-east-2 by default)..
-i KEY_PATH, --key-path KEY_PATH
Specific key path, overrides, --keys
-c COMMAND, --command COMMAND
Translates to ssh -C
-r REMOTE_HOST, --remote-host REMOTE_HOST
Open a tunnel.
Equivalent to ssh -L <local-port>:<remote-host>:<remote-port> <selected-aws-host>
-p REMOTE_PORT, --remote-port REMOTE_PORT
Port to use on the remote host.
-l LOCAL_PORT, --local-port LOCAL_PORT
Port to use on the local host. Get overwritten by
remote port if not defined.
--keys KEYS Directory of the private keys (~/.ssh by default).
--timeout TIMEOUT SSH connection timeout.
--console-output Display the instance console out before logging in.
--version Returns awssh's version.
Examples:
"awssh --users user1 user2 --region us-east-2 --keys '~/.ssh' instance-name"
"awssh instance-name --users user1 user2".
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.