Added clone functionality

.gitignore

@@ -1,3 +1,6 @@
 *.swp
 *.swo
 pkg/*
+
+## RubyMine
+.idea

Gemfile

@@ -0,0 +1,3 @@
+source 'http://rubygems.org'
+
+gemspec

LICENSE

@@ -0,0 +1,10 @@
+Copyright (c) 2012 RightScale, Inc, All Rights Reserved Worldwide.
+
+THIS PROGRAM IS CONFIDENTIAL AND PROPRIETARY TO RIGHTSCALE
+AND CONSTITUTES A VALUABLE TRADE SECRET.  Any unauthorized use,
+reproduction, modification, or disclosure of this program is
+strictly prohibited.  Any use of this program by an authorized
+licensee is strictly subject to the terms and conditions,
+including confidentiality obligations, set forth in the applicable
+License Agreement between RightScale, Inc. and
+the licensee.

README.md

@@ -0,0 +1,140 @@
+# RightScale REST Connection
+
+The rest_connection gem is a Ruby library for RightScale's API 0.1, 1.0 and 1.5.
+
+Legacy clusters:
+- API 0.1 AWS clouds
+- API 1.0 AWS clouds
+- API 1.5 non-AWS clouds
+
+Unified clusters:
+- API 1.0 AWS clouds
+- API 1.5 all clouds
+
+This gem also supports RightScale's instance facing API 1.0, which use the instance token to login.
+The instance token is found in the instance's user data as 'RS_rn_auth' or alternatively as part of 'RS_api_url'.
+The user data is available under the 'Info' tab on the server's page in the RightScale Dashboard.
+
+This gem should be considered deprecated!
+
+If you only use API 1.5, you should use the right_api_client gem instead:
+https://rubygems.org/gems/right_api_client
+
+- API 1.0 Documentation: http://support.rightscale.com/12-Guides/03-RightScale_API
+- API 1.0 Reference Docs: http://reference.rightscale.com/api1.0
+- API 1.5 Documentation: http://support.rightscale.com/12-Guides/RightScale_API_1.5
+- API 1.5 Reference Docs: http://reference.rightscale.com/api1.5
+
+Maintained by the RightScale "Yellow_team" 
+
+## Installation
+
+Ruby 1.8.7 or higher is required.
+
+### Installing from RubyGems
+
+    "gem install rest_connection"
+
+### Installing from source
+
+    "git clone [email protected]:rightscale/rest_connection.git"
+    "cd rest_connection"
+    "gem install rconf"
+    "rconf" <- follow any further instructions from rconf
+    "bundle install"
+
+## Versioning
+
+This gem follows semantic versioning: http://semver.org
+
+## Usage Instructions
+
+You must setup '~/.rest_connection/rest_api_config.yaml' or '/etc/rest_connection/rest_api_config.yaml'
+
+Copy the example from '$GEMHOME/rest_connection/config/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"
+
+The following examples assume an interactive ruby session (irb):
+
+    $ bundle exec irb
+    ruby> require 'rubygems'; require 'rest_connection'
+
+### Look up 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'] }
+
+## Design Decisions
+
+Currently, all API resources are represented by classes in 'lib/rest_connection/rightscale'.
+Various helper modules are also located in this directory.
+
+### API 0.1 resources
+
+API 0.1 resources are often named with suffix '_internal'.
+
+They often pull in common internal code:
+
+    include RightScale::Api::Internal
+    extend RightScale::Api::InternalExtend
+
+### API 1.0 resources
+
+API 1.0 resources are often named with prefix 'ec2_' for Amazon Elastic Compute Cloud.
+
+They often pull in common internal code:
+
+    include RightScale::Api::Base
+    extend RightScale::Api::BaseExtend
+
+### API 1.5 resources
+
+API 1.5 resources are often named with prefix 'mc_' for MultiCloud.
+They often talk to the MultiCloud gateway and therefore pull in some common gateway code:
+
+    include RightScale::Api::Gateway
+    extend RightScale::Api::GatewayExtend
+
+## Troubleshooting
+
+### Wrong ruby version
+
+Ruby 1.8.7 or higher is required.
+
+## Publishing
+
+To cut a new gem and push to RubyGems:
+
+Edit lib/rest_connection/version.rb with semantic version number.
+
+    "bundle exec gem build rest_connection.gemspec"
+    "ls *.gem" <- verify that gem was built
+    "cd /tmp"
+    "bundle exec gem install /path/to/local/rest_connection-X.Y.Z.gem" <- replace X.Y.Z with your new version number
+    "bundle exec gem uninstall rest_connection"
+    "cd -"
+    "bundle exec gem push rest_connection-X.Y.Z.gem"
+
+Check it out: https://rubygems.org/gems/rest_connection

Rakefile

@@ -1,15 +1,17 @@
-require 'rubygems'
-require 'jeweler'
-Jeweler::Tasks.new do |gemspec|
-  gemspec.name = "rest_connection"
-  gemspec.summary = "lib for restful connections to the rightscale api"
-  gemspec.description = "provides rest_connection"
-  gemspec.email = "[email protected]"
-  gemspec.homepage = "http://github.com/jeremyd/rest_connection"
-  gemspec.authors = ["Jeremy Deininger"]
-  gemspec.add_dependency('activesupport', "=2.3.10")
-  gemspec.add_dependency('net-ssh')
-  gemspec.add_dependency('json')
+require File.expand_path('../lib/rest_connection', __FILE__)
+require 'rake'
+require 'spec/rake/spectask'
+
+task :build do
+  system "gem build rest_connection.gemspec"
+end
+
+task :release => :build do
+  system "gem push rest_connection-#{RestConnection::VERSION}.gem"
 end
-Jeweler::GemcutterTasks.new
 
+Spec::Rake::SpecTask.new('spec') do |t|
+  t.spec_files = Dir.glob('spec/*_spec.rb')
+  t.spec_opts << '--format nested'
+  t.spec_opts << '--colour'
+end

config/rest_api_config.yaml.sample

@@ -1,10 +1,14 @@
---- 
-:ssh_keys: 
+---
+:ssh_keys:
 - ~/.ssh/my_server_key
 - ~/.ssh/my_server_key-eu
 - ~/.ssh/my_server_key-west
 :pass: myUltraSecurePasswordz
 :user: [email protected]
 :api_url: https://my.rightscale.com/api/acct/00000000
-:common_headers: 
+:common_headers:
   X_API_VERSION: "1.0"
+:azure_hack_on: true
+:azure_hack_retry_count: 5
+:azure_hack_sleep_seconds: 60
+:api_logging: false

examples/console.rb

@@ -1,3 +1,26 @@
+#--
+# Copyright (c) 2010-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.
+#++
+
 require 'rubygems'
 require 'rest_connection'
 require 'ruby-debug'

examples/cucumber/step_definitions/deployment_steps.rb

@@ -1,3 +1,26 @@
+#--
+# Copyright (c) 2010-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.
+#++
+
 require "rubygems"
 require "rest_connection"
 require "net/ssh"

examples/cucumber/step_definitions/mysql_steps.rb

@@ -1,3 +1,26 @@
+#--
+# Copyright (c) 2010-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.
+#++
+
 require 'rubygems'
 require 'sqlite3'
 

examples/cucumber/step_definitions/recipe_steps.rb

@@ -1,3 +1,26 @@
+#--
+# Copyright (c) 2010-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.
+#++
+
 When /^I run a recipe named "([^\"]*)" on server "([^\"]*)"\.$/ do |recipe, server_index|
   human_index = server_index.to_i - 1
   STDOUT.puts "#{recipe} -> root@#{@servers[human_index].dns_name}"