Skip to content
The chimp automation tool, created for RightScale operations
Branch: master
Clone or download
Latest commit 290d3e0 Mar 21, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin acu89424 - chimp open sourcing work Apr 24, 2013
docker OPS-3227 - right_chimp now builds for docker image using ruby 2.3.x v… Aug 16, 2016
lib OPS-4541 Prevent defaulting to zero Aug 4, 2017
spec OPS-3445 specs prepared for PR Oct 25, 2016
.gitignore OPS-2494 updated gitignore Apr 7, 2016
.rubocop.yml OPS-3175 implemented the delay attribute for workitems of the Executo… Oct 1, 2016
.travis.yml OPS-3269 fixed build job Aug 25, 2016
CHANGES OPS-4541 Addedc changelog and version number Aug 3, 2017
Gemfile
Gemfile.lock OPS-4541 Updated the Gemfile.lock Aug 3, 2017
INSTALL updating_instructions_based_on_feedback Mar 20, 2018
LICENSE acu89424 - update copyright year Apr 26, 2013
README Added link to installation instructions Dec 4, 2017
Rakefile acu89424 - chimp open sourcing work Apr 24, 2013
chimp.gemspec OPS-3445 initial specs for chimping Oct 12, 2016

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.

INSTALLATION
------------
Installation and authentication instructions are available [here](INSTALLATION)

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
You can’t perform that action at this time.