Skip to content

Latest commit

 

History

History
57 lines (37 loc) · 1.46 KB

README.md

File metadata and controls

57 lines (37 loc) · 1.46 KB
Raw

ec2ssh

Go wrapper around SSH that speaks AWS API

Installation

Clone this repository and run go install

If this is the first Go binary you're installing on your machine you'll probably need to add the folder to your PATH, like export PATH=$PATH:$HOME/go/bin

Installation via go get is not currently supported; see #3 for details

Usage

Connecting

# by AWS instance ID
$ ec2ssh i-0017c8b3

# by the instance Name tag
$ ec2ssh api-server

# by the instance private IP address
$ ec2ssh 1.2.3.4

Other options/flags

Specify an AWS profile other than "default":

$ AWS_PROFILE=altprofile ec2ssh

Specify an AWS region other than "us-east-1":

$ AWS_REGION=us-west-2 ec2ssh

See a list of running/pending instance names and ids:

$ ec2ssh --list

Run a command on a remote server:

$ ec2ssh -c 'echo bananas' <remote-server-name>

Notes

  • Assumes you have at least one AWS profile configured. See AWS docs for details.
  • The tool assumes you keep all SSH keys in $HOME/.ssh/, and match the key name assigned to the EC2 instance. Use -p or AWS_KEY_DIR to specify an alternate path to your private keys.
  • The GO111MODULE=on bit is due to some clunky behavior in go, you can follow this ticket to see when it gets fixed