fog-rackspace 0.1.0

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

@@ -0,0 +1,81 @@
+#!/usr/bin/env ruby
+
+# This example demonstrates creating a private network and attaching it to a new server with the Rackpace Open Cloud
+
+require 'rubygems' #required for Ruby 1.8.x
+require 'fog'
+
+# 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
+
+# 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
+})
+
+#create private network called my_private_net with an ip range between 192.168.0.1 - 192.168.0.255 (Note this will accept IPv6 CIDRs as well)
+net = service.networks.create :label => 'my_private_net', :cidr => '192.168.0.0/24'
+
+puts "\nCreating #{net.label} Network with CIDR #{net.cidr}"
+
+# pick the first flavor
+flavor = service.flavors.first
+
+# pick the first Ubuntu image we can find
+image = service.images.find {|image| image.name =~ /Ubuntu/}
+
+# Create a server called alphabits connected our private network as well as the internet
+server = service.servers.create :name => 'alphabits',
+                                :flavor_id => flavor.id,
+                                :image_id => image.id,
+                                :networks => [net.id, INTERNET]
+
+puts "\nNow creating server '#{server.name}' connected the the Internet and '#{net.label}'\n"
+
+begin
+  # Check every 5 seconds to see if server is in the active state (ready?).
+  # If the server has not been built in 10 minutes (600 seconds) an exception will be raised.
+  server.wait_for(600, 5) do
+    print "."
+    STDOUT.flush
+    ready?
+  end
+
+  puts "[DONE]\n\n"
+
+  puts "The server has been successfully created, to login onto the server:\n\n"
+  puts "\t ssh #{server.username}@#{server.public_ip_address}\n\n"
+
+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 "The #{server.username} password is #{server.password}\n\n"
+puts "To delete the server and private network please execute the delete_network.rb script\n\n"

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

@@ -0,0 +1,87 @@
+#!/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
+
+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
+
+# 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"
+
+# create server
+server = service.servers.create :name => server_name,
+                                :flavor_id => flavor.id,
+                                :image_id => image.id,
+                                :metadata => { 'fog_sample' => 'true'},
+                                :personality => [{
+                                  :path => '/root/fog.txt',
+                                  :contents => Base64.encode64('Fog was here!')
+                                }]
+
+# 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
+  # Check every 5 seconds to see if server is in the active state (ready?).
+  # If the server has not been built in 5 minutes (600 seconds) an exception will be raised.
+  server.wait_for(600, 5) do
+    print "."
+    STDOUT.flush
+    ready?
+  end
+
+  puts "[DONE]\n\n"
+
+  puts "The server has been successfully created, to login onto the server:\n\n"
+  puts "\t ssh #{server.username}@#{server.public_ip_address}\n\n"
+
+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 "The #{server.username} password is #{server.password}\n\n"
+puts "To delete the server please execute the delete_server.rb script\n\n"

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

@@ -0,0 +1,60 @@
+#!/usr/bin/env ruby
+
+# This example demonstrates deleting 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_image(snapshot_images)
+  abort "\nThere are not any images to delete in the Chicago region. Try running create_image.rb\n\n" if snapshot_images.empty?
+
+  puts "\nSelect Image To Delete:\n\n"
+  snapshot_images.each_with_index do |image, i|
+    puts "\t #{i}. #{image.name}"
+  end
+
+  delete_str = get_user_input "\nEnter Image Number"
+  snapshot_images[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
+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 images
+images = service.images
+
+# select all of the snapshot type images. base images are not user deletable
+snapshot_images = images.select do |image|
+  image.metadata["image_type"] == "snapshot"
+end
+
+# prompt user for image to delete
+image = select_image(snapshot_images)
+
+# delete image
+image.destroy
+
+puts "\n#{image.name} has been destroyed\n\n"

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

@@ -0,0 +1,78 @@
+#!/usr/bin/env ruby
+
+# This example demonstrates deletes a private network and attaching it to a new server with the Rackpace Open Cloud
+
+require 'rubygems' #required for Ruby 1.8.x
+require 'fog'
+
+def wait_for_server_deletion(server)
+  begin
+    server.wait_for { state = 'DELETED' }
+  rescue Fog::Compute::RackspaceV2::NotFound => e
+    # do nothing
+  end
+end
+
+# I have notice that cloud networks is slow to acknowledge deleted servers. This method tries to mitigate this.
+def delete_network(network)
+  attempt = 0
+  begin
+    network.destroy
+  rescue Fog::Compute::RackspaceV2::ServiceError => e
+    if attempt == 3
+       puts  "Unable to delete #{network.label}"
+      return false
+    end
+     puts "Network #{network.label} Delete Fail Attempt #{attempt}- #{e.inspect}"
+    attempt += 1
+    sleep 60
+    retry
+  end
+  return true
+end
+
+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
+
+# 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
+})
+
+# NOTE: The network must not be connected to any servers before deletion
+
+# Find alpha bits server
+server = service.servers.find {|s| s.name == 'alphabits'}
+
+puts "\n"
+if server
+  puts "Deleting alphabits server..."
+  server.destroy
+else
+  puts "Unable to find server alphabits"
+end
+
+wait_for_server_deletion(server)
+
+network = service.networks.find {|n| n.label == 'my_private_net'}
+delete_network(network)
+
+puts "The network '#{network.label}' has been successfully deleted"

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

@@ -0,0 +1,55 @@
+#!/usr/bin/env ruby
+
+# This example demonstrates how to delete servers with Fog and the Rackspace 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 to delete in the Chicago region. Try running create_server.rb\n\n" if servers.empty?
+
+  puts "\nSelect Server To Delete:\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
+
+# 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)
+
+#destroy server
+server.destroy
+
+puts "\nServer #{server.name} has been destroyed\n"

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

@@ -0,0 +1,93 @@
+#!/usr/bin/env ruby
+
+# This example demonstrates working with server and volumes on 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 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
+})
+
+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)
+
+volume = cbs_service.volumes.get attachment.volume_id
+puts "Detaching Volume #{volume.display_name} From Server #{server.name}"
+attachment.detach
+
+puts "\n"
+delete_confirm = get_user_input "Would You Like To Destroy Volume #{volume.display_name} (y/n)"
+if delete_confirm.downcase ==  'y'
+  # wait for server to finish detaching before attempting to delete
+  volume.wait_for(600)  do
+    print "."
+    STDOUT.flush
+    ready? && attachments.empty?
+  end
+
+  volume.destroy
+
+  puts "\n\nThe Volume Has been Destroyed"
+end