Apache jclouds®

<!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"> <title>Apache jclouds® :: Home</title> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <meta name="description" content=""> <meta name="author" content="">     <link href="/css/bootstrap.min.css" rel="stylesheet"> <link href="/css/style.css" rel="stylesheet"> <link href="/css/syntax.css" rel="stylesheet">     <link rel="shortcut icon" href="/favicon.ico"> <link rel="alternate" type="application/atom+xml" href="/blog/atom.xml" title="Blog Posts Feed"> <link rel="alternate" type="application/atom+xml" href="/releasenotes/atom.xml" title="Release Notes Feed"> <script type="text/javascript" src="/js/jquery.min.js"></script> <script type="text/javascript" src="/js/bootstrap.min.js"></script> <script type="text/javascript" src="/js/toc.js"></script> </head> <body> <nav class="navbar navbar-default navbar-fixed-top" role="navigation"> <div class="container"> <div class="navbar-header"> <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1"> <span class="sr-only">Toggle navigation</span> <span class="icon-bar"></span> <span class="icon-bar"></span> <span class="icon-bar"></span> </button> <a class="navbar-brand" href="/">Apache jclouds ®</a> </div> <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1"> <ul class="nav navbar-nav"> <li class="dropdown"> <a href="#" class="dropdown-toggle" data-toggle="dropdown">Getting Started<strong class="caret"></strong></a> <ul class="dropdown-menu"> <li><a href="/start/what-is-jclouds/">What Is Apache jclouds?</a></li> <li><a href="/start/install/">Installation Guide</a></li> <li class="divider"></li> <li><a href="/start/concepts/">Core Concepts</a></li> <li><a href="/start/compute/">ComputeService</a></li> <li><a href="/start/blobstore/">BlobStore</a></li> <li><a href="https://github.com/apache/jclouds-examples">Examples</a></li> </ul> </li> <li class="dropdown"> <a href="#" class="dropdown-toggle" data-toggle="dropdown">Documentation<strong class="caret"></strong></a> <ul class="dropdown-menu"> <li><a href="/reference/providers/">Cloud Providers</a></li> <li><a href="/guides">User Guides</a></li> <li><a href="/reference/troubleshooting/">Troubleshooting</a></li> <li><a href="/reference/configuration/">Configuration</a></li> <li><a href="/reference/logging/">Logging</a></li> <li><a href="/reference/javadoc/">Javadoc</a></li> <li class="divider"></li> <li class="dropdown-header">Developer Guides</li> <li><a href="https://cwiki.apache.org/confluence/display/JCLOUDS/">Wiki</a></li> </ul> </li> <li class="dropdown"> <a href="#" class="dropdown-toggle" data-toggle="dropdown">Community<strong class="caret"></strong></a> <ul class="dropdown-menu"> <li><a href="/community/">Get In Touch!</a></li> <li><a href="/community/users/">Who Is Using jclouds?</a></li> <li class="divider"></li> <li class="dropdown-header">Contribute</li> <li><a href="/reference/report-a-bug/">Report a Bug</a></li> <li><a href="https://ci-builds.apache.org/job/JClouds/">Continuous Integration</a></li> <li><a href="https://cwiki.apache.org/confluence/display/JCLOUDS/How+to+Contribute">How To Contribute Code</a></li> <li><a href="https://cwiki.apache.org/confluence/display/JCLOUDS/How+to+Contribute+Documentation">How To Contribute Documentation</a></li> </ul> </li> <li class="dropdown"> <a href="#" class="dropdown-toggle" data-toggle="dropdown">About Apache<strong class="caret"></strong></a> <ul class="dropdown-menu"> <li><a href="https://www.apache.org">The Apache Software Foundation</a></li> <li><a href="https://www.apache.org/licenses/">License</a></li> <li><a href="https://www.apache.org/foundation/contributing.html">Donations</a></li> <li><a href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li> <li><a href="https://www.apache.org/security/">Security</a></li> <li><a href="https://www.apache.org/foundation/thanks.html">Thanks</a></li> <li class="divider"></li> <li class="dropdown-header">Apache Events</li> <li><a href="https://www.apache.org/events/current-event.html"><img src="https://www.apache.org/events/current-event-234x60.png"/></a></li> </ul> </li> <li><a href="/blog">Blog</a></li> </ul> <ul class="nav navbar-nav navbar-right"> <li class="dropdown"> <a href="#" class="dropdown-toggle" data-toggle="dropdown">Release Notes<strong class="caret"></strong></a> <ul class="dropdown-menu">  <li><a href="/releasenotes/2.7.0">2.7.0</a></li> <li><a href="/releasenotes/2.6.0">2.6.0</a></li> <li><a href="/releasenotes/2.5.0">2.5.0</a></li> <li><a href="/releasenotes/2.4.0">2.4.0</a></li> <li><a href="/releasenotes/2.3.0">2.3.0</a></li> <li><a href="/releasenotes/2.2.1">2.2.1</a></li> <li><a href="/releasenotes/2.2.0">2.2.0</a></li> <li><a href="/releasenotes/2.1.3">2.1.3</a></li> <li><a href="/releasenotes/2.1.2">2.1.2</a></li> <li><a href="/releasenotes/2.1.1">2.1.1</a></li> <li><a href="/releasenotes/2.1.0">2.1.0</a></li> <li><a href="/releasenotes/2.0.3">2.0.3</a></li> <li><a href="/releasenotes/2.0.2">2.0.2</a></li> <li><a href="/releasenotes/2.0.1">2.0.1</a></li> <li><a href="/releasenotes/2.0.0">2.0.0</a></li> <li class="divider"></li> <li class="dropdown-header">Previous releases</li> <li><a href="/releasenotes">Release archive</a></li> </ul> </li> <li> <div> <a class="btn btn-success navbar-btn" href="/start/install/"> <span class="glyphicon glyphicon-download"></span> Install </a> </div> </li> </ul> </div> </div> </nav> <div id="home-content" class="container"> <div class="row clearfix"> <div class="col-md-4 column"> <img src="/img/fullsizelogo.jpg" class="img-rounded"/> </div> <div class="col-md-8 column"> <div class="jumbotron"> <h2>The Java Multi-Cloud Toolkit</h2> <p>Apache jclouds® is an open source multi-cloud toolkit for the Java platform that gives you the freedom to create applications that are <strong>portable across clouds</strong> while giving you <strong>full control</strong> to use cloud-specific features.</p> <p> <a class="btn btn-primary btn-large" href="/start/"> <span class="glyphicon glyphicon-book"></span> Learn </a> <a class="btn btn-success btn-large" href="/start/install/"> <span class="glyphicon glyphicon-download"></span> Install </a> <a class="btn btn-warning btn-large" href="https://github.com/apache/jclouds"> <span class="glyphicon glyphicon-cog"></span> Source </a> <a class="btn btn-warning btn-large" href="/community/"> <span class="glyphicon glyphicon-globe"></span> Contribute </a> </p> </div> </div> </div> <div id="releasenews" class="alert alert-info"> <p>The <a href="/start/install/">latest version</a> is 2.7.0 released on 2025-01-29! Read the <a href="/releasenotes/2.7.0/">release notes</a>.</p> </div> <div id="quicknews" class="alert alert-info"> </div> <script type="text/javascript"> $('#quicknews').hide(); </script> <div class="section-divider"> <span class="text">CLOUDS</span> </div> <br/> <ul class="list-inline text-center"> <li><img class="img-list" src="img/logos/aws.jpg" alt="Amazon Web Services" title="Amazon Web Services"/></li> <li><img class="img-list" src="img/logos/cloudsigma.png" alt="CloudSigma" title="CloudSigma"/></li> <li><img class="img-list" src="img/logos/cloudstack.png" alt="CloudStack" title="CloudStack"/></li> <li><img class="img-list" src="img/logos/digitalocean.png" alt="DigitalOcean" title="DigitalOcean"/></li> </ul> <ul class="list-inline text-center"> <li><img class="img-list" src="img/logos/docker.png" alt="Docker" title="Docker"/></li> <li><img class="img-list" src="img/logos/gcp.png" alt="Google Cloud Platform" title="Google Cloud Platform"/></li> <li><img class="img-list" src="img/logos/ms-azure.png" alt="Microsoft Azure" title="Microsoft Azure"/></li> </ul> <ul class="list-inline text-center"> <li><img class="img-list" src="img/logos/openstack.png" alt="OpensStack" title="OpenStack"/></li> <li><img class="img-list" src="img/logos/packet.png" alt="Packet" title="Packet"/></li> <li><img class="img-list" src="img/logos/profitbricks.png" alt="ProfitBricks" title="ProfitBricks"/></li> <li><img class="img-list" src="img/logos/rackspace.png" alt="Rackspace" title="Rackspace"/></li> </ul> <p class="lead text-center text-primary"><strong><a href="/reference/providers/">...and many more!</a></strong></p> <div class="section-divider"> <span class="text">CODE</span> </div> <br/> <div class="row clearfix"> <div class="col-md-6 column"> <div class="panel panel-primary"> <div class="panel-heading"> <h3 class="panel-title">Compute</h3> </div> <div class="panel-body"> <figure class="highlight"><pre><code class="language-java" data-lang="java"><span class="nc">ComputeService</span> <span class="n">compute</span> <span class="o">=</span> <span class="nc">ContextBuilder</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="s">"aws-ec2"</span><span class="o">)</span> <span class="o">.</span><span class="na">credentials</span><span class="o">(</span><span class="s">"identity"</span><span class="o">,</span> <span class="s">"credential"</span><span class="o">)</span> <span class="o">.</span><span class="na">buildView</span><span class="o">(</span><span class="nc">ComputeServiceContext</span><span class="o">.</span><span class="na">class</span><span class="o">)</span> <span class="o">.</span><span class="na">getComputeService</span><span class="o">();</span> <span class="nc">Template</span> <span class="n">template</span> <span class="o">=</span> <span class="n">compute</span><span class="o">.</span><span class="na">templateBuilder</span><span class="o">()</span> <span class="o">.</span><span class="na">osFamily</span><span class="o">(</span><span class="nc">OsFamily</span><span class="o">.</span><span class="na">UBUNTU</span><span class="o">)</span> <span class="o">.</span><span class="na">minRam</span><span class="o">(</span><span class="mi">2048</span><span class="o">)</span> <span class="o">.</span><span class="na">options</span><span class="o">(</span><span class="n">inboundPorts</span><span class="o">(</span><span class="mi">22</span><span class="o">,</span> <span class="mi">80</span><span class="o">))</span> <span class="o">.</span><span class="na">build</span><span class="o">();</span> <span class="n">compute</span><span class="o">.</span><span class="na">createNodesInGroup</span><span class="o">(</span><span class="s">"jclouds"</span><span class="o">,</span> <span class="mi">1</span><span class="o">,</span> <span class="n">template</span><span class="o">);</span></code></pre></figure> </div> </div> </div> <div class="col-md-6 column"> <div class="panel panel-primary"> <div class="panel-heading"> <h3 class="panel-title">BlobStore</h3> </div> <div class="panel-body"> <figure class="highlight"><pre><code class="language-java" data-lang="java"><span class="nc">BlobStore</span> <span class="n">blobStore</span> <span class="o">=</span> <span class="nc">ContextBuilder</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="s">"aws-s3"</span><span class="o">)</span> <span class="o">.</span><span class="na">credentials</span><span class="o">(</span><span class="s">"identity"</span><span class="o">,</span> <span class="s">"credential"</span><span class="o">)</span> <span class="o">.</span><span class="na">buildView</span><span class="o">(</span><span class="nc">BlobStoreContext</span><span class="o">.</span><span class="na">class</span><span class="o">)</span> <span class="o">.</span><span class="na">getBlobStore</span><span class="o">();</span> <span class="n">blobStore</span><span class="o">.</span><span class="na">createContainerInLocation</span><span class="o">(</span><span class="n">location</span><span class="o">,</span> <span class="s">"container-name"</span><span class="o">);</span> <span class="nc">ByteSource</span> <span class="n">payload</span> <span class="o">=</span> <span class="nc">ByteSource</span><span class="o">.</span><span class="na">wrap</span><span class="o">(</span><span class="k">new</span> <span class="kt">byte</span><span class="o">[]</span> <span class="o">{</span><span class="mi">1</span><span class="o">,</span> <span class="mi">2</span><span class="o">,</span> <span class="mi">3</span><span class="o">,</span> <span class="mi">4</span><span class="o">});</span> <span class="nc">Blob</span> <span class="n">blob</span> <span class="o">=</span> <span class="n">blobStore</span><span class="o">.</span><span class="na">blobBuilder</span><span class="o">(</span><span class="s">"blob-name"</span><span class="o">)</span> <span class="o">.</span><span class="na">payload</span><span class="o">(</span><span class="n">payload</span><span class="o">)</span> <span class="o">.</span><span class="na">contentLength</span><span class="o">(</span><span class="n">payload</span><span class="o">.</span><span class="na">size</span><span class="o">())</span> <span class="o">.</span><span class="na">build</span><span class="o">();</span> <span class="n">blobStore</span><span class="o">.</span><span class="na">putBlob</span><span class="o">(</span><span class="s">"container-name"</span><span class="o">,</span> <span class="n">blob</span><span class="o">);</span></code></pre></figure> </div> </div> </div> </div> <div class="row clearfix"> <div class="col-md-3 column"> <h3 class="text-primary"><span class="glyphicon glyphicon-cog"></span> Compute</h3> <p>The portable Compute interface allows users to provision their infrastructure in any cloud provider. With Apache jclouds® users are in control of the entire process: deployment configuration, provisioning and bootstrap.</p> </div> <div class="col-md-3 column"> <h3 class="text-primary"><span class="glyphicon glyphicon-hdd"></span> BlobStore</h3> <p>Using the BlobStore interface, users can easily store objects in a wide range of blob store providers, regardless of how big the objects to manage are, or how many files are there.</p> </div> <div class="col-md-3 column"> <h3 class="text-primary"><span class="glyphicon glyphicon-stats"></span> Load Balancer</h3> <p>The Load Balancer abstraction provides a common interface to configure the load balancers in any cloud that supports them. Just define the load balancer and the nodes that should join it, and it will be ready for the action.</p> </div> <div class="col-md-3 column"> <h3 class="text-primary"><span class="glyphicon glyphicon-fire"></span> Specific APIs</h3> <p>Apache jclouds® also provides DNS, firewall, storage, configuration management, image management, provider specific APIs, and much more. Make sure to check them out!</p> </div> </div> <br/> <div class="section-divider"> <span class="text">USERS</span> </div> <br/> <ul class="list-inline text-center"> <li><img class="img-list" src="img/logos/adobe.png" alt="Adobe" title="Adobe"/></li> <li><img class="img-list" src="img/logos/cloudsoft.png" alt="Cloudsoft" title="Cloudsoft"/></li> <li><img class="img-list" src="img/logos/jenkins.png" alt="Jenkins" title="Jenkins"/></li> <li><img class="img-list" src="img/logos/maginatics.png" alt="Maginatics" title="Maginatics"/></li> <li><img class="img-list" src="img/logos/neoload.png" alt="NeoTys NeoLoad" title="NeoTys NeoLoad"/></li> </ul> <ul class="list-inline text-center"> <li><img class="img-list" src="img/logos/cloudify.png" alt="GigaSpaces Cloudify" title="GigaSpaces Cloudify"/></li> <li><img class="img-list" src="img/logos/pallet.png" alt="Pallet" title="Pallet"/></li> <li><img class="img-list" src="img/logos/redhat.png" alt="Red Hat" title="Red Hat"/></li> <li><img class="img-list" src="img/logos/seatyourself.gif" alt="SeatYourself" title="SeatYourself"/></li> </ul> <ul class="list-inline text-center"> <li><img class="img-list" src="img/logos/mesosphere.png" alt="Mesosphere" title="Mesosphere"/></li> </ul> <p class="lead text-center text-primary"><strong><a href="/community/users/">...and many more!</a></strong></p> <div id="footer"> <hr/> <div class="row clearfix"> <div class="col-md-2 column"> <p class="text-center"> <a class="text-primary" href="/start/">Getting Started</a> </p> </div> <div class="col-md-2 column"> <p class="text-center"> <a class="text-primary" href="/reference/report-a-bug/">Report a Bug</a> </p> </div> <div class="col-md-2 column"> <p class="text-center"> <a href="https://github.com/apache/jclouds-site/edit/master/index.md">Fix This Page</a><a class="text-primary" href="https://cwiki.apache.org/confluence/display/JCLOUDS/How+to+Contribute+Documentation"><sup>*</sup></a> </p> </div> <div class="col-md-2 column"> <p class="text-center"> <a class="text-primary" href="https://cwiki.apache.org/confluence/display/JCLOUDS/How+to+Contribute">Contribute Code</a> </p> </div> <div class="col-md-2 column"> <p class="text-center"> <a class="text-primary" href="/community/">Contact Us</a> </p> </div> <div class="col-md-2 column"> <p class="text-center"> <a class="text-primary" href="https://twitter.com/jclouds">Follow Us</a> </p> </div> </div> <hr style="margin-top: 10px"/> <div class="row clearfix"> <div class="col-md-12 column"> <p class="text-center"> Copyright © 2011-2014 <a href="https://www.apache.org">The Apache Software Foundation</a>. All Rights Reserved. <a href="https://privacy.apache.org/policies/privacy-policy-public.html">Privacy policy</a>. </p> <p class="text-center"> Apache, jclouds, Apache jclouds, the jclouds logo, and the Apache feather logos are registered trademarks or trademarks of the Apache Software Foundation. </p> <p class="text-center"> <img src="/img/Apache_Logo.png" height="120" /> </p> <p class="text-center"> <a href="https://donate.apache.org/" title="Support Apache"> <img src="/img/support-apache.png" height="120" /> </a> </p> <br/> </div> </div> </div> </div> </body> </html>

CINXE.COM

Apache jclouds® :: Home