jclouds is an open-source multi-cloud library written in Java that provides a unified API and abstraction layer for connecting to and managing different cloud providers. It supports over 40 cloud providers and 20 APIs, and allows developers to manage resources like compute instances, load balancers, and object storage in a portable way across clouds through a consistent Java API.

1. Overview
@jclouds

2. Agenda
• What is jclouds?
• What does it do?
• Relationship to other projects
• Code examples
• Extras

3. What is jclouds?
• Apache licensed Java multi-cloud SDK
• b 3/2009; ~525k loc; 110 contributors
• connects tools portably regardless of,
yet also availing backend
• Over 40 cloud providers supported
• next release is 1.6 (March)

4. What does it do?
• Helps projects become cloud projects,
and developers become cloud
developers.
• through consistency in
• Tools vs Services
• Services vs Model
• API approach

5. Tools vs Services
• jclouds helps existing tools connect to
cloud services
• a consistent integration pattern and
configuration
• adjustable library dependencies
• sample patterns, integrations, and
abstractions

6. Services vs Model
• jclouds simplifies modeling of cloud
services
• Standards focus with pragmatic
extensions. (JSR-330, 311)
• Clean means of addressing service
quirks
• pluggable strategies for error/retry

7. API Approach
• Backend before abstraction
• proprietary features, multiple abstractions
• Async/Sync api mirroring
• scalably deal with 400ms-3m response time
• Guava
• Universal Testing Approach
• unit, “expect”, and live tests

8. Who’s integrating?
you?

9. Alternatives
• Roll-your-own
• Jersey, RESTEasy
• EC2-based cloud apis
• typica, jets3t
• Dasein Cloud API
• Proprietary Service Provider SDKs

10. Portable APIs
BlobStore LoadBalancer
DNS, Block Storage,
Compute Network, Identity
Provider-Specific Hooks
Embeddable
40 built-in providers & 20 apis and dialects!

11. java overview github jclouds/jclouds
// init
context = ContextBuilder.newBuilder(“cloudfiles-us”)
.credentials(apikey, secret)
.buildView(BlobStoreContext.class);
blobStore = context.getBlobStore();
// create container
blobStore.createContainerInLocation(null, “adriansmovies”);
// add blob
blob = blobStore.blobBuilder("sushi.avi").payload(file).build();
blobStore.putBlob(“adriansmovies”, blob);

12. java overview github jclouds/jclouds
// init
context = ContextBuilder.newBuilder(“openstack-nova”)
.endpoint(“https://keystone:5000/v2.0”)
.credentials(tenantUser, password)
.modules(singleton(new SshjSshClientModule()))
.buildView(ComputeServiceContext.class);
compute = context.getComputeService();
// create a couple nodes and open a couple ports
nodes = compute.createNodesInGroup(“hbase-master”, 1,
runScript(install).
inboundPorts(60000, 60010));
// gather my ip addresses
for (NodeMetadata node : nodes) {
node.getPublicAddresses();
node.getPrivateAddresses();
}
@jclouds 12

13. jclouds locations
Location helps
normalize placement
across resource types
All top-level resources listAssignableLocations
have a location US
Location metadata is IE
SG
extensible

14. jclouds modularity
APIs are software
focused jclouds-blobstore
Providers are offering s3
focused aws-s3
scality-ring walrus
API + location + googlestorage
scaleup-storage
defaults = Provider
eucaluptus-partnercloud-s3

15. New
Toys
• Fluent
Pagina,on
(1.5)
• Small
distribu,on
(1.6)
@jclouds

16. Fluent Pagination
• Many apis == pagination differences
• Desire ease, but also ability to “opt-out”
of lazy continuations
• Can we make it easier to filter/transform
resources?

17. FluentIterable
lazy advance through all your metrics:
FluentIterable<Metric> allMetrics = cloudwatch.getMetricApi().list().concat();
advance only until we find the load balancer we want:
Optional<LoadBalancer> firstInterestingLoadBalancer = elb
.getLoadBalancerApi().list()
.concat()
.firstMatch(isInterestingLB());
get only the first page of google instances
IterableWithMarker<Instance> firstPage =
gce.getInstanceApiForProject("myproject").listFirstPage();

18. Small Distribution
• Before 1.6 we had more deps
• We now have much less deps
• You can now make a <5MB cloud app!

19. Where
now?
• jclouds.org
• github/jclouds/jclouds-­‐examples
• jclouds@googlegroups.com
• @jclouds
@jclouds

20. java overview github jclouds/jclouds
// create a couple nodes and open a couple ports
nodes = compute.createNodesInGroup(“web-prod”, 2,
runScript(installApache).
inboundPorts(22, 8080));
// load balance the nodes mapping port 80 -> 8080
lb = lbapi.createLoadBalancerInLocation(null, “web-prod”,
“HTTP”, 80, 8080,
nodes);
// gather my lb addresses
for (String lbAddress : lb.getAddresses()) {
}
@jclouds 20

21. chef integration github jclouds/jclouds-chef
if (any(cookbookVersions, containsRecipe("apache2")))
runList = new RunListBuilder().addRecipe("apache2").build();
chef.updateRunListForGroup(runList, “web-prod”);
boot = chef.createClientAndBootstrapScriptForGroup(“web-prod”);
nodes = compute.createNodesInGroup(“web-prod”, 1, runScript(boot));

22. CLI github jclouds/jclouds-cli

23. BYON github jclouds/jclouds