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/10/06 17:43:06 UTC
svn commit: r1629683 [1/4] - in /jclouds/site-content: ./ blog/
blog/2009/05/13/catching-exceptions-with-less-keystrokes/
blog/2011/10/18/jclouds-1-2-released/
blog/2012/03/23/take-a-peek-at-vcloud-director-1-5-openstack-and/
blog/2012/05/02/new-toys-i...
Author: nacx
Date: Mon Oct 6 15:43:05 2014
New Revision: 1629683
URL: http://svn.apache.org/r1629683
Log:
deploy jclouds site content
Added:
jclouds/site-content/blog/2014/08/05/
jclouds/site-content/blog/2014/08/05/1-release-2-committers/
jclouds/site-content/blog/2014/08/05/1-release-2-committers/index.html
jclouds/site-content/blog/2014/09/04/
jclouds/site-content/blog/2014/09/04/better-builders/
jclouds/site-content/blog/2014/09/04/better-builders/index.html
Modified:
jclouds/site-content/README.md
jclouds/site-content/blog/2009/05/13/catching-exceptions-with-less-keystrokes/index.html
jclouds/site-content/blog/2011/10/18/jclouds-1-2-released/index.html
jclouds/site-content/blog/2012/03/23/take-a-peek-at-vcloud-director-1-5-openstack-and/index.html
jclouds/site-content/blog/2012/05/02/new-toys-in-1-5-0-alpha-6/index.html
jclouds/site-content/blog/2012/07/16/fluency-for-paginated-api-lists/index.html
jclouds/site-content/blog/2012/12/12/jclouds-1-5-4-mistletoe-released/index.html
jclouds/site-content/blog/atom.xml
jclouds/site-content/blog/index.html
jclouds/site-content/blog/page2/index.html
jclouds/site-content/blog/page3/index.html
jclouds/site-content/blog/page4/index.html
jclouds/site-content/blog/page5/index.html
jclouds/site-content/guides/abiquo-cloud/index.html
jclouds/site-content/guides/abiquo/index.html
jclouds/site-content/guides/aws-ebs/index.html
jclouds/site-content/guides/aws-ec2/index.html
jclouds/site-content/guides/aws-sqs/index.html
jclouds/site-content/guides/aws/index.html
jclouds/site-content/guides/azure-storage/index.html
jclouds/site-content/guides/bluelock/index.html
jclouds/site-content/guides/chef/index.html
jclouds/site-content/guides/cloudsigma/index.html
jclouds/site-content/guides/docker/index.html
jclouds/site-content/guides/filesystem/index.html
jclouds/site-content/guides/glacier/index.html
jclouds/site-content/guides/go-grid/index.html
jclouds/site-content/guides/hpcloud/index.html
jclouds/site-content/guides/karaf/index.html
jclouds/site-content/guides/openstack/index.html
jclouds/site-content/guides/rackspace/index.html
jclouds/site-content/guides/vcloud-director/index.html
jclouds/site-content/guides/vcloud/index.html
jclouds/site-content/index.html
jclouds/site-content/reference/configuration/index.html
jclouds/site-content/reference/logging/index.html
jclouds/site-content/reference/troubleshooting/index.html
jclouds/site-content/releasenotes/1.1.0/index.html
jclouds/site-content/releasenotes/1.2/index.html
jclouds/site-content/releasenotes/1.6.1/index.html
jclouds/site-content/releasenotes/1.6.2/index.html
jclouds/site-content/releasenotes/1.6.3/index.html
jclouds/site-content/releasenotes/1.7.0/index.html
jclouds/site-content/releasenotes/1.7.1/index.html
jclouds/site-content/releasenotes/1.7.2/index.html
jclouds/site-content/releasenotes/1.7.3/index.html
jclouds/site-content/releasenotes/atom.xml
jclouds/site-content/start/blobstore/index.html
jclouds/site-content/start/compute/index.html
jclouds/site-content/start/install/index.html
Modified: jclouds/site-content/README.md
URL: http://svn.apache.org/viewvc/jclouds/site-content/README.md?rev=1629683&r1=1629682&r2=1629683&view=diff
==============================================================================
--- jclouds/site-content/README.md (original)
+++ jclouds/site-content/README.md Mon Oct 6 15:43:05 2014
@@ -4,7 +4,7 @@ This repository supports the GitHub Page
To deploy the site:
-* ensure you have [jekyll](http://jekyllrb.com/docs/installation/) 1.5.1 or newer installed
+* ensure you have [jekyll](http://jekyllrb.com/docs/installation/) 1.5.1 installed
* if necessary, clone this repository
* run `sh ./deploy-site.sh [$uid] [$pwd]` from the repository root. Here, `$uid` is your ASF account ID and `$pwd` your ASF password. If you do not supply your account ID or password, you will be prompted for them
Modified: jclouds/site-content/blog/2009/05/13/catching-exceptions-with-less-keystrokes/index.html
URL: http://svn.apache.org/viewvc/jclouds/site-content/blog/2009/05/13/catching-exceptions-with-less-keystrokes/index.html?rev=1629683&r1=1629682&r2=1629683&view=diff
==============================================================================
--- jclouds/site-content/blog/2009/05/13/catching-exceptions-with-less-keystrokes/index.html (original)
+++ jclouds/site-content/blog/2009/05/13/catching-exceptions-with-less-keystrokes/index.html Mon Oct 6 15:43:05 2014
@@ -154,7 +154,8 @@
<span class="o">}</span> <span class="k">catch</span> <span class="o">(</span><span class="n">Exception</span> <span class="n">e</span><span class="o">)</span> <span class="o">{</span>
<span class="n">Utils</span><span class="o">.<</span><span class="n">ApplicationException</span><span class="o">></span><span class="n">rethrowIfRuntimeOrSameType</span><span class="o">(</span><span class="n">e</span><span class="o">);</span>
<span class="k">throw</span> <span class="k">new</span> <span class="nf">ApplicationException</span><span class="o">(</span><span class="s">"Error applying stuff"</span><span class="o">,</span> <span class="n">e</span><span class="o">);</span>
-<span class="o">}</span></code></pre></div>
+<span class="o">}</span>
+</code></pre></div>
<p>This code does what it says, preventing us from unnecessarily nesting application exceptions or swallowing runtimes.</p>
@@ -169,7 +170,8 @@
<span class="o">}</span> <span class="k">catch</span> <span class="o">(</span><span class="n">ClassCastException</span> <span class="n">throwAway</span><span class="o">)</span> <span class="o">{</span>
<span class="c1">// using cce as there's no way to do instanceof E in current java</span>
<span class="o">}</span>
-<span class="o">}</span></code></pre></div>
+<span class="o">}</span>
+</code></pre></div>
<p>The trick is that we try to force the exception we caught into the generic type. If that fails, we know it wasn't that type and that we should wrap, log, etc.</p>
Modified: jclouds/site-content/blog/2011/10/18/jclouds-1-2-released/index.html
URL: http://svn.apache.org/viewvc/jclouds/site-content/blog/2011/10/18/jclouds-1-2-released/index.html?rev=1629683&r1=1629682&r2=1629683&view=diff
==============================================================================
--- jclouds/site-content/blog/2011/10/18/jclouds-1-2-released/index.html (original)
+++ jclouds/site-content/blog/2011/10/18/jclouds-1-2-released/index.html Mon Oct 6 15:43:05 2014
@@ -158,7 +158,8 @@
<div class="highlight"><pre><code class="java"><span class="n">future</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">submitScriptOnNode</span><span class="o">(</span><span class="n">node</span><span class="o">.</span><span class="na">getId</span><span class="o">(),</span>
<span class="n">AdminAccess</span><span class="o">.</span><span class="na">builder</span><span class="o">().</span><span class="na">adminUsername</span><span class="o">(</span><span class="s">"foo"</span><span class="o">).</span><span class="na">build</span><span class="o">(),</span>
- <span class="n">nameTask</span><span class="o">(</span><span class="s">"adminUpdate"</span><span class="o">));</span></code></pre></div>
+ <span class="n">nameTask</span><span class="o">(</span><span class="s">"adminUpdate"</span><span class="o">));</span>
+</code></pre></div>
<p>As always, we keep our <a href="https://github.com/jclouds/jclouds-examples">examples site</a> up to date so you can see how to work this stuff. Next release will be in approximately 1-months time. Look out for progress including <a href="http://www.vmware.com/products/vcloud-director/overview.html">vCloud 1.5</a>, <a href="http://voxel.net/voxcloud">Voxel</a>, and <a href="https://www.virtualbox.org/">VirtualBox</a>.</p>
Modified: jclouds/site-content/blog/2012/03/23/take-a-peek-at-vcloud-director-1-5-openstack-and/index.html
URL: http://svn.apache.org/viewvc/jclouds/site-content/blog/2012/03/23/take-a-peek-at-vcloud-director-1-5-openstack-and/index.html?rev=1629683&r1=1629682&r2=1629683&view=diff
==============================================================================
--- jclouds/site-content/blog/2012/03/23/take-a-peek-at-vcloud-director-1-5-openstack-and/index.html (original)
+++ jclouds/site-content/blog/2012/03/23/take-a-peek-at-vcloud-director-1-5-openstack-and/index.html Mon Oct 6 15:43:05 2014
@@ -162,12 +162,14 @@
<div class="highlight"><pre><code class="clojure"><span class="p">(</span><span class="nf">use</span> <span class="o">'</span><span class="ss">'org.jclouds.compute2</span><span class="p">)</span>
<span class="p">(</span><span class="nb">import </span><span class="o">'</span><span class="ss">'org.jclouds.scriptbuilder.statements.login.AdminAccess</span><span class="p">)</span>
<span class="p">(</span><span class="k">def </span><span class="nv">compute</span> <span class="p">(</span><span class="nf">compute-service</span> <span class="s">"hpcloud-compute"</span> <span class="s">"tenantId:ACCESSKEY"</span> <span class="s">"SECRETKEY"</span> <span class="ss">:slf4j</span> <span class="ss">:sshj</span><span class="p">))</span>
-<span class="p">(</span><span class="nf">create-node</span> <span class="nv">compute</span> <span class="s">"test"</span> <span class="p">(</span><span class="nf">build-template</span> <span class="nv">compute</span> <span class="p">{</span> <span class="ss">:run-script</span> <span class="p">(</span><span class="nf">AdminAccess/standard</span><span class="p">)</span> <span class="p">}</span> <span class="p">))</span></code></pre></div>
+<span class="p">(</span><span class="nf">create-node</span> <span class="nv">compute</span> <span class="s">"test"</span> <span class="p">(</span><span class="nf">build-template</span> <span class="nv">compute</span> <span class="p">{</span> <span class="ss">:run-script</span> <span class="p">(</span><span class="nf">AdminAccess/standard</span><span class="p">)</span> <span class="p">}</span> <span class="p">))</span>
+</code></pre></div>
<p>Here's an example of how to do the same on <a href="https://trystack.org/">TryStack</a>, authenticating w/ user & pass as opposed to key, via our <a href="https://github.com/jclouds/jclouds-examples/tree/master/compute-basics">java example</a>:</p>
-<div class="highlight"><pre><code class="bash">java -jar target/compute-basics-jar-with-dependencies.jar trystack-nova tenantId:user password mygroup add</code></pre></div>
+<div class="highlight"><pre><code class="bash">java -jar target/compute-basics-jar-with-dependencies.jar trystack-nova tenantId:user password mygroup add
+</code></pre></div>
<p>In the group org.jclouds.labs, you'll find two more new and notable members of the jclouds family:</p>
@@ -180,7 +182,8 @@
<p>You can try out virtualbox like any other api. For example, you can use the clojure above, only changing how you create the connection slightly:</p>
-<div class="highlight"><pre><code class="clojure"><span class="p">(</span><span class="k">def </span><span class="nv">compute</span> <span class="p">(</span><span class="nf">compute-service</span> <span class="s">"virtualbox"</span> <span class="s">"administrator"</span> <span class="s">"12345"</span> <span class="ss">:sshj</span> <span class="ss">:slf4j</span><span class="p">))</span></code></pre></div>
+<div class="highlight"><pre><code class="clojure"><span class="p">(</span><span class="k">def </span><span class="nv">compute</span> <span class="p">(</span><span class="nf">compute-service</span> <span class="s">"virtualbox"</span> <span class="s">"administrator"</span> <span class="s">"12345"</span> <span class="ss">:sshj</span> <span class="ss">:slf4j</span><span class="p">))</span>
+</code></pre></div>
<p>The code in labs will certainly change before we release a beta, but feel free to check them out. Meanwhile, you can try them out and give us feedback on #jclouds irc freenode or jclouds-dev google group!</p>
@@ -189,7 +192,8 @@
<p>Oh, and don't forget to clean up your nodes :)</p>
-<div class="highlight"><pre><code class="clojure"><span class="p">(</span><span class="nf">destroy-nodes-matching</span> <span class="nv">compute</span> <span class="p">(</span><span class="nb">constantly </span><span class="nv">true</span><span class="p">))</span></code></pre></div>
+<div class="highlight"><pre><code class="clojure"><span class="p">(</span><span class="nf">destroy-nodes-matching</span> <span class="nv">compute</span> <span class="p">(</span><span class="nb">constantly </span><span class="nv">true</span><span class="p">))</span>
+</code></pre></div>
Modified: jclouds/site-content/blog/2012/05/02/new-toys-in-1-5-0-alpha-6/index.html
URL: http://svn.apache.org/viewvc/jclouds/site-content/blog/2012/05/02/new-toys-in-1-5-0-alpha-6/index.html?rev=1629683&r1=1629682&r2=1629683&view=diff
==============================================================================
--- jclouds/site-content/blog/2012/05/02/new-toys-in-1-5-0-alpha-6/index.html (original)
+++ jclouds/site-content/blog/2012/05/02/new-toys-in-1-5-0-alpha-6/index.html Mon Oct 6 15:43:05 2014
@@ -161,7 +161,8 @@
<span class="k">for</span> <span class="o">(</span><span class="n">Tenant</span> <span class="n">tenant</span> <span class="o">:</span> <span class="n">adminClient</span><span class="o">.</span><span class="na">listTenants</span><span class="o">())</span> <span class="o">{</span>
<span class="c1">// ...</span>
<span class="o">}</span>
-<span class="o">}</span></code></pre></div>
+<span class="o">}</span>
+</code></pre></div>
<p>Also pro, is our new Amazon CloudWatch support from Jeremy Whitlock. This is our first complete renovation of an AWS api to have the same look/feel as our new OpenStack stuff. Just add a dependency on <em>org.jclouds.providers/aws-cloudwatch</em> and you can do this!</p>
@@ -176,7 +177,8 @@
<span class="k">for</span> <span class="o">(</span><span class="n">Metric</span> <span class="n">metric</span> <span class="o">:</span> <span class="n">metricClient</span><span class="o">.</span><span class="na">listMetrics</span><span class="o">())</span> <span class="o">{</span>
<span class="c1">// ...</span>
<span class="o">}</span>
-<span class="o">}</span></code></pre></div>
+<span class="o">}</span>
+</code></pre></div>
<p>And for the jenkins users, we also have an api for remote job and computer control, at <em>org.jclouds.labs/jenkins</em>!</p>
@@ -185,7 +187,8 @@
<span class="n">RestContext</span> <span class="n">localhost</span> <span class="o">=</span> <span class="n">contextBuilder</span><span class="o">.</span><span class="na">build</span><span class="o">();</span>
<span class="n">Node</span> <span class="n">master</span> <span class="o">=</span> <span class="n">localhost</span><span class="o">.</span><span class="na">getApi</span><span class="o">().</span><span class="na">getMaster</span><span class="o">();</span>
-<span class="n">localhost</span><span class="o">.</span><span class="na">getJobClient</span><span class="o">().</span><span class="na">createFromXML</span><span class="o">(</span><span class="s">"newJob"</span><span class="o">,</span> <span class="n">xmlAsString</span><span class="o">);</span></code></pre></div>
+<span class="n">localhost</span><span class="o">.</span><span class="na">getJobClient</span><span class="o">().</span><span class="na">createFromXML</span><span class="o">(</span><span class="s">"newJob"</span><span class="o">,</span> <span class="n">xmlAsString</span><span class="o">);</span>
+</code></pre></div>
<p>This is especially helpful with the new <a href="https://github.com/jenkinsci/jclouds-plugin">jclouds-plugin</a>, which uses jclouds to spin up new slaves and publish artifacts to BlobStore. Tons more in there, too.</p>
Modified: jclouds/site-content/blog/2012/07/16/fluency-for-paginated-api-lists/index.html
URL: http://svn.apache.org/viewvc/jclouds/site-content/blog/2012/07/16/fluency-for-paginated-api-lists/index.html?rev=1629683&r1=1629682&r2=1629683&view=diff
==============================================================================
--- jclouds/site-content/blog/2012/07/16/fluency-for-paginated-api-lists/index.html (original)
+++ jclouds/site-content/blog/2012/07/16/fluency-for-paginated-api-lists/index.html Mon Oct 6 15:43:05 2014
@@ -168,7 +168,8 @@
<h3>Lazy advance through all your metrics:</h3>
-<div class="highlight"><pre><code class="java"><span class="n">FluentIterable</span><span class="o"><</span><span class="n">Metric</span><span class="o">></span> <span class="n">allMetrics</span> <span class="o">=</span> <span class="n">cloudwatch</span><span class="o">.</span><span class="na">getMetricApi</span><span class="o">().</span><span class="na">list</span><span class="o">().</span><span class="na">concat</span><span class="o">();</span></code></pre></div>
+<div class="highlight"><pre><code class="java"><span class="n">FluentIterable</span><span class="o"><</span><span class="n">Metric</span><span class="o">></span> <span class="n">allMetrics</span> <span class="o">=</span> <span class="n">cloudwatch</span><span class="o">.</span><span class="na">getMetricApi</span><span class="o">().</span><span class="na">list</span><span class="o">().</span><span class="na">concat</span><span class="o">();</span>
+</code></pre></div>
<h3>Â Advance only until we find the load balancer we want:</h3>
@@ -176,12 +177,14 @@
<div class="highlight"><pre><code class="java"><span class="n">Optional</span><span class="o"><</span><span class="n">LoadBalancer</span><span class="o">></span> <span class="n">firstInterestingLoadBalancer</span> <span class="o">=</span> <span class="n">elb</span>
<span class="o">.</span><span class="na">getLoadBalancerApi</span><span class="o">().</span><span class="na">list</span><span class="o">()</span>
<span class="o">.</span><span class="na">concat</span><span class="o">()</span>
- <span class="o">.</span><span class="na">firstMatch</span><span class="o">(</span><span class="n">isInterestingLB</span><span class="o">());</span></code></pre></div>
+ <span class="o">.</span><span class="na">firstMatch</span><span class="o">(</span><span class="n">isInterestingLB</span><span class="o">());</span>
+</code></pre></div>
<h3>Get only the first page of database instances</h3>
-<div class="highlight"><pre><code class="java"><span class="n">IterableWithMarker</span><span class="o"><</span><span class="n">Instance</span><span class="o">></span> <span class="n">firstPage</span> <span class="o">=</span> <span class="n">rds</span><span class="o">.</span><span class="na">getInstanceApi</span><span class="o">().</span><span class="na">list</span><span class="o">().</span><span class="na">get</span><span class="o">(</span><span class="mi">0</span><span class="o">);</span></code></pre></div>
+<div class="highlight"><pre><code class="java"><span class="n">IterableWithMarker</span><span class="o"><</span><span class="n">Instance</span><span class="o">></span> <span class="n">firstPage</span> <span class="o">=</span> <span class="n">rds</span><span class="o">.</span><span class="na">getInstanceApi</span><span class="o">().</span><span class="na">list</span><span class="o">().</span><span class="na">get</span><span class="o">(</span><span class="mi">0</span><span class="o">);</span>
+</code></pre></div>
<p>The above syntax is being worked through relevant apis. In order to try it out, grab jclouds 1.5.0-beta.7 (releasing today), and use any of the following methods:</p>
Modified: jclouds/site-content/blog/2012/12/12/jclouds-1-5-4-mistletoe-released/index.html
URL: http://svn.apache.org/viewvc/jclouds/site-content/blog/2012/12/12/jclouds-1-5-4-mistletoe-released/index.html?rev=1629683&r1=1629682&r2=1629683&view=diff
==============================================================================
--- jclouds/site-content/blog/2012/12/12/jclouds-1-5-4-mistletoe-released/index.html (original)
+++ jclouds/site-content/blog/2012/12/12/jclouds-1-5-4-mistletoe-released/index.html Mon Oct 6 15:43:05 2014
@@ -156,7 +156,8 @@
<p>For example, the following syntax can be used in karaf directly, or via the <a href="https://github.com/jclouds/jclouds-cli">jclouds cli</a> to start a node in any supported cloud and bootstrap chef recipes.</p>
-<div class="highlight"><pre><code class="bash">karaf@root>node-create --adminAccess --recipe chef/java::openjdk karaf</code></pre></div>
+<div class="highlight"><pre><code class="bash">karaf@root>node-create --adminAccess --recipe chef/java::openjdk karaf
+</code></pre></div>
<h2>What else is in 1.5.4?</h2>
@@ -167,14 +168,16 @@
<p><a href="https://github.com/everett-toews">Everett</a> modernized support for <strong>rackspace-cloudloadbalancers-us</strong> and <strong>uk</strong> is now available. This includes syntactic sugar such as auto-pagination and easy transforms.</p>
-<div class="highlight"><pre><code class="java"><span class="n">FluentIterable</span><span class="o"><</span><span class="n">HostAndPort</span><span class="o">></span> <span class="n">sockets</span> <span class="o">=</span> <span class="n">clb</span><span class="o">.</span><span class="na">getLoadBalancerApiForZone</span><span class="o">(</span><span class="n">zone</span><span class="o">).</span><span class="na">list</span><span class="o">().</span><span class="na">concat</span><span class="o">().</span><span class="na">transform</span><span class="o">(</span><span class="n">converter</span><span class="o">);</span></code></pre></div>
+<div class="highlight"><pre><code class="java"><span class="n">FluentIterable</span><span class="o"><</span><span class="n">HostAndPort</span><span class="o">></span> <span class="n">sockets</span> <span class="o">=</span> <span class="n">clb</span><span class="o">.</span><span class="na">getLoadBalancerApiForZone</span><span class="o">(</span><span class="n">zone</span><span class="o">).</span><span class="na">list</span><span class="o">().</span><span class="na">concat</span><span class="o">().</span><span class="na">transform</span><span class="o">(</span><span class="n">converter</span><span class="o">);</span>
+</code></pre></div>
<h3>Nova Server Diagnostics</h3>
<p>Some implementations of Nova have diagnostic information available. Thanks to <a href="https://github.com/LeanderBB">Leander</a>, you can now discover this capability at runtime.</p>
-<div class="highlight"><pre><code class="java"><span class="n">Optional</span><span class="o"><</span><span class="n">Map</span><span class="o">></span> <span class="n">diagnosticInfo</span> <span class="o">=</span> <span class="n">novaApi</span><span class="o">.</span><span class="na">getServerApiForZone</span><span class="o">(</span><span class="s">"az-1.region-a.geo-1"</span><span class="o">).</span><span class="na">getDiagnostics</span><span class="o">(</span><span class="n">serverId</span><span class="o">);</span></code></pre></div>
+<div class="highlight"><pre><code class="java"><span class="n">Optional</span><span class="o"><</span><span class="n">Map</span><span class="o">></span> <span class="n">diagnosticInfo</span> <span class="o">=</span> <span class="n">novaApi</span><span class="o">.</span><span class="na">getServerApiForZone</span><span class="o">(</span><span class="s">"az-1.region-a.geo-1"</span><span class="o">).</span><span class="na">getDiagnostics</span><span class="o">(</span><span class="n">serverId</span><span class="o">);</span>
+</code></pre></div>
<h3>S3 Multi-Object delete</h3>
@@ -182,7 +185,8 @@
<p><a href="http://maginatics.com/">Maginatics</a> have BlobStore containers with over a billion objects in them. S3 containers (buckets) can now be cleared with 1/1000 the requests, thanks to <a href="https://twitter.com/andreisavu">Andrei</a>'s additional support of S3 multi-delete.</p>
<div class="highlight"><pre><code class="java"><span class="n">DeleteResult</span> <span class="n">result</span> <span class="o">=</span> <span class="n">s3Api</span><span class="o">.</span><span class="na">deleteObjects</span><span class="o">(</span><span class="n">container</span><span class="o">,</span> <span class="n">keys</span><span class="o">);</span>
-<span class="n">assertEquals</span><span class="o">(</span><span class="n">result</span><span class="o">.</span><span class="na">size</span><span class="o">(),</span> <span class="n">keys</span><span class="o">.</span><span class="na">size</span><span class="o">());</span></code></pre></div>
+<span class="n">assertEquals</span><span class="o">(</span><span class="n">result</span><span class="o">.</span><span class="na">size</span><span class="o">(),</span> <span class="n">keys</span><span class="o">.</span><span class="na">size</span><span class="o">());</span>
+</code></pre></div>
<h2>What's next</h2>
Added: jclouds/site-content/blog/2014/08/05/1-release-2-committers/index.html
URL: http://svn.apache.org/viewvc/jclouds/site-content/blog/2014/08/05/1-release-2-committers/index.html?rev=1629683&view=auto
==============================================================================
--- jclouds/site-content/blog/2014/08/05/1-release-2-committers/index.html (added)
+++ jclouds/site-content/blog/2014/08/05/1-release-2-committers/index.html Mon Oct 6 15:43:05 2014
@@ -0,0 +1,239 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+<title>Apache jclouds® :: 1 release, 2 committers...a busy week for jclouds!</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.org');
+ 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.8.0">1.8.0</a></li>
+ <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 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>1 release, 2 committers...a busy week for jclouds!</h1>
+ <span class="text-muted">05 August 2014, by <a href="http://blog.xebialabs.com/author/aphillips/">Andrew Phillips</a></span>
+ </div>
+ <p><img class="img-right" src="/img/posts/chris-and-andrea.png"/>There's a lot going on this week for the jclouds community. Most importantly, we're really pleased to introduce two new committers: Andrea Turli and Chris Custine.</p>
+
+<!--more-->
+
+
+<p><a href="https://twitter.com/turlinux">Andrea</a> has been involved with jclouds for quite a while, working previously on the libvirt and vSphere <a href="/start/compute/">compute</a> providers. He's recently brought SoftLayer support up to speed and contributed the new <a href="/guides/docker/">Docker provider</a>, which is a really exciting addition.</p>
+
+<p><a href="https://twitter.com/ccustine">Chris</a> also has a lot of prior experience with many areas of jclouds, including <a href="/guides/chef/">Chef</a> and <a href="/guides/karaf/">Karaf</a>, as well as contributing to a number of projects in the surrounding ecosystem. He's recently worked on <a href="/guides/openstack">OpenStack</a>, especially on getting <a href="/guides/hpcloud/">HP Cloud</a>'s compute and blobstore providers back in shape.</p>
+
+<p>Both Andrea and Chris have been active in the jclouds community too, regularly contributing to discussions and helping to answer questions on the mailing lists and IRC. We're very glad to have both on board!</p>
+
+<p>In other news: we've been busy <a href="http://markmail.org/thread/7ixght2jgfbu73ok">getting the 1.8.0 release ready</a>, which (advance warning here!) will be the last jclouds release to support Java 6. More details to come once the release has been finalized...watch this space!</p>
+
+
+ <div id="comments">
+ <hr/>
+ <div id="disqus_thread"></div>
+<script type="text/javascript">
+var disqus_shortname = 'jclouds';
+/* * * DON'T EDIT BELOW THIS LINE * * */
+(function() {
+ var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
+ dsq.src = '//' + disqus_shortname + '.disqus.com/embed.js';
+ (document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
+})();
+</script>
+<noscript>Please enable JavaScript to view the <a href="http://disqus.com/?ref_noscript">Comments powered by Disqus.</a></noscript>
+<a href="http://disqus.com" class="dsq-brlink">Comments powered by <span class="logo-disqus">Disqus</span></a>
+
+ </div>
+
+ <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/_posts/2014-08-04-1-release-2-committers.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>
Added: jclouds/site-content/blog/2014/09/04/better-builders/index.html
URL: http://svn.apache.org/viewvc/jclouds/site-content/blog/2014/09/04/better-builders/index.html?rev=1629683&view=auto
==============================================================================
--- jclouds/site-content/blog/2014/09/04/better-builders/index.html (added)
+++ jclouds/site-content/blog/2014/09/04/better-builders/index.html Mon Oct 6 15:43:05 2014
@@ -0,0 +1,347 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+<title>Apache jclouds® :: Better Builders with jclouds!</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.org');
+ 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.8.0">1.8.0</a></li>
+ <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 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>Better Builders with jclouds!</h1>
+ <span class="text-muted">04 September 2014, by Zack Shoylev</span>
+ </div>
+ <p>If you are a new <a href="jclouds.apache.org">jclouds</a> developer, or even if you are already developing jclouds support for any of the OpenStack or Rackspace APIs, you have likely seen the domain classes that are used throughout the the jclouds codebase.
+These classes are used to represent OpenStack resources, particularly the JSON structures supported by OpenStack APIs.</p>
+
+<!--more-->
+
+
+<p>For example, when listing database users in openstack-trove (the OpenStack database API), the service returns a JSON response body describing the existing users. This JSON might look something like this:</p>
+
+<div class="highlight"><pre><code class="json"><span class="p">{</span>
+ <span class="nt">"users"</span><span class="p">:</span> <span class="p">[</span>
+ <span class="p">{</span>
+ <span class="nt">"databases"</span><span class="p">:</span> <span class="p">[],</span>
+ <span class="nt">"host"</span><span class="p">:</span> <span class="s2">"%"</span><span class="p">,</span>
+ <span class="nt">"name"</span><span class="p">:</span> <span class="s2">"dbuser1"</span>
+ <span class="p">},</span>
+ <span class="p">{</span>
+ <span class="nt">"databases"</span><span class="p">:</span> <span class="p">[</span>
+ <span class="p">{</span>
+ <span class="nt">"name"</span><span class="p">:</span> <span class="s2">"databaseB"</span>
+ <span class="p">},</span>
+ <span class="p">{</span>
+ <span class="nt">"name"</span><span class="p">:</span> <span class="s2">"databaseC"</span>
+ <span class="p">}</span>
+ <span class="p">],</span>
+ <span class="nt">"host"</span><span class="p">:</span> <span class="s2">"%"</span><span class="p">,</span>
+ <span class="nt">"name"</span><span class="p">:</span> <span class="s2">"dbuser2"</span>
+ <span class="p">},</span>
+ <span class="p">{</span>
+ <span class="nt">"databases"</span><span class="p">:</span> <span class="p">[],</span>
+ <span class="nt">"name"</span><span class="p">:</span> <span class="s2">"dbuser3"</span><span class="p">,</span>
+ <span class="nt">"host"</span><span class="p">:</span> <span class="s2">"%"</span>
+ <span class="p">},</span>
+ <span class="p">{</span>
+ <span class="nt">"databases"</span><span class="p">:</span> <span class="p">[</span>
+ <span class="p">{</span>
+ <span class="nt">"name"</span><span class="p">:</span> <span class="s2">"sampledb"</span>
+ <span class="p">}</span>
+ <span class="p">],</span>
+ <span class="nt">"host"</span><span class="p">:</span> <span class="s2">"%"</span><span class="p">,</span>
+ <span class="nt">"name"</span><span class="p">:</span> <span class="s2">"demouser"</span>
+ <span class="p">}</span>
+ <span class="p">]</span>
+<span class="p">}</span>
+</code></pre></div>
+
+
+<p>To parse the response, jclouds uses <a href="https://github.com/jclouds/jclouds/blob/master/apis/openstack-trove/src/main/java/org/jclouds/openstack/trove/v1/domain/User.java">domain classes</a> to represent the JSON data returned by the service. The array of "users" is unwrapped into individual User domain objects. Conversely, when creating users, domain objects are transformed into a JSON request body.</p>
+
+<p>Because of the relative simplicity of user creation in trove, jclouds developers can use a create method in the features package without having to build an instance of the User class. For example, the developer might use a method such as</p>
+
+<div class="highlight"><pre><code class="java"><span class="kt">boolean</span> <span class="nf">create</span><span class="o">(</span><span class="n">String</span> <span class="n">userName</span><span class="o">,</span> <span class="n">String</span> <span class="n">password</span><span class="o">,</span> <span class="n">String</span> <span class="n">databaseName</span><span class="o">);</span>
+</code></pre></div>
+
+
+<p>In this case, it was easy to add support for this call by using a <a href="https://github.com/jclouds/jclouds/blob/master/apis/openstack-trove/src/main/java/org/jclouds/openstack/trove/v1/binders/BindCreateUserToJson.java">map binder</a>.</p>
+
+<p>However, some APIs send or receive significantly more complex JSON structures. Recent work on Neutron has shown that there are benefits to increased consistency among the domain classes and the OpenStack API calls that use them.</p>
+
+<p>Current implementations have the following two issues :</p>
+
+<ol>
+<li>Heavy use of map-binders and parsers to transform JSON. Map-binders use annotation-selected classes to map method data (such as the data in the create-user call above) to the JSON required by the service. The <a href="https://github.com/jclouds/jclouds-labs-openstack/blob/master/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/functions/ParseNetworkDetails.java">parsers</a> apply the reverse transformation: from JSON to domain objects.</li>
+<li>Lack of consistent, concise, and user-friendly way to use domain objects in create/update/list methods.</li>
+</ol>
+
+
+<p>In addition to fixing these issues, jclouds wants to provide developers with some compiler checks and other syntactic sugar (fluent builders), while also supporting different updating, creating, or listing validation strategies.</p>
+
+<p>We want to</p>
+
+<ol>
+<li>Ensure object immutability.</li>
+<li>Utilize the fluent builder pattern.</li>
+<li>Ensure that "create" objects can only be used for create; update for update; and listed resources cannot be directly sent back to the service.</li>
+<li>Reuse code and keep domain classes <a href="http://en.wikipedia.org/wiki/Don't_repeat_yourself">DRY</a>.</li>
+<li>Allow using different validation strategies (for example, create vs update).</li>
+</ol>
+
+
+<p>We have been able to identify a pattern that addresses these issues. Here is some <a href="https://github.com/jclouds/jclouds-labs-openstack/blob/master/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2/domain/Router.java">sample code</a>.</p>
+
+<p>This approach reuses code by having <a href="https://code.google.com/p/google-gson/">GSON</a> handle the domain objects directly, as much as possible, both for serialization and deserialization, thus eliminating map-binders and parsers in most cases. The domain classes annotate their member variables using the @Named (for serialization) and @ConstructorProperties (for deserialization) annotations.</p>
+
+<p>Many of the JSON attributes in Neutron are optional. GSON's jclouds configuration supports such optional values by using @Nullable and boxed types. An alternate supported method, more convoluted, implements Optional<T> private member variables and getter return types.</p>
+
+<p>To ensure immutability, users have no access to a constructor or setters, and instead they must instantiate domain objects by using a slightly modified Builder pattern. The builder pattern also provides proper validation and user-friendliness.</p>
+
+<p>Some <a href="https://github.com/jclouds/jclouds-labs-openstack/blob/master/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2/domain/AddressPair.java">simpler classes</a> implement the regular fluent builder pattern.</p>
+
+<p>In <a href="https://github.com/jclouds/jclouds-labs-openstack/blob/master/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2/features/NetworkApi.java">other cases</a>, the same domain class has several different purposes, such as making sure users have different Network-subtype object instances for updating, creating, and listing networks:</p>
+
+<ol>
+<li>Listing networks returns a Network or a list of Networks.</li>
+<li>Updating a network requires Network.UpdateOptions.</li>
+<li>Creating a network requires Network.CreateOptions.</li>
+</ol>
+
+
+<p>CreateOptions and UpdateOptions extend Network and implement their own copy constructors, with custom validation, if needed.</p>
+
+<p>To instantiate these create or update-specific objects, developers have access to CreateBuilder and UpdateBuilder, which both extend the regular Network builder abstract class. The only code these special builders implement: the constructor (taking as parameters any required properties), a build() method returning the create or update object, and also self(). The self method is needed to make sure we can reuse most of the Builder code, but still be able to chain the fluent builder methods.</p>
+
+<p>This is how it all works out from the developer's perspective:</p>
+
+<div class="highlight"><pre><code class="java"><span class="n">Network</span><span class="o">.</span><span class="na">CreateOptions</span> <span class="n">createNetwork</span> <span class="o">=</span> <span class="n">Network</span><span class="o">.</span><span class="na">createOptions</span><span class="o">(</span><span class="s">"jclouds-wibble"</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">networkType</span><span class="o">(</span><span class="n">NetworkType</span><span class="o">.</span><span class="na">LOCAL</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">build</span><span class="o">();</span>
+
+<span class="n">Network</span> <span class="n">network</span> <span class="o">=</span> <span class="n">networkApi</span><span class="o">.</span><span class="na">create</span><span class="o">(</span><span class="n">createNetwork</span><span class="o">);</span>
+
+<span class="n">Network</span><span class="o">.</span><span class="na">UpdateOptions</span> <span class="n">updateNetwork</span> <span class="o">=</span> <span class="n">Network</span><span class="o">.</span><span class="na">updateOptions</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">name</span><span class="o">(</span><span class="s">"jclouds-wibble-updated"</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">networkType</span><span class="o">(</span><span class="n">NetworkType</span><span class="o">.</span><span class="na">LOCAL</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">build</span><span class="o">();</span>
+
+<span class="n">networkApi</span><span class="o">.</span><span class="na">update</span><span class="o">(</span><span class="s">"some id"</span><span class="o">,</span> <span class="n">updateNetwork</span><span class="o">);</span>
+</code></pre></div>
+
+
+<p>This ensures developers get an easy to understand interface, with validation and compiler checks. It also allows jclouds developers to use significantly less code when developing complex domain classes that need to be reused in list/create/update API calls.</p>
+
+
+ <div id="comments">
+ <hr/>
+ <div id="disqus_thread"></div>
+<script type="text/javascript">
+var disqus_shortname = 'jclouds';
+/* * * DON'T EDIT BELOW THIS LINE * * */
+(function() {
+ var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
+ dsq.src = '//' + disqus_shortname + '.disqus.com/embed.js';
+ (document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
+})();
+</script>
+<noscript>Please enable JavaScript to view the <a href="http://disqus.com/?ref_noscript">Comments powered by Disqus.</a></noscript>
+<a href="http://disqus.com" class="dsq-brlink">Comments powered by <span class="logo-disqus">Disqus</span></a>
+
+ </div>
+
+ <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/_posts/2014-09-03-better-builders.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/blog/atom.xml
URL: http://svn.apache.org/viewvc/jclouds/site-content/blog/atom.xml?rev=1629683&r1=1629682&r2=1629683&view=diff
==============================================================================
--- jclouds/site-content/blog/atom.xml (original)
+++ jclouds/site-content/blog/atom.xml Mon Oct 6 15:43:05 2014
@@ -8,10 +8,10 @@
<entry>
- <id>http://jclouds.apache.org/blog/2014/09/03/better-builders</id>
+ <id>http://jclouds.apache.org/blog/2014/09/04/better-builders</id>
<title type="html"><![CDATA[Better Builders with jclouds!]]></title>
- <link href="http://jclouds.apache.org/blog/2014/09/03/better-builders"/>
- <updated>2014-09-03T00:00:00Z</updated>
+ <link href="http://jclouds.apache.org/blog/2014/09/04/better-builders"/>
+ <updated>2014-09-04T00:00:00Z</updated>
<content type="html"><![CDATA[<p>If you are a new <a href="jclouds.apache.org">jclouds</a> developer, or even if you are already developing jclouds support for any of the OpenStack or Rackspace APIs, you have likely seen the domain classes that are used throughout the the jclouds codebase.
These classes are used to represent OpenStack resources, particularly the JSON structures supported by OpenStack APIs.</p>
@@ -54,14 +54,16 @@ These classes are used to represent Open
<span class="nt">"name"</span><span class="p">:</span> <span class="s2">"demouser"</span>
<span class="p">}</span>
<span class="p">]</span>
-<span class="p">}</span></code></pre></div>
+<span class="p">}</span>
+</code></pre></div>
<p>To parse the response, jclouds uses <a href="https://github.com/jclouds/jclouds/blob/master/apis/openstack-trove/src/main/java/org/jclouds/openstack/trove/v1/domain/User.java">domain classes</a> to represent the JSON data returned by the service. The array of "users" is unwrapped into individual User domain objects. Conversely, when creating users, domain objects are transformed into a JSON request body.</p>
<p>Because of the relative simplicity of user creation in trove, jclouds developers can use a create method in the features package without having to build an instance of the User class. For example, the developer might use a method such as</p>
-<div class="highlight"><pre><code class="java"><span class="kt">boolean</span> <span class="nf">create</span><span class="o">(</span><span class="n">String</span> <span class="n">userName</span><span class="o">,</span> <span class="n">String</span> <span class="n">password</span><span class="o">,</span> <span class="n">String</span> <span class="n">databaseName</span><span class="o">);</span></code></pre></div>
+<div class="highlight"><pre><code class="java"><span class="kt">boolean</span> <span class="nf">create</span><span class="o">(</span><span class="n">String</span> <span class="n">userName</span><span class="o">,</span> <span class="n">String</span> <span class="n">password</span><span class="o">,</span> <span class="n">String</span> <span class="n">databaseName</span><span class="o">);</span>
+</code></pre></div>
<p>In this case, it was easy to add support for this call by using a <a href="https://github.com/jclouds/jclouds/blob/master/apis/openstack-trove/src/main/java/org/jclouds/openstack/trove/v1/binders/BindCreateUserToJson.java">map binder</a>.</p>
@@ -125,7 +127,8 @@ These classes are used to represent Open
<span class="o">.</span><span class="na">networkType</span><span class="o">(</span><span class="n">NetworkType</span><span class="o">.</span><span class="na">LOCAL</span><span class="o">)</span>
<span class="o">.</span><span class="na">build</span><span class="o">();</span>
-<span class="n">networkApi</span><span class="o">.</span><span class="na">update</span><span class="o">(</span><span class="s">"some id"</span><span class="o">,</span> <span class="n">updateNetwork</span><span class="o">);</span></code></pre></div>
+<span class="n">networkApi</span><span class="o">.</span><span class="na">update</span><span class="o">(</span><span class="s">"some id"</span><span class="o">,</span> <span class="n">updateNetwork</span><span class="o">);</span>
+</code></pre></div>
<p>This ensures developers get an easy to understand interface, with validation and compiler checks. It also allows jclouds developers to use significantly less code when developing complex domain classes that need to be reused in list/create/update API calls.</p>
@@ -133,10 +136,10 @@ These classes are used to represent Open
</entry>
<entry>
- <id>http://jclouds.apache.org/blog/2014/08/04/1-release-2-committers</id>
+ <id>http://jclouds.apache.org/blog/2014/08/05/1-release-2-committers</id>
<title type="html"><![CDATA[1 release, 2 committers...a busy week for jclouds!]]></title>
- <link href="http://jclouds.apache.org/blog/2014/08/04/1-release-2-committers"/>
- <updated>2014-08-04T00:00:00Z</updated>
+ <link href="http://jclouds.apache.org/blog/2014/08/05/1-release-2-committers"/>
+ <updated>2014-08-05T00:00:00Z</updated>
<content type="html"><![CDATA[<p><img class="img-right" src="/img/posts/chris-and-andrea.png"/>There's a lot going on this week for the jclouds community. Most importantly, we're really pleased to introduce two new committers: Andrea Turli and Chris Custine.</p>
<!--more-->
@@ -605,7 +608,8 @@ These classes are used to represent Open
<p>For example, the following syntax can be used in karaf directly, or via the <a href="https://github.com/jclouds/jclouds-cli">jclouds cli</a> to start a node in any supported cloud and bootstrap chef recipes.</p>
-<div class="highlight"><pre><code class="bash">karaf@root>node-create --adminAccess --recipe chef/java::openjdk karaf</code></pre></div>
+<div class="highlight"><pre><code class="bash">karaf@root>node-create --adminAccess --recipe chef/java::openjdk karaf
+</code></pre></div>
<h2>What else is in 1.5.4?</h2>
@@ -616,14 +620,16 @@ These classes are used to represent Open
<p><a href="https://github.com/everett-toews">Everett</a> modernized support for <strong>rackspace-cloudloadbalancers-us</strong> and <strong>uk</strong> is now available. This includes syntactic sugar such as auto-pagination and easy transforms.</p>
-<div class="highlight"><pre><code class="java"><span class="n">FluentIterable</span><span class="o"><</span><span class="n">HostAndPort</span><span class="o">></span> <span class="n">sockets</span> <span class="o">=</span> <span class="n">clb</span><span class="o">.</span><span class="na">getLoadBalancerApiForZone</span><span class="o">(</span><span class="n">zone</span><span class="o">).</span><span class="na">list</span><span class="o">().</span><span class="na">concat</span><span class="o">().</span><span class="na">transform</span><span class="o">(</span><span class="n">converter</span><span class="o">);</span></code></pre></div>
+<div class="highlight"><pre><code class="java"><span class="n">FluentIterable</span><span class="o"><</span><span class="n">HostAndPort</span><span class="o">></span> <span class="n">sockets</span> <span class="o">=</span> <span class="n">clb</span><span class="o">.</span><span class="na">getLoadBalancerApiForZone</span><span class="o">(</span><span class="n">zone</span><span class="o">).</span><span class="na">list</span><span class="o">().</span><span class="na">concat</span><span class="o">().</span><span class="na">transform</span><span class="o">(</span><span class="n">converter</span><span class="o">);</span>
+</code></pre></div>
<h3>Nova Server Diagnostics</h3>
<p>Some implementations of Nova have diagnostic information available. Thanks to <a href="https://github.com/LeanderBB">Leander</a>, you can now discover this capability at runtime.</p>
-<div class="highlight"><pre><code class="java"><span class="n">Optional</span><span class="o"><</span><span class="n">Map</span><span class="o">></span> <span class="n">diagnosticInfo</span> <span class="o">=</span> <span class="n">novaApi</span><span class="o">.</span><span class="na">getServerApiForZone</span><span class="o">(</span><span class="s">"az-1.region-a.geo-1"</span><span class="o">).</span><span class="na">getDiagnostics</span><span class="o">(</span><span class="n">serverId</span><span class="o">);</span></code></pre></div>
+<div class="highlight"><pre><code class="java"><span class="n">Optional</span><span class="o"><</span><span class="n">Map</span><span class="o">></span> <span class="n">diagnosticInfo</span> <span class="o">=</span> <span class="n">novaApi</span><span class="o">.</span><span class="na">getServerApiForZone</span><span class="o">(</span><span class="s">"az-1.region-a.geo-1"</span><span class="o">).</span><span class="na">getDiagnostics</span><span class="o">(</span><span class="n">serverId</span><span class="o">);</span>
+</code></pre></div>
<h3>S3 Multi-Object delete</h3>
@@ -631,7 +637,8 @@ These classes are used to represent Open
<p><a href="http://maginatics.com/">Maginatics</a> have BlobStore containers with over a billion objects in them. S3 containers (buckets) can now be cleared with 1/1000 the requests, thanks to <a href="https://twitter.com/andreisavu">Andrei</a>'s additional support of S3 multi-delete.</p>
<div class="highlight"><pre><code class="java"><span class="n">DeleteResult</span> <span class="n">result</span> <span class="o">=</span> <span class="n">s3Api</span><span class="o">.</span><span class="na">deleteObjects</span><span class="o">(</span><span class="n">container</span><span class="o">,</span> <span class="n">keys</span><span class="o">);</span>
-<span class="n">assertEquals</span><span class="o">(</span><span class="n">result</span><span class="o">.</span><span class="na">size</span><span class="o">(),</span> <span class="n">keys</span><span class="o">.</span><span class="na">size</span><span class="o">());</span></code></pre></div>
+<span class="n">assertEquals</span><span class="o">(</span><span class="n">result</span><span class="o">.</span><span class="na">size</span><span class="o">(),</span> <span class="n">keys</span><span class="o">.</span><span class="na">size</span><span class="o">());</span>
+</code></pre></div>
<h2>What's next</h2>
@@ -723,7 +730,8 @@ These classes are used to represent Open
<h3>Lazy advance through all your metrics:</h3>
-<div class="highlight"><pre><code class="java"><span class="n">FluentIterable</span><span class="o"><</span><span class="n">Metric</span><span class="o">></span> <span class="n">allMetrics</span> <span class="o">=</span> <span class="n">cloudwatch</span><span class="o">.</span><span class="na">getMetricApi</span><span class="o">().</span><span class="na">list</span><span class="o">().</span><span class="na">concat</span><span class="o">();</span></code></pre></div>
+<div class="highlight"><pre><code class="java"><span class="n">FluentIterable</span><span class="o"><</span><span class="n">Metric</span><span class="o">></span> <span class="n">allMetrics</span> <span class="o">=</span> <span class="n">cloudwatch</span><span class="o">.</span><span class="na">getMetricApi</span><span class="o">().</span><span class="na">list</span><span class="o">().</span><span class="na">concat</span><span class="o">();</span>
+</code></pre></div>
<h3>Â Advance only until we find the load balancer we want:</h3>
@@ -731,12 +739,14 @@ These classes are used to represent Open
<div class="highlight"><pre><code class="java"><span class="n">Optional</span><span class="o"><</span><span class="n">LoadBalancer</span><span class="o">></span> <span class="n">firstInterestingLoadBalancer</span> <span class="o">=</span> <span class="n">elb</span>
<span class="o">.</span><span class="na">getLoadBalancerApi</span><span class="o">().</span><span class="na">list</span><span class="o">()</span>
<span class="o">.</span><span class="na">concat</span><span class="o">()</span>
- <span class="o">.</span><span class="na">firstMatch</span><span class="o">(</span><span class="n">isInterestingLB</span><span class="o">());</span></code></pre></div>
+ <span class="o">.</span><span class="na">firstMatch</span><span class="o">(</span><span class="n">isInterestingLB</span><span class="o">());</span>
+</code></pre></div>
<h3>Get only the first page of database instances</h3>
-<div class="highlight"><pre><code class="java"><span class="n">IterableWithMarker</span><span class="o"><</span><span class="n">Instance</span><span class="o">></span> <span class="n">firstPage</span> <span class="o">=</span> <span class="n">rds</span><span class="o">.</span><span class="na">getInstanceApi</span><span class="o">().</span><span class="na">list</span><span class="o">().</span><span class="na">get</span><span class="o">(</span><span class="mi">0</span><span class="o">);</span></code></pre></div>
+<div class="highlight"><pre><code class="java"><span class="n">IterableWithMarker</span><span class="o"><</span><span class="n">Instance</span><span class="o">></span> <span class="n">firstPage</span> <span class="o">=</span> <span class="n">rds</span><span class="o">.</span><span class="na">getInstanceApi</span><span class="o">().</span><span class="na">list</span><span class="o">().</span><span class="na">get</span><span class="o">(</span><span class="mi">0</span><span class="o">);</span>
+</code></pre></div>
<p>The above syntax is being worked through relevant apis. In order to try it out, grab jclouds 1.5.0-beta.7 (releasing today), and use any of the following methods:</p>
@@ -773,7 +783,8 @@ These classes are used to represent Open
<span class="k">for</span> <span class="o">(</span><span class="n">Tenant</span> <span class="n">tenant</span> <span class="o">:</span> <span class="n">adminClient</span><span class="o">.</span><span class="na">listTenants</span><span class="o">())</span> <span class="o">{</span>
<span class="c1">// ...</span>
<span class="o">}</span>
-<span class="o">}</span></code></pre></div>
+<span class="o">}</span>
+</code></pre></div>
<p>Also pro, is our new Amazon CloudWatch support from Jeremy Whitlock. This is our first complete renovation of an AWS api to have the same look/feel as our new OpenStack stuff. Just add a dependency on <em>org.jclouds.providers/aws-cloudwatch</em> and you can do this!</p>
@@ -788,7 +799,8 @@ These classes are used to represent Open
<span class="k">for</span> <span class="o">(</span><span class="n">Metric</span> <span class="n">metric</span> <span class="o">:</span> <span class="n">metricClient</span><span class="o">.</span><span class="na">listMetrics</span><span class="o">())</span> <span class="o">{</span>
<span class="c1">// ...</span>
<span class="o">}</span>
-<span class="o">}</span></code></pre></div>
+<span class="o">}</span>
+</code></pre></div>
<p>And for the jenkins users, we also have an api for remote job and computer control, at <em>org.jclouds.labs/jenkins</em>!</p>
@@ -797,7 +809,8 @@ These classes are used to represent Open
<span class="n">RestContext</span> <span class="n">localhost</span> <span class="o">=</span> <span class="n">contextBuilder</span><span class="o">.</span><span class="na">build</span><span class="o">();</span>
<span class="n">Node</span> <span class="n">master</span> <span class="o">=</span> <span class="n">localhost</span><span class="o">.</span><span class="na">getApi</span><span class="o">().</span><span class="na">getMaster</span><span class="o">();</span>
-<span class="n">localhost</span><span class="o">.</span><span class="na">getJobClient</span><span class="o">().</span><span class="na">createFromXML</span><span class="o">(</span><span class="s">"newJob"</span><span class="o">,</span> <span class="n">xmlAsString</span><span class="o">);</span></code></pre></div>
+<span class="n">localhost</span><span class="o">.</span><span class="na">getJobClient</span><span class="o">().</span><span class="na">createFromXML</span><span class="o">(</span><span class="s">"newJob"</span><span class="o">,</span> <span class="n">xmlAsString</span><span class="o">);</span>
+</code></pre></div>
<p>This is especially helpful with the new <a href="https://github.com/jenkinsci/jclouds-plugin">jclouds-plugin</a>, which uses jclouds to spin up new slaves and publish artifacts to BlobStore. Tons more in there, too.</p>
@@ -825,12 +838,14 @@ These classes are used to represent Open
<div class="highlight"><pre><code class="clojure"><span class="p">(</span><span class="nf">use</span> <span class="o">'</span><span class="ss">'org.jclouds.compute2</span><span class="p">)</span>
<span class="p">(</span><span class="nb">import </span><span class="o">'</span><span class="ss">'org.jclouds.scriptbuilder.statements.login.AdminAccess</span><span class="p">)</span>
<span class="p">(</span><span class="k">def </span><span class="nv">compute</span> <span class="p">(</span><span class="nf">compute-service</span> <span class="s">"hpcloud-compute"</span> <span class="s">"tenantId:ACCESSKEY"</span> <span class="s">"SECRETKEY"</span> <span class="ss">:slf4j</span> <span class="ss">:sshj</span><span class="p">))</span>
-<span class="p">(</span><span class="nf">create-node</span> <span class="nv">compute</span> <span class="s">"test"</span> <span class="p">(</span><span class="nf">build-template</span> <span class="nv">compute</span> <span class="p">{</span> <span class="ss">:run-script</span> <span class="p">(</span><span class="nf">AdminAccess/standard</span><span class="p">)</span> <span class="p">}</span> <span class="p">))</span></code></pre></div>
+<span class="p">(</span><span class="nf">create-node</span> <span class="nv">compute</span> <span class="s">"test"</span> <span class="p">(</span><span class="nf">build-template</span> <span class="nv">compute</span> <span class="p">{</span> <span class="ss">:run-script</span> <span class="p">(</span><span class="nf">AdminAccess/standard</span><span class="p">)</span> <span class="p">}</span> <span class="p">))</span>
+</code></pre></div>
<p>Here's an example of how to do the same on <a href="https://trystack.org/">TryStack</a>, authenticating w/ user & pass as opposed to key, via our <a href="https://github.com/jclouds/jclouds-examples/tree/master/compute-basics">java example</a>:</p>
-<div class="highlight"><pre><code class="bash">java -jar target/compute-basics-jar-with-dependencies.jar trystack-nova tenantId:user password mygroup add</code></pre></div>
+<div class="highlight"><pre><code class="bash">java -jar target/compute-basics-jar-with-dependencies.jar trystack-nova tenantId:user password mygroup add
+</code></pre></div>
<p>In the group org.jclouds.labs, you'll find two more new and notable members of the jclouds family:</p>
@@ -843,7 +858,8 @@ These classes are used to represent Open
<p>You can try out virtualbox like any other api. For example, you can use the clojure above, only changing how you create the connection slightly:</p>
-<div class="highlight"><pre><code class="clojure"><span class="p">(</span><span class="k">def </span><span class="nv">compute</span> <span class="p">(</span><span class="nf">compute-service</span> <span class="s">"virtualbox"</span> <span class="s">"administrator"</span> <span class="s">"12345"</span> <span class="ss">:sshj</span> <span class="ss">:slf4j</span><span class="p">))</span></code></pre></div>
+<div class="highlight"><pre><code class="clojure"><span class="p">(</span><span class="k">def </span><span class="nv">compute</span> <span class="p">(</span><span class="nf">compute-service</span> <span class="s">"virtualbox"</span> <span class="s">"administrator"</span> <span class="s">"12345"</span> <span class="ss">:sshj</span> <span class="ss">:slf4j</span><span class="p">))</span>
+</code></pre></div>
<p>The code in labs will certainly change before we release a beta, but feel free to check them out. Meanwhile, you can try them out and give us feedback on #jclouds irc freenode or jclouds-dev google group!</p>
@@ -852,7 +868,8 @@ These classes are used to represent Open
<p>Oh, and don't forget to clean up your nodes :)</p>
-<div class="highlight"><pre><code class="clojure"><span class="p">(</span><span class="nf">destroy-nodes-matching</span> <span class="nv">compute</span> <span class="p">(</span><span class="nb">constantly </span><span class="nv">true</span><span class="p">))</span></code></pre></div>
+<div class="highlight"><pre><code class="clojure"><span class="p">(</span><span class="nf">destroy-nodes-matching</span> <span class="nv">compute</span> <span class="p">(</span><span class="nb">constantly </span><span class="nv">true</span><span class="p">))</span>
+</code></pre></div>
@@ -973,7 +990,8 @@ These classes are used to represent Open
<div class="highlight"><pre><code class="java"><span class="n">future</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">submitScriptOnNode</span><span class="o">(</span><span class="n">node</span><span class="o">.</span><span class="na">getId</span><span class="o">(),</span>
<span class="n">AdminAccess</span><span class="o">.</span><span class="na">builder</span><span class="o">().</span><span class="na">adminUsername</span><span class="o">(</span><span class="s">"foo"</span><span class="o">).</span><span class="na">build</span><span class="o">(),</span>
- <span class="n">nameTask</span><span class="o">(</span><span class="s">"adminUpdate"</span><span class="o">));</span></code></pre></div>
+ <span class="n">nameTask</span><span class="o">(</span><span class="s">"adminUpdate"</span><span class="o">));</span>
+</code></pre></div>
<p>As always, we keep our <a href="https://github.com/jclouds/jclouds-examples">examples site</a> up to date so you can see how to work this stuff. Next release will be in approximately 1-months time. Look out for progress including <a href="http://www.vmware.com/products/vcloud-director/overview.html">vCloud 1.5</a>, <a href="http://voxel.net/voxcloud">Voxel</a>, and <a href="https://www.virtualbox.org/">VirtualBox</a>.</p>
Modified: jclouds/site-content/blog/index.html
URL: http://svn.apache.org/viewvc/jclouds/site-content/blog/index.html?rev=1629683&r1=1629682&r2=1629683&view=diff
==============================================================================
--- jclouds/site-content/blog/index.html (original)
+++ jclouds/site-content/blog/index.html Mon Oct 6 15:43:05 2014
@@ -150,14 +150,14 @@
<p><a href="https://wiki.apache.org/jclouds/How%20to%20Contribute%20Documentation">Write a guest post!</a></p>
-<h3><a class="text-primary" href="/blog/2014/09/03/better-builders">Better Builders with jclouds!</a></h3>
-<span class="text-muted">03 September 2014, by Zack Shoylev</span>
+<h3><a class="text-primary" href="/blog/2014/09/04/better-builders">Better Builders with jclouds!</a></h3>
+<span class="text-muted">04 September 2014, by Zack Shoylev</span>
<p>If you are a new jclouds developer, or even if you are already developing jclouds support for any of the OpenStack or Rackspace APIs, you have likely seen the domain classes that are used throughout the the jclouds codebase.
These classes are used to represent OpenStack resources, particularly the JSON structures supported by OpenStack APIs.
</p>
-<h3><a class="text-primary" href="/blog/2014/08/04/1-release-2-committers">1 release, 2 committers...a busy week for jclouds!</a></h3>
-<span class="text-muted">04 August 2014, by <a href="http://blog.xebialabs.com/author/aphillips/">Andrew Phillips</a></span>
+<h3><a class="text-primary" href="/blog/2014/08/05/1-release-2-committers">1 release, 2 committers...a busy week for jclouds!</a></h3>
+<span class="text-muted">05 August 2014, by <a href="http://blog.xebialabs.com/author/aphillips/">Andrew Phillips</a></span>
<p>There's a lot going on this week for the jclouds community. Most importantly, we're really pleased to introduce two new committers: Andrea Turli and Chris Custine.
</p>
@@ -190,25 +190,25 @@ These classes are used to represent Open
<li>
- <a class="text-primary" href="blog/page2">2</a>
+ <a class="text-primary" href="/blog/page2">2</a>
</li>
<li>
- <a class="text-primary" href="blog/page3">3</a>
+ <a class="text-primary" href="/blog/page3">3</a>
</li>
<li>
- <a class="text-primary" href="blog/page4">4</a>
+ <a class="text-primary" href="/blog/page4">4</a>
</li>
<li>
- <a class="text-primary" href="blog/page5">5</a>
+ <a class="text-primary" href="/blog/page5">5</a>
</li>
Modified: jclouds/site-content/blog/page2/index.html
URL: http://svn.apache.org/viewvc/jclouds/site-content/blog/page2/index.html?rev=1629683&r1=1629682&r2=1629683&view=diff
==============================================================================
--- jclouds/site-content/blog/page2/index.html (original)
+++ jclouds/site-content/blog/page2/index.html Mon Oct 6 15:43:05 2014
@@ -191,25 +191,25 @@
<li>
- <a class="text-primary" href="blog/page2">2</a>
+ <a class="text-primary" href="/blog/page2">2</a>
</li>
<li>
- <a class="text-primary" href="blog/page3">3</a>
+ <a class="text-primary" href="/blog/page3">3</a>
</li>
<li>
- <a class="text-primary" href="blog/page4">4</a>
+ <a class="text-primary" href="/blog/page4">4</a>
</li>
<li>
- <a class="text-primary" href="blog/page5">5</a>
+ <a class="text-primary" href="/blog/page5">5</a>
</li>
Modified: jclouds/site-content/blog/page3/index.html
URL: http://svn.apache.org/viewvc/jclouds/site-content/blog/page3/index.html?rev=1629683&r1=1629682&r2=1629683&view=diff
==============================================================================
--- jclouds/site-content/blog/page3/index.html (original)
+++ jclouds/site-content/blog/page3/index.html Mon Oct 6 15:43:05 2014
@@ -191,25 +191,25 @@
<li>
- <a class="text-primary" href="blog/page2">2</a>
+ <a class="text-primary" href="/blog/page2">2</a>
</li>
<li>
- <a class="text-primary" href="blog/page3">3</a>
+ <a class="text-primary" href="/blog/page3">3</a>
</li>
<li>
- <a class="text-primary" href="blog/page4">4</a>
+ <a class="text-primary" href="/blog/page4">4</a>
</li>
<li>
- <a class="text-primary" href="blog/page5">5</a>
+ <a class="text-primary" href="/blog/page5">5</a>
</li>