Getting Started
Quick Start Guides
- Amazon Web Services
- Elastic Block Store Models
- Azure Storage Service
- BlueLock vCloud
- Cloud Sigma
- Eucalyptus
- File System
- Go Grid
- HP Cloud Services
- IBM Developer Cloud
- OpenStack
- Rackspace
- RimuHosting
- Terremark eCloud
- Terremark vCloud Express
Release Notes
Maven Sites and Javadocs
- HEAD (Javadoc) - updates weekly
- 1.3.1 (Javadoc)
- 1.3.0 (Javadoc)
- 1.3.0-rc-2 (Javadoc)
- 1.3.0-rc-1 (Javadoc)
- 1.2.2 (Javadoc)
- 1.2.1 (Javadoc)
- 1.2.0 (Javadoc)
- 1.1.1 (Javadoc)
- 1.1.0 (Javadoc)
User Guides
- Using Blob Store API
- Using Compute API and Tools
- Google App Engine
- VMWare vCloud
- Terremark
- File System Provider
- Init Builder
- Using jclouds with Apache Karaf
- Using EC2
- Using Maven
Samples & Examples
FAQs
Reference
- jclouds Rationale and Design
- Location Metadata Design
- Compute API Design
- Columnar Data Design
- jclouds API
- jclouds OAuth Integration
- Using jclouds with Apache Felix OSGi Container
- Pool Design
- Load Balancer Design
- Logging in jclouds
- VMWare Integration Approach & Design
- Supported Providers
- Apps that use jclouds
- Using Provider Metadata
Developer Resources
- Contributing to jclouds
- Provider Testing
- Contributing to Documentation
- Using Eclipse
- jclouds Continuous Integration
- Provider Metadata
Old versions
Release Notes
- 1.0.0
- 1.0 Beta 8
- 1.0 Beta 7
Maven Sites and Javadocs
Introduction
The 1.3 release of jclouds includes results of 3-months effort by our contributors. A total of 57 Issues were addressed between jclouds 1.2.0 and the current revision of jclouds 1.3 (1.3.1).
Notable updates include
- support for Citrix CloudStack 2.2.13+
- support for vCloud Director 1.5 endpoints
- support for OpenStack Nova via our eucalyptus support
This release also supports more locations than ever including:
- introduction of Ninefold compute in Sydney and HP Cloud Object Storage in SuperNAP (vegas)
- new aws-ec2 regions in Oregon and São Paulo
- new ElasticHosts zones in Toronto and Los Angeles
We also have a few new tricks for power users
- image-id and login-user properties allow you to customize the default ComputeService template.
- support for adding/removing nodes from Rackspace Cloud Load Balancers
- solid state drive (SSD) support for Cloudsigma
- support for aws-s3 Reduce Redundancy Storage
- new property to automatically assign elastic IP addresses (handy for OpenStack Nova).
As always, we keep our examples site up to date so you can see how to work this stuff. Also, check out recent jclouds integrations including Abiquo 2.0, Apache Camel, ElasticInbox, and GigaSpaces Cloudify.
Please submit your own ideas and let us know if there are features you'd like to see, need help on, or are interested in contributing. Make sure you follow us on Twitter for updates. If you are interested in learning about jclouds 1.3 IRL, come to our training in Stockholm or our next meetup at Jfokus
Credits
Special thanks to Alcatel Lucent for sponsoring the majority of our CloudStack implementation, and the CloudStack community for answering hundreds of questions over the last year! Additional thanks to Jeremy Daggett from HP for contributing HP Cloud Object Storage support, and setting stage for further OpenStack improvements in future releases. Also thanks to Jesse Wilson from Gson, who took time with us to hone our use of Gson to the point where we no longer require patches.
Finally, thanks to everyone who contributed their time and effort in order to make this release happen. Check out who's been busy here.
API Breakers and Upgrades
Deprecated methods have been removed in this release. We will remove compute.clj and blobstore.clj next release in favor of the compute2/blobstore2 out for a while now. We have upgraded all of our dependencies including guava 11.0.1, gson 2.1, and sshj 0.7.0
Cool Stuff
We've improved our development process to include simulating api server responses. Check out our provider testing page for more.
Tracking
Status of release 1.3.1 is tracked in issue 817
Test Results
| maven dependency | abstraction | iso 3166 codes | result | notes | ||
|---|---|---|---|---|---|---|
| o.j.p/aws-cloudwatch | US-VA,US-CA,US-OR,BR-SP,IE,SG | 1/1 | ||||
| o.j.p/aws-ec2 | compute | US-VA,US-CA,US-OR,BR-SP,IE,SG | 153/153 | |||
| o.j.p/aws-s3 | blobstore | US,US-CA,US-OR,BR-SP,IE,SG | 103/103 | |||
| o.j.p/azureblob | blobstore | US-TX,US-IL,IE-D,SG,NL-NH,HK | 94/95 | failures | ||
| o.j.p/bluelock-vcloud-zone01 | compute | US-IN | 123/123 | |||
| o.j.p/cloudfiles-uk | blobstore | GB-SLG | 88/88 | |||
| o.j.p/cloudfiles-us | blobstore | US-TX | 89/90 | failures | ||
| o.j.p/cloudloadbalancers-uk | loadbalancer | GB-SLG | 8/8 | |||
| o.j.p/cloudloadbalancers-us | loadbalancer | US-IL,US-TX | 8/8 | |||
| o.j.p/cloudonestorage | blobstore | US-GA,US-TX | 63/71 | failures | ||
| o.j.p/cloudservers-uk | compute | GB-SLG | 151/152 | failures | ||
| o.j.p/cloudservers-us | compute | US-IL,US-TX | 151/151 | |||
| o.j.p/cloudsigma-zrh | compute | CH-ZH | 139/149 | failures | ||
| o.j.p/cloudsigma-lvs | compute | US-NV | 138/146 | failures | ||
| o.j.p/elastichosts-lax-p | compute | US-CA | 129/129 | |||
| o.j.p/elastichosts-lon-b | compute | GB-LND | 129/129 | |||
| o.j.p/elastichosts-lon-p | compute | GB-LND | 129/129 | |||
| o.j.p/elastichosts-sat-p | compute | US-TX | 129/129 | |||
| o.j.p/elastichosts-tor-p | compute | CA-OR | 129/129 | |||
| o.j.p/eucalyptus-partnercloud-ec2 | compute | US-CA | 117/130 | failures | ||
| o.j.p/eucalyptus-partnercloud-s3 | blobstore | US-CA | 100/108 | failures | ||
| o.j.p/hpcloud-objectstorage-lvs | blobstore | US-NV | 88/88 | |||
| o.j.p/go2cloud-jhb1 | compute | ZA-GP | 128/129 | |||
| o.j.p/gogrid | compute | US-CA,US-VA,NL-NH | 115/116 | failures | ||
| o.j.p/greenhousedata-element-vcloud | compute | US-WY | 123/134 | failures | ||
| o.j.p/ninefold-compute | compute | AU-NSW | 113/113 | |||
| o.j.p/ninefold-storage | blobstore | AU-NSW | 63/69 | failures | ||
| o.j.p/openhosting-east1 | compute | US-VA | 128/129 | |||
| o.j.p/rimuhosting | compute | NZ-AUK,US-TX,AU-NSW,GB-LND | PASS/TOTAL | failures | ||
| o.j.p/savvis-symphonyvpdc | compute | US,CA | FAIL/FAIL | unless tests stabilize, we should move this back to sandbox | ||
| o.j.p/serverlove-z1-man | compute | GB-MAN | 129/129 | |||
| o.j.p/skalicloud-sdg-my | compute | MY-10 | 128/129 | failures | ||
| o.j.p/slicehost | compute | US-IL,US-TX,US-MO | 129/144 | failures | ||
| o.j.p/softlayer | compute | SG,US-CA,US-TX,US-VA,US-WA,US-TX | 129/129 | |||
| o.j.p/stratogen-vcloud-mycloud | compute | GB | 125/130 | failures | ||
| o.j.p/synaptic-storage | blobstore | US-VA,US-TX | 63/65 | failures | ||
| o.j.p/trmk-ecloud | compute | US-FL,US-VA,NL-NH,BR-SP | 142/150 | failures | ||
| o.j.p/trmk-vcloudexpress | compute | US-FL | 142/151 | failures |
| maven dependency | abstraction | endpoint tested | result | notes | ||
|---|---|---|---|---|---|---|
| o.j.a/atmos | blobstore | pending | ||||
| o.j.a/byon | compute | pending | ||||
| o.j.a/cloudfiles | blobstore | pending | ||||
| o.j.a/cloudservers | compute | pending | ||||
| o.j.a/cloudstack | compute | http://72.52.126.25/client/api | 120/188 | re-run w/global access | ||
| o.j.a/deltacloud | compute | https://api.deltacloud.org/ | fail | jclouds needs to be updated to 0.4.1 | ||
| o.j.a/elasticstack | compute | pending | ||||
| o.j.a/eucalyptus | compute | pending | ||||
| o.j.a/filesystem | blobstore | pending | ||||
| o.j.a/nova | compute | pending | ||||
| o.j.a/swift | blobstore | https://region-a.geo-1.objects.hpcloudsvc.com/auth | 88/88 | |||
| o.j.a/vcloud | compute | https://zone01.bluelock.com/api | 33/34 | failures | ||
| o.j.a/walrus | blobstore | pending |