sabat-rudy 0.8.0

data/CHANGES.txt

@@ -0,0 +1,188 @@
+RUDY, CHANGES
+
+* TODO: Remove string messages for non-string output formats
+* TODO: Support for reserved instances
+* TODO: Tests for zone and region support
+* TODO: Support for machine image attributes
+* TODO: Support for product codes
+
+#### 0.7.5 (2009-05-??) ###############################
+
+* CHANGE: rudy-ec2 console now displays windows password automatically if keypair is supplied.
+* ADDED: register and destroy commands to rudy-ec2 images
+
+
+#### 0.7.4 (2009-05-10) ###############################
+
+* CHANGE: Keypairs now include zone. This was necessary to allow US and EU keypairs to
+be stored in the same directory. 
+* CHANGE: Moved non-rudy specific modules to separate projects (storable, sysinfo, annoy, console -> Drydock, escape -> Rye, tryouts -> tryouts/).
+* CHANGE: Renamed restart routine to reboot to make it clear it's about the machine
+* CHANGE: Renamed Rudy::Disk to Rudy::MetaData::Disk
+* CHANGE: Short alias for rudy-ec2 snapshot is now 's' (instead of 't')
+* CHANGE: Removed highline-1.5.1 from vendor (it's now available as a gem)
+* FIXED: Bug in Huxtable when loading global. Wasn't reloaded after config was updated. 
+* FIXED: Closed gh-12 (thanks sabat)
+* ADDED: Routines now support dependencies
+* ADDED: Disk routines now support mount, umount, snapshot, and restore
+* ADDED: rudy disk command now displays backups with -b switch
+* ADDED: RE-added basic support for creating Linux images (with security warning)
+* ADDED: Routines with underscores can now be called with dashes (a_routine vs a-routine)
+
+
+#### 0.7.3 (2009-05-05) ###############################
+
+* FIXED: Corrected a few minor interface errors in rudy-ec2
+* ADDED: rudy-ec2 console can now display the decoded admin password for Windows instances. 
+
+
+#### 0.7.2 (2009-05-04) ###############################
+
+* FIXED: cli/routine.rb release method wasn't sending command alias (which broke rerelease)
+* ADDED: global.offline for being cool when Internet is down
+* ADDED: Better handling in aws/sdb when call returns nil (Internet is down)
+
+
+#### 0.7.1 (2009-05-04) ###############################
+
+* FIXED: rudy wasn't honouring -C option for specifying a config file
+* FIXED: Was disabling, but not enabling colour
+* FIXED: Symbol errors in 1.8 
+* FIXED: Command blocks for root user are always run first now in Routines config.
+* CHANGE: routines before, after, and script blocks are now processed by Rye::Box.batch as Procs. 
+* CHANGE: deny was removed from commands config (it will come back later). 
+* CHANGE: Rudy now checks the current working directory for machines, commands, etc... configs
+* ADDED: examples/
+* ADDED: "script" keyword to routines config. 
+* ADDED: script_local
+* ADDED: Routine now checks whether there are any remote tasks. If not, it doesn't loop through machines. 
+
+
+#### 0.7.0 (2009-05-02) ###############################
+
+* CHANGE: Upgrade to Drydock 0.6, Caesars 0.6, and Rye 0.6
+* CHANGE: Updated Routines configuration syntax for specifying shell commands 
+* ADDED: Releases via local git repository
+* ADDED: authorize and adduser directives to routines config.
+* ADDED: Improved CLI output for routines. 
+* ADDED: Commands configuration for custom SSH commands
+* ADDED: Auto-set hostname to machine name
+* ADDED: Support for arbitrary routines via passthrough
+
+
+
+#### 0.6.8 (2009-04-24) ###############################
+
+* CHANGE: Renamed rudy config --rudy option to --project. This was important 
+to maintain consistency in documentation.
+* CHANGE: Cleaned README. See: http://wiki.github.com/solutious/rudy
+
+#### 0.6.7 (2009-04-22) ###############################
+
+* ADDED: rudy-ec2 status can now display EU status
+* FIXED: Fixed bug on instance create. Instance.groups was nil, now it returns 
+empty Array.
+
+#### 0.6.6 (2009-04-22) ###############################
+
+* ADDED: Better error handling for Rudy::AWS::SDB
+* FIXED: Ruby 1.9.1 compatability (including requiring aws-s3 >=0.6.1)
+
+
+#### 0.6.5 (2009-04-20) ###############################
+
+* FIXED: Startup and Shutdown routines now check machine group status first
+* FIXED: Misc release process issues between 0.6.0 and 0.6.4
+* ADDED: Better error handling during startup and shutdown. 
+* ADDED: Support for assigning addresses on startup
+
+
+#### 0.6.0 (2009-04-19) ###############################
+
+NOTE: This is a significant re-write from 0.5
+
+* CHANGE: Rebuilt Rudy::AWS::*
+* CHANGE: Removed lib/rudy/commands/* and lib/rudy/metadata/*
+* ADDED: rudy-ec2 executable
+* CHANGE: have local copies of Caesars and Drydock to reduce external dependencies. 
+* ADDED: new output formats: yaml, json, csv, tsv
+
+
+#### 0.5.1 (2009-04-10) ###############################
+
+* CHANGE: Removed require 'rubygems'
+* FIXED: Resolved Drydock namespace issue for rudy and ird
+
+
+#### 0.5.0 (2009-04-09) ###############################
+
+NOTE: This is a significant re-write from 0.4
+
+* CHANGE: Recommend keypair config to be in ~/.rudy/config
+* FIX: Rudy now checks for user keys specified by env-role, env, and global
+* FIX: gemspec dependency net-ssh-multi
+* ADDED: --nocolor option 
+* ADDED: Ruby API
+* ADDED: Tests with 55% coverage
+* ADDED: Ruby API (Rudy::Machines, etc...)
+* ADDED: ird, a REPL (experimental)
+* ADDED: Now uses Rye 0.4.1
+
+#### 0.4 (2009-03-12) ###############################
+
+NOTE: This is a significant re-write from 0.3
+
+* CHANGE: Mostly re-written bin/ruby, moving validation to CLI classes 
+* CHANGE: upgrade to Drydock 0.5
+* CHANGE: Moved generic EC2 commands to bin/rudy-ec2
+* CHANGE: Removed ambiguity of pluralized command names.
+  * OLD: backups, disks, configs
+  * ADDED: backup, disk, config
+* ADDED: ssh and scp commands for connecting to and copying files to/from machines
+* ADDED: New dependencies (trying out net-ssh)
+* ADDED: Domain specific language for configuration
+* ADDED: "Routines" for handling common actions. Starting, stopping, releasing, deploying. 
+* ADDED: "rudy release" will create a release from the current working copy, start an instance, 
+checkout the release, run routines. It needs some work still, but this already functions as
+a single command release process. 
+* ADDED: "rudy start|destroy|restart|update|status". Routines allow us to have generic commands 
+that can be used for any machine group. These commands relate to starting new instances.
+* ADDED: Extra caution when running destructive commands
+* ADDED: Default ~/.rudy/config created if it doesn't exist. 
+
+
+#### 0.3 (2009-02-26) ###############################
+
+NOTE: This is a significant re-write from 0.2
+
+* CHANGE: Re-written support/rudy-ec2-startup
+* CHANGE: upgrade to Drydock 0.4
+* ADDED: More functionality for disks and backups
+* ADDED: config commands
+* ADDED: Per machine configuration (via ~/.rudy)
+
+
+#### 0.2 (2009-02-23) ###############################
+
+NOTE: This is a complete re-write from 0.1
+
+* CHANGE: Added Environment variables
+* CHANGE: upgrade to drydock 0.3.3
+* ADDED: All time references are converted to UTC
+* ADDED: Safer "Are you sure?". Number of characters to enter is 
+       commiserate with amount of danger.  
+* ADDED: CLIs: myaddress, addresses, images, instances, 
+       disks, connect, copy, stage, backups, volumes
+* ADDED: Metadata storage to SimpleDB for disks, backups
+* ADDED: Creates EBS volumes based on startup from metadata
+* ADDED: Automated release process
+* ADDED: Automated creation of machine images
+* ADDED: Partial support for regions and zones
+* ADDED: Manage system based on security groups. 
+* ADDED: "rudy groups" overhaul. Display, creates, destroys groups. 
+
+
+
+#### 0.1 (2009-02-06) ###############################
+
+* Initial public release

data/LICENSE.txt

@@ -0,0 +1,19 @@
+Copyright (c) 2009 Solutious 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.rdoc

@@ -0,0 +1,118 @@
+= Rudy - v0.7 BETA
+
+<b>Not your grandparents' EC2 deployment tool.</b>
+
+Rudy is a command-line development and deployment tool for Amazon Web Services. It helps you build and manage machines in EC2 by organizing them into groups of _environments_ and _roles_. These are called _machine_ _groups_. <tt>stage</tt> is the default environment and <tt>app</tt> is the default role. You can run multiple machines with the same role. These are called _positions_. Rudy also supports running machine groups across availability _zones_. 
+
+When you put all this together, you have a unique name for every machine. The default machine is:
+
+             zone     env  role
+              v        v    v   
+        m-us-east-1b-stage-app-01
+        ^                       ^
+     "machine"                position
+
+All configuration is organized into the zones, environments, and roles that you specify (Rudy assumes positions are identical which is important for backups and scaling). And as you'd expect, the defaults can be changed too (in <tt>~/.rudy/config</tt>).
+
+<b>See Getting-Started[http://wiki.github.com/solutious/rudy/getting-started] for more info.</b>
+
+<em>NOTE: This is a BETA release. That means Rudy's not ready for production use! See Project-Status[http://wiki.github.com/solutious/rudy/project-status].</em>
+
+== Features
+
+* Create complex environments with a single command
+  * Launch multiple instances 
+  * Assign elastic IP addresses
+  * Create EBS volumes, attach to instances, format, and mount
+  * Run scripts locally and remotely automatically
+* Organize instances into environments and roles
+* Powerful command-line tools
+  * <tt>$ rudy -u root ssh</tt>
+  * <tt>$ rudy -e testing -r database startup</tt>
+* Use _any Linux_ Amazon machine image (AMI) (partial Solaris support)
+* Complete command-line interface for EC2. See <tt>bin/rudy-ec2</tt>.
+
+== Installation
+
+Via Rubygems, one of:
+
+    $ sudo gem install rudy
+    $ sudo gem install solutious-rudy --source http://gems.github.com/
+
+or via download:
+* rudy-latest.tar.gz[http://github.com/solutious/rudy/tarball/latest]
+* rudy-latest.zip[http://github.com/solutious/rudy/zipball/latest]
+
+NOTE: <em>If you are not installing via RubyGems, you need to make sure the dependencies are in your LOAD_PATH (<tt>$:</tt>). Ryan Tomayko wrote a gist[http://gist.github.com/54177] about it.</em>
+
+<b>See Getting-Started[http://wiki.github.com/solutious/rudy/getting-started] for more info.</b>
+
+
+== Pre-Requisites
+
+* Amazon AWS[http://aws.amazon.com/] Account
+  * EC2[http://aws.amazon.com/ec2/]
+  * SimpleDB[http://aws.amazon.com/simpledb/]
+  * S3[http://aws.amazon.com/s3/]
+* OpenSSH[http://www.openssh.com/]
+* Ruby[http://ruby-lang.org] 1.8.x, 1.9.x, or JRuby[http://jruby.codehaus.org] 1.2
+  * Net::SSH[http://net-ssh.rubyforge.org/]
+  * Net::SCP[http://net-ssh.rubyforge.org/]
+  * amazon-ec2[http://github.com/grempe/amazon-ec2]
+  * aws-s3[http://github.com/marcel/aws-s3]
+  * Rye[http://github.com/delano/rye]
+  * Drydock[http://github.com/delano/drydock]
+  * Caesars[http://github.com/delano/caesars]
+
+
+== More Info
+
+* Fork at GitHub[http://github.com/solutious/rudy]
+* Read the Documentation[http://wiki.github.com/solutious/rudy]
+* Submit issues to the IssueTracker[http://github.com/solutious/rudy/issues]
+* Start a discussion on the GoogleGroup[http://groups.google.com/group/rudy-deployment]
+* Find some Inspiration[http://www.youtube.com/watch?v=CgaiIW5Rzes]
+* For all other inquires, email me directly: delano@solutious.com
+
+
+== Thanks
+
+* The Rilli.com[http://rilli.com] team
+  * Adam Bognar
+  * Andrew Simpson
+  * Caleb Buxton
+  * Colin Brumelle
+* Sam Aaron
+* Everyone at Utrecht.rb[http://groups.google.com/group/utrecht-rb]
+* Jamis Buck for Net::SSH and friends
+* Glenn Rempe for amazon-ec2
+* Marcel Molina Jr. for aws-s3
+* sabat[http://github.com/sabat] 
+* Keshia Knight Pulliam
+
+
+== Contributions
+
+I'm very open to contributions! 
+
+* For bigger features please fork the git repo and send me a pull request. 
+* For small or single file changes, send me an email with the details: <tt>delano@solutious.com</tt>
+
+
+== Credits
+
+* Delano Mandelbaum (delano@solutious.com)
+* Rudy::AWS::SDB adapted from aws_sdb by Tim Dysinger (http://dysinger.net)
+
+
+== Related Projects
+
+* Pool Party -- http://www.poolpartyrb.com/
+* Rubber -- http://github.com/wr0ngway/rubber/wikis
+* Moonshine -- http://github.com/railsmachine/moonshine/tree
+* Boto -- http://code.google.com/p/boto/
+
+
+== License
+
+See: LICENSE.txt

data/Rakefile

@@ -0,0 +1,165 @@
+
+require 'rake/clean'
+require 'rake/gempackagetask'
+require 'hanna/rdoctask'
+require 'rake/testtask'
+require 'shoulda/tasks'
+require 'rake/runtest'
+require 'monkeyspecdoc'  # http://jgre.org/2008/09/03/monkeyspecdoc/
+require 'fileutils'
+include FileUtils
+ 
+task :default => :test
+ 
+
+
+# TESTS ===============================================================
+ 
+Rake::TestTask.new(:test_old) do |t|
+  require 'monkeyspecdoc'
+  test_files = FileList['test/**/*_test.rb'] || []
+  t.test_files = test_files
+  t.ruby_opts = ['-rubygems'] if defined? Gem
+  t.verbose = true
+#  t.warning = true
+  
+end
+
+
+namespace :test do
+  #about 'Measures test coverage'
+  task :coverage do
+    rm_f "coverage"
+    rm_f "coverage.data"
+    rcov = "rcov -Itest --aggregate coverage.data -T -x ' rubygems/*,/Library/Ruby/Site/*,gems/*,rcov*'"
+    system("#{rcov} --html test/**/*_test.rb")
+    system("open coverage/index.html") if RUBY_PLATFORM['darwin']
+  end
+  task :list do
+    puts Dir.glob(File.join('test', '**', '*_test.rb'))
+  end
+  
+  # Run individual test groups with: 
+  # rake test:05 
+  # rake test:60
+  # etc...
+  ('00'..'99').each do |group|
+    task group.to_sym do
+      Rake.run_tests "test/#{group}*/*_test.rb"
+    end
+    
+    # And also individual test files
+    # rake test:50:10
+    # etc...
+    ('00'..'99').each do |test|
+      namespace group.to_sym do
+        task test.to_sym do
+          Rake.run_tests "test/#{group}*/{00,#{test}}*_test.rb"
+        end
+      end
+    end
+  end
+end
+
+task :test do
+
+  #all_tests = Dir.glob(File.join('test', '{05,20,50}*', '*_test.rb')) || []
+  #all_tests.sort.each do |file|
+  #  load file
+  #end
+  Rake.run_tests 'test/**/*_test.rb'
+end
+
+
+# From: shoulda/tasks/list_tests.rake
+namespace :shoulda do
+  #about "List the names of the test methods in a specification like format"
+  task :list_fixed do
+    $LOAD_PATH.unshift("test")
+
+    require 'test/unit'
+    require 'active_support'
+
+    # bug in test unit.  Set to true to stop from running.
+    Test::Unit.run = true
+
+    test_files = Dir.glob(File.join('test', '**', '*_test.rb'))
+    
+    test_files.each do |file|
+      load file
+      klass = File.basename(file, '.rb').classify
+      #unless Object.const_defined?(klass.to_s)    # => raises: wrong constant name 00SetupTest
+      unless Object.constants.member?(klass.to_s)  # fixed
+        puts "Skipping #{klass} because it doesn't map to a Class"
+        next
+      end
+      klass = klass.constantize
+
+      puts klass.name.gsub('Test', '')
+
+      test_methods = klass.instance_methods.grep(/^test/).map {|s| s.gsub(/^test: /, '')}.sort
+      test_methods.each {|m| puts "  " + m }
+    end
+  end
+end
+
+
+# PACKAGE =============================================================
+
+name = "rudy"
+load "#{name}.gemspec"
+
+version = @spec.version
+
+Rake::GemPackageTask.new(@spec) do |p|
+  p.need_tar = true if RUBY_PLATFORM !~ /mswin/
+end
+
+task :release => [ "publish:gem", :clean, "publish:rdoc" ] do
+  $: << File.join(File.dirname(__FILE__), 'lib')
+  require "rudy"
+  abort if Drydock.debug?
+end
+
+task :install => [ :rdoc, :package ] do
+	sh %{sudo gem install pkg/#{name}-#{version}.gem}
+end
+
+task :uninstall => [ :clean ] do
+	sh %{sudo gem uninstall #{name}}
+end
+
+
+# Rubyforge Release / Publish Tasks ==================================
+
+#about 'Publish website to rubyforge'
+task 'publish:rdoc' => 'doc/index.html' do
+  sh "scp -rp doc/* rubyforge.org:/var/www/gforge-projects/#{name}/"
+end
+
+#about 'Public release to rubyforge'
+task 'publish:gem' => [:package] do |t|
+  sh <<-end
+    rubyforge add_release -o Any -a CHANGES.txt -f -n README.rdoc #{name} #{name} #{@spec.version} pkg/#{name}-#{@spec.version}.gem &&
+    rubyforge add_file -o Any -a CHANGES.txt -f -n README.rdoc #{name} #{name} #{@spec.version} pkg/#{name}-#{@spec.version}.tgz 
+  end
+end
+
+
+Rake::RDocTask.new do |t|
+	t.rdoc_dir = 'doc'
+	t.title    = @spec.summary
+	t.options << '--line-numbers' <<  '-A cattr_accessor=object'
+	t.options << '--charset' << 'utf-8'
+	t.rdoc_files.include('LICENSE.txt')
+	t.rdoc_files.include('README.rdoc')
+	t.rdoc_files.include('CHANGES.txt')
+	#t.rdoc_files.include('Rudyfile')  # why is the formatting f'd?
+	t.rdoc_files.include('bin/*')
+	t.rdoc_files.include('lib/**/*.rb')
+end
+
+CLEAN.include [ 'pkg', '*.gem', '.config', 'doc', 'coverage*' ]
+
+
+