fog-rackspace 0.1.0

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

@@ -0,0 +1,89 @@
+#!/usr/bin/env ruby
+
+# This example demonstrates delete a webhook from 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 With 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
+
+def select_webhook(webhooks)
+  abort "\nThere are no webhooks for this policy. Try running add_webhook.rb\n\n" if webhooks.empty?
+
+  puts "\nSelect Webhook:\n\n"
+  webhooks.each_with_index do |webhook, i|
+    puts "\t #{i}. #{webhook.name}"
+  end
+
+  select_str = get_user_input "\nEnter Webhook Number"
+  webhooks[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
+policy = select_policy(policies)
+
+# retrieve list of webhooks for policy
+webhooks = policy.webhooks
+
+# prompt for webhook
+webhook = select_webhook(webhooks)
+
+# delete webhook
+webhook.destroy
+
+puts "Webhook '#{webhook.name} was destroyed"

data/lib/fog/rackspace/examples/block_storage/create_snapshot.rb

@@ -0,0 +1,116 @@
+#!/usr/bin/env ruby
+
+# This example demonstrates creating a snapshot from a Cloud Block Storage volume with the Rackpace Open Cloud
+
+require 'rubygems' #required for Ruby 1.8.x
+require 'fog'
+
+def get_user_input(prompt)
+  print "\n#{prompt}: "
+  gets.chomp
+end
+
+def select_server(servers)
+  abort "\nThere are not any servers in the Chicago region. Try running create_server.rb\n\n" if servers.empty?
+
+  puts "\nSelect Server For Volume Detachment:\n\n"
+  servers.each_with_index do |server, i|
+    puts "\t #{i}. #{server.name} [#{server.public_ip_address}]"
+  end
+
+  delete_str = get_user_input "\nEnter Server Number"
+  servers[delete_str.to_i]
+end
+
+def select_attachment(attachments)
+  abort "\nThis server does not contain any volumes in the Chicago region. Try running server_attachments.rb\n\n" if attachments.empty?
+
+  puts "\nSelect Volume To Detach:\n\n"
+  attachments.each_with_index do |attachment, i|
+    puts "\t #{i}. #{attachment.device}"
+  end
+
+  delete_str = get_user_input "\nEnter Volume Number"
+  attachments[delete_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
+
+#create Next Generation Cloud Server service
+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
+})
+
+#create Cloud Block Storage service
+cbs_service = Fog::Rackspace::BlockStorage.new({
+  :rackspace_username => rackspace_username,
+  :rackspace_api_key  => rackspace_api_key,
+  :rackspace_region => :ord #Use Chicago Region
+})
+
+# retrieve list of servers
+servers = compute_service.servers
+
+# prompt user for server
+server = select_server(servers)
+
+# get attached volumes --also know as attachments
+attachments = server.attachments
+
+# prompt user for volume to detach
+attachment = select_attachment(attachments)
+
+# prompt for snapshot name
+snapshot_name = get_user_input "Enter Snapshot Name"
+
+puts "\n\n"
+puts "******************** NOTE ******************************************"
+puts "* Volume must be unmounted from operating system before detaching. *"
+puts "* This script assumes volume has been unmounted.                   *"
+puts "********************************************************************\n\n"
+
+volume = cbs_service.volumes.get attachment.volume_id
+
+# The snapshot process requires all writes to be flushed to disk. This requires unmounting the file systems or detaching the volume.
+puts "Detaching Volume #{volume.display_name}"
+attachment.detach
+
+volume.wait_for { ready? }
+
+puts "Now Creating Snapshot #{snapshot_name}"
+snapshot = cbs_service.snapshots.create :display_name => snapshot_name, :volume_id => attachment.volume_id
+
+begin
+  # Check every 5 seconds to see if snapshot is in the available state (ready?).
+  # If the available has not been built in 5 minutes (600 seconds) an exception will be raised.
+  snapshot.wait_for(600, 5) do
+    print "."
+    STDOUT.flush
+    ready?
+  end
+
+  puts "[DONE]\n\n"
+
+  puts "Re-attaching Volume #{volume.display_name}"
+  attachment.save
+
+rescue Fog::Errors::TimeoutError
+  puts "[TIMEOUT]\n\n"
+
+  puts "The snapshot #{snapshot.display_name} is still being preformed and is taking longer to complete than expected."
+  puts "You can continute to monitor the process through the web console at https://mycloud.rackspace.com/\n\n"
+end

data/lib/fog/rackspace/examples/block_storage/create_volume.rb

@@ -0,0 +1,58 @@
+#!/usr/bin/env ruby
+
+# This example demonstrates creating Cloud Block Storage volume with the Rackpace Open Cloud
+
+require 'rubygems' #required for Ruby 1.8.x
+require 'fog'
+
+def get_user_input(prompt)
+  print "\n#{prompt}: "
+  gets.chomp
+end
+
+def select_volume_type(volume_types)
+  puts "\nSelect Volume Type:\n\n"
+  volume_types.each_with_index do |volume_type, i|
+    puts "\t #{i}. #{volume_type.name}"
+  end
+
+  selected_str = get_user_input "Enter Volume Type Number"
+  volume_types[selected_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
+
+# create Cloud Block Storage service
+service = Fog::Rackspace::BlockStorage.new({
+  :rackspace_username   => rackspace_username,
+  :rackspace_api_key    => rackspace_api_key,
+  :rackspace_region => :ord #Use Chicago Region
+})
+
+# retrieve list of volume types
+volume_types = service.volume_types
+
+#prompt user for volume type
+volume_type = select_volume_type(volume_types)
+
+# prompt for volume size
+volume_size = get_user_input "Enter Size of Volume (100 GB Minimum)"
+
+# prompt for name of volume
+volume_name = get_user_input "Enter Name for Volume"
+
+#create volume
+volume = service.volumes.create(:size => volume_size, :display_name => volume_name, :volume_type => volume_type.name)
+
+puts "\nVolume #{volume_name} is being created.\n\n"
+puts "To delete the volume please execute the delete_volume.rb script\n\n"

data/lib/fog/rackspace/examples/block_storage/delete_volume.rb

@@ -0,0 +1,53 @@
+#!/usr/bin/env ruby
+
+# This example demonstrates deleting Cloud Block Storage volume with the Rackpace Open Cloud
+
+require 'rubygems' #required for Ruby 1.8.x
+require 'fog'
+
+def get_user_input(prompt)
+ print "\n#{prompt}: "
+ gets.chomp
+end
+
+def select_volume(volumes)
+  abort "\nThere are not any volumes to delete in the Chicago region. Try running create_volume.rb\n\n" if volumes.empty?
+
+  puts "\nSelect Volume:\n\n"
+  volumes.each_with_index do |volume, i|
+    puts "\t #{i}. #{volume.display_name}"
+  end
+
+ selected_str = get_user_input "Enter Volume Type Number"
+ volumes[selected_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
+
+# create Cloud Block Storage service
+service = Fog::Rackspace::BlockStorage.new({
+  :rackspace_username   => rackspace_username,
+  :rackspace_api_key    => rackspace_api_key,
+  :rackspace_region => :ord #Use Chicago Region
+})
+
+# retrieve list of volumes
+volumes = service.volumes
+
+# prompt user for volume
+volume = select_volume(volumes)
+
+# delete volume
+volume.destroy
+
+puts "\nVolume #{volume.display_name} is being destroyed.\n\n"

data/lib/fog/rackspace/examples/compute_v2/bootstrap_server.rb

@@ -0,0 +1,96 @@
+#!/usr/bin/env ruby
+
+# This example demonstrates creating a server with the Rackpace Open Cloud
+
+require 'rubygems' #required for Ruby 1.8.x
+require 'fog'
+require 'base64' #required to encode files for personality functionality
+require 'sshkey' #required to generate ssh keys. 'gem install sshkey'
+
+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
+
+# Generates a ssh key using the SSHKey library. The private key is avaialble via
+# the '.private_key' and the public key is avaialble via '.ssh_public_key'
+def generate_ssh_key
+  SSHKey.generate
+end
+
+# create Next Generation Cloud Server service
+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
+})
+
+# pick the first flavor
+flavor = service.flavors.first
+
+# pick the first Ubuntu image we can find
+image = service.images.find {|image| image.name =~ /Ubuntu/}
+
+# prompt for server name
+server_name = get_user_input "\nEnter Server Name"
+
+# generate the ssh key
+ssh_key = generate_ssh_key
+
+# reload flavor in order to retrieve all of its attributes
+flavor.reload
+
+puts "\nNow creating server '#{server_name}' the following with specifications:\n"
+puts "\t* #{flavor.ram} MB RAM"
+puts "\t* #{flavor.disk} GB"
+puts "\t* #{flavor.vcpus} CPU(s)"
+puts "\t* #{image.name}"
+puts "\n"
+
+begin
+  # bootstrap server
+  server = service.servers.bootstrap :name => server_name,
+                                     :flavor_id => flavor.id,
+                                     :image_id => image.id,
+                                     :private_key => ssh_key.private_key,
+                                     :public_key => ssh_key.ssh_public_key
+
+  if server.ready?
+    puts "[DONE]\n\n"
+
+    puts "The server has been successfully created.\n"
+    puts "Write the following ssh keys to you ~/.ssh directory in order to log in\n\n"
+    puts "+++++++++++PRIVATE_KEY (~/.ssh/fog_key)++++++++++++"
+    puts ssh_key.private_key
+    puts "++++++++++PUBLIC_KEY (~/.ssh/fog_key.pub)++++++++++"
+    puts ssh_key.ssh_public_key
+    puts "+++++++++++++++++++++++++++++++++++++++++++++++++++i\n\n"
+
+    puts "You can then log into the server using the following command\n"
+    puts "ssh #{server.username}@#{server.public_ip_address}\n\n"
+  else
+    puts "An error occured, please try again"
+  end
+
+rescue Fog::Errors::TimeoutError
+  puts "[TIMEOUT]\n\n"
+
+  puts "This server is currently #{server.progress}% into the build process and is taking longer to complete than expected."
+  puts "You can continute to monitor the build process through the web console at https://mycloud.rackspace.com/\n\n"
+end
+
+puts "To delete the server please execute the delete_server.rb script\n\n"

data/lib/fog/rackspace/examples/compute_v2/create_image.rb

@@ -0,0 +1,59 @@
+#!/usr/bin/env ruby
+
+# This example demonstrates creating a server image with the Rackpace Open Cloud
+
+require 'rubygems' #required for Ruby 1.8.x
+require 'fog'
+
+def get_user_input(prompt)
+  print "#{prompt}: "
+  gets.chomp
+end
+
+def select_server(servers)
+  abort "\nThere are not any servers available to image in the Chicago region. Try running create_server.rb\n\n" if servers.empty?
+
+  puts "\nSelect Server To Image:\n\n"
+  servers.each_with_index do |server, i|
+    puts "\t #{i}. #{server.name} [#{server.public_ip_address}]"
+  end
+
+  selected_str = get_user_input "\nEnter Server Number"
+  servers[selected_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
+
+# create Next Generation Cloud Server service
+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
+})
+
+# retrieve list of servers
+servers = service.servers
+
+# prompt user for server
+server = select_server(servers)
+
+# prompt user for image name
+image_name = get_user_input "Enter Image Name"
+
+# creates image for server
+server.create_image image_name
+
+puts "\nImage #{image_name} is being created for server #{server.name}.\n\n"
+puts "To delete the image please execute the delete_image.rb script\n\n"