ropenstack 1.2.1 → 2.0.0

data/lib/ropenstack/networking.rb

@@ -0,0 +1,160 @@
+module Ropenstack
+=begin
+	* Name: Networking
+	* Description: An implementation of the Networking V2.0 API Client in Ruby
+	* Authors: Sam 'Tehsmash' Betts, John Davidge
+	* Date: 01/15/2013
+=end
+  class Networking < OpenstackService
+    require 'ropenstack/networking/v2'
+
+    ## Extensions
+    include Version2::Extensions::L3
+    include Version2::Extensions::LBaaS
+    include Version2::Extensions::Metering
+    include Version2::Extensions::Quotas
+    include Version2::Extensions::SecurityGroups
+
+    ## Networks
+
+    ##
+    # Get a list of a tenants networks
+    # 
+    # :call-seq:
+    #   networks(id) => A single network with the id matching the parameter
+    #   networks => All networks visible to the tenant making the request
+    ##
+    def networks(id = nil)
+      endpoint = "networks"
+      unless id.nil?
+        endpoint = endpoint + "/" + id
+      end
+      return get_request(address(endpoint), @token)
+    end 
+
+    ##
+    # Create a new network on Openstack given a name and tenant id.
+    ## 
+    def create_network(name, tenant, admin_state_up = true)
+      data = {
+        'network' => {
+          'name' => name,
+          'tenant_id' => tenant,
+          'admin_state_up' => admin_state_up
+        }   
+      }
+      return post_request(address("networks"), data, @token)
+    end 
+    
+    ##
+    # Delete a network given a network id.
+    ##
+    def delete_network(network)
+      return delete_request(address("networks/" + network), @token)
+    end 
+
+    ## Subnets
+
+    ##
+    # Get a list of subnets 
+    ##
+    def subnets
+      return get_request(address("subnets"), @token)
+    end 
+    
+    ##
+    # Create a new ipv4 subnet in a network, given a network id, and
+    # a IP range in CIDR format.
+    ##
+    def create_subnet(network, cidr)
+      data = {
+        'subnet' => {
+          'network_id' => network,
+          'ip_version' => 4,
+          'cidr' => cidr
+        }   
+      }
+      return post_request(address("subnets"), data, @token)
+    end 
+
+    ##
+    # Delete a subnet given a subnet id
+    ##
+    def delete_subnet(subnet)
+      return delete_request(address("subnets/" + subnet), @token)
+    end
+
+    ## Ports
+
+    ##
+    # Get a list of ports
+    ##
+    def ports
+      return get_request(address("ports"), @token)
+    end 
+
+    ##
+    # Get a list of ports specific to a device_id
+    ##
+    def device_ports(device_id)
+      return get_request(address("ports?device_id=#{device_id}"), @token)
+    end 
+
+    ##
+    # Create a new port given network and device ids, optional 
+    # parameter subnet id allows for scoping the port to a single subnet. 
+    ##
+    def create_port(network, subnet = nil, device = nil, device_owner = nil)
+      data = {
+        'port' => {
+          'network_id' => network,
+        }   
+      }
+      unless device_owner.nil?
+        data['port']['device_owner'] = device_owner
+      end
+      unless device.nil?
+        data['port']['device_id'] = device
+      end
+      unless subnet.nil?
+        data['port']['fixed_ips'] = [{'subnet_id' => subnet}]
+      end
+  
+      puts data
+
+      return post_request(address("ports"), data, @token)
+    end 
+
+    ##
+    # Update a specific ports fixed_ips, including subnet and ip data.
+    ##
+    def update_port(port, fixed_ips) 
+      data = { 'port' => { 'fixed_ips' => fixed_ips } }
+      return put_request(address("ports/"+port), data, @token)
+    end
+
+    ##
+    # Weird function for adding a port to multiple subnets if nessessary.
+    ##
+    def move_port_to_subnets(port_id, subnet_ids)
+      id_list = Array.new()
+      subnet_ids.each do |id|
+        id_list << { "subnet_id" => id }
+      end
+      return update_port(port_id, id_list)
+    end
+
+    ##
+    # Delete a port given a port id.
+    ##
+    def delete_port(port)
+      return delete_request(address("ports/" + port), @token)
+    end
+
+    private
+
+    def address(endpoint)
+      super("/v2.0/#{endpoint}")
+    end
+  end
+end

data/lib/ropenstack/networking/v2.rb

@@ -0,0 +1,5 @@
+module Ropenstack
+  module Networking::Version2  
+    require 'ropenstack/networking/v2/extensions'
+  end
+end

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

@@ -0,0 +1,9 @@
+module Ropenstack
+  module Networking::Version2::Extensions
+    require 'ropenstack/networking/v2/extensions/l3'
+    require 'ropenstack/networking/v2/extensions/lbaas'
+    require 'ropenstack/networking/v2/extensions/metering'
+    require 'ropenstack/networking/v2/extensions/quotas'
+    require 'ropenstack/networking/v2/extensions/securitygroups'
+  end
+end

data/lib/ropenstack/networking/v2/extensions/l3.rb

@@ -0,0 +1,111 @@
+module Ropenstack::Networking::Version2::Extensions
+  module L3
+    ##
+    # Get a list of a tenants routers
+    # 
+    # :call-seq:
+    #   routers(id) => A single router with the id matching the parameter
+    #   routers => All routers visible to the tenant making the request
+    ##
+    def routers(id = nil)
+      endpoint = "routers"
+      unless id.nil?
+        endpoint = endpoint + "/" + id
+      end
+      return get_request(address(endpoint), @token)
+    end 
+    ##
+    # Create a new router with a given name.
+    ##
+    def create_router(name, admin_state_up = true)
+      data = {
+        'router' =>{
+          'name' => name,
+          'admin_state_up' => admin_state_up,
+        }   
+      }
+      return post_request(address("routers"), data, @token)
+    end 
+
+    ##
+    # Delete a router given a routers id.
+    ##
+    def delete_router(router)
+      return delete_request(address("routers/" + router), @token)
+    end
+
+    ##
+    # Connect a router to a subnet, given router id and subnet id.
+    ##
+    def add_router_interface(router, subnet)
+      data = { 'subnet_id' => subnet } 
+      return put_request(address("routers/"+router+"/add_router_interface"), data, @token)
+    end
+    
+    ##
+    # Delete a connection between a subnet and router given either port
+    # or subnet ids.
+    #
+    # :call-seq:
+    #   delete_router_interface(router_id, subnet_id, "subnet")
+    #   delete_router_interface(router_id, port_id, "port")
+    ##
+    def delete_router_interface(router, id, type)
+      data = case type
+        when 'port' then { 'port_id' => id }
+        when 'subnet' then { 'subnet_id' => id } 
+        else raise "Invalid Interface Type"  
+        end
+      return put_request(address("routers/" + router + "/remove_router_interface"), data, @token)
+    end
+
+    ##
+    # Enable external connectivity through this router by connecting it to
+    # an "external network"
+    ##
+    def add_router_gateway(router, network_id)
+      data = { 'router' => {'external_gateway_info' => { 'network_id' => network_id }}}
+      return put_request(address("routers/"+router), data, @token)
+    end
+
+    ##
+    # Clear a routers external gateway information given a router id.  
+    ##
+    def delete_router_gateway(router)
+      data = { 'router' => {'external_gateway_info' => nil}}
+      return put_request(address('routers/' + router), data, @token)
+    end
+
+    ##
+    # Get a full list of floating ips for the tenant
+    ##
+    def floating_ips
+      return get_request(address("floatingips"), @token)
+    end
+
+    def create_floating_ip(network, port = nil)
+      data = {
+        'floatingip' => {
+          'floating_network_id' => network
+        }
+      }
+      unless port.nil?
+        data['floatingip']['port_id'] = port
+      end
+      return post_request(address('floatingips'), data, @token)
+    end
+
+    def delete_floating_ip(id)
+      return delete_request(address("floatingips/#{id}"), @token)
+    end
+
+    def update_floating_ip(id, port)
+      data = {
+        'floatingip' => {
+          'port_id' => port
+        }
+      }
+      return put_request(address("floatingips/#{id}"), data, @token)
+    end
+  end
+end

data/lib/ropenstack/networking/v2/extensions/lbaas.rb

@@ -0,0 +1,5 @@
+module Ropenstack::Networking::Version2::Extensions
+  module LBaaS
+    ## TODO 
+  end
+end

data/lib/ropenstack/networking/v2/extensions/metering.rb

@@ -0,0 +1,5 @@
+module Ropenstack::Networking::Version2::Extensions
+  module Metering
+    ## TODO
+  end
+end

data/lib/ropenstack/networking/v2/extensions/quotas.rb

@@ -0,0 +1,5 @@
+module Ropenstack::Networking::Version2::Extensions
+  module Quotas
+    ## TODO
+  end
+end

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

@@ -0,0 +1,5 @@
+module Ropenstack::Networking::Version2::Extensions
+  module SecurityGroups
+    ## TODO
+  end
+end

data/lib/ropenstack/objectStorage.rb

@@ -0,0 +1,60 @@
+module Ropenstack
+  ##
+  # * Name: ObjectStorage
+  # * Description: Implementation of the Block Storage API Client in Ruby.
+  # * Author: Sam 'Tehsmash' Betts
+  # * Date: 01/15/2013
+  ##
+  class ObjectStorage < OpenstackService
+    ## Accounts
+    def account(id, head)
+      if head
+        get_request(address(id), @token)
+      else
+        head_request(address(id), @token)
+      end
+    end
+
+    def create_account()
+    end
+
+    ## Containers 
+    def container(account, container, head)
+      if head
+        get_request(address(account + "/" + container), @token)
+      else
+        head_request(address(account + "/" + container), @token)
+      end
+    end
+
+    def create_container(account, container)
+    end
+
+    def delete_container(account, container)
+    end
+
+    def update_container(account, container)
+    end
+    
+    ## Objects
+    def object(account, container, object)
+      get_request(address(account + "/" + container + "/" + object), @token)
+    end
+    
+    def object_metadata(account, container, object)
+      head_request(address(account + "/" + container + "/" + object), @token)
+    end
+
+    def create_object(account, container, object)
+    end
+
+    def copy_object(account, container, object)
+    end
+
+    def delete_object(account, container, object)
+    end
+    
+    def create_object_metadata(account, container, object)
+    end
+  end
+end

data/lib/ropenstack/orchestration.rb

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

data/lib/ropenstack/orchestration/v1.rb

@@ -0,0 +1,162 @@
+module Ropenstack
+  ##
+  # * Name: OrchestrationVersion1
+  # * Description: Implementation of the Orchestration V1.0 API Client in Ruby 
+  # * Author: Sam 'Tehsmash' Betts, John Davidge
+  # * Date: 30/06/2014
+  ##
+  module Orchestration::Version1
+    def stacks(name, id)
+      if name.nil?
+        get_request(address("/stacks"), @token)
+      elsif id.nil?
+        get_request(address("/stacks/"+name), @token)
+      else
+        get_request(address("/stacks/"+name+"/"+id), @token)
+      end
+    end
+
+    def stack_create(name, template, isURL, environmment, files, parameters, timeout, disable, adoptData, preview)
+      data = { 
+        :stack_name => name,
+        :environment => environment, 
+        :timeout_mins => timeout, 
+        :files => files,
+        :parameters => parameters,
+        :disable => disable
+      }
+      if isURL
+        data[:template_url] = template
+      else
+        data[:template] = template
+      end
+      unless adoptData.nil? 
+        data[:adopt_stack_data] = adoptData
+      end
+      post_request(address("/stacks"), data, @token)
+    end
+
+    def stack_update(name, id)
+      put_request(address("/stack/"+name+"/"+id+"/action"), {:resume => nil}, @token)
+    end
+
+    def stack_delete(name, id)
+      delete_request(address("/stack/"+name+"/"+id), @token)
+    end
+
+    def stack_adandon(name, id, preview)
+      if preview
+        get_request(address("/stack/" + name + "/"+ id + "/abandon"), @token)
+      else
+        delete_request(address("/stack/" + name + "/"+ id + "/abandon"), @token)
+      end
+    end
+
+    def stack_action(name, id, action)
+      case action
+      when "SUSPEND"
+        post_request(address("/stack/"+name+"/"+id+"/action"), {:suspend => nil}, @token)
+      when "RESUME"
+        post_request(address("/stack/"+name+"/"+id+"/action"), {:resume => nil}, @token)
+      else
+        raise Ropenstack::RopenstackError, "Invalid Action Passed"
+      end
+    end
+
+    def resources(stack, id = nil, name = nil, meta = false)
+      if id.nil?
+        get_request(address("/stacks/"+stack+"/resources"), @token)
+      elsif name.nil?
+        get_request(address("/stacks/"+stack+"/"+id+"/resources"), @token)
+      else
+        if meta 
+          get_request(address("/stacks/"+stack+"/"+id+"/resources/"+name+"/metadata"), @token)
+        else
+          get_request(address("/stacks/"+stack+"/"+id+"/resources/"+name), @token)
+        end
+      end 
+    end
+
+    def resource_types(name = nil)
+      if name.nil?
+        get_request(address("/resource_types"), @token)
+      else
+        get_request(address("/resource_types/"+name), @token)
+      end
+    end
+
+    def resource_type_template(name)
+      get_request(address("/resource_types/"+name+"/template"), @token)
+    end
+
+    def events(stack, id = nil, resource = nil, event = nil)
+      if id.nil?
+        get_request(address("/stacks/"+stack+"/events"), @token)
+      elsif resource.nil?
+        get_request(address("/stacks/"+stack+"/"+id+"/events"), @token)
+      elsif event.nil?
+        get_request(address("/stacks/"+stack+"/"+id+"/resources/"+resource+"/events"), @token)
+      else
+        get_request(address("/stacks/"+stack+"/"+id+"/resources/"+resource+"/events/"+event), @token)
+      end 
+    end
+
+    def stack_template(name, id)
+      get_request(address("/stacks/" + name + "/" + id), @token)
+    end
+
+    def validate_template(template, isURL)
+      data = {}
+      if isURL
+        data[:template_url] = template
+      else
+        data[:template] = template
+      end
+      post_request(address("/validate"), data, @token)
+    end
+
+    def build_info
+      get_request(address("/build_info"), @token)
+    end
+
+    def software_configs(id)
+      get_request(address("/software_configs/" + id), @token)
+    end
+
+    # TODO
+    def create_software_config
+    end
+
+    def delete_software_config(id)
+      delete_request(address("/software_configs/" + id), @token)
+    end
+
+    def software_deployments(id = nil)
+      if id.nil?
+        get_request(address("/software_deployments"), @token)
+      else
+        get_request(address("/software_deployments/" + id), @token)
+      end
+    end
+
+    def server_software_deployment(server)
+      get_request(address("/software_deployments/metadata/"+server), @token)
+    end
+
+    # TODO 
+    def create_software_deployment
+    end
+
+    # TODO 
+    def update_software_deployment(id)
+    end
+
+    def delete_software_deployment(id)
+      delete_request(address("/software_deployments/" + id), @token)
+    end
+
+    def version
+      "V1"
+    end
+  end
+end