fog-rackspace 0.1.0

data/lib/fog/rackspace/errors.rb

@@ -0,0 +1,33 @@
+module Fog
+  module Rackspace
+    module Errors
+      def self.included(mod)
+        mod.class_eval <<-'EOS', __FILE__, __LINE__
+          class NotFound < Fog::Service::NotFound
+            attr_reader :region, :status_code, :transaction_id
+
+            def to_s
+              status = status_code ? "HTTP #{status_code}" : "HTTP <Unknown>"
+              message = region ? "resource not found in #{region} region" : super
+              "[#{status} | #{transaction_id}] #{message}"
+            end
+
+            def self.slurp(error, service=nil)
+              exception = NotFound.new
+              exception.instance_variable_set(:@region, service.region) if service && service.respond_to?(:region)
+              exception.instance_variable_set(:@status_code, error.response.status) rescue nil
+              exception.set_transaction_id(error, service)
+              exception
+            end
+
+            def set_transaction_id(error, service)
+              return unless service && service.respond_to?(:request_id_header) && error.response
+              @transaction_id = error.response.headers[service.request_id_header]
+            end
+
+          end
+        EOS
+      end
+    end
+  end
+end

data/lib/fog/rackspace/examples/README.md

@@ -0,0 +1,47 @@
+# Getting Started Examples
+
+## Download
+
+Examples using the Rackspace Open Cloud and Fog can be found in the [fog repository](https://github.com/fog/fog) under the directory `fog/lib/fog/rackspace/examples`.
+
+This repository can be downloaded via `git` by executing the following:
+
+	git clone git://github.com/fog/fog.git
+
+Optionally you can download a zip by clicking on this [link](https://github.com/fog/fog/archive/master.zip).
+
+## Requirements
+
+Examples require the following:
+
+* Rackspace Open Cloud account
+* Ruby 1.8.x or 1.9.x
+* `fog` gem
+
+For more information please refer to the [Getting Started with Fog and the Rackspace Open Cloud](https://github.com/fog/fog/blob/master/lib/fog/rackspace/docs/getting_started.md) document.
+
+## Credentials
+
+Examples will prompt for Rackspace Open Cloud credentials. Prompts can be skipped by creating a `.fog` file in the user's home directory. This is an example of a `.fog` file for the Rackspace Open Cloud:
+
+	default:
+    	rackspace_username: RACKSPACE_USERNAME
+    	rackspace_api_key: RACKSPACE_API_KEY
+
+**Note:** Replace capitalized values with the appropriate credential information.
+
+## Executing
+
+To execute scripts using `bundler`:
+
+	bundle exec ruby <script>
+	
+To execute scripts without `bundler`:
+
+	ruby <script>
+	
+## Support and Feedback
+
+Your feedback is appreciated! If you have specific issues with the **fog** SDK, developers should file an [issue via Github](https://github.com/fog/fog/issues).
+
+For general feedback and support requests, please visit: https://developer.rackspace.com/support.

data/lib/fog/rackspace/examples/auto_scale/add_policy.rb

@@ -0,0 +1,66 @@
+#!/usr/bin/env ruby
+
+# This example demonstrates adding a poicy to an auto scaling group with the Rackpace Open Cloud
+
+require 'fog'
+
+def get_user_input(prompt)
+  print "#{prompt}: "
+  gets.chomp
+end
+
+def get_user_input_as_int(prompt)
+  str = get_user_input(prompt)
+  str.to_i
+end
+
+# Use username defined in ~/.fog file, if absent prompt for username.
+# For more details on ~/.fog refer to http://fog.io/about/getting_started.html
+def rackspace_username
+  Fog.credentials[:rackspace_username] || get_user_input("Enter Rackspace Username")
+end
+
+# Use api key defined in ~/.fog file, if absent prompt for api key
+# For more details on ~/.fog refer to http://fog.io/about/getting_started.html
+def rackspace_api_key
+  Fog.credentials[:rackspace_api_key] || get_user_input("Enter Rackspace API key")
+end
+
+def select_group(groups)
+  abort "\nThere are not any scaling groups in the Chicago region. Try running create_scaling_group.rb\n\n" if groups.empty?
+
+  puts "\nSelect Group For New Policy:\n\n"
+  groups.each_with_index do |group, i|
+    config = group.group_config
+    puts "\t #{i}. #{config.name}"
+  end
+
+  select_str = get_user_input "\nEnter Group Number"
+  groups[select_str.to_i]
+end
+
+# create auto scaling service
+auto_scale_service = Fog::Rackspace::AutoScale.new({
+  :rackspace_username   => rackspace_username,
+  :rackspace_api_key    => rackspace_api_key,
+  :rackspace_region => :ord # Use Chicago Region
+})
+
+# retrieve list of scaling groups
+groups = auto_scale_service.groups
+
+# prompt group
+group = select_group(groups)
+
+# prompt for policy name
+policy_name = get_user_input "Enter name for policy"
+
+# prompt for cool down period for policy
+cooldown = get_user_input_as_int "Enter cool down period in seconds"
+
+# prompt for change increment
+change = get_user_input_as_int "Enter change increment"
+
+group.policies.create :name => policy_name, :cooldown => cooldown, :type => 'webhook', :change => change
+
+puts "\nPolicy #{policy_name} was successfully added to group"

data/lib/fog/rackspace/examples/auto_scale/add_webhook.rb

@@ -0,0 +1,74 @@
+#!/usr/bin/env ruby
+
+# This example demonstrates adding a webhook to an auto scaling group with the Rackpace Open Cloud
+
+require 'fog'
+
+def get_user_input(prompt)
+  print "#{prompt}: "
+  gets.chomp
+end
+
+# Use username defined in ~/.fog file, if absent prompt for username.
+# For more details on ~/.fog refer to http://fog.io/about/getting_started.html
+def rackspace_username
+  Fog.credentials[:rackspace_username] || get_user_input("Enter Rackspace Username")
+end
+
+# Use api key defined in ~/.fog file, if absent prompt for api key
+# For more details on ~/.fog refer to http://fog.io/about/getting_started.html
+def rackspace_api_key
+  Fog.credentials[:rackspace_api_key] || get_user_input("Enter Rackspace API key")
+end
+
+def select_group(groups)
+  abort "\nThere are no groups in the Chicago region. Try running create_scaling_group.rb\n\n" if groups.empty?
+
+  puts "\nSelect Group With Policy:\n\n"
+  groups.each_with_index do |group, i|
+    config = group.group_config
+    puts "\t #{i}. #{config.name}"
+  end
+
+  select_str = get_user_input "\nEnter Group Number"
+  groups[select_str.to_i]
+end
+
+def select_policy(policies)
+  abort "\nThere are no policies for this scaling group. Try running add_policy.rb\n\n" if policies.empty?
+
+  puts "\nSelect Policy Triggered By Webhook:\n\n"
+  policies.each_with_index do |policy, i|
+    puts "\t #{i}. #{policy.name}"
+  end
+
+  select_str = get_user_input "\nEnter Policy Number"
+  policies[select_str.to_i]
+end
+
+# create auto scaling service
+auto_scale_service = Fog::Rackspace::AutoScale.new({
+  :rackspace_username   => rackspace_username,
+  :rackspace_api_key    => rackspace_api_key,
+  :rackspace_region => :ord # Use Chicago Region
+})
+
+# retrieve list of scaling groups
+groups = auto_scale_service.groups
+
+# prompt for group
+group = select_group(groups)
+
+# retrieve list of policies for group
+policies = group.policies
+
+# prompt for policy to delete
+policy = select_policy(policies)
+
+# prompt for webhook name
+webhook_name = get_user_input "Enter name for webhook"
+
+# create webhook
+webhook = policy.webhooks.create :name => webhook_name
+
+puts "\nWebhook #{webhook.name} was successfully added - #{webhook.execution_url}"

data/lib/fog/rackspace/examples/auto_scale/create_scaling_group.rb

@@ -0,0 +1,111 @@
+#!/usr/bin/env ruby
+
+# This example demonstrates creating an auto scaling group with the Rackpace Open Cloud
+
+require 'fog'
+require 'fog/rackspace/models/auto_scale/group_builder'
+
+# UUID for INTERNET
+INTERNET = '00000000-0000-0000-0000-000000000000'
+
+# UUID for Rackspace's service net
+SERVICE_NET = '11111111-1111-1111-1111-111111111111'
+
+def get_user_input(prompt)
+  print "#{prompt}: "
+  gets.chomp
+end
+
+def get_user_input_as_int(prompt)
+  str = get_user_input(prompt)
+  str.to_i
+end
+
+# Use username defined in ~/.fog file, if absent prompt for username.
+# For more details on ~/.fog refer to http://fog.io/about/getting_started.html
+def rackspace_username
+  Fog.credentials[:rackspace_username] || get_user_input("Enter Rackspace Username")
+end
+
+# Use api key defined in ~/.fog file, if absent prompt for api key
+# For more details on ~/.fog refer to http://fog.io/about/getting_started.html
+def rackspace_api_key
+  Fog.credentials[:rackspace_api_key] || get_user_input("Enter Rackspace API key")
+end
+
+def select_image(images)
+  puts "\nSelect Image For Server:\n\n"
+  images.each_with_index do |image, i|
+    puts "\t #{i}. #{image.name}"
+  end
+
+  select_str = get_user_input "\nEnter Image Number"
+  images[select_str.to_i]
+end
+
+# create auto scaling service
+auto_scale_service = Fog::Rackspace::AutoScale.new({
+  :rackspace_username   => rackspace_username,
+  :rackspace_api_key    => rackspace_api_key,
+  :rackspace_region => :ord # Use Chicago Region
+})
+
+# create Next Generation Cloud Server service to get list of flavors
+compute_service = Fog::Compute.new({
+  :provider             => 'rackspace',
+  :rackspace_username   => rackspace_username,
+  :rackspace_api_key    => rackspace_api_key,
+  :version => :v2,  # Use Next Gen Cloud Servers
+  :rackspace_region => :ord # Use Chicago Region
+})
+
+# prompt for scaling group name
+scaling_group_name = get_user_input "Enter name of scaling group"
+
+# prompt for cool down period
+cooldown = get_user_input_as_int "Enter cool down period in seconds"
+
+# prompt for miniumum number of entities
+min_entities = get_user_input_as_int "Enter minimum number of servers"
+
+# prompt for max number of entities
+max_entities = get_user_input_as_int "Enter maximum number of servers"
+
+# retrieve list of images from computer service
+print "Loading available server images...."
+images = compute_service.images.all
+puts "[DONE]"
+
+# prompt for server image
+image = select_image(images)
+
+# pick first server flavor
+flavor = compute_service.flavors.first
+
+attributes = {
+  :server_name => "autoscale_server",
+  :image => image,
+  :flavor => flavor,
+  :networks => [INTERNET, SERVICE_NET],
+  :personality => [
+    {
+      "path" => "/root/.csivh",
+      "contents" => "VGhpcyBpcyBhIHRlc3QgZmlsZS4="
+    }
+  ],
+  :max_entities => max_entities,
+  :min_entities => min_entities,
+  :cooldown => cooldown,
+  :name => scaling_group_name,
+  :metadata => { "created_by" => "autoscale sample script" },
+  :launch_config_type => :launch_server
+}
+
+# Use builder to create group
+group = Fog::Rackspace::AutoScale::GroupBuilder.build(auto_scale_service, attributes)
+
+# save the built group
+group.save
+
+puts "\nScaling Group #{scaling_group_name} (#{group.id}) was created!"
+puts "State: #{group.state}"

data/lib/fog/rackspace/examples/auto_scale/delete_policy.rb

@@ -0,0 +1,71 @@
+#!/usr/bin/env ruby
+
+# This example demonstrates deleting an auto scaling policy with the Rackpace Open Cloud
+
+require 'fog'
+
+def get_user_input(prompt)
+  print "#{prompt}: "
+  gets.chomp
+end
+
+# Use username defined in ~/.fog file, if absent prompt for username.
+# For more details on ~/.fog refer to http://fog.io/about/getting_started.html
+def rackspace_username
+  Fog.credentials[:rackspace_username] || get_user_input("Enter Rackspace Username")
+end
+
+# Use api key defined in ~/.fog file, if absent prompt for api key
+# For more details on ~/.fog refer to http://fog.io/about/getting_started.html
+def rackspace_api_key
+  Fog.credentials[:rackspace_api_key] || get_user_input("Enter Rackspace API key")
+end
+
+def select_group(groups)
+  abort "\nThere are no groups in the Chicago region. Try running create_scaling_group.rb\n\n" if groups.empty?
+
+  puts "\nSelect Group With Policy:\n\n"
+  groups.each_with_index do |group, i|
+    config = group.group_config
+    puts "\t #{i}. #{config.name}"
+  end
+
+  select_str = get_user_input "\nEnter Group Number"
+  groups[select_str.to_i]
+end
+
+def select_policy(policies)
+  abort "\nThere are no policies for this scaling group. Try running add_policy.rb\n\n" if policies.empty?
+
+  puts "\nSelect Policy To Delete:\n\n"
+  policies.each_with_index do |policies, i|
+    puts "\t #{i}. #{policies.name}"
+  end
+
+  select_str = get_user_input "\nEnter Policy Number"
+  policies[select_str.to_i]
+end
+
+# create auto scaling service
+auto_scale_service = Fog::Rackspace::AutoScale.new({
+  :rackspace_username   => rackspace_username,
+  :rackspace_api_key    => rackspace_api_key,
+  :rackspace_region => :ord # Use Chicago Region
+})
+
+# retrieve list of scaling groups
+groups = auto_scale_service.groups
+
+# prompt for group
+group = select_group(groups)
+
+# retrieve list of policies for group
+policies = group.policies
+
+# prompt for policy to delete
+policy = select_policy(policies)
+
+# delete policy
+policy.destroy
+
+puts "\nPolicy '#{policy.name}' has been destroyed\n\n"

data/lib/fog/rackspace/examples/auto_scale/delete_scaling_group.rb

@@ -0,0 +1,59 @@
+#!/usr/bin/env ruby
+
+# This example demonstrates deleting an auto scaling group with the Rackpace Open Cloud
+
+require 'fog'
+
+def get_user_input(prompt)
+  print "#{prompt}: "
+  gets.chomp
+end
+
+# Use username defined in ~/.fog file, if absent prompt for username.
+# For more details on ~/.fog refer to http://fog.io/about/getting_started.html
+def rackspace_username
+  Fog.credentials[:rackspace_username] || get_user_input("Enter Rackspace Username")
+end
+
+# Use api key defined in ~/.fog file, if absent prompt for api key
+# For more details on ~/.fog refer to http://fog.io/about/getting_started.html
+def rackspace_api_key
+  Fog.credentials[:rackspace_api_key] || get_user_input("Enter Rackspace API key")
+end
+
+def select_group(groups)
+  abort "\nThere are not any groups to delete in the Chicago region. Try running create_scaling_group.rb\n\n" if groups.empty?
+
+  puts "\nSelect Group To Delete:\n\n"
+  groups.each_with_index do |group, i|
+    config = group.group_config
+    puts "\t #{i}. #{config.name}"
+  end
+
+  select_str = get_user_input "\nEnter Group Number"
+  groups[select_str.to_i]
+end
+
+# create auto scaling service
+auto_scale_service = Fog::Rackspace::AutoScale.new({
+  :rackspace_username   => rackspace_username,
+  :rackspace_api_key    => rackspace_api_key,
+  :rackspace_region => :ord # Use Chicago Region
+})
+
+# retrieve list of scaling groups
+groups = auto_scale_service.groups
+
+# prompt for group to delete
+group = select_group(groups)
+
+# min_entities and max_entities must be 0 before deleting group
+config = group.group_config
+config.min_entities = 0
+config.max_entities = 0
+config.save
+
+# delete group
+group.destroy
+
+puts "\nScaling Group '#{config.name}' has been destroyed\n\n"