rest_connection 0.0.9 → 0.0.10

data/.gitignore

@@ -1,2 +1,3 @@
 *.swp
 *.swo
+pkg/*

data/README.rdoc

@@ -0,0 +1,49 @@
+= rest_connection Quick Start
+== Install
+==== Installing with rubygems
+  "gem install rest_connection"
+
+==== Installing from source
+  "git clone http://github.com/jeremyd/rest_connection.git"
+  "gem install jeweler rspec"
+  "rake check_dependencies" <- Install any gems listed.
+  "rake install"
+
+== Configuration
+
+You must setup ~/.rest_connection/rest_api_config.yaml or /etc/rest_connection/rest_api_config.yaml
+
+Copy the example from GEMHOME/rest_connection/examples/rest_api_config.yaml.sample and fill in your connection info.
+
+  Pro Tip: to find a GEMHOME, use gemedit
+  "gem install gemedit"
+  "gem edit rest_connection"
+
+== Usage: some IRB samples
+
+  $ irb
+  ruby> require 'rubygems'; require 'rest_connection'
+
+=== Lookup and run a RightScript
+
+  first_fe = Server.find(:first) { |s| s.nickname =~ /Front End/ }
+  st = ServerTemplate.find(first_fe.server_template_href)
+  connect_script = st.executables.detect { |ex| ex.name =~  /LB [app|mongrels]+ to HA proxy connect/i }
+  state = first_fe.run_executable(connect_script)
+  state.wait_for_completed
+
+=== Stop a Deployment
+
+  deployment = Deployment.find(opts[:id])
+  my_servers = deployment.servers
+  my_servers.each { |s| s.stop }
+  my_servers.each { |s| s.wait_for_state("stopped") }
+
+=== Activate an Ec2ServerArray / Display instances IPs
+  
+  my_array = Ec2ServerArray.find(opts[:href])  
+  my_array.active = true
+  my_array.save
+
+  puts my_array.instances.map { |i| i['ip-address'] }
+

data/VERSION

@@ -1 +1 @@
-0.0.9
+0.0.10

data/examples/relaunch_deployment.rb

@@ -1,4 +1,4 @@
-#!/usr/bin/ruby
+#!/usr/bin/env ruby
 require 'rubygems'
 require 'trollop'
 require 'rest_connection'

data/lib/rest_connection/rightscale/alert_spec.rb

@@ -0,0 +1,27 @@
+#    This file is part of RestConnection 
+#
+#    RestConnection is free software: you can redistribute it and/or modify
+#    it under the terms of the GNU General Public License as published by
+#    the Free Software Foundation, either version 3 of the License, or
+#    (at your option) any later version.
+#
+#    RestConnection is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#    GNU General Public License for more details.
+#
+#    You should have received a copy of the GNU General Public License
+#    along with RestConnection.  If not, see <http://www.gnu.org/licenses/>.
+#
+class AlertSpec
+  include RightScale::Api::Base
+  extend RightScale::Api::BaseExtend
+
+
+
+  def attach(params)
+    connection.post('alert_spec_subjects.js' , :alert_spec_subject => params)
+  end
+
+
+end 

data/lib/rest_connection/rightscale/audit_entry.rb

@@ -28,16 +28,18 @@ class AuditEntry
   include  RightScale::Api::Base
   extend RightScale::Api::BaseExtend
 
-  def wait_for_state(state)
-    while(1)
+  def wait_for_state(state, timeout=900)
+    while(timeout > 0)
       reload
       connection.logger("state is #{self.state}, waiting for #{state}")
       friendly_url = "https://my.rightscale.com/audit_entries/"
       friendly_url += self.href.split(/\//).last
       raise "FATAL error, #{self.summary}\nSee Audit: API:#{self.href}, WWW:<a href='#{friendly_url}'>#{friendly_url}</a>\n" if self.state == 'failed'
-      sleep 5
+      sleep 30
+      timeout -= 30
       return true if state == self.state
     end
+    raise "FATAL: Timeout waiting for Executable to complete.  State was #{self.state}" if timeout <= 0
   end
 
   def wait_for_completed(legacy=nil)

data/lib/rest_connection/rightscale/ec2_ebs_volume.rb

@@ -17,4 +17,8 @@
 class Ec2EbsVolume
   include  RightScale::Api::Base
   extend RightScale::Api::BaseExtend
+
+  def attach(params)
+    connection.post('component_ec2_ebs_volumes.js' , :component_ec2_ebs_volume => params)
+  end
 end

data/lib/rest_connection/rightscale/ec2_server_array.rb

@@ -13,16 +13,13 @@
 #    You should have received a copy of the GNU General Public License
 #    along with RestConnection.  If not, see <http://www.gnu.org/licenses/>.
 
-# Example:
-# a = Ec2ServerArray.new(:href => "https://validhref")
-# st = ServerTemplate.new(:href => "https://validhref")
-# st.executables.find(:nickname
-# a.run_script_on_all(
-
 class Ec2ServerArray 
   include RightScale::Api::Base
   extend RightScale::Api::BaseExtend
 
+#  Example:
+#    right_script = @server_template.executables.first
+#    result = @my_array.run_script_on_all(right_script, [@server_template.href])
   def run_script_on_all(script, server_template_hrefs, inputs=nil)
      serv_href = URI.parse(self.href)
      options = Hash.new

data/lib/rest_connection/rightscale/rightscale_api_resources.rb

@@ -29,6 +29,7 @@ require 'rest_connection/rightscale/multi_cloud_image'
 require 'rest_connection/rightscale/tag'
 require 'rest_connection/rightscale/rs_internal'
 require 'rest_connection/rightscale/audit_entry'
+require 'rest_connection/rightscale/alert_spec'
 require 'rest_connection/rightscale/ec2_ebs_volume'
 require 'rest_connection/rightscale/ec2_ebs_snapshot'
 require 'rest_connection/rightscale/server_internal'

data/lib/rest_connection/rightscale/server.rb

@@ -30,27 +30,36 @@ class Server
     newrecord
   end
 
-  def wait_for_state(st)
+  # waits until the specified state is reached for this Server
+  # *st <~String> the name of the state to wait for, eg. "operational"
+  # *timeout <~Integer> optional, how long to wait for the state before declare failure (in seconds).
+  def wait_for_state(st,timeout=1200)
     reload
     connection.logger("#{nickname} is #{self.state}")
-    while(1)
+    while(timeout > 0)
       return true if state == st
       raise "FATAL error, this server is stranded and needs to be #{st}: #{nickname}, see audit: #{self.audit_link}" if state.include?('stranded')
-      sleep 5
+      sleep 30
+      timeout -= 30
       connection.logger("waiting for server #{nickname} to go #{st}, state is #{state}")
       reload
     end
+    raise "FATAL, this server #{self.audit_link} timed out waiting for the state to be #{st}" if timeout <= 0
   end
 
+  # waits until the server is operational and dns_name is available
   def wait_for_operational_with_dns
+    timeout = 600
     wait_for_state("operational")
-    while(1)
-      connection.logger "waiting for dns-name for #{self.nickname}"
-      break if self['dns-name'] && !self['dns-name'].empty?
+    while(timeout > 0)
       self.settings
-      sleep 2
+      break if self['dns-name'] && !self['dns-name'].empty?
+      connection.logger "waiting for dns-name for #{self.nickname}"
+      sleep 30
+      timeout -= 30
     end
     connection.logger "got DNS: #{self['dns-name']}"
+    raise "FATAL, this server #{self.audit_link} timed out waiting for DNS" if timeout <= 0
   end
 
   def audit_link
@@ -89,8 +98,8 @@ class Server
     @server_internal.stop
   end
 
-  # This should be used with v5 images only.
-  # executable to run can be an Executable or RightScript object
+  # Works on v4 and v5 images.
+  # *executable can be an <~Executable> or <~RightScript>
   def run_executable(executable, opts=nil)
     script_options = Hash.new
     script_options[:server] = Hash.new
@@ -141,6 +150,13 @@ class Server
     @params.merge! connection.get(serv_href.path + "/settings")
   end
 
+  def attach_volume(params)
+    hash = {}
+    hash[:server] = params 
+    serv_href = URI.parse(self.href)
+    connection.post(serv_href.path + "/attach_volume", hash)
+  end
+
   def get_sketchy_data
     serv_href = URI.parse(self.href)
     @params.merge! connection.get(serv_href.path + "/get_sketchy_data")
@@ -162,12 +178,6 @@ class Server
     end
   end
 
-  def events
-    my_events = Event.new
-    id = self.href.split(/\//).last
-    my_events.filter_by(:server_id, id)
-  end
-
   def relaunch
     self.stop
     self.wait_for_state("stopped")
@@ -182,31 +192,12 @@ class Server
       old_state = self.state unless old_state
       connection.logger("#{nickname} is #{self.state}")
       return true if self.state != old_state
-      sleep 5
-      timer += 5
+      sleep 30
+      timer += 30
       connection.logger("waiting for server #{nickname} to change from #{old_state} state.")
     end
     raise("FATAL: timeout after #{timeout}s waiting for state change")
   end
 
-#  DOES NOT WORK: fragile web scraping
-#  def relaunch
-#    unless state == "stopped"
-#      wind_monkey
-#      server_id = self.href.split(/\//).last
-#      base_url = URI.parse(self.href)
-#      base_url.path = "/servers/#{server_id}"
-#
-#      s = agent.get(base_url.to_s)
-#      relaunch = s.links.detect {|d| d.to_s == "Relaunch"}
-#      prelaunch_page = agent.get(relaunch.href)
-#      debugger
-#      launch_form = prelaunch_page.forms[2]
-#      launch_form.radiobuttons_with(:name => 'launch_immediately').first.check
-#      agent.submit(launch_form, launch_form.buttons.first)
-#    else
-#      connection.logger("WARNING: detected server is #{self.state}, skipping relaunch")
-#    end
-#  end
 end
 

data/lib/rest_connection/rightscale/status.rb

@@ -20,13 +20,15 @@
 class Status 
   include RightScale::Api::Base
   extend RightScale::Api::BaseExtend
-  def wait_for_completed(audit_link = "no audit link available")
-    while(1)
+  def wait_for_completed(audit_link = "no audit link available", timeout = 900)
+    while(timeout > 0)
       reload
       return true if self.state == "completed"
       raise "FATAL error, script failed\nSee Audit: #{audit_link}" if self.state == 'failed'
-      sleep 5
+      sleep 30
+      timeout -= 30
       connection.logger("querying status of right_script.. got: #{self.state}")
     end
+    raise "FATAL: Timeout waiting for Executable to complete.  State was #{self.state}" if timeout <= 0
   end
 end

data/lib/rest_connection/ssh_hax.rb

@@ -42,7 +42,7 @@ module SshHax
     result = nil
     output = ""
     connection.logger("Running: #{run_this}")
-    Net::SSH.start(host_dns, 'root', :keys => ssh_key_config(ssh_key)) do |ssh|
+    Net::SSH.start(host_dns, 'root', :keys => ssh_key_config(ssh_key), :user_known_hosts_file => "/dev/null") do |ssh|
       cmd_channel = ssh.open_channel do |ch1|
         ch1.on_request('exit-status') do |ch, data|
           status = data.read_long
@@ -152,15 +152,13 @@ module SshHax
     retry_count = 0
     while (!success && retry_count < SSH_RETRY_COUNT) do
     begin
-    Net::SSH.start(host_dns, 'root', :keys => ssh_key_config(ssh_key)) do |ssh|
+    Net::SSH.start(host_dns, 'root', :keys => ssh_key_config(ssh_key), :user_known_hosts_file => "/dev/null") do |ssh|
       cmd_channel = ssh.open_channel do |ch1|
         ch1.on_request('exit-status') do |ch, data|
           status = data.read_long
         end
-        output += "Running: #{command}\n"
         ch1.exec(command) do |ch2, success|
           unless success
-            output = "ERROR: SSH cmd failed to exec"
             status = 1
           end
           ch2.on_data do |ch, data|
@@ -174,10 +172,11 @@ module SshHax
     end
     rescue Exception => e
       retry_count += 1 # opening the ssh channel failed -- try again.
+      connection.logger "ERROR during SSH session to #{host_dns}, retrying #{retry_count}: #{e} #{e.backtrace}"
       sleep 10
     end
     end
-    connection.logger output
+    connection.logger "SSH Run: #{command} on #{host_dns}. Retry was #{retry_count}. Exit status was #{status}. Output below ---\n#{output}\n---"
     return {:status => status, :output => output}
   end 
 

data/rest_connection.gemspec

@@ -5,19 +5,19 @@
 
 Gem::Specification.new do |s|
   s.name = %q{rest_connection}
-  s.version = "0.0.9"
+  s.version = "0.0.10"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Jeremy Deininger"]
-  s.date = %q{2010-06-23}
+  s.date = %q{2010-09-02}
   s.description = %q{provides rest_connection}
   s.email = %q{jeremy@rubyonlinux.org}
   s.extra_rdoc_files = [
-    "README"
+    "README.rdoc"
   ]
   s.files = [
     ".gitignore",
-     "README",
+     "README.rdoc",
      "Rakefile",
      "VERSION",
      "config/rest_api_config.yaml.sample",
@@ -31,6 +31,7 @@ Gem::Specification.new do |s|
      "examples/relaunch_deployment.rb",
      "examples/right_scale_ec2_instances_api_test.rb",
      "lib/rest_connection.rb",
+     "lib/rest_connection/rightscale/alert_spec.rb",
      "lib/rest_connection/rightscale/audit_entry.rb",
      "lib/rest_connection/rightscale/deployment.rb",
      "lib/rest_connection/rightscale/ec2_ebs_snapshot.rb",

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: rest_connection
 version: !ruby/object:Gem::Version 
-  hash: 13
+  hash: 11
   prerelease: false
   segments: 
   - 0
   - 0
-  - 9
-  version: 0.0.9
+  - 10
+  version: 0.0.10
 platform: ruby
 authors: 
 - Jeremy Deininger
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-06-23 00:00:00 -07:00
+date: 2010-09-02 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -67,10 +67,10 @@ executables: []
 extensions: []
 
 extra_rdoc_files: 
-- README
+- README.rdoc
 files: 
 - .gitignore
-- README
+- README.rdoc
 - Rakefile
 - VERSION
 - config/rest_api_config.yaml.sample
@@ -84,6 +84,7 @@ files:
 - examples/relaunch_deployment.rb
 - examples/right_scale_ec2_instances_api_test.rb
 - lib/rest_connection.rb
+- lib/rest_connection/rightscale/alert_spec.rb
 - lib/rest_connection/rightscale/audit_entry.rb
 - lib/rest_connection/rightscale/deployment.rb
 - lib/rest_connection/rightscale/ec2_ebs_snapshot.rb

data/README

@@ -1,7 +0,0 @@
-RestConnection is a library designed to facilitate Restful connections to APIs using Basic auth and more.  However!  If you've done any API work you know that every API is different.  The goal of RestConnection is to be as lean as possible and a EXAMPLE of how to use Net::HTTP in a restful way.  Right now RestConnection uses JSON and Basic Auth, this is easy to change or expand on and it's written to give more control to the user of the library (You).
-
-My hope is to include 'helper resources' for common API endpoints while maintaining a somewhat universal 'Connection' class that can be easily understood and modified to suit any Restful API needs.  These resources will have a similar usage to ActiveResource. 
-
-The first API we will be supporting is the RightScale API.  
-
-I welcome any contributions or suggestions.  Thanks!