rs-api-tools 0.0.1 → 0.0.2

data/bin/rs-create-alert-spec

@@ -0,0 +1,91 @@
+#!/usr/bin/ruby
+
+# rs-create-alert-spec <alert spec params>
+
+require 'rubygems'
+require 'getoptlong'
+require 'json'
+require 'rest_connection'
+require 'active_support'  #for to_xml()
+require 'xmlsimple'
+
+def usage
+  puts("#{$0} [--xml] [--json]")
+  puts "Example:"
+  puts "rs-create-alert-spec --name 'foobar alert' --file 'processes-java/ps_count' --variable 'processes' --condition '>' --threshold '25.0' --escalation-name 'critical' --duration 60 --subject-type ServerTemplate --action escalate"
+  exit
+end
+
+def usage_exit
+  usage; exit
+end
+
+json = false
+xml = false
+verbose = false
+alert_spec_params = Hash.new
+
+usage_exit if ARGV.length < 18   # (9 required options, but this should not be checked so arbitrarily)
+
+opts = GetoptLong.new(
+  [ '--name', '-n', GetoptLong::REQUIRED_ARGUMENT ],
+  [ '--file', '-f', GetoptLong::REQUIRED_ARGUMENT ],
+  [ '--variable', '-v', GetoptLong::REQUIRED_ARGUMENT ],
+  [ '--condition', '-c', GetoptLong::REQUIRED_ARGUMENT ],
+  [ '--threshold', '-t', GetoptLong::REQUIRED_ARGUMENT ],
+  [ '--escalation-name', '-e', GetoptLong::REQUIRED_ARGUMENT ],
+  [ '--duration', '-d', GetoptLong::REQUIRED_ARGUMENT ],
+  [ '--description', '-D', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--subject-type', '-s', GetoptLong::REQUIRED_ARGUMENT ],
+  [ '--subject-href', '-S', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--action', '-a', GetoptLong::REQUIRED_ARGUMENT ],
+  [ '--vote-tag', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--vote-type', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--xml', '-x', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--json', '-j', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--verbose', '-V', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--help', '-h', GetoptLong::NO_ARGUMENT ]
+)
+
+opts.each do |opt, arg|
+  case opt
+    when '--help'
+      usage; exit
+    when '--name'
+      alert_spec_params['name'] = arg
+    when '--file'
+      alert_spec_params['file'] = arg
+    when '--variable'
+      alert_spec_params['variable'] = arg
+    when '--condition'
+      alert_spec_params['condition'] = arg
+    when '--threshold'
+      alert_spec_params['threshold'] = arg
+    when '--duration'
+      alert_spec_params['duration'] = arg
+    when '--description'
+      alert_spec_params['description'] = arg
+    when '--subject-type'
+      alert_spec_params['subject_type'] = arg
+    when '--subject-href'
+      alert_spec_params['subject_href'] = arg
+    when '--action'
+      alert_spec_params['action'] = arg
+    when '--vote-tag'
+      alert_spec_params['vote_tag'] = arg
+    when '--vote-type'
+      alert_spec_params['vote_tpe'] = arg
+    when '--json'
+      json = true
+    when '--verbose'
+      verbose = true
+    when '--xml'
+      xml = true
+  	end
+end
+
+puts alert_spec_params.to_yaml if verbose
+
+#AlertSpec.attach(alert_spec_params)
+
+puts 'This command is unfinished. Please contrib via pull request.'

data/bin/rs-describe-alerts

@@ -4,10 +4,6 @@
 
 require 'rubygems'
 require 'getoptlong'
-require 'json'
-require 'rest_connection'
-require 'active_support'  #for to_xml()
-require 'xmlsimple'
 
 def usage
   puts("#{$0} [--xml] [--json]")
@@ -31,11 +27,15 @@ opts.each do |opt, arg|
   	end
 end
 
+require 'json'
+require 'rest_connection'
+
 alerts = AlertSpec.find_all()
 
 if json
   puts alerts.to_json
 elsif xml
+  require 'xmlsimple'
   puts JSON.parse(alerts.to_json).to_xml(:root => 'deployments', :skip_instruct => true)
 else
   puts alerts.to_yaml

data/bin/rs-describe-ec2-ebs-snapshots

@@ -4,9 +4,6 @@
 
 require 'rubygems'
 require 'getoptlong'
-require 'json'
-require 'rest_connection'
-require 'active_support'  #for to_xml()
 
 def usage
   puts("#{$0} [--xml] [--json]")
@@ -30,6 +27,9 @@ opts.each do |opt, arg|
   	end
 end
 
+require 'json'
+require 'rest_connection'
+
 ebs_snapshots = Ec2EbsSnapshot.find_all()
 
 if json

data/bin/rs-describe-ec2-ebs-volumes

@@ -1,41 +1,67 @@
 #!/usr/bin/ruby
 
-# rs-describe-ec2-ebs-volumes
+# rs-describe-ec2-ebs-volumes [--cloud <cloud_id>] [--json] [--xml] [--help]
 
 require 'rubygems'
 require 'getoptlong'
-require 'json'
-require 'rest_connection'
-require 'active_support'  #for to_xml()
-require 'xmlsimple'
 
 def usage
-  puts("#{$0} [--xml] [--json]")
+  puts("#{$0} [--cloud] [--help] [--xml] [--json]")
 	exit
 end
 
 opts = GetoptLong.new(
+  [ '--cloud', '-c', GetoptLong::OPTIONAL_ARGUMENT ],
   [ '--xml', '-x', GetoptLong::OPTIONAL_ARGUMENT ],
-  [ '--json', '-j', GetoptLong::OPTIONAL_ARGUMENT ]
+  [ '--json', '-j', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--help', '-h', GetoptLong::OPTIONAL_ARGUMENT ]
 )
 
 json = false
 xml = false
+cloud_id = false
 
 opts.each do |opt, arg|
   case opt
+    when '--cloud'
+      cloud_id = arg
     when '--json'
       json = true
     when '--xml'
       xml = true
+    when '--help'
+      usage; exit
   	end
 end
 
-ebs_volumes = Ec2EbsVolume.find_all()
+# RightScale (public) cloud IDs
+rs_clouds = Array.new
+rs_clouds.push({:cloud_id => 1, :name => "AWS US-East", :region => "us-east-1"})
+rs_clouds.push({:cloud_id => 2, :name => "AWS EU", :region => "eu-west-1"})
+rs_clouds.push({:cloud_id => 3, :name => "AWS US-West", :region => "us-west-1"})
+rs_clouds.push({:cloud_id => 4, :name => "AWS AP-Singapore", :region => "ap-southeast-1"})
+rs_clouds.push({:cloud_id => 5, :name => "AWS AP-Tokyo", :region => "ap-northeast-1"})
+rs_clouds.push({:cloud_id => 6, :name => "AWS AP-Oregon", :region => "us-west-2"})
+rs_clouds.push({:cloud_id => 7, :name => "AWS SA-Sao Paulo", :region => "sa-east-1"})
+
+require 'rest_connection'
+
+ebs_volumes = Array.new
+
+if cloud_id
+  ebs_volumes += Ec2EbsVolume.find_by_cloud_id(cloud_id)
+else
+  rs_clouds.each { |cloud|
+    puts "Fetching from #{cloud[:name]} (#{cloud[:region]})."
+    ebs_volumes += Ec2EbsVolume.find_by_cloud_id(cloud[:cloud_id])
+  }
+end
 
 if json
+  require 'json'
   puts ebs_volumes.to_json
 elsif xml
+  require 'active_support'  #for to_xml()
   puts JSON.parse(ebs_volumes.to_json).to_xml(:root => 'ec2-ebs-volumes', :skip_instruct => true)
 else
   puts ebs_volumes.to_yaml

data/bin/rs-describe-key

@@ -0,0 +1,49 @@
+#!/usr/bin/ruby
+
+# rs-describe-key
+
+puts 'This operation is not currently permitted with the RightScale API (will return HTTP code: 401: Permission denied).'
+exit 1
+
+require 'rubygems'
+require 'getoptlong'
+
+def usage
+  puts("#{$0} --id <ec2_ssh_key_id> [--xml] [--json]")
+	exit
+end
+
+opts = GetoptLong.new(
+  [ '--id', '-i', GetoptLong::REQUIRED_ARGUMENT ],
+  [ '--xml', '-x', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--json', '-j', GetoptLong::OPTIONAL_ARGUMENT ]
+)
+
+key_id = nil
+json = false
+xml = false
+
+opts.each do |opt, arg|
+  case opt
+    when '--id'
+      key_id = arg
+    when '--json'
+      json = true
+    when '--xml'
+      xml = true
+  	end
+end
+
+require 'json'
+require 'rest_connection'
+
+key = Ec2SshKey.find(key_id)
+
+if json
+  puts key.to_json
+elsif xml
+  require 'xmlsimple'
+  puts JSON.parse(key.to_json).to_xml(:root => 'ec2_ssh_key', :skip_instruct => true)
+else
+  puts key.to_yaml
+end

data/bin/rs-describe-server

@@ -4,13 +4,9 @@
 
 require 'rubygems'
 require 'getoptlong'
-require 'json'
-require 'rest_connection'
-require 'active_support'  #for to_xml()
-require 'xmlsimple'
 
 def usage
-  puts("usage:  rs-describe-server --settings [current] [--nickname <server_nickname> | --id <server_id>]")
+  puts("usage:  rs-describe-server --settings [current] [--name <server_nickname> | --id <server_id>]")
   puts("           [[--verbose]]")
 end
 
@@ -21,15 +17,15 @@ end
 def help
   usage
   puts ''
-  puts 'Reboots a RightScale server.'
+  puts 'Describes a RightScale server.'
   puts ''
-  puts "examples:  rs-reboot-server --name 'Sandbox'"
+  puts "examples:  rs-describe-server --id 836587 --settings current"
   puts ''
   exit
 end
 
 opts = GetoptLong.new(
-  [ '--nickname', '-n', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--name', '-n', GetoptLong::OPTIONAL_ARGUMENT ],
   [ '--settings', '-s', GetoptLong::OPTIONAL_ARGUMENT ],
   [ '--id', '-i', GetoptLong::OPTIONAL_ARGUMENT ],
   [ '--xml', '-x', GetoptLong::OPTIONAL_ARGUMENT ],
@@ -42,10 +38,11 @@ settings = false
 json = false
 xml = false
 verbose = false
+server = false
 
 opts.each do |opt, arg|
   case opt
-    when '--nickname'
+    when '--name'
       server_name = arg
     when '--settings'
       settings = arg
@@ -63,35 +60,42 @@ end
 
 usage_exit if !(server_name || server_id)
 
+require 'json'
+require 'rest_connection'
+
 # get server
 if server_name
   puts "Finding server: '%#{server_name}%'"
   server = Server.find(:first) { |s| s.nickname =~ /#{server_name}/ }
-  #puts "Found server, '#{server.nickname}'."
 elsif server_id
   server = Server.find(server_id.to_i)
 else
   usage_exit
 end
 
+if server
+  puts "Found server, '#{server.nickname}'."
+else
+  puts "No server found!"
+end
+
 if settings
-    if settings == 'next'
-      server_settings = server.settings
-    elsif settings == 'current'
-      server.reload_current
-      server_settings = server.settings
-    end
-    output = server_settings
+  if settings == 'next'
+    server_settings = server.settings
+  elsif settings == 'current'
+    server.reload_current
+    server_settings = server.settings
+  end
+  api_result = server_settings
 else
-  output = server
+  api_result = server
 end
 
 if json
-  puts output.to_json
+  puts api_result.to_json
 elsif xml
-  puts JSON.parse(output.to_json).to_xml(:root => 'servers', :skip_instruct => true)
+  require 'xmlsimple'
+  puts JSON.parse(api_result.to_json).to_xml(:root => 'servers', :skip_instruct => true)
 else
-  puts output.to_yaml
-end
-
-
+  puts api_result.to_yaml
+end

data/bin/rs-describe-servers

@@ -1,13 +1,13 @@
 #!/usr/bin/ruby
 
-# rs-describe-servers
+# rs-describe-servers [--filter <filter>]
+
+# e.g. rs-describe-servers
+#      rs-describe-servers --filter "ip_address=44.1.2.3"    # server-side filter
+#      rs-describe-servers --filter "state=operational"         # client-side filter
 
 require 'rubygems'
 require 'getoptlong'
-require 'json'
-require 'rest_connection'
-require 'active_support'  #for to_xml()
-require 'xmlsimple'
 
 def usage
   puts("#{$0} [--xml] [--json]")
@@ -15,28 +15,81 @@ def usage
 end
 
 opts = GetoptLong.new(
+  [ '--filter', '-f', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--current', '-c', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--field', '-F', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--raw', '-r', GetoptLong::OPTIONAL_ARGUMENT ],
   [ '--xml', '-x', GetoptLong::OPTIONAL_ARGUMENT ],
   [ '--json', '-j', GetoptLong::OPTIONAL_ARGUMENT ]
 )
 
+filter = false
 json = false
 xml = false
+raw = false
+field = false
 
 opts.each do |opt, arg|
   case opt
+    when '--filter'
+      filter = arg.split('=')
     when '--json'
       json = true
     when '--xml'
       xml = true
-  	end
+    when '--raw'
+      raw = true
+    when '--field'
+      field = arg
+  end
 end
 
-servers = Server.find_all()
+filters = [ 'aws_id', 'created_at', 'deployment_href', 'ip_address', 'nickname', 'private_ip_address', 'updated_at' ]  
+
+require 'rest_connection'
+require 'json'
+  
+if filter
+  if filters.include? filter[0]
+    # server-side filter
+    servers = Server.find_with_filter(filter[0] => filter[1])
+  else
+    # client-side filter
+    servers = Server.find(:all) {|server| server.params[filter[0]] == filter[1]}
+  end
+else
+  servers = Server.find_all()
+end
 
 if json
-  puts servers.to_json
+  servers_formatted = Array.new
+  servers.each do |server|
+    servers_formatted.push(server.params)
+  end
+  puts JSON.pretty_generate(servers_formatted)
 elsif xml
-  puts JSON.parse(servers.to_json).to_xml(:root => 'servers', :skip_instruct => true)
+  require "active_support/core_ext"
+  puts "<servers>"
+  servers.each do |server|
+    puts JSON.parse(server.params.to_json).to_xml(:root => 'server', :skip_instruct => true)
+  end
+  puts "</servers>"
+elsif raw
+  servers.each do |server|
+    #print server.state
+    if server.state == ('operational'||'stranded'||'booting'||'decommissioning')
+      #puts server.state
+      server.reload_as_current
+      #puts server.settings.to_yaml
+      #server.reload_as_current
+      #puts server.to_yaml
+      if field
+        puts server.settings[field]
+      else
+        puts server
+      end
+    end
+  end
 else
-  puts servers.to_yaml
+  puts servers.to_yaml      # output yaml by default for readability
 end

data/bin/rs-fetch-executables

@@ -0,0 +1,115 @@
+#!/usr/bin/ruby
+
+# rs-fetch-rightscripts
+
+require 'rubygems'
+require 'getoptlong'
+
+def usage
+	puts("rs-fetch-rightscripts [ --id <server_template_id> | --name <server_template_name>] [ OPTIONS ]")
+	puts("e.g. rs-fetch-rightscripts --name 'RightScale Linux Server RL 5.8' -v --xml")
+	exit
+end
+
+opts = GetoptLong.new(
+  [ '--id', '-i', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--name', '-n', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--verbose', '-v', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--json', '-j', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--xml', '-x', GetoptLong::OPTIONAL_ARGUMENT ]
+)
+
+name = false
+id = false
+show_help = false
+verbose = false
+xml = false
+json = false
+server_template = false
+
+opts.each do |opt, arg|
+  case opt
+  when '--name'
+    name = arg
+  when '--id'
+	  id = arg
+  when '--verbose'
+    verbose = true
+  when '--json'
+    json = true
+    require 'json'
+  when '--xml'
+    xml = true
+    require 'xmlsimple'
+  end
+end
+
+usage if !(name || id)
+
+def sanitize_filename(filename)
+  filename.strip do |name|
+   # NOTE: File.basename doesn't work right with Windows paths on Unix
+   # get only the filename, not the whole path
+   name.gsub! /^.*(\\|\/)/, ''
+
+   # Finally, replace all non alphanumeric, underscore 
+   # or periods with underscore
+   # name.gsub! /[^\w\.\-]/, '_'
+   # Basically strip out the non-ascii alphabets too 
+   # and replace with x. 
+   # You don't want all _ :)
+   name.gsub!(/[^0-9A-Za-z.\-]/, 'x')
+  end
+end
+
+require 'rest_connection'
+
+# get servertemplate
+if name
+  puts "Finding ServerTemplate: '%#{name}%'." if verbose
+  server_template = ServerTemplate.find(:first) { |s| s.nickname =~ /#{name}/ }
+elsif id
+  puts "Fetching ServerTemplate, ID: #{id}." if verbose
+  server_template = ServerTemplate.find(id.to_i)
+end
+
+if server_template
+  puts "Located ServerTemplate, '#{server_template.nickname}'." if verbose
+  puts server_template.to_yaml if verbose
+else
+  puts "No ServerTemplate found."
+  exit 1
+end
+
+# get executables (RightScripts or Chef recipes) of the ServerTemplate
+executables = server_template.fetch_executables
+
+if json
+  # TODO: proper processing
+  executables.each do |exec|
+    puts exec.to_s.to_json
+  end
+elsif xml
+  require 'cgi'
+  puts "<executables>"
+  executables.each do |exec|
+    puts " <executable>"
+    puts "  <position>#{exec.position}</position>"
+    puts "  <name>#{exec.name}</name>"
+    puts "  <recipe>#{! exec.recipe.to_s.empty? ? exec.recipe : 'n/a'}</recipe>"
+    puts "  <href>#{exec.href}</href>"
+    puts "  <phase>#{exec.apply}</phase>"
+    if exec.right_script?
+      puts "  <description>#{exec.right_script.description}</description>"
+      puts "  <created_at>#{exec.right_script.created_at}</created_at>"
+      puts "  <updated_at>#{exec.right_script.updated_at}</updated_at>"
+      puts "  <version>#{exec.right_script.version == 0 ? 'HEAD' : exec.right_script.version}</version>"
+      puts "  <filename>#{sanitize_filename(exec.name).gsub(' ', '_')}</filename>"
+      puts "  <script>#{CGI.escapeHTML(exec.right_script['script'])}</script>"
+    end
+    puts " </executable>"
+  end
+  puts "</executables>"
+else
+  puts executables.to_yaml
+end

data/bin/rs-fetch-rightscripts

@@ -1,126 +1,3 @@
-#!/usr/bin/ruby
+#!/bin/sh
 
-# rs-fetch-rightscripts
-
-require 'rubygems'
-require 'getoptlong'
-require 'json'
-require 'rest_connection'
-require 'activesupport'  #for to_xml()
-require 'xmlsimple'
-
-def usage
-	puts("rs-fetch-rightscripts [ --id <server_template_id> | --name <server_template_name>] [ OPTIONS ]")
-	puts("e.g. rs-fetch-rightscripts --name 'RightScale Linux Server RL 5.7 -v --xml'")
-	exit
-end
-
-opts = GetoptLong.new(
-  [ '--id', '-i', GetoptLong::OPTIONAL_ARGUMENT ],
-  [ '--name', '-n', GetoptLong::OPTIONAL_ARGUMENT ],
-  [ '--verbose', '-v', GetoptLong::OPTIONAL_ARGUMENT ],
-  [ '--json', '-j', GetoptLong::OPTIONAL_ARGUMENT ],
-  [ '--xml', '-x', GetoptLong::OPTIONAL_ARGUMENT ],
-)
-
-name = false
-id = false
-show_help = false
-verbose = false
-xml = false
-json = false
-
-opts.each do |opt, arg|
-  case opt
-  when '--name'
-    name = arg
-  when '--id'
-	  id = arg
-  when '--verbose'
-    verbose = true
-  when '--json'
-    json = true
-  when '--xml'
-    xml = true
-  end
-end
-
-usage if !(name || id)
-
-def sanitize_filename(filename)
-  filename.strip do |name|
-   # NOTE: File.basename doesn't work right with Windows paths on Unix
-   # get only the filename, not the whole path
-   name.gsub! /^.*(\\|\/)/, ''
-
-   # Finally, replace all non alphanumeric, underscore 
-   # or periods with underscore
-   # name.gsub! /[^\w\.\-]/, '_'
-   # Basically strip out the non-ascii alphabets too 
-   # and replace with x. 
-   # You don't want all _ :)
-   name.gsub!(/[^0-9A-Za-z.\-]/, 'x')
-  end
-end
-
-# Awesome truncate
-# First regex truncates to the length, plus the rest of that word, if any.
-# Second regex removes any trailing whitespace or punctuation (except ;).
-# Unlike the regular truncate method, this avoids the problem with cutting
-# in the middle of an entity ex.: truncate("this &amp; that",9)  => "this &am..."
-# though it will not be the exact length.
-def awesome_truncate(text, length = 30, truncate_string = "...")
-  return if text.nil?
-  l = length - truncate_string.mb_chars.length
-  text.mb_chars.length > length ? text[/\A.{#{l}}\w*\;?/m][/.*[\w\;]/m] + truncate_string : text
-end
-
-server_template = false
-
-# get servertemplate
-if name
-  puts "Finding ServerTemplate: '%#{name}%'." unless ! verbose
-  server_template = ServerTemplate.find(:first) { |s| s.nickname =~ /#{name}/ }
-elsif id
-  puts "Fetching ServerTemplate; ID: #{id}." unless ! verbose
-  server_template = ServerTemplate.find(id.to_i)
-end
-
-if server_template
-  puts "Located ServerTemplate, '#{server_template.nickname}'." unless ! verbose
-  puts server_template.to_yaml unless ! verbose
-else
-  puts "No ServerTemplate found."
-  exit 1
-end
-
-# get executables (RightScripts) of template
-executables = server_template.fetch_executables
-
-if json
-  puts executables.to_json
-elsif xml
-  #puts JSON.parse(executables.to_json).to_xml(:root => 'right_scripts', :skip_instruct => true)
-  executables.each do |exec|
-    puts "<right_script>"
-    puts " <position>#{exec.position}</position>"
-    puts " <name>#{exec.name}</name>"
-    puts " <recipe>#{! exec.recipe.to_s.empty? ? exec.recipe : 'n/a'}</recipe>"
-    puts " <href>#{exec.href}</href>"
-    puts " <description>#{exec.right_script.description}</description>"
-    puts " <created_at>#{exec.right_script.created_at}</created_at>"
-    puts " <updated_at>#{exec.right_script.updated_at}</updated_at>"
-    puts " <version>#{exec.right_script.version == 0 ? 'HEAD' : exec.right_script.version}</version>"
-    puts " <phase>#{exec.apply}</phase>"
-    puts " <filename>#{sanitize_filename(exec.name).gsub(' ', '_')}</filename>"
-    puts " <script>#{awesome_truncate(exec.right_script.script)}</script>"
-    puts "</right_script>"
-  end
-#  puts "--- #{exec.position}  #{! exec.recipe.to_s.empty? ? exec.recipe : '*'} #{exec.name} #{exec.right_script.version == 0 ? 'HEAD' : 'rev'+exec.right_script.version.to_s} #{exec.description} #{exec.href} #{exec.right_script.created_at} #{exec.right_script.updated_at} #{exec.apply}"
-#  puts "- #{sanitize_filename(exec.name)}: "
-#  puts "#{awesome_truncate(exec.right_script.script)}"
-#  puts '---'
-#  puts
-else
-  puts executables.to_yaml
-end
+rs-fetch-executables "$@"

data/bin/rs-lock-server

@@ -0,0 +1,77 @@
+#!/usr/bin/ruby
+
+# rs-lock-server
+
+require 'rubygems'
+require 'getoptlong'
+
+def usage
+  puts("usage:  rs-lock-server [--name <server_name> | --id <server_id>]")
+  puts("           [[--verbose]]")
+end
+
+def usage_exit
+  usage; exit
+end
+
+def help
+  usage
+  puts ''
+  puts 'Locks a RightScale server.'
+  puts ''
+  puts "examples:  rs-lock-server --name 'Back to earth'"
+  puts ''
+  exit
+end
+
+opts = GetoptLong.new(
+  [ '--name', '-n', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--id', '-i', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--xml', '-x', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--json', '-j', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--help', '-h', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--verbose', '-v', GetoptLong::OPTIONAL_ARGUMENT ]
+)
+
+server_name = false
+server_id = false
+show_help = false
+verbose = false
+
+opts.each do |opt, arg|
+  case opt
+    when '--name'
+      server_name = arg
+    when '--id'
+      server_id = arg
+    when '--help'
+      show_help = true
+	  when '--verbose'
+      verbose = true
+  end
+end
+
+help if show_help
+
+require 'json'
+require 'rest_connection'
+
+usage_exit if !(server_name || server_id)
+
+# get server
+if server_name
+  puts "Finding server: '%#{server_name}%'"
+  server = Server.find(:first) { |s| s.nickname =~ /#{server_name}/ }
+  puts "Found server, '#{server.nickname}'."
+  puts server.to_yaml if verbose
+elsif server_id
+  server = Server.find(server_id.to_i)
+else
+  usage_exit
+end
+
+# lock server
+puts "Locking server, '#{server.nickname}'."
+server.reload_as_current
+server.settings["locked"] = 'true'
+server.save

data/bin/rs-query-cloud

@@ -0,0 +1,27 @@
+#!/usr/bin/ruby
+
+# rs-query-cloud
+
+require 'rubygems'
+require 'getoptlong'
+require 'json'
+require 'rest_connection'
+
+def usage
+  puts("#{$0} [--cloud]")
+	exit
+end
+
+opts = GetoptLong.new(
+  [ '--cloud', '-c', GetoptLong::REQUIRED_ARGUMENT ]
+)
+
+cloud_id = false
+
+opts.each do |opt, arg|
+  case opt
+    when '--cloud'
+      cloud_id = arg
+  	end
+end
+

data/bin/rs-run-recipe

@@ -0,0 +1,80 @@
+#!/usr/bin/ruby
+
+# rs-run-recipe
+
+require 'rubygems'
+require 'getoptlong'
+
+def usage
+  puts("usage:  rs-run-recipe [--name <recipe_name>]")
+  puts("           [--server-name <server_name> | --server-id <server_id>]")
+end
+
+def usage_exit
+  usage; exit
+end
+
+def help
+  usage
+  puts ''
+  puts 'Run a Chef recipe on a RightScale server.'
+  puts ''
+  puts "examples:  rs-run-recipe --name 'helloworld::goodbye_world' --server 'Messy Sandbox'"
+  puts ''
+  exit
+end
+
+opts = GetoptLong.new(
+  [ '--name', '-n', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--server-name', '-s', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--server-id', '-S', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--xml', '-x', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--json', '-j', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--help', '-h', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--verbose', '-v', GetoptLong::OPTIONAL_ARGUMENT ]
+)
+
+recipe_name = false
+server_name = false
+server_id = false
+show_help = false
+verbose = false
+
+opts.each do |opt, arg|
+  case opt
+    when '--name'
+      recipe_name = arg
+    when '--server-name'
+      server_name = arg
+    when '--server-id'
+      server_id = arg
+    when '--help'
+      show_help = true
+	  when '--verbose'
+      verbose = true
+  end
+end
+
+help if show_help
+
+require 'json'
+require 'rest_connection'
+
+usage_exit if !(recipe_name)
+
+# get server
+if server_name
+  puts "Finding server: '%#{server_name}%'"
+  server = Server.find(:first) { |s| s.nickname =~ /#{server_name}/ }
+  puts "Found server, '#{server.nickname}'."
+  puts server.to_yaml if verbose
+elsif server_id
+  server = Server.find(server_id.to_i)
+else
+  usage_exit
+end
+
+puts "Running Chef Recipe, '#{recipe_name}' on server, '#{server.nickname}'."
+recipe_executable = Executable.new(recipe_name)
+state = server.run_executable(recipe_executable)
+state.wait_for_completed

data/bin/rs-search-tags

@@ -16,9 +16,12 @@ end
 def help
   usage
   puts ''
-  puts 'Searches for machine tags.'
+  puts 'Searches for resources with a specific RightScale tag.'
   puts ''
   puts "examples:  rs-search-tags --resource Ec2Instance \"foo:bar=foobar\""
+  puts "               - Searches for all EC2 instances with the tag, \"foo:bar=foobar\""
+  puts "           rs-search-tags --resource Server \"rs_agent_dev:log_level=DEBUG\""
+  puts "               - Searches for all Servers (next instance) with the tag, \"rs_agent_dev:log_level=DEBUG\""
   puts ''
   exit
 end
@@ -32,6 +35,7 @@ opts = GetoptLong.new(
   [ '--resource', '-r', GetoptLong::REQUIRED_ARGUMENT ],
   [ '--xml', '-x', GetoptLong::OPTIONAL_ARGUMENT ],
   [ '--json', '-j', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--help', '-h', GetoptLong::OPTIONAL_ARGUMENT ],
   [ '--verbose', '-v', GetoptLong::OPTIONAL_ARGUMENT ]
 )
 
@@ -45,6 +49,8 @@ opts.each do |opt, arg|
       xml = true
     when '--verbose'
       verbose = true
+    when '--help'
+      help; exit
   	end
 end
 
@@ -56,13 +62,14 @@ require 'rest_connection'
 
 tags_search = Array.new
 tags_search.push(tag)
-#puts Gem.datadir('rest_connection')
 
 servers = Tag.search(resource, ["#{tag}"])
 
 if json
   puts servers.to_json
 elsif xml
+  require 'active_support'
+  #require 'active_support/core_ext'
   puts JSON.parse(servers.to_json).to_xml(:root => 'servers', :skip_instruct => true)
 else
   puts servers.to_yaml

data/bin/rs-tag-array

@@ -0,0 +1,39 @@
+#!/usr/bin/ruby
+
+# rs-tag-array
+
+require 'rubygems'
+require 'getoptlong'
+
+def usage
+  puts("#{$0} --id <server_array_id> --tag <tag_foo>")
+	exit
+end
+
+# taggable resources
+# 'Server', 'Ec2EbsSnapshot', 'Ec2EbsVolume', 'Ec2Image', 'Image', 'ServerArray', 'Ec2Instance', 'Instance', 'Deployment', 'ServerTemplate', 'Ec2ServerTemplate'
+
+opts = GetoptLong.new(
+  [ '--id', '-i', GetoptLong::REQUIRED_ARGUMENT ],
+  [ '--tag', '-t', GetoptLong::REQUIRED_ARGUMENT ],
+)
+
+array_id = false
+tag = false
+
+opts.each do |opt, arg|
+  case opt
+    when '--id'
+      array_id = arg
+    when '--tag'
+      tag = true
+  end
+end
+
+usage unless (array_id and tag)
+
+require 'rest_connection'
+
+server_array = Ec2ServerArray.find('server_arrays/'+array_id)
+
+Tag.set(server_array.href, tag)

data/bin/rs-terminate-self

@@ -62,9 +62,5 @@ if server
 	server.terminate
 else
 	array_instance = Server.find_with_filter('aws_id' => "#{instance_id}")[0]
-end
-
-
-
-Tag.search('Ec2Instance', "server:private_ip_0=10.128.74.253")
-
+	array_instance.terminate
+end

data/bin/rs-unlock-server

@@ -0,0 +1,77 @@
+#!/usr/bin/ruby
+
+# rs-unlock-server
+
+require 'rubygems'
+require 'getoptlong'
+
+def usage
+  puts("usage:  rs-unlock-server [--name <server_name> | --id <server_id>]")
+  puts("           [[--verbose]]")
+end
+
+def usage_exit
+  usage; exit
+end
+
+def help
+  usage
+  puts ''
+  puts 'Unlocks a RightScale server.'
+  puts ''
+  puts "examples:  rs-unlock-server --name 'Back to earth'"
+  puts ''
+  exit
+end
+
+opts = GetoptLong.new(
+  [ '--name', '-n', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--id', '-i', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--xml', '-x', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--json', '-j', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--help', '-h', GetoptLong::OPTIONAL_ARGUMENT ],
+  [ '--verbose', '-v', GetoptLong::OPTIONAL_ARGUMENT ]
+)
+
+server_name = false
+server_id = false
+show_help = false
+verbose = false
+
+opts.each do |opt, arg|
+  case opt
+    when '--name'
+      server_name = arg
+    when '--id'
+      server_id = arg
+    when '--help'
+      show_help = true
+	  when '--verbose'
+      verbose = true
+  end
+end
+
+help if show_help
+
+require 'json'
+require 'rest_connection'
+
+usage_exit if !(server_name || server_id)
+
+# get server
+if server_name
+  puts "Finding server: '%#{server_name}%'"
+  server = Server.find(:first) { |s| s.nickname =~ /#{server_name}/ }
+  puts "Found server, '#{server.nickname}'."
+  puts server.to_yaml if verbose
+elsif server_id
+  server = Server.find(server_id.to_i)
+else
+  usage_exit
+end
+
+# unlock server
+puts "Unlocking server, '#{server.nickname}'."
+#server.reload_as_current
+server.settings["locked"] = 'false'
+server.save

data/bin/rs-update-server-array

@@ -45,7 +45,7 @@ if nickname
   server_array = Ec2ServerArray.find(:first) { |s| s.nickname =~ /#{nickname}/ }
   puts server.to_yaml if verbose
 elsif id
-  server = Server.find(server_id.to_i)
+  server = Ec2ServerArray.find(server_id.to_i)
 end
 puts "Found server array, '#{server_array.nickname}'."
 

metadata

@@ -1,13 +1,12 @@
 --- !ruby/object:Gem::Specification 
 name: rs-api-tools
 version: !ruby/object:Gem::Version 
-  hash: 29
-  prerelease: 
+  prerelease: false
   segments: 
   - 0
   - 0
-  - 1
-  version: 0.0.1
+  - 2
+  version: 0.0.2
 platform: ruby
 authors: 
 - Chris Fordham
@@ -15,17 +14,16 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-06-06 00:00:00 Z
+date: 2013-06-12 00:00:00 -07:00
+default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: json
   prerelease: false
   requirement: &id001 !ruby/object:Gem::Requirement 
-    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        hash: 15
         segments: 
         - 1
         - 4
@@ -33,7 +31,6 @@ dependencies:
         version: 1.4.4
     - - <=
       - !ruby/object:Gem::Version 
-        hash: 13
         segments: 
         - 1
         - 6
@@ -45,11 +42,9 @@ dependencies:
   name: rest_connection
   prerelease: false
   requirement: &id002 !ruby/object:Gem::Requirement 
-    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        hash: 3
         segments: 
         - 0
         version: "0"
@@ -58,10 +53,10 @@ dependencies:
 description: RightScale API Command Line Tools.
 email: chris@xhost.com.au
 executables: 
-- .DS_Store
 - rs-clone-deployment
 - rs-clone-rightscript
 - rs-clone-server
+- rs-create-alert-spec
 - rs-describe-alerts
 - rs-describe-attached-vols
 - rs-describe-deployment
@@ -69,6 +64,7 @@ executables:
 - rs-describe-ec2-ebs-snapshots
 - rs-describe-ec2-ebs-volumes
 - rs-describe-ec2-security-groups
+- rs-describe-key
 - rs-describe-keys
 - rs-describe-multi-cloud-images
 - rs-describe-rightscript
@@ -79,6 +75,7 @@ executables:
 - rs-describe-server-self
 - rs-describe-server-templates
 - rs-describe-servers
+- rs-fetch-executables
 - rs-fetch-rightscripts
 - rs-get-array-instances
 - rs-get-server-input
@@ -86,22 +83,27 @@ executables:
 - rs-get-server-sketchy-data
 - rs-launch-deployment
 - rs-launch-server
+- rs-lock-server
 - rs-ping-active-servers
+- rs-query-cloud
 - rs-reboot-deployment
 - rs-reboot-server
 - rs-relaunch-deployment
 - rs-relaunch-server
 - rs-run-all-boot-executables
+- rs-run-recipe
 - rs-run-rightscript
 - rs-search-tags
 - rs-start-deployment
 - rs-start-server
 - rs-stop-deployment
 - rs-stop-server
+- rs-tag-array
 - rs-terminate-all
 - rs-terminate-deployment
 - rs-terminate-self
 - rs-terminate-server
+- rs-unlock-server
 - rs-update-input
 - rs-update-inputs
 - rs-update-server-array
@@ -109,54 +111,9 @@ extensions: []
 
 extra_rdoc_files: []
 
-files: 
-- bin/.DS_Store
-- bin/rs-clone-deployment
-- bin/rs-clone-rightscript
-- bin/rs-clone-server
-- bin/rs-describe-alerts
-- bin/rs-describe-attached-vols
-- bin/rs-describe-deployment
-- bin/rs-describe-deployments
-- bin/rs-describe-ec2-ebs-snapshots
-- bin/rs-describe-ec2-ebs-volumes
-- bin/rs-describe-ec2-security-groups
-- bin/rs-describe-keys
-- bin/rs-describe-multi-cloud-images
-- bin/rs-describe-rightscript
-- bin/rs-describe-rightscripts
-- bin/rs-describe-server
-- bin/rs-describe-server-array
-- bin/rs-describe-server-arrays
-- bin/rs-describe-server-self
-- bin/rs-describe-server-templates
-- bin/rs-describe-servers
-- bin/rs-fetch-rightscripts
-- bin/rs-get-array-instances
-- bin/rs-get-server-input
-- bin/rs-get-server-monitoring
-- bin/rs-get-server-sketchy-data
-- bin/rs-launch-deployment
-- bin/rs-launch-server
-- bin/rs-ping-active-servers
-- bin/rs-reboot-deployment
-- bin/rs-reboot-server
-- bin/rs-relaunch-deployment
-- bin/rs-relaunch-server
-- bin/rs-run-all-boot-executables
-- bin/rs-run-rightscript
-- bin/rs-search-tags
-- bin/rs-start-deployment
-- bin/rs-start-server
-- bin/rs-stop-deployment
-- bin/rs-stop-server
-- bin/rs-terminate-all
-- bin/rs-terminate-deployment
-- bin/rs-terminate-self
-- bin/rs-terminate-server
-- bin/rs-update-input
-- bin/rs-update-inputs
-- bin/rs-update-server-array
+files: []
+
+has_rdoc: true
 homepage: https://github.com/flaccid/rs-api-tools
 licenses: []
 
@@ -166,27 +123,23 @@ rdoc_options: []
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
-  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3
       segments: 
       - 0
       version: "0"
 required_rubygems_version: !ruby/object:Gem::Requirement 
-  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3
       segments: 
       - 0
       version: "0"
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.8.10
+rubygems_version: 1.3.6
 signing_key: 
 specification_version: 3
 summary: rs-api-tools