nephophobia 0.2.0 → 0.3.0

data/README.md

@@ -25,3 +25,7 @@ ruby 1.9.2
 Tests can run offline thanks to [VCR](https://github.com/myronmarston/vcr).
 
     $ bundle exec rake
+
+## TODO
+
+* Should really handle users better.  Once you have a user object perform actions on it vs passing user all over the place.

data/lib/nephophobia/client.rb

@@ -82,7 +82,7 @@ module Nephophobia
     # Provide a simple interface to the OpenStack Project resources.
 
     def project
-      @path      = "/services/Admin/"
+      @path      = "/services/Admin"
       @project ||= Nephophobia::Project.new self
     end
 
@@ -90,7 +90,7 @@ module Nephophobia
     # Provide a simple interface to the OpenStack User resources.
 
     def user
-      @path   = "/services/Admin/"
+      @path   = "/services/Admin"
       @user ||= Nephophobia::User.new self
     end
 
@@ -98,7 +98,7 @@ module Nephophobia
     # Provide a simple interface to the OpenStack Role resources.
 
     def role
-      @path   = "/services/Admin/"
+      @path   = "/services/Admin"
       @role ||= Nephophobia::Role.new self
     end
   end

data/lib/nephophobia/compute.rb

@@ -28,13 +28,22 @@ module Nephophobia
   end
 
   class VncData
-    attr_reader :url
+    attr_reader :attributes, :url
 
     def initialize attributes
       @url = attributes['url']
     end
   end
 
+  class AddressData
+    attr_reader :attributes, :floating_ip, :status
+
+    def initialize attributes
+      @floating_ip = attributes['publicIp']
+      @status      = attributes['item']
+    end
+  end
+
   class Compute
     def initialize client
       @client = client
@@ -158,7 +167,7 @@ module Nephophobia
 
     ##
     # Returns the VNC browser URL.  Used by the Portal.
-    # __Must__ have an +admin+ role to use.
+    # __Must__ execute as a user with the +admin+ role.
     #
     # +instance_id+: A String representing the ID of the instance.
 
@@ -171,5 +180,64 @@ module Nephophobia
 
       VncData.new response.body['GetVncConsoleResponse']
     end
+
+    ##
+    # Acquires an elastic IP address.
+    # Returns an elastic IP.
+
+    def allocate_address
+      response = @client.action "AllocateAddress", {}
+
+      AddressData.new response.body['AllocateAddressResponse']
+    end
+
+    ##
+    # Releases an elastic IP address.
+    #
+    # +floating_ip+: A String representing a floating IP address.
+
+    def release_address floating_ip
+      params = {
+        "PublicIp" => floating_ip
+      }
+
+      response = @client.action "ReleaseAddress", params
+
+      AddressData.new response.body['ReleaseAddressResponse']['releaseResponse']
+    end
+
+    ##
+    # Associates an elastic IP address with an instance.
+    #
+    # +instance_id+: A String representing the ID of the instance.
+    # +floating_ip+: A String representing a floating IP address.
+
+    def associate_address instance_id, floating_ip
+      params = {
+        "InstanceId" => instance_id,
+        "PublicIp"   => floating_ip
+      }
+
+      response = @client.action "AssociateAddress", params
+
+      AddressData.new response.body['AssociateAddressResponse']['associateResponse']
+    end
+
+    ##
+    # Disassociates the specified elastic IP address from the instance
+    # to which it is assigned.
+    #
+    # +instance_id+: A String representing the ID of the instance.
+    # +floating_ip+: A String representing a floating IP address.
+
+    def disassociate_address floating_ip
+      params = {
+        "PublicIp" => floating_ip
+      }
+
+      response = @client.action "DisassociateAddress", params
+
+      AddressData.new response.body['DisassociateAddressResponse']['disassociateResponse']
+    end
   end
 end

data/lib/nephophobia/credential.rb

@@ -61,24 +61,5 @@ module Nephophobia
 
       ResponseData.new response.body['DeleteKeyPairResponse']
     end
-
-    ##
-    # Returns the credentials for a given 'user_name' for the specified 'project_name'.
-    #
-    # +user_name+: A String containing a nova user_name.
-    # +project_name+: A String containing a nova project_name name.
-    #
-    # TODO: Determine why it fails in Nova when a user is in more than one project.
-
-    #def download user_name, project_name
-    #  params = {
-    #    "Name"    => user_name,
-    #    "Project" => project_name
-    #  }
-
-    #  response = @client.action "GenerateX509ForUser", params
-
-    #  Base64.decode64 response.body['GenerateX509ForUserResponse']['file']
-    #end
   end
 end

data/lib/nephophobia/project.rb

@@ -1,3 +1,6 @@
+##
+# __Must__ execute as a user with the +admin+ role.
+
 module Nephophobia
   class ProjectData
     attr_reader :name, :manager_id, :description

data/lib/nephophobia/role.rb

@@ -1,3 +1,6 @@
+##
+# __Must__ execute as a user with the +admin+ role.
+
 module Nephophobia
   class RoleData
     attr_reader :name

data/lib/nephophobia/user.rb

@@ -1,3 +1,6 @@
+##
+# __Must__ execute as a user with the +admin+ role.
+
 module Nephophobia
   class UserData
     attr_reader :accesskey, :username, :secretkey
@@ -30,6 +33,23 @@ module Nephophobia
       UserData.new response.body['RegisterUserResponse']
     end
 
+    ##
+    # Returns the credentials for a given 'user_name' for the specified 'project_name'.
+    #
+    # +user_name+: A String containing a nova user_name.
+    # +project_name+: A String containing a nova project_name name.
+
+    def credentials user_name, project_name
+      params = {
+        "Name"    => user_name,
+        "Project" => project_name
+      }
+
+      response = @client.action "GenerateX509ForUser", params
+
+      Base64.decode64 response.body['GenerateX509ForUserResponse']['file']
+    end
+
     ##
     # Removes the given 'user_name'.
     # Returns a response to the state change.

data/lib/nephophobia/version.rb

@@ -1,3 +1,3 @@
 module Nephophobia
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

data/nephophobia.gemspec

@@ -7,8 +7,8 @@ Gem::Specification.new do |s|
   s.version     = Nephophobia::VERSION
   s.platform    = Gem::Platform::RUBY
   s.authors     = ["John Dewey", "Josh Kleinpeter"]
-  s.email       = ["jdewey@attinteractive.com", "jkleinpeter@attinteractive.com"]
-  s.homepage    = ""
+  s.email       = ["john@dewey.ws", "jkleinpeter@attinteractive.com"]
+  s.homepage    = "http://github.com/retr0h/nephophobia"
   s.summary     = %q{Bindings to EC2/OpenStack}
   s.description = %q{This gem is a simple binding to the EC2 API. It has specific extensions to allow extra functionality provided by OpenStack.}
 

data/test/cassettes/compute_allocate_address.yml

@@ -0,0 +1,55 @@
+--- 
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :get
+    uri: http://10.3.170.35:8773/services/Cloud?AWSAccessKeyId=2ea76797-229c-4e52-a21b-f30513cb91a6%3Asandbox&Action=AllocateAddress&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=1999-12-31T19%3A59%3A59Z&Version=2010-11-15&Signature=bCaGs5tWfNNy%2F3sg%2FRP0ISHMEnT0EZzuoPe%2Fcconzn8%3D
+    body: 
+    headers: 
+      accept: 
+      - application/xml
+      connection: 
+      - keep-alive
+      keep-alive: 
+      - 30
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 200
+      message: OK
+    headers: 
+      content-type: 
+      - text/xml
+      content-length: 
+      - "194"
+      date: 
+      - Wed, 25 May 2011 22:30:56 GMT
+      connection: 
+      - keep-alive
+    body: <?xml version="1.0" ?><AllocateAddressResponse xmlns="http://ec2.amazonaws.com/doc/2010-11-15/"><requestId>PW8TPJTX8XSPDPTNSAIR</requestId><publicIp>69.1.1.1</publicIp></AllocateAddressResponse>
+    http_version: "1.1"
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :get
+    uri: http://10.3.170.35:8773/services/Cloud?AWSAccessKeyId=2ea76797-229c-4e52-a21b-f30513cb91a6%3Asandbox&Action=ReleaseAddress&PublicIp=69.1.1.1&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=1999-12-31T19%3A59%3A59Z&Version=2010-11-15&Signature=lQpO7lKIr7pdJWi7J%2FWS3T6e6X%2FYjVixw2qaK%2FJyS30%3D
+    body: 
+    headers: 
+      accept: 
+      - application/xml
+      connection: 
+      - keep-alive
+      keep-alive: 
+      - 30
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 200
+      message: OK
+    headers: 
+      content-type: 
+      - text/xml
+      content-length: 
+      - "228"
+      date: 
+      - Wed, 25 May 2011 22:30:56 GMT
+      connection: 
+      - keep-alive
+    body: <?xml version="1.0" ?><ReleaseAddressResponse xmlns="http://ec2.amazonaws.com/doc/2010-11-15/"><requestId>6RRU8VV0CEG-SPEB5KKP</requestId><releaseResponse><item>Address released.</item></releaseResponse></ReleaseAddressResponse>
+    http_version: "1.1"

data/test/cassettes/compute_allocate_address_when_not_available.yml

@@ -0,0 +1,30 @@
+--- 
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :get
+    uri: http://10.3.170.35:8773/services/Cloud?AWSAccessKeyId=2ea76797-229c-4e52-a21b-f30513cb91a6%3Asandbox&Action=AllocateAddress&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=1999-12-31T19%3A59%3A59Z&Version=2010-11-15&Signature=bCaGs5tWfNNy%2F3sg%2FRP0ISHMEnT0EZzuoPe%2Fcconzn8%3D
+    body: 
+    headers: 
+      accept: 
+      - application/xml
+      connection: 
+      - keep-alive
+      keep-alive: 
+      - 30
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 400
+      message: Bad Request
+    headers: 
+      content-type: 
+      - text/xml
+      content-length: 
+      - "223"
+      date: 
+      - Wed, 25 May 2011 20:18:57 GMT
+      connection: 
+      - keep-alive
+    body: |-
+      <?xml version="1.0"?>
+      <Response><Errors><Error><Code>UnknownError</Code><Message>An unknown error has occurred. Please try your request again.</Message></Error></Errors><RequestID>XMJSQ3C9JVKG8425FI48</RequestID></Response>
+    http_version: "1.1"

data/test/cassettes/compute_associate_address.yml

@@ -0,0 +1,136 @@
+--- 
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :get
+    uri: http://10.3.170.35:8773/services/Cloud?AWSAccessKeyId=2ea76797-229c-4e52-a21b-f30513cb91a6%3Asandbox&Action=RunInstances&ImageId=ami-00000002&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=1999-12-31T19%3A59%3A59Z&Version=2010-11-15&Signature=tPz8K7mYsXFNuGeGmQCf3JFCOWsQ5iGKP%2B4CU1PUoOI%3D
+    body: 
+    headers: 
+      accept: 
+      - application/xml
+      connection: 
+      - keep-alive
+      keep-alive: 
+      - 30
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 200
+      message: OK
+    headers: 
+      content-type: 
+      - text/xml
+      content-length: 
+      - "838"
+      date: 
+      - Wed, 25 May 2011 21:22:10 GMT
+      connection: 
+      - keep-alive
+    body: <?xml version="1.0" ?><RunInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2010-11-15/"><requestId>MJCBI4431XGHED2QAQUU</requestId><ownerId>sandbox</ownerId><groupSet><item><groupId>default</groupId></item></groupSet><reservationId>r-cqy0q7w3</reservationId><instancesSet><item><displayDescription/><displayName>Server 64</displayName><keyName>None (sandbox, None)</keyName><instanceId>i-00000040</instanceId><instanceState><code>0</code><name>scheduling</name></instanceState><publicDnsName/><imageId>ami-00000002</imageId><productCodesSet/><privateDnsName/><dnsName/><launchTime>2011-05-25T21:22:09Z</launchTime><amiLaunchIndex>0</amiLaunchIndex><placement><availabilityZone>unknown zone</availabilityZone></placement><ipAddress/><instanceType>m1.small</instanceType><privateIpAddress/></item></instancesSet></RunInstancesResponse>
+    http_version: "1.1"
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :get
+    uri: http://10.3.170.35:8773/services/Cloud?AWSAccessKeyId=2ea76797-229c-4e52-a21b-f30513cb91a6%3Asandbox&Action=AssociateAddress&InstanceId=i-00000040&PublicIp=69.1.1.1&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=1999-12-31T19%3A59%3A59Z&Version=2010-11-15&Signature=BPjJhW8InPmLYkhbNoDw6wcpuAZ1seaX0m1PFsLj%2FY8%3D
+    body: 
+    headers: 
+      accept: 
+      - application/xml
+      connection: 
+      - keep-alive
+      keep-alive: 
+      - 30
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 200
+      message: OK
+    headers: 
+      content-type: 
+      - text/xml
+      content-length: 
+      - "238"
+      date: 
+      - Wed, 25 May 2011 21:22:15 GMT
+      connection: 
+      - keep-alive
+    body: <?xml version="1.0" ?><AssociateAddressResponse xmlns="http://ec2.amazonaws.com/doc/2010-11-15/"><requestId>H9IDU1-TG51CLYOMVT76</requestId><associateResponse><item>Address associated.</item></associateResponse></AssociateAddressResponse>
+    http_version: "1.1"
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :get
+    uri: http://10.3.170.35:8773/services/Cloud?AWSAccessKeyId=2ea76797-229c-4e52-a21b-f30513cb91a6%3Asandbox&Action=TerminateInstances&InstanceId.1=i-00000040&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=1999-12-31T19%3A59%3A59Z&Version=2010-11-15&Signature=%2FR%2FjPbTCgci4Ip2a0N0nO5F9KPU%2Bney9Ji5CrHbd4GI%3D
+    body: 
+    headers: 
+      accept: 
+      - application/xml
+      connection: 
+      - keep-alive
+      keep-alive: 
+      - 30
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 200
+      message: OK
+    headers: 
+      content-type: 
+      - text/xml
+      content-length: 
+      - "192"
+      date: 
+      - Wed, 25 May 2011 21:22:15 GMT
+      connection: 
+      - keep-alive
+    body: <?xml version="1.0" ?><TerminateInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2010-11-15/"><requestId>IH7PO8M4R6RCMR8B8PEV</requestId><return>true</return></TerminateInstancesResponse>
+    http_version: "1.1"
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :get
+    uri: http://10.3.170.35:8773/services/Cloud?AWSAccessKeyId=2ea76797-229c-4e52-a21b-f30513cb91a6%3Asandbox&Action=AllocateAddress&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=1999-12-31T19%3A59%3A59Z&Version=2010-11-15&Signature=bCaGs5tWfNNy%2F3sg%2FRP0ISHMEnT0EZzuoPe%2Fcconzn8%3D
+    body: 
+    headers: 
+      accept: 
+      - application/xml
+      connection: 
+      - keep-alive
+      keep-alive: 
+      - 30
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 200
+      message: OK
+    headers: 
+      content-type: 
+      - text/xml
+      content-length: 
+      - "194"
+      date: 
+      - Wed, 25 May 2011 22:39:52 GMT
+      connection: 
+      - keep-alive
+    body: <?xml version="1.0" ?><AllocateAddressResponse xmlns="http://ec2.amazonaws.com/doc/2010-11-15/"><requestId>7URCU5WTAPD50ZXP9RH0</requestId><publicIp>69.1.1.1</publicIp></AllocateAddressResponse>
+    http_version: "1.1"
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :get
+    uri: http://10.3.170.35:8773/services/Cloud?AWSAccessKeyId=2ea76797-229c-4e52-a21b-f30513cb91a6%3Asandbox&Action=ReleaseAddress&PublicIp=69.1.1.1&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=1999-12-31T19%3A59%3A59Z&Version=2010-11-15&Signature=lQpO7lKIr7pdJWi7J%2FWS3T6e6X%2FYjVixw2qaK%2FJyS30%3D
+    body: 
+    headers: 
+      accept: 
+      - application/xml
+      connection: 
+      - keep-alive
+      keep-alive: 
+      - 30
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 200
+      message: OK
+    headers: 
+      content-type: 
+      - text/xml
+      content-length: 
+      - "228"
+      date: 
+      - Wed, 25 May 2011 22:42:37 GMT
+      connection: 
+      - keep-alive
+    body: <?xml version="1.0" ?><ReleaseAddressResponse xmlns="http://ec2.amazonaws.com/doc/2010-11-15/"><requestId>61E-BMEKN9BB9BTXBP-Y</requestId><releaseResponse><item>Address released.</item></releaseResponse></ReleaseAddressResponse>
+    http_version: "1.1"