0.01
No release in over 3 years
Low commit activity in last 3 years
The Chimp is a tool for managing servers using the RightScale platform.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

~> 1.7.2
~> 1.6.7.1
~> 0.11.0
~> 10.4.2
 Project 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