fog-maestrodev 1.15.0.20130927082724 → 1.18.0.20131111203459

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

@@ -0,0 +1,115 @@
+#!/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,61 @@
+#!/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"

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

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

@@ -12,7 +12,7 @@ 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}]"

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

@@ -12,7 +12,7 @@ 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}"

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

@@ -12,7 +12,7 @@ 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}]"

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

@@ -12,7 +12,7 @@ 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}]"
@@ -24,7 +24,7 @@ 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}"

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

@@ -23,7 +23,7 @@ end
 
 def select_server(servers)
   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|
     puts "\t #{i}. #{server.name} [#{server.public_ip_address}]"

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

@@ -12,7 +12,7 @@ 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 Attachment:\n\n"
   servers.each_with_index do |server, i|
     puts "\t #{i}. #{server.name} [#{server.public_ip_address}]"

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

@@ -28,7 +28,7 @@ service = Fog::Storage.new({
   :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"

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

@@ -12,7 +12,7 @@ end
 
 def select_directory(directories)
   abort "\nThere are not any directories to delete in the Chicago region. Try running create_directory.rb\n\n" if directories.empty?
-  
+
   puts "\nSelect Directory To Delete:\n\n"
   directories.each_with_index do |dir, i|
     puts "\t #{i}. #{dir.key} [#{dir.count} objects]"

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

@@ -12,7 +12,7 @@ end
 
 def select_directory(directories)
   abort "\nThere are not any directories with files to delete in the Chicago region. Try running create_file.rb\n\n" if directories.empty?
-  
+
   puts "\nSelect Directory:\n\n"
   directories.each_with_index do |dir, i|
     puts "\t #{i}. #{dir.key} [#{dir.count} objects]"

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

@@ -12,7 +12,7 @@ end
 
 def select_directory(directories)
   abort "\nThere are not any directories with files in the Chicago region. Try running create_file.rb\n\n" if directories.empty?
-  
+
   puts "\nSelect Directory:\n\n"
   directories.each_with_index do |dir, i|
     puts "\t #{i}. #{dir.key} [#{dir.count} objects]"

data/lib/fog/rackspace/models/auto_scale/group.rb

@@ -9,7 +9,7 @@ module Fog
       class Group < Fog::Model
         
         # @!attribute [r] id
-        # @return [String] The autoscale group's id   
+        # @return [String] The autoscale group's id
         identity :id
 
         # @!attribute [r] links
@@ -103,6 +103,7 @@ module Fog
         # @see http://docs.rackspace.com/cas/api/v1.0/autoscale-devguide/content/POST_createGroup_v1.0__tenantId__groups_Groups.html   
         def save
           requires :launch_config, :group_config, :policies
+          raise Fog::Errors::Error.new("You should update launch_config and group_config directly") if persisted?
 
           launch_config_hash = {
             'args' => launch_config.args,
@@ -190,8 +191,7 @@ module Fog
         private
 
         def load_model(class_name, attrs = nil)
-          # Can use either Kernel.const_get or do an eval() - first is quicker
-          model = Kernel.const_get("Fog::Rackspace::AutoScale::#{class_name}").new({
+          model = Fog::Rackspace::AutoScale.const_get(class_name).new({
             :service => @service,
             :group   => self
           })

data/lib/fog/rackspace/models/auto_scale/group_builder.rb

@@ -0,0 +1,85 @@
+require 'fog/core/model'
+require 'fog/rackspace/models/auto_scale/group_config'
+require 'fog/rackspace/models/auto_scale/launch_config'
+require 'fog/rackspace/models/auto_scale/policies'
+
+module Fog
+  module Rackspace
+    class AutoScale
+      class GroupBuilder
+
+        class << self
+          def build(service, attributes)
+            service.groups.new :group_config => build_group_config(attributes), :launch_config => build_server_launch_config(attributes)
+          end
+
+          def build_group_config(attributes)
+            Fog::Rackspace::AutoScale::GroupConfig.new :max_entities => attributes[:max_entities],
+              :min_entities => attributes[:min_entities],
+              :cooldown => attributes[:cooldown],
+              :name => attributes[:name],
+              :metadata => attributes[:metadata] || {}
+          end
+
+          def build_server_launch_config(attributes)
+            return nil unless attributes[:launch_config_type] == :launch_server
+            args = {"server" => build_server_template(attributes) }
+            args["loadBalancers"] = build_load_balancers(attributes) if attributes[:load_balancers]
+
+            Fog::Rackspace::AutoScale::LaunchConfig.new :type => :launch_server, :args => args
+          end
+
+          private
+
+          def build_load_balancers(attributes)
+            return nil unless attributes[:load_balancers]
+
+            load_balancers = attributes[:load_balancers].is_a?(Array) ? attributes[:load_balancers] : [attributes[:load_balancers]]
+            load_balancers.collect do |obj|
+              obj.is_a?(Hash) ? obj : load_balancer_to_hash(obj)
+            end
+          end
+
+          def load_balancer_to_hash(lb)
+            raise ArgumentError.new("Expected LoadBalancer") unless lb.respond_to?(:id) && lb.respond_to?(:port)
+            {
+              "port" =>  lb.port,
+              "loadBalancerId" => lb.id
+            }
+          end
+
+          def build_server_template(attributes)
+            image_id = get_id(:image, attributes)
+            flavor_id = get_id(:flavor, attributes)
+
+            server_template =   {
+              "name" => attributes[:server_name],
+              "imageRef" => image_id,
+              "flavorRef" => flavor_id,
+              "OS-DCF =>diskConfig" => attributes[:disk_config] || "MANUAL",
+              "metadata" => attributes[:server_metadata] || {}
+            }
+
+            server_template["personality"] = attributes[:personality] if attributes[:personality]
+            server_template["networks"] = networks_to_hash(attributes[:networks]) if attributes[:networks]
+            server_template
+          end
+
+          def model?(obj)
+            obj.class.ancestors.include?(Fog::Model)
+          end
+
+          def get_id(type, attributes)
+            id = attributes["#{type}_id".to_sym]
+            type_key = type.to_sym
+            id ||= model?(attributes[type_key]) ? attributes[type_key].id : attributes[type_key]
+          end
+
+          def networks_to_hash(networks)
+            networks.collect {|n| {"uuid" => n}}
+          end
+        end
+      end
+    end
+  end
+end

data/lib/fog/rackspace/models/auto_scale/group_config.rb

@@ -42,18 +42,37 @@ module Fog
         def update
           
           options = {}
-
           options['name'] = name unless name.nil?
           options['cooldown'] = cooldown unless cooldown.nil?
           options['minEntities'] = min_entities
           options['maxEntities'] = max_entities
           options['metadata'] = metadata unless metadata.nil?
 
-          data = service.update_group_config(group.id, options)
-          merge_attributes(data.body)
+          service.update_group_config(group.id, options)
           true
         end
 
+        # Saves group configuration.
+        # This method will only save existing group configurations. New group configurations are created when a scaling group is created
+        #
+        # @return [Boolean] true if group config was saved
+        def save
+          if group.id
+            update
+            true
+          else
+            raise "New #{self.class} are created when a new Fog::Rackspace::AutoScale::Group is created"
+          end
+        end
+
+        # Reloads group configuration
+        def reload
+          if group.id
+            data = service.get_group_config(group.id)
+            merge_attributes data.body['groupConfiguration']
+          end
+        end
+
       end
   	end
   end

data/lib/fog/rackspace/models/auto_scale/groups.rb

@@ -8,9 +8,9 @@ module Fog
 
         model Fog::Rackspace::AutoScale::Group
 
-        # Returns list of autoscale grouos
+        # Returns list of autoscale groups
         #
-        # @return [Fog::Rackspace::AutoScale::Groups] Retrieves a list images.
+        # @return [Fog::Rackspace::AutoScale::Groups] Retrieves a list groups.
         #
         # @raise [Fog::Rackspace::AutoScale:::NotFound] - HTTP 404
         # @raise [Fog::Rackspace::AutoScale:::BadRequest] - HTTP 400
@@ -25,7 +25,7 @@ module Fog
 
         # Returns an individual autoscale group
         #
-        # @return [Fog::Rackspace::AutoScale::Group] Retrieves a list images.
+        # @return [Fog::Rackspace::AutoScale::Group] Retrieves a list groups.
         # @return nil if not found
         #
         # @raise [Fog::Rackspace::AutoScale:::NotFound] - HTTP 404

data/lib/fog/rackspace/models/auto_scale/launch_config.rb

@@ -33,11 +33,31 @@ module Fog
           options['type'] = type unless type.nil?
           options['args'] = args unless args.nil?
 
-          data = service.update_launch_config(group.id, options)
-          merge_attributes(data.body['launchConfiguration'])
+          service.update_launch_config(group.id, options)
           true
         end
 
+        # Saves group launch configuration.
+        # This method will only save existing group configurations. New group configurations are created when a scaling group is created
+        #
+        # @return [Boolean] true if launch group was saved
+        def save
+          if group.id
+            update
+            true
+          else
+            raise "New #{self.class} are created when a new Fog::Rackspace::AutoScale::Group is created"
+          end
+        end
+
+        # Reloads group launch configuration
+        def reload
+          if group.id
+            data = service.get_launch_config(group.id)
+            merge_attributes data.body['launchConfiguration']
+          end
+        end
+
       end
   	end
   end