right_chimp 1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e09b15f187436252531ccd9b94d249cddceac907
+  data.tar.gz: 95490f6e40c38ebeb1da91396ffc3b17db0c9916
+SHA512:
+  metadata.gz: c979e8dd6652009e1c0b55f3345167eb868d97bf1edcf6ddb52448aba766954de662433735498c55fd0f984b65d48dbbde6d9e2a8891b4a88b69c567555dd7c7
+  data.tar.gz: bb0e17fd39c8709770ca2792064028ddcb30361b85251b51b2fedf8b531335b3e450396ec1ddce8c991f0a65808be49007091e41ed44617a84a6b5bb6702f7b2

data/CHANGES

@@ -0,0 +1,88 @@
+Version 0.2.0
+--------------
+* Initial non-alpha release
+
+Version 0.2.2
+-------------
+* Feature: you can now specify a --script via its URI
+* Feature: initial release of chimpd
+
+Version 0.2.3
+-------------
+* Bugfix: chimpd job id management was broken in some places
+
+Version 0.3.0
+-------------
+* Feature: New --dry-run option
+* Feature: Array instance execution now includes error checking (requires API 0.1)
+* Change:  The work queue is now sorted by server name initially
+* Change:  Refactored chimp and chimpd scripts into Real Ruby Objects
+
+Version 0.4.0
+-------------
+* Feature: "chimpd --exit" can be used to stop a chimpd server
+* Feature: chimp will now display a list of scripts to choose from
+
+Version 0.4.1
+-------------
+* Feature: specify --script via numerical script id instead of full href
+* Bugfix:  fixed --script href bug
+* Bugfix:  fix chimpd submission from chimp exit code
+
+Version 0.4.2
+-------------
+* Bugfix:  fixed chimpd submission
+* Feature: Improved ability to ignore runaway tasks in chimpd
+
+Version 0.4.3
+-------------
+* Feature: If ServerArrays cannot be found, print a warning instead of failing
+
+Version 0.4.5
+-------------
+* Feature: add support for setting inputs when executing RightScripts (--input)
+* Feature: add ignore-errors command line flag
+* Feature: now using the USER environment variable for ssh jobs
+
+Version 0.4.6
+-------------
+* Bugfix: add --ssh-user flag to replace buggy USER env. variable feature
+
+Version 0.4.8
+-------------
+* Bugfix: chimpd --verbose
+
+Version 0.4.9
+-------------
+* Feature: log actions to file
+* Feature: retry/cancel all button added to chimpd
+
+Version 0.5.0
+-------------
+* Feature: rewrite of queue system to support task grouping
+* Feature: detailed execution time reporting
+* Feature: new chimpd web interface skin
+* Feature: retry failed and cancel running
+* Feature: improved logging in chimpd
+
+Version 0.5.1
+-------------
+* Feature: move run_script_on_instances from API 0.1 to API 1.0 (rest_connection 06df205d7f)
+
+Version 0.5.2
+-------------
+* Feature: --noverify flag disables interactive verification of errors
+
+Version 0.5.3
+-------------
+* Bugfix: non-operational array instances are no longer operated upon
+
+Version 0.5.4
+-------------
+* Bugfix:  reduce log output during reporting
+* Feature: The --report flag now sets quiet mode and concurrency=5 by default
+
+Version 0.5.5
+-------------
+* Bugfix: --limit flag wasn't sorting servers before executing
+

data/Gemfile

@@ -0,0 +1,4 @@
+# A sample Gemfile
+source "https://rubygems.org"
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,49 @@
+PATH
+  remote: .
+  specs:
+    right_chimp (1.0)
+      progressbar (~> 0.11.0)
+      rake (~> 0.9.2.2)
+      rest-client (~> 1.6.7)
+      rest_connection (~> 1.0.6)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (3.2.13)
+      i18n (= 0.6.1)
+      multi_json (~> 1.0)
+    diff-lcs (1.1.3)
+    highline (1.6.18)
+    i18n (0.6.1)
+    json (1.7.7)
+    mime-types (1.23)
+    multi_json (1.7.2)
+    net-ssh (2.6.7)
+    nokogiri (1.5.9)
+    progressbar (0.11.0)
+    rake (0.9.2.2)
+    rest-client (1.6.7)
+      mime-types (>= 1.16)
+    rest_connection (1.0.6)
+      activesupport
+      highline
+      json
+      net-ssh
+      nokogiri
+      rest-client
+    rspec (2.6.0)
+      rspec-core (~> 2.6.0)
+      rspec-expectations (~> 2.6.0)
+      rspec-mocks (~> 2.6.0)
+    rspec-core (2.6.4)
+    rspec-expectations (2.6.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.6.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  right_chimp!
+  rspec (~> 2.6.0)

data/INSTALL

@@ -0,0 +1,25 @@
+INSTALLING FROM GEM
+-------------------
+
+This is the easiest way to get up and running with chimp. Make sure you have
+Ruby and RubyGems installed. You can then install on your system by using the
+following command:
+
+        gem install chimp-<version>.gem
+
+INSTALLING FROM SOURCE
+----------------------
+
+If you want to hack on chimp or just run unstable code, then you've come to
+the right place! To install chimp from source, first make sure you have 
+all the required gems installed. Change to the chimp source directory and
+execute:
+
+        bundle install
+
+Chimp uses a rakefile to perform most common operations. For a complete list
+of rake targets, please see "rake -T". To build and install the gem:
+
+        rake build
+        rake install
+

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011-2012 RightScale, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README

@@ -0,0 +1,80 @@
+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 based on a tag query. Multiple fields to include in a report can
+be specified in a comma delimited list:
+
+  chimp --report="nickname,ip-address"
+
+Would include both the server nickname and ip address to the report:
+
+  server1-1.rightscale.com,192.168.0.1
+  server1-2.rightscale.com,192.168.0.2
+  server1-3.rightscale.com,192.168.0.3
+  server1-4.rightscale.com,192.168.0.4
+
+Any field present on a rest_connection Server object can be queried. This
+includes: 
+
+  Field                               Example
+  ----------------------------------- ----------------------------
+  aws-id                              i-12345
+  aws-platform                        Linux/Unix
+  cloud_id                              
+  created_at
+  current_instance_href
+  deployment_href
+  dns-name                            ec2-50-17-195-218.compute-1.amazonaws.com
+  ec2-availability-zone               us-east-1a
+  ec2-instance-type                   c1.medium
+  ec2-security-groups-href
+  ec2-ssh-key-href
+  href
+  ip-address                          50.17.195.12
+  locked                              false
+  nickname
+  pricing                             on_demand
+  private-dns-name
+  private-ip-address                  10.10.1.1
+  server_template_href
+  server_type                         ec2
+  state                               operational
+  updated_at                          2011/10/18 21:53:56 +0000
+
+Additionally you can report on instance tags:
+
+  chimp --report="nickname,tag=service:myservice"
+
+  server1-1.rightscale.com,service:id=1
+  server1-2.rightscale.com,service:id=2
+  server1-3.rightscale.com,service:id=3
+  server1-4.rightscale.com,service:id=4
+
+OBLIGATORY MAINTENANCE STRING
+-----------------------------
+maintained by Red_Team

data/Rakefile

@@ -0,0 +1,18 @@
+require 'rubygems'
+require 'bundler/gem_tasks'
+
+desc "Open an irb session preloaded with Chimp"
+task :console do
+  sh "irb -rubygems -I lib -r lib/right_chimp.rb"
+end
+
+desc "Run rspec tests"
+task :spec do
+  sh "rspec spec/spec_*.rb"
+end
+
+desc "Clean up source directories and packages"
+task :clean do
+  sh "rm -rf pkg/*.gem 2>/dev/null || true"
+  sh "rm *~ */*~ */*/*~ 2>/dev/null || true"
+end

data/bin/chimp

@@ -0,0 +1,12 @@
+#!/usr/bin/env ruby
+#
+# Chimp - a command-line tool for the RightScale Platform
+#
+# Copyright (c) 2011-2012 RightScale Inc.
+#
+
+require 'rubygems'
+require 'bundler'
+require 'right_chimp'
+
+Chimp::Chimp.new.run

data/bin/chimpd

@@ -0,0 +1,12 @@
+#!/usr/bin/env ruby
+#
+# chimpd -- the chimp daemon
+#
+# Copyright (c) 2011 RightScale Inc.
+#
+
+require 'rubygems'
+require 'bundler'
+require 'right_chimp'
+
+Chimp::ChimpDaemon.instance.run

data/chimp.gemspec

@@ -0,0 +1,27 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "right_chimp/version"
+
+Gem::Specification.new do |s|
+  s.name        = "right_chimp"
+  s.version     = Chimp::VERSION
+  s.authors     = ["Christopher Deutsch"]
+  s.email       = ["christopher@rightscale.com"]
+  s.homepage    = "https://github.com/rightscale/right_chimp"
+  s.summary     = %q{RightScale platform command-line tool}
+  s.description = %q{The Chimp is a tool for managing servers using the RightScale platform.}
+
+  # s.rubyforge_project = "chimp"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+  
+  s.add_dependency "progressbar", "~> 0.11.0"
+  s.add_dependency "rest-client", "~> 1.6.7"
+  s.add_dependency "rake", "~> 0.9.2.2"
+  s.add_dependency "rest_connection", "~> 1.0.6"
+
+  s.add_development_dependency "rspec", "~> 2.6.0"              
+end