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