occi-api 4.0.0.alpha.1

data/examples/x509auth_example.rb

@@ -0,0 +1,161 @@
+require 'rubygems'
+require 'occi-api'
+require 'pp'
+
+## options
+use_os_temlate = true         # use OS_TEMPLATE or NETWORK + STORAGE + INSTANCE TYPE
+OS_TEMPLATE    = 'monitoring' # name of the VM template in ON
+
+clean_up_compute = true       # issue DELETE <RESOURCE> after we are done
+
+USER_CERT          = ENV['HOME'] + '/.globus/usercred.pem'
+USER_CERT_PASSWORD = 'mypassphrase'
+CA_PATH            = '/etc/grid-security/certificates'
+ENDPOINT           = 'https://localhost:3300'
+
+## get an OCCI::Api::Client::ClientHttp instance
+client = Occi::Api::Client::ClientHttp.new({
+  :endpoint => ENDPOINT,
+  :auth => {
+    :type               => "x509",
+    :user_cert          => USER_CERT,
+    :user_cert_password => USER_CERT_PASSWORD,
+    :ca_path            => CA_PATH
+  },
+  :log => {
+    :out   => STDERR,
+    :level => Occi::Log::DEBUG
+  }
+})
+
+puts "\n\nListing all available resource types:"
+client.get_resource_types.each do |type|
+  puts "\n#{type}"
+end
+
+puts "\n\nListing all available resource type identifiers:"
+client.get_resource_type_identifiers.each do |type_id|
+  puts "\n#{type_id}"
+end
+
+puts "\n\nListing all available mixin types:"
+client.get_mixin_types.each do |mixin_type|
+  puts "\n#{mixin_type}"
+end
+
+puts "\n\nListing all available mixin type identifiers:"
+client.get_mixin_type_identifiers.each do |mixin_typeid|
+  puts "\n#{mixin_typeid}"
+end
+
+puts "\n\nListing all available mixins:"
+client.get_mixins.each do |mixin|
+  puts "\n#{mixin}"
+end
+
+samples = [OS_TEMPLATE, "medium", "large", "small"]
+
+puts "\n\nFind mixins using their names:"
+samples.each do |mixin|
+  puts "\n#{mixin}:\n"
+  pp client.find_mixin mixin
+end
+
+puts "\n\nFind mixins using their names and a type:"
+samples.each do |mixin|
+  puts "\n#{mixin}:\n"
+  pp client.find_mixin(mixin, "os_tpl")
+end
+
+puts "\n\nFind mixins using their names and a type:"
+samples.each do |mixin|
+  puts "\n#{mixin}:\n"
+  pp client.find_mixin(mixin, "resource_tpl")
+end
+
+puts "\n\nFind mixins using their names (showing detailed descriptions):"
+samples.each do |mixin|
+  puts "\n#{mixin}:\n"
+  pp client.find_mixin(mixin, nil, true)
+end
+
+## get links of all available resources
+puts "\n\nListing storage resources"
+pp client.list "storage"
+
+puts "\n\nListing network resources"
+pp client.list "network"
+
+puts "\n\nListing compute resources"
+pp client.list "compute"
+
+## get detailed information about all available resources
+puts "\n\nDescribing storage resources"
+pp client.describe "storage"
+
+puts "\n\nDescribing compute resources"
+pp client.describe "compute"
+
+puts "\n\nDescribing network resources"
+pp client.describe "network"
+
+## create a compute resource using the chosen method (os_tpl|strg+ntwrk)
+puts "\n\nCreate compute resources"
+cmpt = client.get_resource "compute"
+
+unless use_os_temlate
+  ## without OS template, we have to manually select and attach
+  ## network, storage and resource template (instance type)
+
+  ## select instance type medium
+  cmpt.mixins << client.find_mixin('medium', "resource_tpl")
+
+  ## list network/storage locations and select the appropriate ones (the first ones in this case)
+  puts "\nUsing:"
+  pp storage_loc = client.list("storage")[0]
+  pp network_loc = client.list("network")[0]
+
+  ## create links and attach them to the compure resource
+  puts "\n Connecting to our compute:"
+  cmpt.storagelink storage_loc
+  cmpt.networkinterface network_loc
+else
+  ## with OS template, we have to find the template by name
+  ## optionally we can change its "size" by choosing an instance type
+  puts "\nUsing:"
+  pp os = client.find_mixin(OS_TEMPLATE, "os_tpl")
+  pp size = client.find_mixin('medium', "resource_tpl")
+
+  ## attach chosen resources to the compute resource
+  cmpt.mixins << os << size
+  ## we can change some of the values manually
+  cmpt.title = "My rOCCI x509 VM"
+end
+
+## create the compute resource and print its location
+cmpt_loc = client.create cmpt
+pp "Location of new compute resource: #{cmpt_loc}"
+
+## get links of all available compute resouces again
+puts "\n\nListing locations of compute resources (should now contain #{cmpt_loc})"
+pp client.list "compute"
+
+## get detailed information about the new compute resource
+puts "\n\nListing information about compute resource #{cmpt_loc}"
+cmpt_data = client.describe cmpt_loc
+pp cmpt_data
+
+## wait until the resource is "active"
+while cmpt_data[0].resources.first.attributes.occi.compute.state == "inactive"
+  puts "\nCompute resource #{cmpt_loc} is inactive, waiting ..."
+  sleep 1
+  cmpt_data = client.describe cmpt_loc
+end
+
+puts "\nCompute resource #{cmpt_loc} is #{cmpt_data[0].resources.first.attributes.occi.compute.state}"
+
+## delete the resource and exit
+if clean_up_compute
+  puts "\n\nDeleting compute resource #{cmpt_loc}"
+  pp client.delete cmpt_loc
+end

data/ext/mkrf_conf.rb

@@ -0,0 +1,34 @@
+require 'rubygems'
+require 'rubygems/command.rb'
+require 'rubygems/dependency_installer.rb' 
+
+begin
+  Gem::Command.build_args = ARGV
+rescue NoMethodError
+  # do nothing but warn the user
+  warn "Gem::Command doesn't have a method named 'build_args'!"
+end 
+
+warn 'Installing platform-specific dependencies.'
+
+warn 'Installing the most recent version of \'rake\''
+inst = Gem::DependencyInstaller.new
+inst.install "rake"
+
+if RUBY_PLATFORM == "java"
+  warn 'Installing dependencies specific for jRuby'
+
+  jrver = (JRUBY_VERSION || "").split('.').map{ |elm| elm.to_i }
+  if jrver[0] == 1 && jrver[1] < 7
+    warn 'Installing \'jruby-openssl\' for jRuby 1.6.x'
+    inst.install "jruby-openssl"
+  end
+else
+  # Nothing to install for rOCCI-api here
+  #warn 'Installing dependencies specific for Ruby'
+end
+
+# create dummy rakefile to indicate success
+f = File.open(File.join(File.dirname(__FILE__), "Rakefile"), "w")
+f.write "task :default\n"
+f.close

data/features/cassettes/Create_an_OCCI_Resource/_http_http___141_5_99_69__text_plain_201_.yml

@@ -0,0 +1,288 @@
+---
+http_interactions:
+- request:
+    method: head
+    uri: http://141.5.99.69/
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - text/plain,text/occi;q=0.2
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Thu, 10 Jan 2013 13:52:01 GMT
+      Server:
+      - Apache/2.2.22 (Ubuntu)
+      X-Powered-By:
+      - Phusion Passenger (mod_rails/mod_rack) 3.0.18
+      X-Frame-Options:
+      - sameorigin
+      X-Xss-Protection:
+      - 1; mode=block
+      Accept:
+      - application/occi+json,application/json,text/plain,text/uri-list,application/xml,text/xml,application/occi+xml,text/occi
+      Set-Cookie:
+      - rack.session=BAh7B0kiD3Nlc3Npb25faWQGOgZFRiJFMDg3MzljYWY5NzIxY2VlOWE0NjI0%0AYTIxNWJlNjNmYzZmMTMxMzAxNDU2YzlkMGM1YjU0OWU1ZDFkNTZkYTE5Zkki%0ADXRyYWNraW5nBjsARnsISSIUSFRUUF9VU0VSX0FHRU5UBjsARiItZGEzOWEz%0AZWU1ZTZiNGIwZDMyNTViZmVmOTU2MDE4OTBhZmQ4MDcwOUkiGUhUVFBfQUND%0ARVBUX0VOQ09ESU5HBjsARiItZGEzOWEzZWU1ZTZiNGIwZDMyNTViZmVmOTU2%0AMDE4OTBhZmQ4MDcwOUkiGUhUVFBfQUNDRVBUX0xBTkdVQUdFBjsARiItZGEz%0AOWEzZWU1ZTZiNGIwZDMyNTViZmVmOTU2MDE4OTBhZmQ4MDcwOQ%3D%3D%0A--ddb37075ac62fd3bda55c7fc4c29d508530b1d5d;
+        path=/; HttpOnly
+      Content-Length:
+      - '738'
+      Status:
+      - '200'
+      Vary:
+      - Accept-Encoding
+      Content-Type:
+      - text/plain;charset=utf-8
+    body:
+      encoding: US-ASCII
+      string: ''
+    http_version: 
+  recorded_at: Thu, 10 Jan 2013 13:52:41 GMT
+- request:
+    method: get
+    uri: http://141.5.99.69/-/
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - text/plain
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Thu, 10 Jan 2013 13:52:01 GMT
+      Server:
+      - Apache/2.2.22 (Ubuntu)
+      X-Powered-By:
+      - Phusion Passenger (mod_rails/mod_rack) 3.0.18
+      X-Frame-Options:
+      - sameorigin
+      X-Xss-Protection:
+      - 1; mode=block
+      Accept:
+      - application/occi+json,application/json,text/plain,text/uri-list,application/xml,text/xml,application/occi+xml,text/occi
+      Set-Cookie:
+      - rack.session=BAh7B0kiD3Nlc3Npb25faWQGOgZFRiJFNDQ2ZGUwN2IwNzRiNjM0ZTIxNGFh%0AMGRhMjUzZDRmY2ZjMDgwMTc1MjkzNjc2MGFhYTlkNmUzOWE4N2QyYjJmMEki%0ADXRyYWNraW5nBjsARnsISSIUSFRUUF9VU0VSX0FHRU5UBjsARiItZGEzOWEz%0AZWU1ZTZiNGIwZDMyNTViZmVmOTU2MDE4OTBhZmQ4MDcwOUkiGUhUVFBfQUND%0ARVBUX0VOQ09ESU5HBjsARiItZGEzOWEzZWU1ZTZiNGIwZDMyNTViZmVmOTU2%0AMDE4OTBhZmQ4MDcwOUkiGUhUVFBfQUNDRVBUX0xBTkdVQUdFBjsARiItZGEz%0AOWEzZWU1ZTZiNGIwZDMyNTViZmVmOTU2MDE4OTBhZmQ4MDcwOQ%3D%3D%0A--af7a5b05f9640950c2dd6dcd66eb00a201915e4c;
+        path=/; HttpOnly
+      Content-Length:
+      - '6397'
+      Status:
+      - '200'
+      Vary:
+      - Accept-Encoding
+      Content-Type:
+      - text/plain;charset=utf-8
+    body:
+      encoding: US-ASCII
+      string: ! 'Category: entity;scheme="http://schemas.ogf.org/occi/core#";class="kind";title="Entity";location="/entity/";attributes="occi.core.id
+        occi.core.title"
+
+        Category: resource;scheme="http://schemas.ogf.org/occi/core#";class="kind";title="Resource";rel="http://schemas.ogf.org/occi/core#entity";location="/resource/";attributes="occi.core.summary"
+
+        Category: link;scheme="http://schemas.ogf.org/occi/core#";class="kind";title="Link";rel="http://schemas.ogf.org/occi/core#entity";location="/link/";attributes="occi.core.target
+        occi.core.source"
+
+        Category: compute;scheme="http://schemas.ogf.org/occi/infrastructure#";class="kind";title="Compute
+        Resource";rel="http://schemas.ogf.org/occi/core#resource";location="/compute/";attributes="occi.compute.architecture
+        occi.compute.cores occi.compute.hostname occi.compute.speed occi.compute.memory
+        occi.compute.state";actions="http://schemas.ogf.org/occi/infrastructure/compute/action#start
+        http://schemas.ogf.org/occi/infrastructure/compute/action#stop http://schemas.ogf.org/occi/infrastructure/compute/action#restart
+        http://schemas.ogf.org/occi/infrastructure/compute/action#suspend"
+
+        Category: networkinterface;scheme="http://schemas.ogf.org/occi/infrastructure#";class="kind";title="Networkinterface";rel="http://schemas.ogf.org/occi/core#link";location="/networkinterface/";attributes="occi.networkinterface.interface
+        occi.networkinterface.mac occi.networkinterface.state"
+
+        Category: storage;scheme="http://schemas.ogf.org/occi/infrastructure#";class="kind";title="Storage
+        Resource";rel="http://schemas.ogf.org/occi/core#resource";location="/storage/";attributes="occi.storage.size
+        occi.storage.state";actions="http://schemas.ogf.org/occi/infrastructure/storage/action#online
+        http://schemas.ogf.org/occi/infrastructure/storage/action#offline http://schemas.ogf.org/occi/infrastructure/storage/action#backup
+        http://schemas.ogf.org/occi/infrastructure/storage/action#snapshot http://schemas.ogf.org/occi/infrastructure/storage/action#resize"
+
+        Category: network;scheme="http://schemas.ogf.org/occi/infrastructure#";class="kind";title="Network
+        Resource";rel="http://schemas.ogf.org/occi/core#resource";location="/network/";attributes="occi.network.vlan
+        occi.network.label occi.network.state";actions="http://schemas.ogf.org/occi/infrastructure/network/action#up
+        http://schemas.ogf.org/occi/infrastructure/network/action#down"
+
+        Category: storagelink;scheme="http://schemas.ogf.org/occi/infrastructure#";class="kind";title="Storage
+        Link";rel="http://schemas.ogf.org/occi/core#link";location="/storagelink/";attributes="occi.storagelink.deviceid
+        occi.storagelink.mountpoint occi.storagelink.state"
+
+        Category: ipnetwork;scheme="http://schemas.ogf.org/occi/infrastructure/network#";class="mixin";title="IP
+        Network Mixin";location="/mixins/ipnetwork/";attributes="occi.network.address
+        occi.network.gateway occi.network.allocation occi.network.state"
+
+        Category: resource_tpl;scheme="http://schemas.ogf.org/occi/infrastructure#";class="mixin";title="Resource
+        Template";location="/mixins/resource_tpl/"
+
+        Category: os_tpl;scheme="http://schemas.ogf.org/occi/infrastructure#";class="mixin";title="Operating
+        System Template";location="/mixins/os_tpl/"
+
+        Category: ipnetworkinterface;scheme="http://schemas.ogf.org/occi/infrastructure/networkinterface#";class="mixin";title="IP
+        Networkinterface Mixin";location="/mixins/ipnetworkinterface/";attributes="occi.networkinterface.address
+        occi.networkinterface.gateway occi.networkinterface.allocation occi.networkinterface.state"
+
+        Category: my_os;scheme="http://my.occi.service/occi/infrastructure/os_tpl#";class="mixin";title="My
+        OS Template";rel="http://schemas.ogf.org/occi/infrastructure#os_tpl";location="/mixins/my_os/"
+
+        Category: large;scheme="http://my.occi.service/occi/infrastructure/resource_tpl#";class="mixin";title="Large
+        Instance";rel="http://schemas.ogf.org/occi/infrastructure#resource_tpl";location="/mixins/large/";attributes="occi.compute.architecture
+        occi.compute.cores occi.compute.speed occi.compute.memory"
+
+        Category: small;scheme="http://my.occi.service/occi/infrastructure/resource_tpl#";class="mixin";title="Small
+        Instance";rel="http://schemas.ogf.org/occi/infrastructure#resource_tpl";location="/mixins/small/";attributes="occi.compute.architecture
+        occi.compute.cores occi.compute.speed occi.compute.memory"
+
+        Category: medium;scheme="http://my.occi.service/occi/infrastructure/resource_tpl#";class="mixin";title="Medium
+        Instance";rel="http://schemas.ogf.org/occi/infrastructure#resource_tpl";location="/mixins/medium/";attributes="occi.compute.architecture
+        occi.compute.cores occi.compute.speed occi.compute.memory"
+
+        Category: extra_large;scheme="http://my.occi.service/occi/infrastructure/resource_tpl#";class="mixin";title="Extra
+        Large Instance";rel="http://schemas.ogf.org/occi/infrastructure#resource_tpl";location="/mixins/extra_large/";attributes="occi.compute.architecture
+        occi.compute.cores occi.compute.speed occi.compute.memory"
+
+        Category: start;scheme="http://schemas.ogf.org/occi/infrastructure/compute/action#";class="action";title="Start
+        Compute instance"
+
+        Category: stop;scheme="http://schemas.ogf.org/occi/infrastructure/compute/action#";class="action";title="Stop
+        Compute instance";attributes="method"
+
+        Category: restart;scheme="http://schemas.ogf.org/occi/infrastructure/compute/action#";class="action";title="Restart
+        Compute instance";attributes="method"
+
+        Category: suspend;scheme="http://schemas.ogf.org/occi/infrastructure/compute/action#";class="action";title="Suspend
+        Compute instance";attributes="method"
+
+        Category: online;scheme="http://schemas.ogf.org/occi/infrastructure/storage/action#";class="action";title="Activate
+        Storage"
+
+        Category: offline;scheme="http://schemas.ogf.org/occi/infrastructure/storage/action#";class="action";title="Deactivate
+        Storage"
+
+        Category: backup;scheme="http://schemas.ogf.org/occi/infrastructure/storage/action#";class="action";title="Backup
+        Storage"
+
+        Category: snapshot;scheme="http://schemas.ogf.org/occi/infrastructure/storage/action#";class="action";title="Snapshot
+        Storage"
+
+        Category: resize;scheme="http://schemas.ogf.org/occi/infrastructure/storage/action#";class="action";title="Resize
+        Storage";attributes="size"
+
+        Category: up;scheme="http://schemas.ogf.org/occi/infrastructure/network/action#";class="action";title="Activate
+        network"
+
+        Category: down;scheme="http://schemas.ogf.org/occi/infrastructure/network/action#";class="action";title="Activate
+        network"
+
+'
+    http_version: 
+  recorded_at: Thu, 10 Jan 2013 13:52:41 GMT
+- request:
+    method: get
+    uri: http://141.5.99.69/
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - text/plain
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Tue, 12 Mar 2013 13:29:42 GMT
+      Server:
+      - Apache/2.2.22 (Ubuntu)
+      X-Powered-By:
+      - Phusion Passenger (mod_rails/mod_rack) 3.0.18
+      X-Frame-Options:
+      - sameorigin
+      X-Xss-Protection:
+      - 1; mode=block
+      Accept:
+      - application/occi+json,application/json,text/plain,text/uri-list,application/xml,text/xml,application/occi+xml,text/occi
+      Set-Cookie:
+      - rack.session=BAh7B0kiD3Nlc3Npb25faWQGOgZFRiJFNjFhMGNmNzdmMDUyOWRmMTBlNWRj%0AOGM2NjE0YWZmMGJjZTYxNDliYjY1OTVhM2E0MjcwNmJiMzJiM2Y2MjY1N0ki%0ADXRyYWNraW5nBjsARnsISSIUSFRUUF9VU0VSX0FHRU5UBjsARiItZGEzOWEz%0AZWU1ZTZiNGIwZDMyNTViZmVmOTU2MDE4OTBhZmQ4MDcwOUkiGUhUVFBfQUND%0ARVBUX0VOQ09ESU5HBjsARiItZGEzOWEzZWU1ZTZiNGIwZDMyNTViZmVmOTU2%0AMDE4OTBhZmQ4MDcwOUkiGUhUVFBfQUNDRVBUX0xBTkdVQUdFBjsARiItZGEz%0AOWEzZWU1ZTZiNGIwZDMyNTViZmVmOTU2MDE4OTBhZmQ4MDcwOQ%3D%3D%0A--c0f98b65169ac2a7e9b2849d1315a7649a2c4e32;
+        path=/; HttpOnly
+      Content-Length:
+      - '738'
+      Status:
+      - '200'
+      Vary:
+      - Accept-Encoding
+      Content-Type:
+      - text/plain;charset=utf-8
+    body:
+      encoding: US-ASCII
+      string: ! 'X-OCCI-Location:  http://141.5.99.69/compute/48e7c51c-5a7d-11e2-a300-fa163e16d22f
+
+        X-OCCI-Location:  http://141.5.99.69/compute/6c706278-5a7d-11e2-a300-fa163e16d22f
+
+        X-OCCI-Location:  http://141.5.99.69/compute/7582ffc4-5a7d-11e2-a300-fa163e16d22f
+
+        X-OCCI-Location:  http://141.5.99.69/compute/8eb0deb2-5a7d-11e2-a300-fa163e16d22f
+
+        X-OCCI-Location:  http://141.5.99.69/compute/8efa93e0-5a7d-11e2-a300-fa163e16d22f
+
+        X-OCCI-Location:  http://141.5.99.69/compute/49cbeaee-5b1d-11e2-a300-fa163e16d22f
+
+        X-OCCI-Location:  http://141.5.99.69/compute/c87fa76c-5b1e-11e2-a300-fa163e16d22f
+
+        X-OCCI-Location:  http://141.5.99.69/compute/1cc544b2-5b1f-11e2-a300-fa163e16d22f
+
+        X-OCCI-Location:  http://141.5.99.69/compute/38e2a6b2-5b1f-11e2-a300-fa163e16d22f
+
+'
+    http_version: 
+  recorded_at: Tue, 12 Mar 2013 13:29:35 GMT
+- request:
+    method: head
+    uri: http://141.5.99.69/
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - text/plain
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Tue, 12 Mar 2013 15:27:53 GMT
+      Server:
+      - Apache/2.2.22 (Ubuntu)
+      X-Powered-By:
+      - Phusion Passenger (mod_rails/mod_rack) 3.0.18
+      X-Frame-Options:
+      - sameorigin
+      X-Xss-Protection:
+      - 1; mode=block
+      Accept:
+      - application/occi+json,application/json,text/plain,text/uri-list,application/xml,text/xml,application/occi+xml,text/occi
+      Set-Cookie:
+      - rack.session=BAh7B0kiD3Nlc3Npb25faWQGOgZFRiJFOTdkZDQ1N2ZiYjdmMjE4NDgzNjMy%0AMzE0ZGI3YjRjOGIwZjMyNTY4ODRkZGVhNjE3NWM4OWI2MDRkNzJiMmFjOUki%0ADXRyYWNraW5nBjsARnsISSIUSFRUUF9VU0VSX0FHRU5UBjsARiItZGEzOWEz%0AZWU1ZTZiNGIwZDMyNTViZmVmOTU2MDE4OTBhZmQ4MDcwOUkiGUhUVFBfQUND%0ARVBUX0VOQ09ESU5HBjsARiItZGEzOWEzZWU1ZTZiNGIwZDMyNTViZmVmOTU2%0AMDE4OTBhZmQ4MDcwOUkiGUhUVFBfQUNDRVBUX0xBTkdVQUdFBjsARiItZGEz%0AOWEzZWU1ZTZiNGIwZDMyNTViZmVmOTU2MDE4OTBhZmQ4MDcwOQ%3D%3D%0A--222744ef8a6fa387cf796b175ba56ec13ea1fa93;
+        path=/; HttpOnly
+      Content-Length:
+      - '738'
+      Status:
+      - '200'
+      Vary:
+      - Accept-Encoding
+      Content-Type:
+      - text/plain;charset=utf-8
+    body:
+      encoding: US-ASCII
+      string: ''
+    http_version: 
+  recorded_at: Tue, 12 Mar 2013 15:27:46 GMT
+recorded_with: VCR 2.4.0