This document provides an overview of the jclouds Java SDK for interacting with cloud APIs. It discusses what jclouds is, the clouds and APIs it supports, its layered architecture, SDK deployment, and examples of using jclouds for tasks like authentication, logging, and interacting with cloud services like files, servers, and load balancers. It also covers getting help, bug reporting, and contributing to the jclouds open source project.

1. Support Training
jclouds: The
Rackspace Java SDK
Everett Toews
Developer Advocate
@everett_toews
You need:
JDK 1.6+
Maven 3+
Rackspace account

2. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Intro
2
Developer

3. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Committer on jclouds
3

4. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Intro
4
Advocate

5. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Intro
5

6. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Intro
6
Operations

7. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Co-author of The OpenStack Operations Guide
7docs.openstack.org/ops

8. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Intro
8
In startup we
are not allow
dev team for
talk to ops team
except by API.
@DevOps_Borat

9. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Agenda
9

10. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
The Workshop
•Introduction
•jclouds Overview
•SDKs
•Terminology
•Cloud Accounts
•Getting Started
10

11. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
The Workshop
•Examples
•Authentication
•Logging
•Cloud Files
•Cloud Servers
•Cloud Block Storage
•Cloud Load Balancers
•Cloud DNS
•Cross-cloud
11

12. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
The Workshop
•Wreck-It
•Bug Reports
•Troubleshooting
•Help!
•Potpourri
•Wrap Up
12

13. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Introduction to jclouds
13

14. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
jclouds
14
• Cross-cloud toolkit
• Open Source (Apache v2)
• Community
• Portable APIs
• Ecosystem APIs
• Provider APIs
• Java

15. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
jclouds’ Supported Clouds
•Compute
•Rackspace Cloud
Servers
•HP Cloud Compute
•AWS EC2
•ElasticHosts
•GoGrid
•All Clouds
15
•Storage
•Rackspace Cloud
Files
•HP Cloud Storage
•AWS S3
•Azure
•CloudOne
•All Clouds

16. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
jclouds Community
16

17. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
17
APIs and Providers
APIs
Providers
openstack-nova ec2 rackspace-clouddns
rackspace-
cloudservers-us
rackspace-
cloudservers-uk
aws-ec2
rackspace-
clouddns-us
rackspace-
clouddns-uk

18. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
18
APIs
APIs
openstack-nova
NovaApi:
ServerApi
FlavorApi
ImageApi
=Extensions=
KeyPairApi
SecurityGroupApi
FloatingIpApi
...
ec2
EC2Api:
TagApi
SubnetApi
WindowsApi
rackspace-clouddns
CloudDNSApi:
LimitApi
DomainApi
RecordApi
ReverseDNSApi

19. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
19
Providers
Providers
rackspace-
cloudservers-us
rackspace-
cloudservers-uk
rackspace-
cloudservers-us
rackspace-
cloudservers-uk
rackspace-
clouddns-us
rackspace-
clouddns-uk
•configuration
•provider specific features

20. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
jclouds Layers (APIs)
•ComputeService
•OpenStack
•Rackspace
•HP, AWS, etc.
•NovaApi (*Api)
•OpenStack
•Rackspace
•HP
20
Portable
Ecosystem

21. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
21
jclouds Compute Venn (APIs)
Portable
Ecosystem

22. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
jclouds Layers (APIs)
22
•BlobStore
•OpenStack
•Rackspace
•HP, AWS, etc.
•SwiftApi
•OpenStack
•Rackspace
•HP
•CloudFilesClient
•Rackspace
Portable
Ecosystem
Provider

23. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
23
jclouds Storage Venn (APIs)
Portable
Ecosystem
Provider

24. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
jclouds Community
24
After 3 beer I
can able use
any of cloud
API.
@DevOps_Borat

25. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Where Does jclouds Live?
25

26. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
SDK Deployment
26
Your
System
S
D
K
Cloud
A
P
I
VM
VM
VM
User
System

27. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
SDK Deployment
27
A
P
I
Cloud
Your
System
S
D
K
User
System
VM
VM
VM
VM

28. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
What Can jclouds
Do For You Today?
28

29. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
SDKs
29
Plumbing

30. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
SDKs
30
(Re)Authentication

31. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
SDKs
31
Pagination

32. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
SDKs
32
State Polling

33. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
SDKs
33
Rate Limiting

34. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
SDKs
34
Retry

35. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
SDKs
35
Smoothing
Rough Edges

36. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
SDKs
36
Open Source

37. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
SDKs
37
In devops
nobody is get
fire for buy
open source.
@DevOps_Borat

38. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
SDKs
38
Community

39. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
SDKs
39
Packaged

40. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
SDKs
40
All-in-one

41. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
SDKs
41
Extensions

42. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
SDKs
42
No lock-in

43. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
SDKs
43

44. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
SDKs
44

45. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
SDKs
45
Battle Tested Code

46. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
SDKs
46
Sample Code

47. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
SDKs
47
Documentation

48. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
SDKs
48

49. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
SDKs
49
Survey is show
junior devops
are still believe
in Tooth Fairy,
Santa Claus and
documentation. @DevOps_Borat

50. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Code
50

51. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Code
51
j.mp/jcldstrain

52. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Cloud Accounts
52

53. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Rackspace
•Username
•API Key
•(Password is useable too)
53

54. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Terminology
54

55. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Terminology
jclouds Rackspace/OpenStack
Compute Cloud Servers/Nova
Node Server
Location Region
Hardware Flavor
NodeMetadata Server details
User Metadata Metadata
BlobStore Cloud Files/Swift
Blob File/Object
55

56. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Getting Started
56

57. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Getting Started
•developer.rackspace.com
•Java
•Getting Started with jclouds
•Get jclouds
•Review JARs
57

58. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Examples
58

59. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Examples
59
Cloud Files

60. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Examples
60
Cloud Servers

61. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Examples
61
Logging

62. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Examples
62
Authentication

63. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Examples
63
?

64. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Examples
64
Cross-Cloud
j.mp/jcldsglue2013

65. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
65

66. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Wreck-It
•Misspell username
•Upload Object to Container that doesn’t
exist
•Create Server in a location that doesn’t
exist
•Use a bad Flavor/Image
•Remove Rackspace JARs from the
classpath
•etc.
66

67. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Bug Reports,
Troubleshooting,
and Help
67

68. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Bug Reports
•Get the version
•Get the code
•Get the wire and header logs
•gist or pastie
68

69. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Troubleshooting
•Download the version
•Run the code
•Compare the wire and header logs
69

70. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Troubleshooting
•Isolate the problem
•jclouds/User Problem (HTTP 4xx)
•Rackspace Problem (HTTP 5xx)
•Use curl to verify
70

71. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Troubleshooting
•Debug the source code
•mvn dependency:copy-dependencies
"-DoutputDirectory=./lib"
"-Dclassifier=sources”
71

72. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Responding
•Ideally:
•Contribute examples/doc
•Send the link to the customer
• jclouds.org/documentation/devguides/contributing-to-jclouds/
•github.rackspace.com/van5941/CLAs
72

73. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Responding
•Encourage customers to join the jclouds
community:
•jclouds-user-subscribe@apache.org
• www.mail-archive.com/user@jclouds.incubator.apache.org/
73

74. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Help!
•developer.rackspace.com/support
•javadocs.jclouds.cloudbees.net
•#jclouds on IRC @ freenode.net
•jclouds-user-subscribe@apache.org
•jclouds-dev-subscribe@apache.org
74

75. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Potpourri
75

76. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Potpourri
•Moved to Apache Software Foundation
•groupId change
• 1.6.0: <groupId>org.jclouds.X</groupId>
• 1.6.1: <groupId>org.apache.jclouds.X</groupId>
•Package change
•1.6.0: import org.jclouds
•1.7 (2.0?): import org.apache.jclouds
76

77. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Potpourri
•Google’s Guice & Guava
•Removal of the AsyncApis in 1.7 (2.0?)
•Dropping support for Java 1.6?
•Cloud Files isn’t multi-region...yet
•Cloud Databases in progress
•More endpoints
77

78. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Potpourri
•Command Line Interface
•Jenkins Plugin
•jclouds-chef
•Who Uses jclouds?
•CloudBees
•Cloudify
•EnterpriseDB
•Pallet
•...
78

79. RACKSPACE® HOSTING | WWW.RACKSPACE.COM
Potpourri
•More examples
•Other installation methods
•Stay up-to-date with jclouds
•blog.phymata.com
•@everett_toews
•What else can we do to stay in sync?
79

80. Thank You
Everett Toews
Developer Advocate
@everett_toews
And don’t forget to terminate your VMs
developer.rackspace.com
j.mp/jcldstrain