jclouds Support Training

Support Training

jclouds: The Rackspace Java SDK

Everett Toews

Developer Advocate

@everett_toews

You need:

JDK 1.6+

Maven 3+

Rackspace account

2RACKSPACE® HOSTING | WWW.RACKSPACE.COM

Intro

Developer


Committer on jclouds


Intro

Advocate


Intro


Intro

Operations


Co-author of The OpenStack Operations Guide

docs.openstack.org/ops


Intro

In startup we are not allow dev team for talk to ops team except by API.

@DevOps_Borat


Agenda


The Workshop

•Introduction•jclouds Overview•SDKs•Terminology•Cloud Accounts•Getting Started


The Workshop

•Examples•Authentication•Logging•Cloud Files•Cloud Servers•Cloud Block Storage•Cloud Load Balancers•Cloud DNS•Cross-cloud


The Workshop

•Wreck-It•Bug Reports•Troubleshooting•Help!•Potpourri•Wrap Up


Introduction to jclouds


jclouds

• Cross-cloud toolkit

• Open Source (Apache v2)

• Community

• Portable APIs

• Ecosystem APIs

• Provider APIs

• Java


jclouds’ Supported Clouds

•Compute• Rackspace Cloud Servers

• HP Cloud Compute• AWS EC2• ElasticHosts• GoGrid• All Clouds

•Storage• Rackspace Cloud Files

• HP Cloud Storage• AWS S3• Azure• CloudOne• All Clouds

http://www.jclouds.org/documentation/reference/supported-providers/

http://www.jclouds.org/documentation/reference/supported-providers/


jclouds Community


APIs and Providers

APIs

Providers

openstack-nova ec2 rackspace-clouddns

rackspace-cloudservers-us

rackspace-cloudservers-uk

aws-ec2rackspace- clouddns-us

rackspace- clouddns-uk


APIs

APIs

openstack-nova

NovaApi:ServerApiFlavorApiImageApi

=Extensions=KeyPairApi

SecurityGroupApiFloatingIpApi

...

ec2

EC2Api:TagApi

SubnetApiWindowsApi

rackspace-clouddns

CloudDNSApi:LimitApi

DomainApiRecordApi

ReverseDNSApi


Providers

Providers





rackspace-clouddns-us

rackspace-clouddns-uk

•configuration•provider specific features


jclouds Layers (APIs)•ComputeService• OpenStack• Rackspace• HP, AWS, etc.

•NovaApi (*Api)• OpenStack• Rackspace• HP

Portable

Ecosystem


jclouds Compute Venn (APIs)

Portable

Ecosystem


jclouds Layers (APIs)•BlobStore• OpenStack• Rackspace• HP, AWS, etc.

•SwiftApi• OpenStack• Rackspace• HP

•CloudFilesClient• Rackspace

Portable

Ecosystem

Provider


jclouds Storage Venn (APIs)

Portable

Ecosystem

Provider


jclouds Community

After 3 beer I can able use any of cloud API.

@DevOps_Borat


Where Does jclouds Live?


SDK Deployment

YourSystem

SDK

CloudAP I

VMVM

VM

UserSystem


SDK Deployment

API

Cloud

YourSystem

SDK

UserSystem

VMVM

VMVM


What Can jclouds Do For You Today?


SDKs

Plumbing


SDKs

(Re)Authentication


SDKs

Pagination


SDKs

State Polling


SDKs

Rate Limiting


SDKs

Retry


SDKs

Smoothing

Rough Edges


SDKs

Open Source


SDKs

In devops nobody is get fire for buy open source.

@DevOps_Borat


SDKs

Community


SDKs

Packaged


SDKs

All-in-one


SDKs

Extensions


SDKs

No lock-in


SDKs


SDKs


SDKs

Battle Tested Code


SDKs

Sample Code


SDKs

Documentation


SDKs


SDKs

Survey is show junior devops are still believe in Tooth Fairy, Santa Claus and documentation. @DevOps_Borat


Code


Code

j.mp/jcldstrain


Cloud Accounts


Rackspace

•Username•API Key•(Password is useable too)


Terminology


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


Getting Started


Getting Started

•developer.rackspace.com•Java•Getting Started with jclouds•Get jclouds•Review JARs


Examples


Examples

Cloud Files

http://www.jclouds.org/documentation/quickstart/rackspace/%23files


Examples

Cloud Servers

http://www.jclouds.org/documentation/quickstart/rackspace/%23servers


Examples

Logging

https://github.com/jclouds/jclouds-examples/blob/master/rackspace/src/main/java/org/jclouds/examples/rackspace/Logging.java


Examples

Authentication

https://github.com/jclouds/jclouds-examples/blob/master/rackspace/src/main/java/org/jclouds/examples/rackspace/Authentication.java


Examples

?


Examples

Cross-Cloud

j.mp/jcldsglue2013



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.


Bug Reports, Troubleshooting,

and Help


Bug Reports

•Get the version•Get the code•Get the wire and header logs•gist or pastie

https://gist.github.com/

http://pastie.org/


Troubleshooting

•Download the version•Run the code•Compare the wire and header logs


Troubleshooting

•Isolate the problem•jclouds/User Problem (HTTP 4xx)•Rackspace Problem (HTTP 5xx)•Use curl to verify


Troubleshooting

•Debug the source code• mvn dependency:copy-dependencies "-DoutputDirectory=./lib" "-Dclassifier=sources”


Responding

•Ideally:• Contribute examples/doc• Send the link to the customer• jclouds.org/documentation/devguides/contributing-to-jclouds/

• github.rackspace.com/van5941/CLAs

http://jclouds.org/documentation/devguides/contributing-to-jclouds/

https://github.rackspace.com/van5941/CLAs


Responding

•Encourage customers to join the jclouds community:• [email protected]• www.mail-archive.com/[email protected]/

mailto:[email protected]

http://www.mail-archive.com/[email protected]/


Help!

•developer.rackspace.com/support•javadocs.jclouds.cloudbees.net•#jclouds on IRC @ freenode.net•[email protected]•[email protected]




Potpourri


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


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


Potpourri

•Command Line Interface•Jenkins Plugin•jclouds-chef•Who Uses jclouds?• CloudBees• Cloudify• EnterpriseDB• Pallet• ...

http://cloud.dzone.com/articles/command-line-interface-jclouds

https://wiki.jenkins-ci.org/display/JENKINS/JClouds+Plugin

http://www.jclouds.org/documentation/quickstart/chef/

http://www.jclouds.org/documentation/reference/apps-that-use-jclouds/

http://cloudbees.com/

http://www.gigaspaces.com/cloudify

http://www.enterprisedb.com/products-services-training/products-overview/postgres-plus-cloud-database

http://palletops.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?

https://github.com/jclouds/jclouds-examples/tree/master/rackspace

http://www.jclouds.org/documentation/userguide/installation-guide/

Thank You

Everett Toews

Developer Advocate

@everett_toews

And don’t forget to terminate your VMs

developer.rackspace.com

j.mp/jcldstrain

jclouds Support Training

Technology