You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jclouds.apache.org by na...@apache.org on 2014/07/15 15:32:58 UTC
svn commit: r1610690 - in /jclouds/site-content: guides/docker/
guides/docker/index.html guides/index.html img/jclouds-docker.png
img/logos/docker.png index.html reference/providers/index.html
Author: nacx
Date: Tue Jul 15 13:32:57 2014
New Revision: 1610690
URL: http://svn.apache.org/r1610690
Log:
deploy jclouds site content
Added:
jclouds/site-content/guides/docker/
jclouds/site-content/guides/docker/index.html
jclouds/site-content/img/jclouds-docker.png (with props)
jclouds/site-content/img/logos/docker.png (with props)
Modified:
jclouds/site-content/guides/index.html
jclouds/site-content/index.html
jclouds/site-content/reference/providers/index.html
Added: jclouds/site-content/guides/docker/index.html
URL: http://svn.apache.org/viewvc/jclouds/site-content/guides/docker/index.html?rev=1610690&view=auto
==============================================================================
--- jclouds/site-content/guides/docker/index.html (added)
+++ jclouds/site-content/guides/docker/index.html Tue Jul 15 13:32:57 2014
@@ -0,0 +1,255 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+<title>Apache jclouds® :: Docker: Getting Started Guide</title>
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="">
+<meta name="author" content="">
+
+<!--link rel="stylesheet/less" href="less/bootstrap.less" type="text/css" /-->
+<!--link rel="stylesheet/less" href="less/responsive.less" type="text/css" /-->
+<!--script src="js/less-1.3.3.min.js"></script-->
+<!--append â#!watchâ to the browser URL, then refresh the page. -->
+
+<link href="/css/bootstrap.min.css" rel="stylesheet">
+<link href="/css/style.css" rel="stylesheet">
+<link href="/css/syntax.css" rel="stylesheet">
+
+<!-- HTML5 shim, for IE6-8 support of HTML5 elements -->
+<!--[if lt IE 9]>
+<script src="js/html5shiv.js"></script>
+<![endif]-->
+
+<!-- Fav and touch icons -->
+<!--
+<link rel="apple-touch-icon-precomposed" sizes="144x144" href="/img/apple-touch-icon-144-precomposed.png">
+<link rel="apple-touch-icon-precomposed" sizes="114x114" href="/img/apple-touch-icon-114-precomposed.png">
+<link rel="apple-touch-icon-precomposed" sizes="72x72" href="/img/apple-touch-icon-72-precomposed.png">
+<link rel="apple-touch-icon-precomposed" href="/img/apple-touch-icon-57-precomposed.png">
+-->
+<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>
+
+<script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-8638379-1']);
+ _gaq.push(['_trackPageview']);
+
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+ })();
+</script>
+<script type="text/javascript">
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+ ga('create', 'UA-47106724-1', 'jclouds.apache.com');
+ ga('send', 'pageview');
+</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="http://github.com/jclouds/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="http://wiki.apache.org/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="http://www.meetup.com/jclouds/">Attend An Event</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="http://wiki.apache.org/jclouds/How%20to%20Contribute">How To Contribute Code</a></li>
+ <li><a href="http://wiki.apache.org/jclouds/How%20to%20Contribute%20Documentation">How To Contribute Documentation</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">
+ <!-- only keep the release notes for supported versions in this list -->
+ <li><a href="/releasenotes/1.7.3">1.7.3</a></li>
+ <li><a href="/releasenotes/1.7.2">1.7.2</a></li>
+ <li><a href="/releasenotes/1.7.1">1.7.1</a></li>
+ <li><a href="/releasenotes/1.7.0">1.7.0</a></li>
+ <li><a href="/releasenotes/1.6.3">1.6.3</a></li>
+ <li><a href="/releasenotes/1.6.2">1.6.2</a></li>
+ <li><a href="/releasenotes/1.6.1">1.6.1</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 class="container">
+ <div class="page-header">
+ <h1>Docker: Getting Started Guide</h1>
+ </div>
+ <p>jclouds-docker is a local cloud provider modelled on <a href="http://www.docker.io">docker</a>. Similar to other jclouds supported
+providers, it supports the same portable abstractions offered by jclouds.</p>
+
+<p><img src="/img/jclouds-docker.png" alt="jclouds docker architecture" /></p>
+
+<p>In order to mimic the behavior of the nodes that jclouds is able to manage, we need to make the Docker containers similar to any other VM.
+Fortunately, to have that is not much work: the only prerequisite is that the node needs to be sshâable.
+This involves <a href="https://docs.docker.com/examples/running_ssh_service/">dockerizing an SSH daemon service</a>.</p>
+
+<h3>Give it a try!</h3>
+
+<ul>
+<li>Install <a href="http://https://docs.docker.com/installation/">Docker</a></li>
+<li>Ensure you are using a recent JDK 7</li>
+<li>Setup your project to include <code>docker</code>
+
+<ul>
+<li>Get the dependency <code>org.jclouds.labs/docker</code> using jclouds <a href="/start/install">Installation</a>.</li>
+</ul>
+</li>
+<li>Start coding</li>
+</ul>
+
+
+<div class="highlight"><pre><code class="java"><span class="c1">// get a context with docker that offers the portable ComputeService api</span>
+<span class="n">ComputeServiceContext</span> <span class="n">context</span> <span class="o">=</span> <span class="n">ContextBuilder</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="s">"docker"</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">credentials</span><span class="o">(</span><span class="n">email</span><span class="o">,</span> <span class="n">password</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">modules</span><span class="o">(</span><span class="n">ImmutableSet</span><span class="o">.<</span><span class="n">Module</span><span class="o">></span> <span class="n">of</span><span class="o">(</span><span class="k">new</span> <span class="n">Log4JLoggingModule</span><span class="o">(),</span>
+ <span class="k">new</span> <span class="nf">SshjSshClientModule</span><span class="o">()))</span>
+ <span class="o">.</span><span class="na">buildView</span><span class="o">(</span><span class="n">ComputeServiceContext</span><span class="o">.</span><span class="na">class</span><span class="o">);</span>
+<span class="n">ComputeService</span> <span class="n">client</span> <span class="o">=</span> <span class="n">context</span><span class="o">.</span><span class="na">getComputeService</span><span class="o">();</span>
+
+<span class="n">String</span> <span class="n">sshableImageId</span> <span class="o">=</span> <span class="s">"your-sshable-image-id"</span><span class="o">;</span> <span class="c1">// this can be obtained using `docker images --no-trunc` command</span>
+<span class="n">Template</span> <span class="n">template</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">templateBuilder</span><span class="o">().</span><span class="na">imageId</span><span class="o">(</span><span class="n">sshableImageId</span><span class="o">).</span><span class="na">build</span><span class="o">();</span>
+
+<span class="c1">// run a couple nodes accessible via group container</span>
+<span class="n">Set</span><span class="o"><?</span> <span class="kd">extends</span> <span class="n">NodeMetadata</span><span class="o">></span> <span class="n">nodes</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">runNodesInGroup</span><span class="o">(</span><span class="s">"container"</span><span class="o">,</span> <span class="mi">2</span><span class="o">,</span> <span class="n">template</span><span class="o">);</span>
+
+<span class="c1">// release resources</span>
+<span class="n">context</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
+</code></pre></div>
+
+
+<p>As for any other jclouds API, this code will create for you 2 nodes in the group <code>container</code> using the provided template.
+The only (big) difference is that jclouds-docker will spin up 2 docker containers for you, instead of being 2 plain-old virtual machines, as it generally happens for the other cloud providers.</p>
+
+ <div class="row clearfix">
+ <div id="footer" class="col-md-12 column">
+ <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/jclouds/jclouds-site/edit/master/guides/docker.md">Fix This Page</a><a class="text-primary" href="https://wiki.apache.org/jclouds/How%20to%20Contribute%20Documentation"><sup>*</sup></a>
+ </p>
+ </div>
+ <div class="col-md-2 column">
+ <p class="text-center">
+ <a class="text-primary" href="https://wiki.apache.org/jclouds/How%20to%20Contribute">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="http://www.apache.org">The Apache Software Foundation</a>. All Rights Reserved.
+ </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/feather-small.gif" width="80", height="24"/>
+ </p>
+ <br/>
+ </div>
+ </div>
+</div>
+
+ </div>
+ </div>
+ </div>
+ </body>
+</html>
Modified: jclouds/site-content/guides/index.html
URL: http://svn.apache.org/viewvc/jclouds/site-content/guides/index.html?rev=1610690&r1=1610689&r2=1610690&view=diff
==============================================================================
--- jclouds/site-content/guides/index.html (original)
+++ jclouds/site-content/guides/index.html Tue Jul 15 13:32:57 2014
@@ -157,6 +157,7 @@
<li><a href="azure-storage">Azure Storage</a></li>
<li><a href="bluelock">BlueLock vCloud</a></li>
<li><a href="cloudsigma">Cloud Sigma</a></li>
+<li><a href="docker">Docker</a></li>
<li><a href="go-grid">Go Grid</a></li>
<li><a href="google">Google Cloud Platform</a></li>
<li><a href="hpcloud">HP Cloud</a></li>
Added: jclouds/site-content/img/jclouds-docker.png
URL: http://svn.apache.org/viewvc/jclouds/site-content/img/jclouds-docker.png?rev=1610690&view=auto
==============================================================================
Binary file - no diff available.
Propchange: jclouds/site-content/img/jclouds-docker.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: jclouds/site-content/img/logos/docker.png
URL: http://svn.apache.org/viewvc/jclouds/site-content/img/logos/docker.png?rev=1610690&view=auto
==============================================================================
Binary file - no diff available.
Propchange: jclouds/site-content/img/logos/docker.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Modified: jclouds/site-content/index.html
URL: http://svn.apache.org/viewvc/jclouds/site-content/index.html?rev=1610690&r1=1610689&r2=1610690&view=diff
==============================================================================
--- jclouds/site-content/index.html (original)
+++ jclouds/site-content/index.html Tue Jul 15 13:32:57 2014
@@ -210,10 +210,11 @@
</ul>
<ul class="list-inline text-center">
<li><img class="img-list" src="img/logos/digitalocean.png" alt="DigitalOcean" title="DigitalOcean"/></li>
+ <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/hpcloud.png" alt="HP Cloud" title="HP Cloud"/></li>
</ul>
<ul class="list-inline text-center">
+ <li><img class="img-list" src="img/logos/hpcloud.png" alt="HP Cloud" title="HP Cloud"/></li>
<li><img class="img-list" src="img/logos/joyent.png" alt="Joyent" title="Joyent"/></li>
<li><img class="img-list" src="img/logos/openstack.png" alt="OpensStack" title="OpenStack"/></li>
<li><img class="img-list" src="img/logos/rackspace.png" alt="Rackspace" title="Rackspace"/></li>
Modified: jclouds/site-content/reference/providers/index.html
URL: http://svn.apache.org/viewvc/jclouds/site-content/reference/providers/index.html?rev=1610690&r1=1610689&r2=1610690&view=diff
==============================================================================
--- jclouds/site-content/reference/providers/index.html (original)
+++ jclouds/site-content/reference/providers/index.html Tue Jul 15 13:32:57 2014
@@ -221,6 +221,11 @@
<td></td>
</tr>
<tr>
+ <td><a href="/guides/docker/">Docker*</a></td>
+ <td>docker</td>
+ <td></td>
+ </tr>
+ <tr>
<td>ElasticHosts GB</td>
<td>elastichosts-lon-b</td>
<td>GB-LND</td>