go-ec2list

README

go-ec2list

Retrieve EC2 instances information from all profiles and all regions concurrently. This tool is intended to use with interactive selection tools like peco or percol.

INSTALLATION

$ go get github.com/sudix/go-ec2list

USAGE

Setup your AWS credential file.

See Configuring the AWS Command Line Interface - AWS Command Line Interface.

Run command

$ go-ec2list

Result

You will get EC2 instances list.
Each line is tab separeted values.

Output Values

• Instance Name
• Instance ID
• Public IP
• Private IP
• Profile Name
• Availability zone
• Instance type
• Instance state

Options

Cache

If you set -cachemin option, go-ec2list caches results and uses that until it expires. Value means expire minutes.

USAGE

$ go-ec2list -cachemin 10

The cache is stored to $HOME/.go-ec2list/cache.

Delete cache

When -refresh is specified, the cache will always be deleted and re-create cache regardless of -cachemin option.

USAGE

$ go-ec2list -cachemin 10 -refresh

EXAMPLE USAGE WITH INTERACTIVE SELECTION TOOLS.

Set alias like below, and you can ssh login to the selected instance.

alias ec2="go-ec2list | peco | cut -f3 | xargs -I{} sh -c 'ssh "ec2-user@{}" </dev/tty' ssh"