jclouds/apis/deltacloud/README.txt

85 lines
3.2 KiB
Plaintext
Raw Normal View History

2011-04-09 06:20:17 -04:00
====
Licensed to jclouds, Inc. (jclouds) under one or more
contributor license agreements. See the NOTICE file
distributed with this work for additional information
regarding copyright ownership. jclouds licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at
2011-04-09 06:20:17 -04:00
http://www.apache.org/licenses/LICENSE-2.0
2011-04-09 06:20:17 -04:00
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
2011-04-09 06:20:17 -04:00
====
jclouds binding to deltacloud requires a minimum server version of 0.1.0.
2010-12-31 11:49:41 -05:00
The identity and credential specified in jclouds will pass through deltacloud to
the backend, such as gogrid.
2010-12-21 07:33:38 -05:00
To install deltacloud, do the following:
* OS/X and jruby
2010-12-31 08:41:19 -05:00
# use homebrew or equiv to install jruby
* brew install jruby
* note testing took place w/ 1.6.0
# install and configure openssl to avoid "certificate verify failed" errors
# install and link openssl
* brew install openssl
* brew link openssl
# install jruby ssl
* jruby -S gem install jruby-openssl
# setup cert directory
* mkdir $HOME/certs
* curl -o $HOME/certs/cacert.pem http://curl.haxx.se/ca/cacert.pem
# rehash cert directory
* export SSL_CERT_DIR=$HOME/certs
* export SSL_CERT_FILE=$HOME/certs/cacert.pem
* c_rehash
# test
* jruby -ropen-uri -e 'p open("https://encrypted.google.com")'
* should see something like #<StringIO:0x5330cb4b>
# install specific version of rack that doesn't conflict with deltacloud
* jruby -S gem install rack --version 1.1.0
# install net-ssh
* jruby -S gem install net-ssh
# install deltacloud core
* jruby -S gem install deltacloud-core
2010-12-21 07:33:38 -05:00
To run a local deltacloud server, do the following:
* jruby
# export SSL_CERT_DIR=$HOME/certs
# export SSL_CERT_FILE=$HOME/certs/cacert.pem
# jruby -S deltacloudd -i mock
2011-03-29 19:59:04 -04:00
* or if you are running from a src tree: jruby -S ./server/bin/deltacloudd -i <driver>
2010-12-31 11:49:41 -05:00
Here are some notes about specific cloud providers
* terremark
# install fog gem
* jruby -S gem install fog
* rackspace
# install cloudfiles, cloudservers gem
* jruby -S gem install cloudservers
2010-12-31 11:49:41 -05:00
* jruby -S gem install cloudfiles
* ec2
* using jruby --1.8, 'gem install aws' will fail with ArrayIndexOutOfBoundsException per http://jira.codehaus.org/browse/JRUBY-5581
* using jruby --1.9, 'gem install aws' works, but running './server/bin/deltacloudd -i ec2' fails per http://jira.codehaus.org/browse/JRUBY-5529
# install i18n, aws gem
* jruby -S gem install i18n
* jruby -S gem install aws
2010-12-31 11:49:41 -05:00
2011-01-11 15:50:42 -05:00
Local Development of Delta
* jruby -S gem install rack-test cucumber
* What tests are available
* jruby -S rake -T
* server/tests/drivers
* specific tests to a particular driver
* Running tests
* jruby -S rake test