Skip to content

A script that uses EC2 instance tags to generate a list of public dns names to be consumed by cluster ssh

License

Notifications You must be signed in to change notification settings

gposton/ec2-clusterssh

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

43 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Ec2::Clusterssh

Use instance tags to launch a ClusterSSH session to multiple EC2 instances.

Installation

$ gem install ec2-clusterssh

Note: Mac users with the latest version of XCode may run into a compilation error installing the json gem dependency. If you see the following error during the gem installation, see this page for a workaround

clang: error: unknown argument: '-multiply_definedsuppress' [-Wunused-command-line-argument-hard-error-in-future]

Prerequisites

  • ClusterSSH (To install csshx on mac use this page)
  • Set up your AWS credentials (note that these values can be also passed in as command line options)

export AWS_ACCESS_KEY_ID='...'

export AWS_SECRET_ACCESS_KEY='...'

Usage

$cluster -h
Usage: cluster [-t TAGS] [-l USER] [-k KEY -s SECRET] [-r region]
    -l, --login [USER]               Log in with this user
    -t, --tags [TAGS]                a 'space' sparated key value pair of tags and values (i.e. -t 'role=web,database environment=dev')
    -r, --region [REGION]            AWS region
    -s, --screen [SCREEN]            What screen to use for clustering windows (form multiple displays)
    -p, --use-public-ip              Use public IP (default false)


$cluster -t Name=web,database                  #Connects to all web and database servers
$cluster -t 'role=web,database environment=dev'  #Connects to all web and database servers in the dev environment

Notes

If you use a bastion jumphost, you'll want to configure your ssh config file to route the relavant IP ranges through your bastion. (i.e. 192.168.*)

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

About

A script that uses EC2 instance tags to generate a list of public dns names to be consumed by cluster ssh

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages