Documentation

The Deltacloud documentation is divided into the following parts:

-
-
-

-
- +
+
+

+
+

Install Deltacloud

This page lists the libraries and packages that you will need in order to install the Deltacloud server, a "Hello Deltacloud" quick-start guide as well as some @@ -117,8 +116,8 @@

Installation of Deltacloud itself

Once you've setup all the dependencies listed below, installing Deltacloud is as easy as typing: -
-
+
+

$ sudo gem install deltacloud-core

And thats it! @@ -127,21 +126,21 @@ command will automatically fetch and install all other gems that the Deltacloud server needs if you don't already have these. As an alternative you can get the latest releases of Deltacloud from the - + Apache website. -
-
-

-
- +
+
+

+
+

Installation dependencies

The Deltacloud server relies on a number of external rubygems and other libraries. You must have the following packages installed before trying to install and run the Deltacloud server. Please note that the names of the packages below may differ for your distribution (e.g. 'ruby-devel' vs 'ruby-dev'). In short, you need: -
-
+
+

ruby and ruby-devel,
gem (RubyGems),

ruby and ruby-devel

install ruby.

$ ruby -v

ruby 1.8.7 (2010-08-16 patchlevel 302) [i686-linux]

sudo yum install ruby
sudo yum install ruby-devel

sudo yum install ruby
+sudo yum install ruby-devel

sudo apt-get install ruby
sudo apt-get install ruby-devel

sudo apt-get install ruby
+sudo apt-get install ruby-devel

gem (RubyGems)

install RubyGems.

gem -v

$ sudo yum install rubygems

gcc-c++, libxml2, libxml2-devel, libxslt, libxslt-devel

$ sudo yum install gcc-c++
$ sudo yum install libxml libxml2-devel
$ sudo yum install libxslt libxslt-devel

$ sudo yum install gcc-c++
+$ sudo yum install libxml libxml2-devel
+$ sudo yum install libxslt libxslt-devel

rake

Rake

$ sudo gem install rake

"Hello Deltacloud!", quick-start guide

Fedora.

let us know,

deltacloudd -i mock

all available

@@ -255,9 +258,24 @@ that can be used with the deltacloudd executable. -
-
-
$ deltacloudd -l Available drivers: * condor * vsphere * opennebula * eucalyptus * rhevm * sbc * azure * gogrid * mock * rackspace * rimuhosting * terremark * ec2
+
+
+
$ deltacloudd -l + +Available drivers: +* condor +* vsphere +* opennebula +* eucalyptus +* rhevm +* sbc +* azure +* gogrid +* mock +* rackspace +* rimuhosting +* terremark +* ec2
After you start the server, the Deltacloud HTML interface is available at http://localhost:3001/api @@ -271,7 +289,7 @@ to each URL. On Webkit based browsers like Safari, you might need to instruct the server explicitly to - + return HTML Do this by appending @@ -281,39 +299,39 @@

credentials

authentication.

deltacloudd.

$ deltacloudd -i rackspace -P 10000

$ deltacloudd -i ec2 -P 5000 -r 192.168.10.200

http://192.168.10.200:5000/api.

The Deltacloud ruby client

192.168.10.244:5000

require 'deltacloud'


api_url      = 'http://192.168.10.244:5000/api'
api_name     = 'TK2PJCAN9R1HKG2FK24Z'
api_password = 'aLe27rZlRhlBcVoQbL4JsVtaNga12vEL9d9kS5CA'


client = DeltaCloud.new( api_name, api_password, api_url )


# get a list of currently running instances (virtual machines)
client.instances.each do |instance|
 puts instance.name
end


other work with client here

require 'deltacloud'
+

+api_url      = 'http://192.168.10.244:5000/api'
+api_name     = 'TK2PJCAN9R1HKG2FK24Z'
+api_password = 'aLe27rZlRhlBcVoQbL4JsVtaNga12vEL9d9kS5CA'
+

+client = DeltaCloud.new( api_name, api_password, api_url )
+

+# get a list of currently running instances (virtual machines)
+client.instances.each do |instance|
+ puts instance.name
+end
+

+other work with client here

client documentation.

$ sudo gem install deltacloud-client

@@ -343,15 +374,15 @@

REST API.

$ deltacloudc collection operation [options]

@@ -362,7 +393,7 @@ refers to the Deltacloud object collections, such as Instances, Images, Buckets, Realms etc, as described in greater detail in the - + REST API

here.

deltacloudd -i mock

$ deltacloudc -l -u http://mockuser:mockpassword@localhost:3001/api

images:

$ deltacloudc images index -u http://mockuser:mockpassword@localhost:3001/api

buckets

$ deltacloudc buckets -l -u http://mockuser:mockpassword@localhost:3001/api

$ deltacloudc blob create -i 'my_new_blob' -b 'bucket1' -f /home/marios/file.txt

Other HTTP clients - cURL

REST API.

cURL.

deltacloudd -i ec2

listing of all images

curl  --user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
"http://localhost:3001/api/images?format=xml"

curl  --user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
+"http://localhost:3001/api/images?format=xml"

--user

username:password

credentials

create a new instance

curl -X POST -F "keyname=eftah" -F "image_id=ami-f51aff9c"
-F "realm_id=us-east-1c" -F "hwp_id=c1.medium" -F "firewalls1=default"
--user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
"http://localhost:3001/api/instances?format=xml"

curl -X POST -F "keyname=eftah" -F "image_id=ami-f51aff9c"
+-F "realm_id=us-east-1c" -F "hwp_id=c1.medium" -F "firewalls1=default"
+--user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
+"http://localhost:3001/api/instances?format=xml"

delete a firewall

curl -X DELETE
--user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
http://localhost:3001/api/firewalls/develgroup?format=xml

curl -X DELETE
+--user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
+http://localhost:3001/api/firewalls/develgroup?format=xml

create a blob

bucket

curl -H 'content-type: text/html' -H 'X-Deltacloud-Blobmeta-Name:mariosblob'
-H 'X-Deltacloud-Blobmeta-Version:2.1' --upload-file
"/home/marios/Desktop/somefile.html"
--user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
http://localhost:3001/api/buckets/mybucket/my_new_blob?format=xml

curl -H 'content-type: text/html' -H 'X-Deltacloud-Blobmeta-Name:mariosblob'
+-H 'X-Deltacloud-Blobmeta-Version:2.1' --upload-file
+"/home/marios/Desktop/somefile.html"
+--user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
+http://localhost:3001/api/buckets/mybucket/my_new_blob?format=xml

retrieve blob metadata

curl -iv -X HEAD
--user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
http://localhost:3001/api/buckets/mybucket/my_new_blob?format=xml

curl -iv -X HEAD
+--user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
+http://localhost:3001/api/buckets/mybucket/my_new_blob?format=xml

+ - - - +

Deltacloud - Many clouds. One API. No problem.