nirvdrum-amazon-ec2 0.7.9

data/README_dev.rdoc

@@ -0,0 +1,10 @@
+= Dev Docs
+
+Publishing the gem using Jeweler:
+
+  rake version:bump:patch release
+
+Push the gem to gemcutter:
+
+  gem push pkg/amazon-ec2-X.Y.Z.gem
+

data/Rakefile

@@ -0,0 +1,70 @@
+require 'rubygems'
+require 'rake'
+require 'yard'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  gem.name = "nirvdrum-amazon-ec2"
+  gem.summary = %Q{Amazon EC2 Ruby Gem}
+  gem.description = %Q{A Ruby library for accessing the Amazon Web Services EC2, ELB, RDS, Cloudwatch, and Autoscaling API's.}
+  gem.email = "glenn@rempe.us"
+  gem.homepage = "http://github.com/grempe/amazon-ec2"
+  gem.authors = ["Glenn Rempe"]
+  gem.rdoc_options = ["--title", "amazon-ec2 documentation", "--line-numbers", "--main", "README.rdoc"]
+  gem.rubyforge_project = 'amazon-ec2'
+  gem.add_dependency('xml-simple', '>= 1.0.12')
+  gem.add_development_dependency('mocha', '>= 0.9.8')
+  gem.add_development_dependency('test-spec', '>= 0.10.0')
+  gem.add_development_dependency('rcov', '>= 0.9.6')
+  gem.add_development_dependency('perftools.rb', '>= 0.3.9')
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/test_*.rb'
+    test.verbose = true
+    test.rcov_opts << "--exclude /gems/,/Library/,spec"
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: [sudo] gem install rcov"
+  end
+end
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION.yml')
+    config = YAML.load(File.read('VERSION.yml'))
+    version = "#{config[:major]}.#{config[:minor]}.#{config[:patch]}"
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "amazon-ec2 #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+YARD::Rake::YardocTask.new do |t|
+  #t.files   = ['lib/**/*.rb']
+end
+
+desc "Generate a perftools.rb profile"
+task :profile do
+  system("CPUPROFILE=perftools/ec2prof RUBYOPT='-r/Library/Ruby/Gems/1.8/gems/perftools.rb-0.3.2/lib/perftools.bundle' ruby -r'rubygems' bin/ec2-gem-profile.rb")
+  system("pprof.rb --text --ignore=Gem perftools/ec2prof > perftools/ec2prof-results.txt")
+  system("pprof.rb --dot --ignore=Gem perftools/ec2prof > perftools/ec2prof-results.dot")
+end
+

data/VERSION

@@ -0,0 +1 @@
+0.7.9

data/amazon-ec2.gemspec

@@ -0,0 +1,142 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{amazon-ec2}
+  s.version = "0.7.9"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Glenn Rempe"]
+  s.date = %q{2009-12-22}
+  s.description = %q{A Ruby library for accessing the Amazon Web Services EC2, ELB, RDS, Cloudwatch, and Autoscaling API's.}
+  s.email = %q{glenn@rempe.us}
+  s.executables = ["ec2-gem-example.rb", "ec2-gem-profile.rb", "ec2sh", "setup.rb"]
+  s.extra_rdoc_files = [
+    "ChangeLog",
+     "LICENSE",
+     "README.rdoc",
+     "README_dev.rdoc"
+  ]
+  s.files = [
+    ".gitignore",
+     ".yardopts",
+     "ChangeLog",
+     "LICENSE",
+     "README.rdoc",
+     "README_dev.rdoc",
+     "Rakefile",
+     "VERSION",
+     "amazon-ec2.gemspec",
+     "bin/ec2-gem-example.rb",
+     "bin/ec2-gem-profile.rb",
+     "bin/ec2sh",
+     "bin/setup.rb",
+     "deps.rip",
+     "lib/AWS.rb",
+     "lib/AWS/Autoscaling.rb",
+     "lib/AWS/Autoscaling/autoscaling.rb",
+     "lib/AWS/Cloudwatch.rb",
+     "lib/AWS/Cloudwatch/monitoring.rb",
+     "lib/AWS/EC2.rb",
+     "lib/AWS/EC2/availability_zones.rb",
+     "lib/AWS/EC2/console.rb",
+     "lib/AWS/EC2/devpay.rb",
+     "lib/AWS/EC2/elastic_ips.rb",
+     "lib/AWS/EC2/image_attributes.rb",
+     "lib/AWS/EC2/images.rb",
+     "lib/AWS/EC2/instances.rb",
+     "lib/AWS/EC2/keypairs.rb",
+     "lib/AWS/EC2/products.rb",
+     "lib/AWS/EC2/security_groups.rb",
+     "lib/AWS/EC2/snapshots.rb",
+     "lib/AWS/EC2/volumes.rb",
+     "lib/AWS/ELB.rb",
+     "lib/AWS/ELB/load_balancers.rb",
+     "lib/AWS/RDS.rb",
+     "lib/AWS/RDS/rds.rb",
+     "lib/AWS/exceptions.rb",
+     "lib/AWS/responses.rb",
+     "perftools/ec2prof",
+     "perftools/ec2prof-results.dot",
+     "perftools/ec2prof-results.txt",
+     "perftools/ec2prof.symbols",
+     "test/test_Autoscaling_groups.rb",
+     "test/test_EC2.rb",
+     "test/test_EC2_availability_zones.rb",
+     "test/test_EC2_console.rb",
+     "test/test_EC2_elastic_ips.rb",
+     "test/test_EC2_image_attributes.rb",
+     "test/test_EC2_images.rb",
+     "test/test_EC2_instances.rb",
+     "test/test_EC2_keypairs.rb",
+     "test/test_EC2_products.rb",
+     "test/test_EC2_responses.rb",
+     "test/test_EC2_s3_xmlsimple.rb",
+     "test/test_EC2_security_groups.rb",
+     "test/test_EC2_snapshots.rb",
+     "test/test_EC2_volumes.rb",
+     "test/test_ELB_load_balancers.rb",
+     "test/test_RDS.rb",
+     "test/test_helper.rb",
+     "wsdl/2007-08-29.ec2.wsdl",
+     "wsdl/2008-02-01.ec2.wsdl",
+     "wsdl/2008-05-05.ec2.wsdl",
+     "wsdl/2008-12-01.ec2.wsdl",
+     "wsdl/2009-10-31.ec2.wsdl",
+     "wsdl/2009-11-30.ec2.wsdl"
+  ]
+  s.homepage = %q{http://github.com/grempe/amazon-ec2}
+  s.rdoc_options = ["--title", "amazon-ec2 documentation", "--line-numbers", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{amazon-ec2}
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Amazon EC2 Ruby Gem}
+  s.test_files = [
+    "test/test_Autoscaling_groups.rb",
+     "test/test_EC2.rb",
+     "test/test_EC2_availability_zones.rb",
+     "test/test_EC2_console.rb",
+     "test/test_EC2_elastic_ips.rb",
+     "test/test_EC2_image_attributes.rb",
+     "test/test_EC2_images.rb",
+     "test/test_EC2_instances.rb",
+     "test/test_EC2_keypairs.rb",
+     "test/test_EC2_products.rb",
+     "test/test_EC2_responses.rb",
+     "test/test_EC2_s3_xmlsimple.rb",
+     "test/test_EC2_security_groups.rb",
+     "test/test_EC2_snapshots.rb",
+     "test/test_EC2_volumes.rb",
+     "test/test_ELB_load_balancers.rb",
+     "test/test_helper.rb",
+     "test/test_RDS.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<xml-simple>, [">= 1.0.12"])
+      s.add_development_dependency(%q<mocha>, [">= 0.9.8"])
+      s.add_development_dependency(%q<test-spec>, [">= 0.10.0"])
+      s.add_development_dependency(%q<rcov>, [">= 0.9.6"])
+      s.add_development_dependency(%q<perftools.rb>, [">= 0.3.9"])
+    else
+      s.add_dependency(%q<xml-simple>, [">= 1.0.12"])
+      s.add_dependency(%q<mocha>, [">= 0.9.8"])
+      s.add_dependency(%q<test-spec>, [">= 0.10.0"])
+      s.add_dependency(%q<rcov>, [">= 0.9.6"])
+      s.add_dependency(%q<perftools.rb>, [">= 0.3.9"])
+    end
+  else
+    s.add_dependency(%q<xml-simple>, [">= 1.0.12"])
+    s.add_dependency(%q<mocha>, [">= 0.9.8"])
+    s.add_dependency(%q<test-spec>, [">= 0.10.0"])
+    s.add_dependency(%q<rcov>, [">= 0.9.6"])
+    s.add_dependency(%q<perftools.rb>, [">= 0.3.9"])
+  end
+end
+

data/bin/ec2-gem-example.rb

@@ -0,0 +1,137 @@
+#!/usr/bin/env ruby
+
+# Amazon Web Services EC2 Query API Ruby library
+#
+# Ruby Gem Name::  amazon-ec2
+# Author::    Glenn Rempe  (mailto:glenn@rempe.us)
+# Copyright:: Copyright (c) 2007-2008 Glenn Rempe
+# License::   Distributes under the same terms as Ruby
+# Home::      http://github.com/grempe/amazon-ec2/tree/master
+#++
+
+require File.dirname(__FILE__) + '/../lib/AWS'
+require 'pp'
+
+# pull these from the local shell environment variables set in ~/.bash_login
+# or using appropriate methods specific to your login shell.
+#
+# e.g. in ~/.bash_login
+#
+#  # For amazon-ec2 and amazon s3 ruby gems
+#  export AMAZON_ACCESS_KEY_ID="FOO"
+#  export AMAZON_SECRET_ACCESS_KEY="BAR"
+
+ACCESS_KEY_ID = ENV['AMAZON_ACCESS_KEY_ID']
+SECRET_ACCESS_KEY = ENV['AMAZON_SECRET_ACCESS_KEY']
+
+if ACCESS_KEY_ID.nil? || ACCESS_KEY_ID.empty?
+  puts "Error : You must add the shell environment variables AMAZON_ACCESS_KEY_ID and AMAZON_SECRET_ACCESS_KEY before calling #{$0}!"
+  exit
+end
+
+# us-east-1.ec2.amazonaws.com == ec2.amazonaws.com
+# eu-west-1.ec2.amazonaws.com for the european region
+# test different servers by running something like:
+# export EC2_URL='https://ec2.amazonaws.com';./bin/ec2-gem-example.rb
+if ENV['EC2_URL']
+  ec2 = AWS::EC2::Base.new( :access_key_id => ACCESS_KEY_ID, :secret_access_key => SECRET_ACCESS_KEY, :server => URI.parse(ENV['EC2_URL']).host )
+else
+  # default server is US ec2.amazonaws.com
+  ec2 = AWS::EC2::Base.new( :access_key_id => ACCESS_KEY_ID, :secret_access_key => SECRET_ACCESS_KEY )
+end
+
+puts "----- ec2.methods.sort -----"
+p ec2.methods.sort
+
+puts "----- listing images owned by 'amazon' -----"
+ec2.describe_images(:owner_id => "amazon").imagesSet.item.each do |image|
+  image.keys.each do |key|
+    puts "#{key} => #{image[key]}"
+  end
+end
+
+puts "----- listing all running instances -----"
+pp ec2.describe_instances()
+
+puts "----- creating a security group -----"
+pp ec2.create_security_group(:group_name => "ec2-example-rb-test-group", :group_description => "ec-example.rb test group description.")
+
+puts "----- listing security groups -----"
+pp ec2.describe_security_groups()
+
+puts "----- deleting a security group -----"
+pp ec2.delete_security_group(:group_name => "ec2-example-rb-test-group")
+
+puts "----- listing my keypairs (verbose mode) -----"
+pp ec2.describe_keypairs()
+
+# ELB examples
+# Autoscaling examples
+if ENV['ELB_URL']
+  elb = AWS::ELB::Base.new( :access_key_id => ACCESS_KEY_ID, :secret_access_key => SECRET_ACCESS_KEY, :server => URI.parse(ENV['ELB_URL']).host )
+else
+  elb = AWS::ELB::Base.new( :access_key_id => ACCESS_KEY_ID, :secret_access_key => SECRET_ACCESS_KEY)
+end
+
+puts "----- creating an elastic load balancer -----"
+pp elb.create_load_balancer(  
+                            :availability_zones => ["us-east-1a"],
+                            :load_balancer_name => "elb-test-load-balancer",
+                            :listeners => [{:protocol => "tcp", :load_balancer_port => "80", :instance_port => "8080"}]
+                           )
+
+puts "----- listing elastic load balancers -----"
+pp elb.describe_load_balancers(:load_balancer_names => ["elb-test-load-balancer"])
+
+puts "----- deleting load balancer -----"
+pp elb.delete_load_balancer(:load_balancer_name => "elb-test-load-balancer")
+
+# Autoscaling examples
+if ENV['AS_URL']
+  as = AWS::Autoscaling::Base.new( :access_key_id => ACCESS_KEY_ID, :secret_access_key => SECRET_ACCESS_KEY, :server => URI.parse(ENV['AS_URL']).host )
+else
+  as = AWS::Autoscaling::Base.new( :access_key_id => ACCESS_KEY_ID, :secret_access_key => SECRET_ACCESS_KEY)
+end
+
+puts "---- creating a launch configuration group -----"
+pp as.create_launch_configuration( 
+                                :image_id => "ami-ed46a784", 
+                                :instance_type => "m1.small",
+                                :availability_zones => ["us-east-1a"],
+                                :launch_configuration_name => "ec2-example-test-launch-configuration"
+                              )
+                              
+puts "---- creating an autoscaling group -----"
+pp as.create_autoscaling_group( :autoscaling_group_name => "ec2-example-test-autoscaling-group", 
+                                :availability_zones => ["us-east-1a"],
+                                :min_size => 0,
+                                :max_size => 0,
+                                :launch_configuration_name => "ec2-example-test-launch-configuration"
+                              )
+                              
+puts "---- listing autoscaling groups -----"
+pp as.describe_autoscaling_groups(:autoscaling_group_names => [])
+
+puts "---- creating a new autoscaling trigger ----"
+pp as.create_or_updated_scaling_trigger(
+                                        :autoscaling_group_name => "ec2-example-test-autoscaling-group",
+                                        :measure_name => "CPUUtilization",
+                                        :statistic => "Average",
+                                        :period => 300,
+                                        :trigger_name => "test-auto-scaling-trigger-name",
+                                        :lower_threshold => 0.2,
+                                        :lower_breach_scale_increment => 0,
+                                        :upper_threshold => 1.5,
+                                        :upper_breach_scale_increment => 0,
+                                        :breach_duration => 1200,
+                                        :dimensions => ["AutoScalingGroupName", "ec2-example-test-autoscaling-group"]
+                                       )
+
+puts "---- deleting scaling trigger -----"
+pp as.delete_trigger(:trigger_name => "test-auto-scaling-trigger-name", :autoscaling_group_name => "ec2-example-test-autoscaling-group")
+
+puts "---- deleting autoscaling group -----"
+pp as.delete_autoscaling_group(:autoscaling_group_name => "ec2-example-test-autoscaling-group")
+
+puts "---- deleting launch configuration group -----"
+pp as.delete_launch_configuration(:launch_configuration_name => "ec2-example-test-launch-configuration")

data/bin/ec2-gem-profile.rb

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+
+# Basic single command application that we can call with perftools.rb to get consistent results.
+
+require File.dirname(__FILE__) + '/../lib/AWS'
+ACCESS_KEY_ID = ENV['AMAZON_ACCESS_KEY_ID']
+SECRET_ACCESS_KEY = ENV['AMAZON_SECRET_ACCESS_KEY']
+ec2 = AWS::EC2::Base.new( :access_key_id => ACCESS_KEY_ID, :secret_access_key => SECRET_ACCESS_KEY )
+@images = ec2.describe_images
+

data/bin/ec2sh

@@ -0,0 +1,62 @@
+#!/usr/bin/env ruby
+
+# Amazon Web Services EC2 Query API Ruby library
+#
+# Ruby Gem Name::  amazon-ec2
+# Author::    Glenn Rempe  (mailto:glenn@rempe.us)
+# Copyright:: Copyright (c) 2007-2008 Glenn Rempe
+# License::   Distributes under the same terms as Ruby
+# Home::      http://github.com/grempe/amazon-ec2/tree/master
+#++
+
+# CREDITS : Credit for this bit of shameful ripoff coolness
+# goes to Marcel Molina and his AWS::S3 gem.  Thanks!
+
+# Usage : running this starts up an irb session and
+# sets up the connection to EC2 as a class variable called
+# '@ec2'.  So just do something like the following on the
+# shell command line:
+
+#   macbook-pro:~ glenn$ ec2sh
+#   >> @ec2.describe_images
+#   => [#<AWS::EC2::Item image_location...
+
+aws_lib   = File.dirname(__FILE__) + '/../lib/AWS'
+setup = File.dirname(__FILE__) + '/setup'
+irb_name = RUBY_PLATFORM =~ /mswin32/ ? 'irb.bat' : 'irb'
+
+if ( ENV['AMAZON_ACCESS_KEY_ID'] && ENV['AMAZON_SECRET_ACCESS_KEY'] )
+
+  welcome_message = <<-MESSAGE
+
+  'ec2sh' usage :
+  This is an interactive 'irb' command shell that allows you to use all
+  commands available to the amazon-ec2 gem.  You'll find this to be a
+  great tool to help you debug issues and practice running commands
+  against the live EC2 servers prior to putting them in your code.
+
+  The EC2 connection is wired to the class instance '@ec2'.  Make method calls
+  on this to execute commands on EC2.  Adding a #to_s
+  at the end of any command should give you a full String representation of the
+  response.
+
+    Examples to try:
+
+      returns : all ec2 public methods
+      >> @ec2.methods.sort
+
+      returns : a string representation of ALL images
+      >> @ec2.describe_images.to_s
+
+      returns : an Array of AWS::Response objects, each an EC2 image and its data
+      >> @ec2.describe_images.imagesSet.item
+      >> @ec2.describe_images.imagesSet.item[0] (a hash representing a single item in that array)
+      >> @ec2.describe_images.imagesSet.item[0].to_s (a String representation of that item)
+
+  MESSAGE
+
+  puts welcome_message
+  exec "#{irb_name} -rubygems -r #{aws_lib} -r #{setup} --simple-prompt"
+else
+  puts "You must define AMAZON_ACCESS_KEY_ID and AMAZON_SECRET_ACCESS_KEY as shell environment variables before running #{$0}!"
+end

data/bin/setup.rb

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+
+# Amazon Web Services EC2 Query API Ruby library
+#
+# Ruby Gem Name::  amazon-ec2
+# Author::    Glenn Rempe  (mailto:glenn@rempe.us)
+# Copyright:: Copyright (c) 2007-2008 Glenn Rempe
+# License::   Distributes under the same terms as Ruby
+# Home::      http://github.com/grempe/amazon-ec2/tree/master
+#++
+
+if ENV['AMAZON_ACCESS_KEY_ID'] && ENV['AMAZON_SECRET_ACCESS_KEY']
+  opts = {
+    :access_key_id => ENV['AMAZON_ACCESS_KEY_ID'],
+    :secret_access_key => ENV['AMAZON_SECRET_ACCESS_KEY']
+  }
+  if ENV['EC2_URL']
+    opts[:server] = URI.parse(ENV['EC2_URL']).host
+  end
+  @ec2 = AWS::EC2::Base.new(opts)
+  @elb = AWS::ELB::Base.new(opts)
+  @as = AWS::Autoscaling::Base.new(opts)
+  @rds = AWS::RDS::Base.new(opts)
+end
+
+puts "EC2 Server: #{opts[:server]}"
+
+include AWS
+