ropenstack 1.2.1 → 2.0.0

data/lib/ropenstack/compute.rb

@@ -0,0 +1,164 @@
+require 'ropenstack/common/rest'
+require 'uri'
+
+module Ropenstack
+=begin
+	* Name: Compute
+	* Description: Implementation of the Compute API Client in Ruby 
+	* Author: Sam 'Tehsmash' Betts
+	* Date: 01/15/2013
+=end
+  class Compute < OpenstackService
+    require 'ropenstack/compute/v2'
+    require 'ropenstack/compute/v3'
+
+    include Version2
+
+    ##
+    # Gets a list of servers from OpenStack 
+    #
+    # :call-seq:
+    #   servers(id) => A single server with the id matching the parameter
+    #   servers() => All servers visible to the tenant making the request
+    ##
+    def servers(id)
+      endpoint = "/servers"
+      unless id.nil?
+        endpoint = endpoint + "/" + id
+      end
+      return get_request(address(endpoint), @token)
+    end 
+
+    ##
+    # Gets a more detailed list of servers from openstack.
+    ##
+    def servers_detailed()
+      return get_request(address("/servers/detail"), @token)
+    end
+
+    ##
+    # Creates a server on OpenStack.
+    ##
+    def create_server(name, image, flavor, networks = nil, keypair = nil, security_group = nil, metadata = nil)
+      data = { 
+        "server" => { 
+          "name" => name,
+          "imageRef" => image,
+          "flavorRef" => flavor,
+        }   
+      }
+      unless networks.nil?
+        data["server"]["networks"] = networks 
+      end
+      unless keypair.nil?
+        data["server"]["key_name"] = keypair
+      end
+      unless security_group.nil?
+        data["server"]["security_group"] = security_group 
+      end
+      return post_request(address("/servers"), data, @token)
+    end 
+
+    ##
+    # Deletes a server from Openstack based on an id
+    ##
+    def delete_server(id)
+      return delete_request(address("/servers/" + id), @token)
+    end
+
+    ##
+    # Perform an action on a server on Openstack, by passing an id, 
+    # and an action, some actions require more data.
+    #
+    # E.g. action(id, "reboot", "hard")
+    ##
+    def action(id, act, *args) 
+      data = case act
+        when "reboot" then {'reboot' =>{"type" => args[0]}}	
+        when "vnc" then {'os-getVNCConsole' => { "type" => "novnc" }} 
+        when "stop" then {'os-stop' => 'null'}
+        when "start" then {'os-start' => 'null'}
+        when "pause" then {'pause' => 'null'}
+        when "unpause" then {'unpause' => 'null'}
+        when "suspend" then {'suspend' => 'null'}
+        when "resume" then {'resume' => 'null'}
+        when "create_image" then {'createImage' => {'name' => args[0], 'metadata' => args[1]}} 
+        else raise "Invalid Action"
+        end
+      return post_request(address("/servers/" + id + "/action"), data, @token)
+    end
+
+    ##
+    # Retrieve a list of images from Openstack through the nova endpoint
+    ##
+    def images() 
+      uri = URI.parse("http://" + @location.host + ":9292/v2/images")
+      return get_request(uri, @token)
+    end
+
+    ##
+    # Delete an image stored on Openstack through the nova endpoint
+    ##
+    def delete_image(id)
+      uri = URI.parse("http://" + @location.host + ":" + @location.port.to_s + "/v2/images/" + id)
+      return delete_request(uri, @token)
+    end
+
+    ##
+    # Get a list of flavors that Servers can be
+    ##
+    def flavors()
+      return get_request(address("/flavors/detail"), @token)	
+    end
+
+    ##
+    # Get a tenants compute quotas
+    ##
+    def limits()
+      return get_request(address("/limits"), @token)
+    end
+
+    ##
+    # Get a list of Compute Extensions
+    ##
+    def extensions(ali)
+      if ali.nil?
+        return get_request(address("/extensions"), @token)
+      else 
+        return get_request(address("/extensions/"+ ali), @token)
+      end
+    end
+
+    def metadata(id, key)
+      if key.nil?
+        return get_request(address("/servers/"+id+"/metadata"), @token)
+      else
+        return get_request(address("/servers/"+id+"/metadata/" + key), @token)
+      end
+    end
+
+    def set_metadata(id, data, key)
+      if key.nil?
+        return put_request(address("/servers/"+id+"/metadata"), data, @token)
+      else
+        return put_request(address("/servers/"+id+"/metadata/"+key), data, @token)
+      end
+    end
+
+    def update_metadata(id, data)
+      return post_request(address("/servers/"+id+"/metadata"), data, @token)
+    end
+
+    def delete_metadata(id, key)
+      return delete_request(address("/servers/"+id+"/metadata/" + key), @token)
+    end
+
+    def ips(id, network)
+      if network.nil?
+        return get_request(address("/servers/"+id+"/ips"), @token) 
+      else 
+        return get_request(address("/servers/"+id+"/ips/" + network), @token) 
+      end
+    end
+  end
+end

data/lib/ropenstack/compute/v2.rb

@@ -0,0 +1,11 @@
+module Ropenstack
+  module Compute::Version2
+    require "ropenstack/compute/v2/extensions"
+    include Extensions
+
+    # Insert V2 Specfic Code here 
+    def version
+      "V2"
+    end
+  end
+end

data/lib/ropenstack/compute/v2/extensions.rb

@@ -0,0 +1,14 @@
+module Ropenstack
+  module Compute::Version2
+    module Extensions
+      # Pull in module extension files
+      require "ropenstack/compute/v2/extensions/keypairs"
+      require "ropenstack/compute/v2/extensions/securitygroups"
+
+      # Include individual extensions so that if anyone wants to 
+      # simply include all extensions they only have to include one file.
+      include Keypairs
+      include SecurityGroups
+    end
+  end
+end

data/lib/ropenstack/compute/v2/extensions/keypairs.rb

@@ -0,0 +1,20 @@
+module Ropenstack::Compute::Version2::Extensions
+  module Keypairs
+    def keypairs(name = nil)
+      endpoint = "/os-keypairs" 
+      unless name.nil?
+        endpoint = "#{endpoint}/#{name}"
+      end
+      return get_request(address(endpoint), @token)
+    end
+
+    def create_keypair(name)
+      data = { "keypair" => { "name" => name } }
+      return post_request(address("/os-keypairs"), data, @token)
+    end
+
+    def delete_keypair(name)
+      return delete_request(address("/os-keypairs/#{name}"), @token)
+    end
+  end
+end

data/lib/ropenstack/compute/v2/extensions/securitygroups.rb

@@ -0,0 +1,40 @@
+module Ropenstack::Compute::Version2::Extensions
+  module SecurityGroups
+    def security_groups(id = nil)
+      endpoint = "/os-security-groups"
+      unless id.nil?
+        endpoint = "#{endpoint}/#{id}"
+      end
+      return get_request(address(endpoint), @token)
+    end
+
+    def create_security_group(name, description)
+      data = { "security_group" => {"name" => name, "description" => description } }
+      return post_request(address("/os-security-groups"), data, @token)
+    end
+
+    def destroy_security_group(id)
+      return post_request(address("/os-security-groups/#{id}"), @token)
+    end
+
+    def create_security_group_rule(protocol, from, to, cidr, parent, group = nil)
+      data = { 
+        "security_group_rule" => {
+          "ip_protocol" => protocol,
+          "from_port" => from,
+          "to_port" => to,
+          "cidr" => cidr,
+          "parent_group_id" => parent
+        } 
+      }
+      unless group.nil?
+        data["security_group_rule"]["group_id"] = group
+      end
+      return post_request(address("/os-security-group-rules"), data, @token)
+    end
+
+    def destroy_security_group_rule(id)
+      return delete_request(address("/os-security-group-rules/#{id}"), @token)
+    end
+  end
+end

data/lib/ropenstack/compute/v2/extensions/volumes.rb

@@ -0,0 +1,20 @@
+module Ropenstack::Compute::Version2::Extensions
+  module Volumes
+    ##
+    # Attach a cinder volume to a server, by passing the server id and
+    # the volume id.
+    ##
+    def attach_volume(id, volume) 
+      data = { 'volumeAttachment' => { 'volumeId' => volume, 'device' => "/dev/vdb" } }
+      return post_request(address("/servers/" + id + "/os-volume_attachments"), data, @token)
+    end
+    
+    ##
+    # Remove a cinder volume from a server, by passing the server id and
+    # the attachment id.
+    ##
+    def detach_volume(id, attachment)
+      return delete_request(address("/servers/"+id+"/os-volume_attachments/"+volume), @token)
+    end
+  end
+end

data/lib/ropenstack/compute/v3.rb

@@ -0,0 +1,5 @@
+module Ropenstack
+  module Compute::Version3
+    # Insert V3 Specfic Code here 
+  end
+end

data/lib/ropenstack/database.rb

@@ -0,0 +1,24 @@
+require 'ropenstack/common/rest'
+
+module Ropenstack
+  ##
+  # * Name: Database
+  # * Description: Implementation of the Block Storage API Client in Ruby.
+  # * Author: Sam 'Tehsmash' Betts, John Davidge
+  # * Date: 30/06/2014
+  ##
+  class Database < OpenstackService
+    # Pull in sub-modules.
+    require 'ropenstack/database/v1'
+
+    def initialize(location, token, type, accountid)
+      super(location, token)
+      @accountid = accountid
+      case type
+      when "database" then extend Version1
+      else
+        raise Ropenstack::RopenstackError, "Invalid type passed to Database"
+      end
+    end
+  end
+end

data/lib/ropenstack/database/v1.rb

@@ -0,0 +1,113 @@
+module Ropenstack
+  ##
+  # * Name: DatabaseVersion1
+  # * Description: Implementation of the Block Storage V1.0 API Client in Ruby.
+  # * Author: Sam 'Tehsmash' Betts, John Davidge
+  # * Date: 30/06/2014
+  ##
+  module Database::Version1
+    ## Database Instances
+    def instances(id)
+      if id.nil? 
+        get_request(address("/instances"), @token)
+      else
+        get_request(address("/instances/" + id), @token)
+      end
+    end
+
+    def instance_create(databases, flavorRef, name, users, volume)
+      ## Construct data
+      data = { :instance => {
+          :databases => databases,
+          :flavorRef => flavorRef, 
+          :name => name,
+          :users => users,
+          :volume => volume
+        }
+      }
+
+      post_request(address("/instances"), data, @token)
+    end
+
+    def instance_delete(id)
+      delete_request(address("/instances/" + id), @token)
+    end
+
+    def instance_root(id)
+      get_request(address("/instances/" + id + "/root"), @token)
+    end
+
+    def instance_root_enable(id)
+      ## Empty data field
+      post_request(address("/instances/" + id + "/root"), {}, @token)
+    end
+
+    ## Database Instance Actions
+    def instance_action(id, action, param)
+      case action
+      when "RESTART" 
+        post_request(address("/instances/" + id + "/action"), {:restart => {}}, @token)
+      when "RESIZE"
+        if param.is_a? String
+          post_request(address("/instances/" + id + "/action"), {:resize => {:flavorRef => param }}, @token)
+        elsif param.is_a? Int
+          post_request(address("/instances/" + id + "/action"), {:resize => {:volume => {:size => param }}}, @token)
+        else
+          raise Ropenstack::RopenstackError, "Invalid Parameter Passed"
+        end
+      else
+        raise Ropenstack::RopenstackError, "Invalid Action Passed"
+      end
+    end
+
+    ## Databases
+    def databases(instance)
+      get_request(address("/instances/" + instance + "/databases"), @token)
+    end
+
+    def database_create(instance, name)
+      data = { :databases => [
+          {
+            :name => name
+          }
+        ]
+      }
+      post_request(address("/instances/" + instance + "/databases"), data, @token)
+    end
+
+    def database_delete(instance, name)
+      delete_request(address("/instances/" + instance + "/databases/" + name), @token)
+    end
+
+    ## Users
+    def users(instance)
+      get_request(address("/instances/" + instance + "/users"), @token)
+    end
+
+    def user_create(instance, name, databases)
+      ## TODO Make this work
+      post_request(address("/instances/" + instance + "/users"), data, @token)
+    end
+
+    def user_delete(instance, name)
+      post_request(address("/instances/" + instance + "/users/" + name), @token)
+    end
+
+    ## Flavors
+    def flavors(id)
+      if id.nil? 
+        get_request(address("/flavors"), @token)
+      else
+        get_request(address("/flavors/" + id), @token)
+      end
+    end
+
+    def address(endpoint)
+      super(endpoint) + @accountid
+    end
+
+    def version
+      "V1"
+    end
+  end
+end