profitbricks-sdk-ruby 1.0.2

data/lib/profitbricks/server.rb

@@ -0,0 +1,165 @@
+module ProfitBricks
+  # Server class
+  class Server < ProfitBricks::Model
+
+    # Delete the server.
+    def delete
+      ProfitBricks.request(
+        method: :delete,
+        path: "/datacenters/#{self.datacenterId}/servers/#{self.id}",
+        expects: 202
+      )
+    end
+
+    # Update the server.
+    def update(options = {})
+      response = ProfitBricks.request(
+        method: :patch,
+        path: "/datacenters/#{self.datacenterId}/servers/#{self.id}",
+        expects: 202,
+        body: options.to_json
+      )
+      if response
+        @properties = @properties.merge(response['properties'])
+      end
+      self
+    end
+
+    # Start the server.
+    def start
+      server_control('start')
+    end
+
+    # Stop the server.
+    def stop
+      server_control('stop')
+    end
+
+    # Reboot the server.
+    def reboot
+      server_control('reboot')
+    end
+
+    # List server volumes.
+    def list_volumes
+      ProfitBricks::Volume.list(self.datacenterId, self.id)
+    end
+
+    # Retrieve server volume.
+    def get_volume(volume_id)
+      ProfitBricks::Volume.get(self.datacenterId, self.id, volume_id)
+    end
+
+    # Attach volume to server.
+    def attach_volume(volume_id)
+      volume = ProfitBricks::Volume.get(self.datacenterId, nil, volume_id)
+      volume.attach(self.id)
+    end
+
+    # Detach volume from server.
+    def detach_volume(volume_id)
+      volume = ProfitBricks::Volume.get(self.datacenterId, nil, volume_id)
+      volume.detach(self.id)
+    end
+
+    def list_cdroms
+      response = ProfitBricks.request(
+        method: :get,
+        path: "/datacenters/#{self.datacenterId}/servers/#{self.id}/cdroms",
+        expects: 200
+      )
+      self.class.instantiate_objects(response)
+    end
+
+    def get_cdrom(cdrom_id)
+      response = ProfitBricks.request(
+        method: :get,
+        path: "/datacenters/#{self.datacenterId}/servers/#{self.id}/cdroms/#{cdrom_id}",
+        expects: 200
+      )
+      self.class.instantiate_objects(response)
+    end
+
+    def attach_cdrom(cdrom_id)
+      response = ProfitBricks.request(
+        method: :post,
+        path: "/datacenters/#{self.datacenterId}/servers/#{self.id}/cdroms",
+        expects: 202,
+        body: { id: cdrom_id }.to_json
+      )
+      self.class.instantiate_objects(response)
+    end
+
+    def detach_cdrom(cdrom_id)
+      ProfitBricks.request(
+        method: :delete,
+        path: "/datacenters/#{self.datacenterId}/servers/#{self.id}/cdroms/#{cdrom_id}",
+        expects: 202
+      )
+    end
+
+    # List server NICs.
+    def list_nics
+      ProfitBricks::NIC.list(self.datacenterId, self.id)
+    end
+
+    # Retrieve server NIC.
+    def get_nic(nic_id)
+      ProfitBricks::NIC.get(self.datacenterId, self.id, nic_id)
+    end
+
+    # Create server NIC.
+    def create_nic(options = {})
+      ProfitBricks::NIC.create(self.datacenterId, self.id, options)
+    end
+
+    alias_method :nics, :list_nics
+    alias_method :nic, :get_nic
+
+    class << self
+      # Create a new server.
+      def create(datacenter_id, options = {})
+        response = ProfitBricks.request(
+          method: :post,
+          path: "/datacenters/#{datacenter_id}/servers",
+          expects: 202,
+          body: { properties: options }.to_json
+        )
+        add_parent_identities(response)
+        instantiate_objects(response)
+      end
+
+      # List all servers by datacenter.
+      def list(datacenter_id)
+        response = ProfitBricks.request(
+          method: :get,
+          path: "/datacenters/#{datacenter_id}/servers",
+          expects: 200
+        )
+        add_parent_identities(response)
+        instantiate_objects(response)
+      end
+
+      def get(datacenter_id, server_id)
+        response = ProfitBricks.request(
+          method: :get,
+          path: "/datacenters/#{datacenter_id}/servers/#{server_id}",
+          expects: 200
+        )
+        add_parent_identities(response)
+        instantiate_objects(response)
+      end
+    end
+
+    private
+
+    def server_control(operation)
+      ProfitBricks.request(
+        method: :post,
+        path: "/datacenters/#{self.datacenterId}/servers/#{self.id}/#{operation}",
+        headers: { 'Content-Type' => 'application/x-www-form-urlencoded' },
+        expects: 202
+      )
+    end
+  end
+end

data/lib/profitbricks/snapshot.rb

@@ -0,0 +1,78 @@
+module ProfitBricks
+  # Snapshot class
+  class Snapshot < ProfitBricks::Model
+
+    # Delete the snapshot.
+    def delete
+      ProfitBricks.request(
+        method: :delete,
+        path: "/snapshots/#{self.id}",
+        expects: 202
+      )
+    end
+
+    # Update the snapshot.
+    def update(options = {})
+      response = ProfitBricks.request(
+        method: :patch,
+        path: "/snapshots/#{self.id}",
+        expects: 202,
+        body: options.to_json
+      )
+      if response
+        @properties = @properties.merge(response['properties'])
+      end
+      self
+    end
+
+    # Restore snapshot to volume.
+    def restore(datacenter_id, volume_id)
+      volume = ProfitBricks::Volume.get(datacenter_id, nil, volume_id)
+      volume.restore_snapshot(self.id)
+    end
+
+    class << self
+
+      # Create snapshot from volume.
+      def create(datacenter_id, volume_id, options = {})
+        volume = ProfitBricks::Volume.get(datacenter_id, nil, volume_id)
+        volume.create_snapshot(options)
+      end
+
+      # Testing snapshot create from within Snapshot class, but currently
+      # relying on Volume class due to lack of datacenter ID in response.
+      #
+      # def create(datacenter_id, volume_id, options = {})
+      #   response = ProfitBricks.request(
+      #     method: :post,
+      #     path: "/datacenters/#{datacenter_id}/volumes/#{volume_id}/create-snapshot",
+      #     expects: 202,
+      #     headers: { 'Content-Type' => 'application/x-www-form-urlencoded' },
+      #     body: URI.encode_www_form(options)
+      #   )
+      #   add_parent_identities(response)
+      #   instatiate_objects(response)
+      # end
+
+      # List all snapshots.
+      def list
+        response = ProfitBricks.request(
+          method: :get,
+          path: '/snapshots',
+          expects: 200
+        )
+        instantiate_objects(response)
+      end
+
+      # Retrieve an snapshot.
+      def get(snapshot_id)
+        response = ProfitBricks.request(
+          method: :get,
+          path: "/snapshots/#{snapshot_id}",
+          expects: 200
+        )
+        instantiate_objects(response)
+      end
+    end
+  end
+end

data/lib/profitbricks/version.rb

@@ -0,0 +1,3 @@
+module ProfitBricks
+  VERSION = "1.0.2"
+end

data/lib/profitbricks/volume.rb

@@ -0,0 +1,199 @@
+module ProfitBricks
+  # Volume class
+  class Volume < ProfitBricks::Model
+
+    # Delete the volume.
+    def delete
+      ProfitBricks.request(
+        method: :delete,
+        path: "/datacenters/#{self.datacenterId}/volumes/#{self.id}",
+        expects: 202
+      )
+    end
+
+    # Update the volume.
+    def update(options = {})
+      response = ProfitBricks.request(
+        method: :patch,
+        path: "/datacenters/#{self.datacenterId}/volumes/#{self.id}",
+        expects: 202,
+        body: options.to_json
+      )
+      if response
+        @properties = @properties.merge(response['properties'])
+      end
+      self
+    end
+
+    # Attach volume to server.
+    def attach(server_id)
+      response = ProfitBricks.request(
+        method: :post,
+        path: "/datacenters/#{self.datacenterId}/servers/#{server_id}/volumes",
+        expects: 202,
+        body: { id: self.id }.to_json
+      )
+      self
+    end
+
+    # Detach volume from server.
+    def detach(server_id)
+      ProfitBricks.request(
+        method: :delete,
+        path: "/datacenters/#{self.datacenterId}/servers/#{server_id}/volumes/#{self.id}",
+        expects: 202
+      )
+    end
+
+    # Create volume snapshot.
+    #
+    # ==== Parameters
+    # * +options+<Hash>:
+    #   - +name+<String> - *Optional*, name of the snapshot
+    #   - +description+<String> - *Optional*, description of the snapshot
+    #
+    # ==== Returns
+    # * +id+<String> - Universally unique identifer of resource
+    # * +type+<String> - Resource type
+    # * +href+<String> - Resource URL representation
+    # * +metadata+<Hash>:
+    #   - +lastModifiedDate+
+    #   - +lastModifiedBy+
+    #   - +createdDate+
+    #   - +createdBy+
+    #   - +state+
+    #   - +etag+
+    # * +properties+<Hash>:
+    #   - +name+<Integer>
+    #   - +description+<Array>
+    #   - +location+<String>
+    #   - +cpuHotPlug+<Boolean>
+    #   - +cpuHotUnPlug+<Boolean>
+    #   - +ramHotPlug+<Boolean>
+    #   - +ramHotUnPlug+<Boolean>
+    #   - +nicHotPlug+<Boolean>
+    #   - +nicHotUnPlug+<Boolean>
+    #   - +discVirtioHotPlug+<Boolean>
+    #   - +discVirtioHotUnPlug+<Boolean>
+    #   - +discScsiHotPlug+<Boolean>
+    #   - +discScsiHotUnPlug+<Boolean>
+    #   - +licenceType+<String>
+    #
+    def create_snapshot(options = {})
+      response = ProfitBricks.request(
+        method: :post,
+        path: "/datacenters/#{self.datacenterId}/volumes/#{self.id}/create-snapshot",
+        headers: { 'Content-Type' => 'application/x-www-form-urlencoded' },
+        expects: 202,
+        body: URI.encode_www_form(options)
+      ) 
+      ProfitBricks::Snapshot.new(response)
+    end
+
+    # Restore snapshot to volume.
+    #
+    # ==== Parameters
+    # * +snapshot_id+<String>: Universally unique identifer of snapshot resource
+    #
+    # ==== Returns
+    # * +true+<Boolean>
+    #
+    def restore_snapshot(snapshot_id)
+      ProfitBricks.request(
+        method: :post,
+        path: "/datacenters/#{self.datacenterId}/volumes/#{self.id}/restore-snapshot",
+        headers: { 'Content-Type' => 'application/x-www-form-urlencoded' },
+        expects: 202,
+        body: URI.encode_www_form(snapshotId: snapshot_id)
+      ) 
+    end
+
+    class << self
+
+      # Create a new volume.
+      #
+      # ==== Parameters
+      # * +options+<Hash>:
+      #   - +name+<String> - *Optional*, name of the volume
+      #   - +size+<Integer> - *Required*, size of the volume in GB
+      #   - +bus+<String> - *Optional*, the bus type of the volume
+      #     * +VIRTIO+ - *Default*
+      #     * +IDE+
+      #   - +image+<String> - *Optional*, image or snapshot ID
+      #
+      # ==== Returns
+      # * +id+<String> - Universally unique identifer of resource
+      # * +type+<String> - Resource type
+      # * +href+<String> - Resource URL representation
+      # * +metadata+<Hash>:
+      #   - +lastModifiedDate+
+      #   - +lastModifiedBy+
+      #   - +createdDate+
+      #   - +createdBy+
+      #   - +state+
+      #   - +etag+
+      # * +properties+<Hash>:
+      #   - +name+<String>
+      #   - +size+<Integer>
+      #   - +bus+<String>
+      #   - +image+<String>
+      #   - +imagePassword+<String>
+      #   - +type+<String>
+      #   - +licenseType+<String>
+      #   - +cpuHotPlug+<Boolean>
+      #   - +cpuHotUnPlug+<Boolean>
+      #   - +ramHotPlug+<Boolean>
+      #   - +ramHotUnPlug+<Boolean>
+      #   - +nicHotPlug+<Boolean>
+      #   - +nicHotUnPlug+<Boolean>
+      #   - +discVirtioHotPlug+<Boolean>
+      #   - +discVirtioHotUnPlug+<Boolean>
+      #   - +discScsiHotPlug+<Boolean>
+      #   - +discScsiHotUnPlug+<Boolean>
+      #
+      def create(datacenter_id, options = {})
+        options[:licenceType] ||= 'UNKNOWN'
+        response = ProfitBricks.request(
+          method: :post,
+          path: "/datacenters/#{datacenter_id}/volumes",
+          expects: 202,
+          body: { properties: options }.to_json
+        )
+        add_parent_identities(response)
+        instantiate_objects(response)
+      end
+
+      # List all datacenter volumes.
+      def list(datacenter_id, server_id = nil)
+        if server_id.nil?
+          path = "/datacenters/#{datacenter_id}/volumes"
+        else
+          path = "/datacenters/#{datacenter_id}/servers/#{server_id}/volumes"
+        end
+        response = ProfitBricks.request(
+          method: :get,
+          path: path,
+          expects: 200
+        )
+        add_parent_identities(response)
+        instantiate_objects(response)
+      end
+
+      # Retrieve a datacenter volume.
+      def get(datacenter_id, server_id = nil, volume_id)
+        if server_id.nil?
+          path = "/datacenters/#{datacenter_id}/volumes/#{volume_id}"
+        else
+          path = "/datacenters/#{datacenter_id}/servers/#{server_id}/volumes/#{volume_id}"
+        end
+        response = ProfitBricks.request(
+          method: :get,
+          path: path,
+          expects: 200
+        )
+        add_parent_identities(response)
+        instantiate_objects(response)
+      end
+    end
+  end
+end

data/lib/profitbricks/wait_for.rb

@@ -0,0 +1,16 @@
+module ProfitBricks
+  def self.wait_for(timeout = ProfitBricks::Config.timeout, interval = ProfitBricks::Config.interval, &_block)
+    duration = 0
+    start = Time.now
+    retries = 0
+    until yield || duration > timeout
+      sleep(interval.respond_to?(:call) ? interval.call(retries += 1).to_f : interval.to_f)
+      duration = Time.now - start
+    end
+    if duration > timeout
+      raise StandardError, "The specified wait_for timeout (#{timeout} seconds) was exceeded"
+    else
+      { :duration => duration }
+    end
+  end
+end

data/lib/profitbricks.rb

@@ -0,0 +1,24 @@
+require 'excon'
+require 'json'
+require 'uri'
+
+# Top-level module
+module ProfitBricks
+  require 'profitbricks/version'
+  require 'profitbricks/config'
+  require 'profitbricks/profitbricks'
+  require 'profitbricks/model'
+  require 'profitbricks/datacenter'
+  require 'profitbricks/server'
+  require 'profitbricks/volume'
+  require 'profitbricks/snapshot'
+  require 'profitbricks/nic'
+  require 'profitbricks/firewall'
+  require 'profitbricks/lan'
+  require 'profitbricks/loadbalancer'
+  require 'profitbricks/ipblock'
+  require 'profitbricks/image'
+  require 'profitbricks/location'
+  require 'profitbricks/request'
+  require 'profitbricks/wait_for'
+end

data/profitbricks-sdk-ruby.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'profitbricks/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "profitbricks-sdk-ruby"
+  spec.version       = ProfitBricks::VERSION
+  spec.authors       = ["Ethan Devenport"]
+  spec.email         = ["ethand@stackpointcloud.com"]
+  spec.summary       = %q{Official ProfitBricks SDK for Ruby}
+  spec.description   = %q{The ProfitBricks SDK for Ruby provides integration with the ProfitBricks cloud environment over the available REST API.}
+  spec.homepage      = "https://github.com/profitbricks/profitbricks-sdk-ruby"
+  spec.license       = "Apache"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency "excon", "~> 0.44"
+  spec.add_runtime_dependency "json", "~> 1.8"
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake", "~> 10.4"
+  spec.add_development_dependency "rspec", "~> 3.2"
+end