• Home
• Download
• Contribute
• Documentation

Help make Deltacloud better

• Getting the sources
• Required packages
• Installing the Deltacloud Core

All development of Deltacloud takes place in the open. Communication is run through the mailing list and all source code changes are tracked publicly.

• Mailing Lists
  For Deltacloud API: deltacloud-dev@incubator.apache.org. To subscribe to it, send an email to deltacloud-dev-subscribe@incubator.apache.org. You can also view Archive in case you are missing something.

• IRC
  You can also join us on the Freenode IRC channel #deltacloud. Deltacloud developers are generally available on the IRC channel

• Bugs
  We track bugs in Apache JIRA. You can view open bugs or file a new one there.

• Patches
  Patches are very welcome. Please send them to the development list. Patches should be generated with git format-patch and sent to the list with git send-email.

• Roadmap
  We maintain our roadmap in teambox so that anyone can comment on tasks and suggest new ones.

Getting the sources

Then Deltacloud Core gives you the API and drivers to various cloud providers. It also provides a client library and a commandline interface.

The Deltacloud Core repository is hosted on Apache Incubator. Apache uses Subversion, but there is a git mirror available:

$ mkdir deltacloud
$ cd deltacloud
$ git clone git://git.apache.org/deltacloud.git core

You can find the Subversion repository at: https://svn.apache.org/repos/asf/incubator/deltacloud.

Required packages

In order to make the Deltacloud components work, you'll need to have the following packages installed (on Fedora 14; the names may vary on your distro):

ruby
ruby-devel
rubygem-rake
gcc-c++
libxml2-devel
libxslt-devel

Note: these packages are necessary for building all the required ruby gems that Deltacloud requires. If you want to install the gems using your system's package manager (yum, apt, ports, etc.) you won't need to install these packages manually.

To install all required ruby gems manually you should run:

$ yum install rubygem-haml rubygem-sinatra rubygem-thin rubygem-json \
  rubygem-net-json rubygem-rack-accept rubygem-nokogiri rubygem-aws \
  rubygem-rest-client

Installing the Deltacloud Core

First, you need to install the server that will give you the Deltacloud API:

$ cd path/to/deltacloud/core/server
$ rake package
$ sudo gem install pkg/deltacloud-core-<version>.gem

Then install the client library:

$ cd path/to/deltacloud/core/client
$ rake package
$ sudo gem install pkg/deltacloud-client-<version>.gem

Once you have the client installed, run the following command:

$ cd path/to/deltacloud/core/client
$ rake fixtures

Apache Deltacloud is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator PMC. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.