The chimp automation tool, created for RightScale operations
Ruby HTML CSS Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
docker
lib
spec
.gitignore
.rubocop.yml
.travis.yml
CHANGES
Gemfile
Gemfile.lock
INSTALL
LICENSE
README
Rakefile
chimp.gemspec

README

Chimp: a command-line tool for remote command execution using the RightScale platform

The goal of the Chimp is to provide a simple command line utility for
performing bulk operations on servers managed on the RightScale platform.

EXAMPLE USAGE
-------------

Run a RightScript on every server with a given tag:

  chimp --tag="service:myservice=true" --script="My RightScript"

Run a RightScript on every server in an array:

  chimp --array=moo1:replicant81 --script='APP Rainbows'

Run a shell command on servers with a specific tag:

  chimp --tag="service:myservice=true" --ssh="uptime"

Run a report:

  bin/chimp --tag="service:myservice=true" --report="nickname,ip-address,tag=myservice:version"

REPORTING
---------

Via the --report command line option it's possible to generate a CSV
report. Multiple fields to include in a report can be specified in a comma
delimited list:

  chimp --report="nickname,ip-address,tag=myservice:version" --array="MyAppServers"

Would include both the server nickname and ip address to the report as well as the specified tag:

  server1-1.rightscale.com,192.168.0.1,myservice:version=production
  server1-2.rightscale.com,192.168.0.2,myservice:version=production
  server1-3.rightscale.com,192.168.0.3,myservice:version=staging
  server1-4.rightscale.com,192.168.0.4,myservice:version=info

Any field present in the following list can be queried:

  Field
  -----------------------------------
  ip-address
  name
  href
  private-ip-address
  resource_uid
  ec2-instance-type
  datacenter
  dns-name
  locked
  tag=mytag

OBLIGATORY MAINTENANCE STRING
-----------------------------
Maintained by the RightScale Red_Team