fog 1.10.0 → 1.10.1

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

@@ -28,7 +28,7 @@ Examples will prompt for Rackspace Open Cloud credentials. Prompts can be skippe
     	rackspace_username: RACKSPACE_USERNAME
     	rackspace_api_key: RACKSPACE_API_KEY
 
-***Note:* Replace capitalized values with the appropriate credential information.*
+**Note:** Replace capitalized values with the appropriate credential information.
 
 ## Executing
 

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

@@ -0,0 +1,118 @@
+#!/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/create_image.rb

@@ -11,7 +11,7 @@ def get_user_input(prompt)
 end
 
 def select_server(servers)
-  abort "\nThere are not any servers avaliable to image. Try running create_server.rb\n\n" if servers.empty?
+  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|
@@ -40,7 +40,7 @@ service = Fog::Compute.new({
   :rackspace_username   => rackspace_username,
   :rackspace_api_key    => rackspace_api_key,
   :version => :v2,  # Use Next Gen Cloud Servers
-  :rackspace_endpoint => Fog::Compute::RackspaceV2::ORD_ENDPOINT #Use Chicago Region
+  :rackspace_region => :ord #Use Chicago Region
 })
 
 # retrieve list of servers

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

@@ -29,7 +29,7 @@ service = Fog::Compute.new({
   :rackspace_username   => rackspace_username,
   :rackspace_api_key    => rackspace_api_key,
   :version => :v2,  # Use Next Gen Cloud Servers
-  :rackspace_endpoint => Fog::Compute::RackspaceV2::ORD_ENDPOINT #Use Chicago Region
+  :rackspace_region => :ord #Use Chicago Region
 })
 
 # pick the first flavor

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

@@ -11,7 +11,7 @@ def get_user_input(prompt)
 end
 
 def select_image(snapshot_images)
-  abort "\nThere are not any images to delete. Try running create_image.rb\n\n" if snapshot_images.empty?
+  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|
@@ -40,7 +40,7 @@ service = Fog::Compute.new({
   :rackspace_username   => rackspace_username,
   :rackspace_api_key    => rackspace_api_key,
   :version => :v2,  # Use Next Gen Cloud Servers
-  :rackspace_endpoint => Fog::Compute::RackspaceV2::ORD_ENDPOINT #Use Chicago Region
+  :rackspace_region => :ord #Use Chicago Region
 })
 
 # retrieve list of images

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

@@ -11,7 +11,7 @@ def get_user_input(prompt)
 end
 
 def select_server(servers)
-  abort "\nThere are not any servers to delete. Try running create_server.rb\n\n" if servers.empty?
+  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|
@@ -40,7 +40,7 @@ service = Fog::Compute.new({
   :rackspace_username   => rackspace_username,
   :rackspace_api_key    => rackspace_api_key,
   :version => :v2,  # Use Next Gen Cloud Servers
-  :rackspace_endpoint => Fog::Compute::RackspaceV2::ORD_ENDPOINT #Use Chicago Region
+  :rackspace_region => :ord #Use Chicago Region
 })
 
 #retrieve list of servers

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

@@ -11,7 +11,7 @@ def get_user_input(prompt)
 end
 
 def select_server(servers)
-  abort "\nThere are not any servers. Try running create_server.rb\n\n" if servers.empty?
+  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|
@@ -23,7 +23,7 @@ def select_server(servers)
 end
 
 def select_attachment(attachments)
-  abort "\nThis server does not contain any volumes. Try running server_attachments.rb\n\n" if attachments.empty?
+  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|
@@ -52,13 +52,13 @@ compute_service = Fog::Compute.new({
   :rackspace_username   => rackspace_username,
   :rackspace_api_key    => rackspace_api_key,
   :version => :v2,  # Use Next Gen Cloud Servers
-  :rackspace_endpoint => Fog::Compute::RackspaceV2::ORD_ENDPOINT #Use Chicago Region
+  :rackspace_region => :ord #Use Chicago Region
 })
 
 cbs_service = Fog::Rackspace::BlockStorage.new({
   :rackspace_username => rackspace_username,
   :rackspace_api_key  => rackspace_api_key,
-  :rackspace_endpoint => Fog::Rackspace::BlockStorage::ORD_ENDPOINT #Use Chicago Region  
+  :rackspace_region => :ord #Use Chicago Region
 })
 
 # retrieve list of servers

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

@@ -22,7 +22,7 @@ def select_flavor(flavors, server)
 end
 
 def select_server(servers)
-  abort "\nThere are not any servers to resize. Try running create_server.rb\n\n" if servers.empty?
+  abort "\nThere are not any servers to resize in the Chicago region. Try running create_server.rb\n\n" if servers.empty?
   
   puts "\nSelect Server Resize:\n\n"
   servers.each_with_index do |server, i|
@@ -51,7 +51,7 @@ service = Fog::Compute.new({
   :rackspace_username   => rackspace_username,
   :rackspace_api_key    => rackspace_api_key,
   :version => :v2,  # Use Next Gen Cloud Servers
-  :rackspace_endpoint => Fog::Compute::RackspaceV2::ORD_ENDPOINT #Use Chicago Region
+  :rackspace_region => :ord #Use Chicago Region
 })
 
 #retrieve list of servers

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

@@ -11,7 +11,7 @@ def get_user_input(prompt)
 end
 
 def select_server(servers)
-  abort "\nThere are not any servers. Try running create_server.rb\n\n" if servers.empty?
+  abort "\nThere are not any servers in the Chicago region. Try running create_server.rb\n\n" if servers.empty?
   
   puts "\nSelect Server For Attachment:\n\n"
   servers.each_with_index do |server, i|
@@ -40,13 +40,13 @@ compute_service = Fog::Compute.new({
   :rackspace_username   => rackspace_username,
   :rackspace_api_key    => rackspace_api_key,
   :version => :v2,  # Use Next Gen Cloud Servers
-  :rackspace_endpoint => Fog::Compute::RackspaceV2::ORD_ENDPOINT #Use Chicago Region
+  :rackspace_region => :ord #Use Chicago Region
 })
 
 cbs_service = Fog::Rackspace::BlockStorage.new({
   :rackspace_username => rackspace_username,
   :rackspace_api_key  => rackspace_api_key,
-  :rackspace_endpoint => Fog::Rackspace::BlockStorage::ORD_ENDPOINT #Use Chicago Region  
+  :rackspace_region => :ord #Use Chicago Region
 })
 
 # retrieve list of servers

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

@@ -30,7 +30,7 @@ service = Fog::Compute.new({
   :rackspace_username   => rackspace_username,
   :rackspace_api_key    => rackspace_api_key,
   :version => :v2,  # Use Next Gen Cloud Servers
-  :rackspace_endpoint => Fog::Compute::RackspaceV2::ORD_ENDPOINT #Use Chicago Region
+  :rackspace_region => :ord #Use Chicago Region
 })
 
 # Pick the first flavor
@@ -54,7 +54,7 @@ end
 
 puts "[DONE]\n\n"
 
-puts "Initial Metadata\n"                                
+puts "Initial Metadata\n"
 print_metadata(server)
 
 puts "Adding New Metadata\n"

data/lib/fog/rackspace/examples/storage/create_cdn_directory.rb

@@ -0,0 +1,44 @@
+#!/usr/bin/env ruby
+
+# This example demonstrates creating a container with CDN 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
+
+# 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 Files service
+service = Fog::Storage.new({
+  :provider             => 'Rackspace',
+  :rackspace_username   => rackspace_username,
+  :rackspace_api_key    => rackspace_api_key,
+  :rackspace_region => :ord #Use Chicago Region
+  }) 
+  
+# prompt for directory name
+directory_name = get_user_input "\nEnter name of directory to create"
+
+# create directory
+directory = service.directories.create :key => directory_name, :public => true
+
+# reload directory to refresh information
+directory.reload
+
+puts "\nDirectory #{directory.key} was created."
+puts "To delete the container please execute the delete_directory.rb script\n\n"
+