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 2013/09/16 09:17:45 UTC
svn commit: r1523548 [4/5] - in
/incubator/jclouds/site-content/documentation:
devguides/contributing-to-documentation/
devguides/creating-providers-with-maven/ devguides/provider-metadata/
devguides/provider-testing/ devguides/using-eclipse/ examples/...
Modified: incubator/jclouds/site-content/documentation/userguide/compute/index.html
URL: http://svn.apache.org/viewvc/incubator/jclouds/site-content/documentation/userguide/compute/index.html?rev=1523548&r1=1523547&r2=1523548&view=diff
==============================================================================
--- incubator/jclouds/site-content/documentation/userguide/compute/index.html (original)
+++ incubator/jclouds/site-content/documentation/userguide/compute/index.html Mon Sep 16 07:17:44 2013
@@ -154,8 +154,7 @@ Here's how to perform common commands.</
<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">computeService</span> <span class="o">=</span> <span class="n">context</span><span class="o">.</span><span class="na">getComputeService</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div>
<h3>List the nodes you have in all locations</h3>
@@ -168,8 +167,7 @@ Here's how to perform common commands.</
<span class="n">node</span><span class="o">.</span><span class="na">getName</span><span class="o">();</span> <span class="c1">// if the node is named, what is it?</span>
<span class="n">node</span><span class="o">.</span><span class="na">getLocation</span><span class="o">();</span> <span class="c1">// where in the world is the node</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div>
<p>Note that the result is of type <code>ComputeMetadata</code> rather than the more useful <code>NodeMetadata</code>.<br/>
@@ -193,8 +191,7 @@ call the <em>Get Node Metadata</em> comm
<span class="n">metadata</span><span class="o">.</span><span class="na">getPrivateAddresses</span><span class="o">();</span>
<span class="n">metadata</span><span class="o">.</span><span class="na">getPublicAddresses</span><span class="o">();</span>
<span class="n">metadata</span><span class="o">.</span><span class="na">getCredentials</span><span class="o">();</span><span class="c1">// only available after createNodesInGroup, identifies login user/credential</span>
-</code></pre>
-</div>
+</code></pre></div>
<h3>List Assignable Locations</h3>
@@ -206,8 +203,7 @@ like eu-west, where a zone is similar to
that implies it is within that location. For example a location can be a rack, whose parent is likely to be a zone.</p>
<div class="highlight"><pre><code class="java"><span class="n">Set</span><span class="o"><?</span> <span class="kd">extends</span> <span class="n">Location</span><span class="o">></span> <span class="n">listAssignableLocations</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div>
<h3>List Hardware Profiles</h3>
@@ -220,8 +216,7 @@ a portable quantity across clouds, as th
relative speed within a cloud. memory is measured in megabytes and disks in gigabytes.</p>
<div class="highlight"><pre><code class="java"><span class="n">Set</span><span class="o"><?</span> <span class="kd">extends</span> <span class="n">Hardware</span><span class="o">></span> <span class="n">listHardwareProfiles</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div>
<h3>List Images</h3>
@@ -231,8 +226,7 @@ In some clouds, images are bound to a sp
For this reason, you should consider matching image requirements like operating system family with TemplateBuilder as opposed to choosing an image explicitly.</p>
<div class="highlight"><pre><code class="java"> <span class="n">Set</span><span class="o"><?</span> <span class="kd">extends</span> <span class="n">Image</span><span class="o">></span> <span class="n">listImages</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div>
<h3>Create Nodes with Group</h3>
@@ -245,8 +239,7 @@ If resources such as security groups are
Here's an example of how to start a nodeSet:</p>
<div class="highlight"><pre><code class="java"><span class="n">NodeSet</span> <span class="n">nodes</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">createNodesInGroup</span><span class="o">(</span><span class="n">group</span><span class="o">,</span> <span class="mi">2</span><span class="o">,</span> <span class="n">template</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div>
<p>The set that is returned will include credentials you can use to ssh into the nodes.
@@ -255,8 +248,7 @@ Make sure you look also at the "identity
<div class="highlight"><pre><code class="java"><span class="k">if</span> <span class="o">(</span><span class="n">node</span><span class="o">.</span><span class="na">getCredentials</span><span class="o">().</span><span class="na">credential</span><span class="o">.</span><span class="na">startsWith</span><span class="o">(</span><span class="s">"-----BEGIN RSA PRIVATE KEY-----"</span><span class="o">))</span>
<span class="c1">// it is a private key, not a password.</span>
-</code></pre>
-</div>
+</code></pre></div>
<p>Note: If all you want to do is execute a script at bootup, you should consider use of the runScript option.</p>
@@ -280,8 +272,7 @@ All predicate commands are run in parall
<span class="n">Map</span><span class="o"><?</span> <span class="kd">extends</span> <span class="n">NodeMetadata</span><span class="o">,</span> <span class="n">ExecResponse</span><span class="o">></span> <span class="n">responses</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">runScriptOnNodesMatching</span><span class="o">(</span><span class="n">runningInGroup</span><span class="o">(</span><span class="n">group</span><span class="o">),</span> <span class="n">script</span><span class="o">,</span>
<span class="n">overrideCredentialsWith</span><span class="o">(</span><span class="n">creds</span><span class="o">));</span>
-</code></pre>
-</div>
+</code></pre></div>
<ul>
@@ -294,8 +285,7 @@ All predicate commands are run in parall
<span class="kn">import</span> <span class="nn">static</span> <span class="n">com</span><span class="o">.</span><span class="na">google</span><span class="o">.</span><span class="na">common</span><span class="o">.</span><span class="na">collect</span><span class="o">.</span><span class="na">Iterables</span><span class="o">.*;</span>
<span class="n">Iterable</span><span class="o"><?</span> <span class="kd">extends</span> <span class="n">NodeMetadata</span><span class="o">></span> <span class="n">billedNodes</span> <span class="o">=</span> <span class="n">filter</span><span class="o">(</span><span class="n">client</span><span class="o">.</span><span class="na">listNodesDetailsMatching</span><span class="o">(</span><span class="n">all</span><span class="o">()),</span> <span class="n">and</span><span class="o">(</span><span class="n">withGroup</span><span class="o">(</span><span class="n">group</span><span class="o">),</span> <span class="n">not</span><span class="o">(</span><span class="n">TERMINATED</span><span class="o">))));</span>
-</code></pre>
-</div>
+</code></pre></div>
<h4>Commands</h4>
@@ -307,8 +297,7 @@ When the last node in a set is destroyed
<div class="highlight"><pre><code class="java"><span class="kn">import</span> <span class="nn">static</span> <span class="n">org</span><span class="o">.</span><span class="na">jclouds</span><span class="o">.</span><span class="na">compute</span><span class="o">.</span><span class="na">predicates</span><span class="o">.</span><span class="na">NodePredicates</span><span class="o">.*;</span>
<span class="n">client</span><span class="o">.</span><span class="na">destroyNodesMatching</span><span class="o">(</span><span class="n">withGroup</span><span class="o">(</span><span class="n">group</span><span class="o">));</span>
-</code></pre>
-</div>
+</code></pre></div>
<h5>Reboot Nodes Matching Predicate</h5>
@@ -317,8 +306,7 @@ When the last node in a set is destroyed
<div class="highlight"><pre><code class="java"><span class="kn">import</span> <span class="nn">static</span> <span class="n">org</span><span class="o">.</span><span class="na">jclouds</span><span class="o">.</span><span class="na">compute</span><span class="o">.</span><span class="na">predicates</span><span class="o">.</span><span class="na">NodePredicates</span><span class="o">.*;</span>
<span class="n">client</span><span class="o">.</span><span class="na">rebootNodesMatching</span><span class="o">(</span><span class="n">withGroup</span><span class="o">(</span><span class="n">group</span><span class="o">));</span>
-</code></pre>
-</div>
+</code></pre></div>
<h5>Run Script on Nodes Matching Predicate</h5>
@@ -328,8 +316,7 @@ When the last node in a set is destroyed
<div class="highlight"><pre><code class="java"><span class="kn">import</span> <span class="nn">static</span> <span class="n">org</span><span class="o">.</span><span class="na">jclouds</span><span class="o">.</span><span class="na">compute</span><span class="o">.</span><span class="na">predicates</span><span class="o">.</span><span class="na">NodePredicates</span><span class="o">.</span><span class="na">runningInGroup</span><span class="o">;</span>
<span class="n">responses</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">runScriptOnNodesMatching</span><span class="o">(</span><span class="n">runningInGroup</span><span class="o">(</span><span class="n">group</span><span class="o">),</span> <span class="n">script</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div>
<p>If you created your nodes using the <code>authorizePublicKey</code> option, then you are probably interested in using that again here.<br/>
@@ -351,8 +338,7 @@ sudo-able login user on the nodes, simpl
<span class="c1">// later, you will use your key with the default login user</span>
<span class="n">responses</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">runScriptOnNodesMatching</span><span class="o">(</span><span class="n">runningInGroup</span><span class="o">(</span><span class="n">group</span><span class="o">),</span> <span class="n">script</span><span class="o">,</span>
<span class="n">overrideCredentialsWith</span><span class="o">(</span><span class="k">new</span> <span class="n">Credentials</span><span class="o">(</span><span class="n">loginUser</span><span class="o">,</span> <span class="n">myKey</span><span class="o">));</span>
-</code></pre>
-</div>
+</code></pre></div>
<h5>Working with credentials</h5>
@@ -377,8 +363,7 @@ If you'd like to have credentials persis
<span class="k">new</span> <span class="nf">CredentialStoreModule</span><span class="o">(</span><span class="n">credentialsMap</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>
-</code></pre>
-</div>
+</code></pre></div>
<h3>Individual Node Commands</h3>
@@ -393,8 +378,7 @@ You can save time if you know you are on
<p>If you save a node's id to disk, you can inflate it later without querying by using the <code>getNodeMetadata</code> command.</p>
<div class="highlight"><pre><code class="java"><span class="n">NodeMetadata</span> <span class="n">metadata</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">getNodeMetadata</span><span class="o">(</span><span class="n">savedId</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div>
<h5>Destroy Node</h5>
@@ -422,8 +406,7 @@ You can save time if you know you are on
2010-02-06 09:44:07,824 DEBUG [jclouds.compute] (main) << authorized securityGroup(ec2)
2010-02-06 09:44:07,828 DEBUG [jclouds.compute] (main) >> running 2 instance region(us-east-1) zone(null) ami(ami-87a243ee) type(m1.large) keyPair(ec2) securityGroup(ec2)
2010-02-06 09:44:09,239 DEBUG [jclouds.compute] (main) << started instances(i-7c180614,i-7e180616)
-</code></pre>
-</div>
+</code></pre></div>
<p>If you are using the Log4JLoggingModule, here is an example log4j.xml stanza you can use to enable compute logging:</p>
@@ -446,8 +429,7 @@ You can save time if you know you are on
<span class="nt"><priority</span> <span class="na">value=</span><span class="s">"TRACE"</span> <span class="nt">/></span>
<span class="nt"><appender-ref</span> <span class="na">ref=</span><span class="s">"ASYNCCOMPUTE"</span> <span class="nt">/></span>
<span class="nt"></category></span>
-</code></pre>
-</div>
+</code></pre></div>
<h2>Usage in Google AppEngine</h2>
@@ -466,8 +448,7 @@ enterprise configuration module. Here's
<span class="o">.</span><span class="na">modules</span><span class="o">(</span><span class="n">wiring</span><span class="o">)</span>
<span class="o">.</span><span class="na">overrides</span><span class="o">(</span><span class="n">overrides</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>
-</code></pre>
-</div>
+</code></pre></div>
<p>For mode information, check out the [[jcloudsAPI]] wiki page.</p>
@@ -479,23 +460,20 @@ enterprise configuration module. Here's
<p>if you just created the node, it will have login credentials set in node.getCredentials(). Ask for an ssh client based on the node.</p>
<div class="highlight"><pre><code class="java"><span class="n">client</span> <span class="o">=</span> <span class="n">context</span><span class="o">.</span><span class="na">utils</span><span class="o">().</span><span class="na">sshForNode</span><span class="o">().</span><span class="na">apply</span><span class="o">(</span><span class="n">node</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div>
<p>if the node's credentials aren't set, you'll have to assign them first.</p>
<div class="highlight"><pre><code class="java"><span class="n">client</span> <span class="o">=</span> <span class="n">context</span><span class="o">.</span><span class="na">utils</span><span class="o">().</span><span class="na">sshForNode</span><span class="o">().</span><span class="na">apply</span><span class="o">(</span><span class="n">NodeMetadataBuilder</span><span class="o">.</span><span class="na">fromNodeMetadata</span><span class="o">(</span><span class="n">node</span><span class="o">).</span><span class="na">credentials</span><span class="o">(</span>
<span class="k">new</span> <span class="nf">Credentials</span><span class="o">(</span><span class="s">"adrian"</span><span class="o">,</span><span class="n">sshKeyInString</span><span class="o">)).</span><span class="na">build</span><span class="o">());</span>
-</code></pre>
-</div>
+</code></pre></div>
<p>Once you have the client, you can push files to it</p>
<div class="highlight"><pre><code class="java"><span class="n">client</span><span class="o">.</span><span class="na">put</span><span class="o">(</span><span class="s">"/path/to/file"</span><span class="o">,</span> <span class="n">Payloads</span><span class="o">.</span><span class="na">newFilePayload</span><span class="o">(</span><span class="n">contents</span><span class="o">));</span>
-</code></pre>
-</div>
+</code></pre></div>
<p>Here's a full example:</p>
@@ -509,8 +487,7 @@ enterprise configuration module. Here's
<span class="k">if</span> <span class="o">(</span><span class="n">ssh</span> <span class="o">!=</span> <span class="kc">null</span><span class="o">)</span>
<span class="n">ssh</span><span class="o">.</span><span class="na">disconnect</span><span class="o">();</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div>
<h3>Selecting a correct package manager</h3>
@@ -526,8 +503,7 @@ enterprise configuration module. Here's
<span class="k">return</span> <span class="n">RunScriptData</span><span class="o">.</span><span class="na">ZYPPER_RUN_SCRIPT</span><span class="o">;</span>
<span class="k">else</span>
<span class="k">throw</span> <span class="k">new</span> <span class="nf">IllegalArgumentException</span><span class="o">(</span><span class="s">"don't know how to handle"</span> <span class="o">+</span> <span class="n">os</span><span class="o">.</span><span class="na">toString</span><span class="o">());</span>
-</code></pre>
-</div>
+</code></pre></div>
<h3>Opening ports</h3>
@@ -542,8 +518,7 @@ Here's how:</p>
<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">options</span><span class="o">(</span><span class="n">inboundPorts</span><span class="o">(</span><span class="mi">22</span><span class="o">,</span> <span class="mi">8080</span><span class="o">)).</span><span class="na">build</span><span class="o">();</span>
<span class="c1">// start 2 nodes</span>
<span class="n">nodes</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">createNodesInGroup</span><span class="o">(</span><span class="n">group</span><span class="o">,</span> <span class="mi">2</span><span class="o">,</span> <span class="n">template</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div>
<h3>Template Matching</h3>
@@ -552,8 +527,7 @@ Here's how:</p>
<div class="highlight"><pre><code class="java"><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">hardwareId</span><span class="o">(</span><span class="n">InstanceType</span><span class="o">.</span><span class="na">M1_SMALL</span><span class="o">)</span>
<span class="o">.</span><span class="na">osVersionMatches</span><span class="o">(</span><span class="s">"10.04"</span><span class="o">).</span><span class="na">imageDescriptionMatches</span><span class="o">(</span><span class="s">"ubuntu-images"</span><span class="o">).</span><span class="na">osFamily</span><span class="o">(</span><span class="n">OsFamily</span><span class="o">.</span><span class="na">UBUNTU</span><span class="o">).</span><span class="na">build</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div>
<h3>Authorizing your RSA SSH Public Key</h3>
@@ -572,8 +546,7 @@ If you are interested in changing the pr
<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">options</span><span class="o">(</span><span class="n">authorizePublicKey</span><span class="o">(</span><span class="n">Payloads</span><span class="o">.</span><span class="na">newPayload</span><span class="o">(</span><span class="k">new</span> <span class="n">File</span><span class="o">(</span><span class="s">"/home/me/.ssh/id_rsa.pub"</span><span class="o">)).</span><span class="na">build</span><span class="o">();</span>
<span class="c1">// start 10 nodes</span>
<span class="n">nodes</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">createNodesInGroup</span><span class="o">(</span><span class="n">group</span><span class="o">,</span> <span class="mi">10</span><span class="o">,</span> <span class="n">template</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div>
<p>Note that SSH must be configured for this feature to work.</p>
@@ -597,8 +570,7 @@ authorizing RSA to establish an SSH mesh
<span class="o">...</span>
<span class="c1">// start 10 nodes</span>
<span class="n">nodes</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">createNodesInGroup</span><span class="o">(</span><span class="n">group</span><span class="o">,</span> <span class="mi">10</span><span class="o">,</span> <span class="n">installPrivateKey</span><span class="o">(</span><span class="n">Files</span><span class="o">.</span><span class="na">toString</span><span class="o">(</span><span class="k">new</span> <span class="n">File</span><span class="o">(</span><span class="s">"/home/me/.ssh/id_rsa"</span><span class="o">));</span>
-</code></pre>
-</div>
+</code></pre></div>
<p>Note that SSH must be configured for this feature to work.</p>
@@ -617,8 +589,7 @@ Set the option <code>runScript</code> to
<span class="o">...</span>
<span class="c1">// start 10 nodes</span>
<span class="n">nodes</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">createNodesInGroup</span><span class="o">(</span><span class="n">group</span><span class="o">,</span> <span class="mi">10</span><span class="o">,</span> <span class="n">runScript</span><span class="o">(</span><span class="n">Files</span><span class="o">.</span><span class="na">toString</span><span class="o">(</span><span class="k">new</span> <span class="n">File</span><span class="o">(</span><span class="s">"runscript.sh"</span><span class="o">)));</span>
-</code></pre>
-</div>
+</code></pre></div>
<p>Note that SSH must be configured for this feature to work.</p>
@@ -639,36 +610,30 @@ without parameters (ex. <code>templateBu
<table>
<thead>
<tr>
-<th></th>
<th> <em>provider</em> </th>
<th> <em>default template</em> </th>
</tr>
</thead>
<tbody>
<tr>
-<td></td>
<td> vcloud/bluelock-vcdirector </td>
-<td> osFamily(UBUNTU).os64Bit(true) |</td>
+<td> osFamily(UBUNTU).os64Bit(true) </td>
</tr>
<tr>
-<td></td>
<td> trmk-vcloudexpress </td>
-<td> osFamily(UBUNTU).osDescriptionMatches(".<em>JeOS.</em>").os64Bit(true) |</td>
+<td> osFamily(UBUNTU).osDescriptionMatches(".<em>JeOS.</em>").os64Bit(true) </td>
</tr>
<tr>
-<td></td>
<td> trmk-ecloud </td>
-<td> osFamily(CENTOS).os64Bit(true) |</td>
+<td> osFamily(CENTOS).os64Bit(true) </td>
</tr>
<tr>
-<td></td>
<td> ec2 </td>
-<td> osFamily(AMZN_LINUX).os64Bit(true) |</td>
+<td> osFamily(AMZN_LINUX).os64Bit(true) </td>
</tr>
<tr>
-<td></td>
<td> gogrid </td>
-<td> osFamily(CENTOS).imageNameMatches(".<em>w/ None.</em>") |</td>
+<td> osFamily(CENTOS).imageNameMatches(".<em>w/ None.</em>") </td>
</tr>
</tbody>
</table>
@@ -686,8 +651,7 @@ cp /etc/apt/sources.list /etc/apt/source
sed 's~us.archive.ubuntu.com~mirror.anl.gov/pub~g' /etc/apt/sources.list.old >/etc/apt/sources.list
apt-get update
apt-get install -f -y --force-yes openjdk-6-jdk
-</code></pre>
-</div>
+</code></pre></div>
<ul>
@@ -702,8 +666,7 @@ apt-get install -f -y --force-yes openjd
<span class="nb">echo</span> <span class="s2">"enabled=1"</span> >> /etc/yum.repos.d/CentOS-Base.repo
yum --nogpgcheck -y install java-1.6.0-openjdk
<span class="nb">echo</span> <span class="s2">"export PATH=\"/usr/lib/jvm/jre-1.6.0-openjdk/bin/:\$PATH\""</span> >> /root/.bashrc
-</code></pre>
-</div>
+</code></pre></div>
<h3>Creating non-root users</h3>
@@ -714,8 +677,7 @@ yum --nogpgcheck -y install java-1.6.0-o
<span class="n">userBuilder</span><span class="o">.</span><span class="na">login</span><span class="o">(</span><span class="s">"john.doe"</span><span class="o">);</span>
<span class="n">userBuilder</span><span class="o">.</span><span class="na">authorizeRSAPublicKey</span><span class="o">(</span><span class="s">"john's public key"</span><span class="o">);</span>
<span class="n">Statement</span> <span class="n">userBuilderStatement</span> <span class="o">=</span> <span class="n">userBuilder</span><span class="o">.</span><span class="na">build</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div>
<p>and run the built statement in <code>templateOptions.runScript</code> or add to a <code>StatementList</code>.</p>
@@ -745,8 +707,7 @@ To see the commands that will be execute
<span class="ss">:dependencies</span> <span class="p">[[</span><span class="nv">org.clojure/clojure</span> <span class="s">"1.2.0"</span><span class="p">]</span>
<span class="p">[</span><span class="nv">org.clojure/clojure-contrib</span> <span class="s">"1.2.0"</span><span class="p">]</span>
<span class="p">[</span><span class="nv">org.jclouds/jclouds-allcompute</span> <span class="s">"1.1.0"</span><span class="p">]])</span>
-</code></pre>
-</div>
+</code></pre></div>
<pre><code>* for jclouds 1.2 / snapshot (clojure 1.2 and 1.3)
@@ -759,8 +720,7 @@ To see the commands that will be execute
<span class="p">[</span><span class="nv">org.clojure/tools.logging</span> <span class="s">"0.2.3"</span><span class="p">]</span>
<span class="p">[</span><span class="nv">org.jclouds/jclouds-allcompute</span> <span class="s">"1.2.0-SNAPSHOT"</span><span class="p">]]</span>
<span class="ss">:repositories</span> <span class="p">{</span><span class="s">"jclouds-snapshot"</span> <span class="s">"https://oss.sonatype.org/content/repositories/snapshots"</span><span class="p">})</span>
-</code></pre>
-</div>
+</code></pre></div>
<ul>
@@ -777,8 +737,7 @@ you need to substitute your accounts and
<span class="p">(</span><span class="nf">with-compute-service</span> <span class="p">[</span><span class="s">"cloudservers"</span> <span class="s">"email"</span> <span class="s">"password"</span><span class="p">]</span>
<span class="p">(</span><span class="nf">nodes</span><span class="p">))</span>
-</code></pre>
-</div>
+</code></pre></div>
<p>The above will list all nodes with cloudservers. Here's an example of creating and running a small linux node with the group webserver, using ssh and log4j extensions:</p>
@@ -792,16 +751,14 @@ you need to substitute your accounts and
<span class="p">(</span><span class="nf">compute-service</span> <span class="nv">provider</span> <span class="nv">user</span> <span class="nv">password</span> <span class="ss">:ssh</span> <span class="ss">:log4j</span><span class="p">))</span>
<span class="p">(</span><span class="nf">create-node</span> <span class="s">"webserver"</span> <span class="nv">my-compute</span><span class="p">)</span>
-</code></pre>
-</div>
+</code></pre></div>
<p>You'll likely want to run the following when you're done:</p>
<div class="highlight"><pre><code class="clojure">
<span class="p">(</span><span class="nf">destroy-nodes-in-group</span> <span class="s">"webserver"</span> <span class="nv">my-compute</span><span class="p">)</span>
-</code></pre>
-</div>
+</code></pre></div>
<h2>Tools</h2>
Modified: incubator/jclouds/site-content/documentation/userguide/google-app-engine/index.html
URL: http://svn.apache.org/viewvc/incubator/jclouds/site-content/documentation/userguide/google-app-engine/index.html?rev=1523548&r1=1523547&r2=1523548&view=diff
==============================================================================
--- incubator/jclouds/site-content/documentation/userguide/google-app-engine/index.html (original)
+++ incubator/jclouds/site-content/documentation/userguide/google-app-engine/index.html Mon Sep 16 07:17:44 2013
@@ -87,8 +87,7 @@ There are only a couple things you need
<span class="o">.</span><span class="na">credentials</span><span class="o">(</span><span class="n">accesskey</span><span class="o">,</span> <span class="n">sceret</span><span class="o">)</span>
<span class="o">.</span><span class="na">modules</span><span class="o">(</span><span class="n">modules</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>
-</code></pre>
-</div>
+</code></pre></div>
<ul>
@@ -115,8 +114,7 @@ Google App Engine config only when runni
<span class="o">.</span><span class="na">credentials</span><span class="o">(</span><span class="n">accesskey</span><span class="o">,</span> <span class="n">sceret</span><span class="o">)</span>
<span class="o">.</span><span class="na">overrides</span><span class="o">(</span><span class="n">overrides</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>
-</code></pre>
-</div>
+</code></pre></div>
<h3>Usage with Clojure</h3>
@@ -130,8 +128,7 @@ org.jclouds/jclouds-gae if < beta-9,
<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">"aws-ec2"</span> <span class="s">"accessKey"</span> <span class="s">"secret"</span> <span class="ss">:gae-async</span><span class="p">))</span>
-</code></pre>
-</div>
+</code></pre></div>
<ul>
@@ -150,8 +147,7 @@ your WEB-INF directory, e.g., here are t
<div class="highlight"><pre><code class="text">jclouds.blobstore=filesystem
jclouds.filesystem.basedir=/tmp/blobstore
filesystem.identity=foo
-</code></pre>
-</div>
+</code></pre></div>
<p>Edit or create <code>WEB-INF/jclouds-gae.properties</code></p>
@@ -163,8 +159,7 @@ jclouds.filesystem.basedir=/tmp/blobstor
jclouds.modules=org.jclouds.gae.config.AsyncGoogleAppEngineConfigurationModule
googlestorage.identity=accessKey
googlestorage.credential=secret
-</code></pre>
-</div>
+</code></pre></div>
<h4>Configuring servlet listener</h4>
@@ -223,8 +218,7 @@ googlestorage.credential=secret
<span class="k">return</span> <span class="n">props</span><span class="o">;</span>
<span class="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div>
<h3>Logging</h3>
@@ -260,8 +254,7 @@ You do not have luxury to synchronously
<div class="highlight"><pre><code class="java"><span class="n">computeService</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">options</span> <span class="o">=</span> <span class="n">computeService</span><span class="o">.</span><span class="na">templateOptions</span><span class="o">().</span><span class="na">blockUntilRunning</span><span class="o">(</span><span class="kc">false</span><span class="o">);</span>
<span class="n">template</span> <span class="o">=</span> <span class="n">computeService</span><span class="o">.</span><span class="na">templateBuilder</span><span class="o">().</span><span class="na">options</span><span class="o">(</span><span class="n">options</span><span class="o">).</span><span class="na">build</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div>
<ul>
@@ -286,8 +279,7 @@ You do not have luxury to synchronously
<span class="k">new</span> <span class="nf">AsyncGoogleAppEngineConfigurationModule</span><span class="o">()))</span>
<span class="o">.</span><span class="na">overrides</span><span class="o">(</span><span class="n">overrides</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>
-</code></pre>
-</div>
+</code></pre></div>
<h3>FAQ</h3>
@@ -304,8 +296,7 @@ java.lang.reflect.InvocationTargetExcept
at com.google.appengine.runtime.Request.process-8e3e8ebfb87d6827(Request.java)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:57)
-</code></pre>
-</div>
+</code></pre></div>
Modified: incubator/jclouds/site-content/documentation/userguide/init-builder/index.html
URL: http://svn.apache.org/viewvc/incubator/jclouds/site-content/documentation/userguide/init-builder/index.html?rev=1523548&r1=1523547&r2=1523548&view=diff
==============================================================================
--- incubator/jclouds/site-content/documentation/userguide/init-builder/index.html (original)
+++ incubator/jclouds/site-content/documentation/userguide/init-builder/index.html Mon Sep 16 07:17:44 2013
@@ -58,8 +58,7 @@ the lifecycle of your applications at a
you to setup something like Tomcat on your Windows laptop and move it to a remote Linux machine.</p>
<div class="highlight"><pre><code class="text">TODO example
-</code></pre>
-</div>
+</code></pre></div>
<p>InitBuilder introduces standard system variables, directory structures and
Modified: incubator/jclouds/site-content/documentation/userguide/installation-guide/index.html
URL: http://svn.apache.org/viewvc/incubator/jclouds/site-content/documentation/userguide/installation-guide/index.html?rev=1523548&r1=1523547&r2=1523548&view=diff
==============================================================================
--- incubator/jclouds/site-content/documentation/userguide/installation-guide/index.html (original)
+++ incubator/jclouds/site-content/documentation/userguide/installation-guide/index.html Mon Sep 16 07:17:44 2013
@@ -73,8 +73,7 @@
<div class="highlight"><pre><code class="clojure"><span class="p">(</span><span class="kd">defproject </span><span class="nv">deps</span> <span class="s">"1"</span> <span class="ss">:dependencies</span> <span class="p">[[</span><span class="nv">org.apache.jclouds/jclouds-all</span> <span class="s">"1.6.1-incubating"</span><span class="p">]</span> <span class="p">[</span><span class="nv">org.apache.jclouds.driver/jclouds-sshj</span> <span class="s">"1.6.1-incubating"</span><span class="p">]])</span>
-</code></pre>
-</div>
+</code></pre></div>
<ul>
@@ -96,8 +95,7 @@ the following your project's <strong>pom
<span class="nt"><version></span>1.6.1-incubating<span class="nt"></version></span>
<span class="nt"></dependency></span>
<span class="nt"></dependencies></span>
-</code></pre>
-</div>
+</code></pre></div>
<h2><a id="ant"></a>Getting the binaries using Apache Ant</h2>
@@ -132,22 +130,19 @@ the following your project's <strong>pom
<span class="na">classpathref=</span><span class="s">"maven-ant-tasks.classpath"</span><span class="nt">/></span>
<span class="nt"></target></span>
<span class="nt"></project></span>
-</code></pre>
-</div>
+</code></pre></div>
<p>To only fetch the jars for a particular provider replace</p>
<div class="highlight"><pre><code class="xml"> <span class="nt"><dependency</span> <span class="na">groupId=</span><span class="s">"org.apache.jclouds"</span> <span class="na">artifactId=</span><span class="s">"jclouds-all"</span> <span class="na">version=</span><span class="s">"1.6.1-incubating"</span> <span class="nt">/></span>
-</code></pre>
-</div>
+</code></pre></div>
<p>with</p>
<div class="highlight"><pre><code class="xml"> <span class="nt"><dependency</span> <span class="na">groupId=</span><span class="s">"org.apache.jclouds.provider"</span> <span class="na">artifactId=</span><span class="s">"the-provider-id"</span> <span class="na">version=</span><span class="s">"1.6.1-incubating"</span> <span class="nt">/></span>
-</code></pre>
-</div>
+</code></pre></div>
<p>You can see the list of supported providers and their ids in the <a href="/documentation/reference/supported-providers">Supported Providers</a>.</p>
@@ -165,8 +160,7 @@ Then, add jclouds to your <strong>build.
<span class="na">artifactId=</span><span class="s">"jclouds-allblobstore"</span>
<span class="na">version=</span><span class="s">"1.6.1-incubating"</span> <span class="nt">/></span>
<span class="nt"></artifact:dependencies></span>
-</code></pre>
-</div>
+</code></pre></div>
<h2><a id="clojure-project"></a>Adding jclouds to your Clojure project using leiningen</h2>
@@ -178,8 +172,7 @@ Then, add jclouds to your <strong>build.
<span class="p">[</span><span class="nv">org.clojure/tools.logging</span> <span class="s">"0.2.3"</span><span class="p">]</span>
<span class="p">[</span><span class="nv">org.apache.jclouds/jclouds-allcompute</span> <span class="s">"1.6.1-incubating"</span><span class="p">]</span>
<span class="p">[</span><span class="nv">org.apache.jclouds/jclouds-allblobstore</span> <span class="s">"1.6.1-incubating"</span><span class="p">]]</span>
-</code></pre>
-</div>
+</code></pre></div>
<h2><a id="lib"></a>Making your own lib dir</h2>
@@ -235,8 +228,7 @@ Then, add jclouds to your <strong>build.
<span class="nt"><version></span>1.6.2-SNAPSHOT<span class="nt"></version></span>
<span class="nt"></dependency></span>
<span class="nt"></dependencies></span>
-</code></pre>
-</div>
+</code></pre></div>
<h2><a id="snapshot-ant"></a>Adding jclouds snapshot to your Apache Ant project</h2>
@@ -256,8 +248,7 @@ Then, add jclouds to your <strong>build.
<span class="na">version=</span><span class="s">"1.6.2-SNAPSHOT"</span> <span class="nt">/></span>
<span class="nt"><remoteRepository</span> <span class="na">refid=</span><span class="s">"jclouds.snapshot.repository"</span> <span class="nt">/></span>
<span class="nt"></artifact:dependencies></span>
-</code></pre>
-</div>
+</code></pre></div>
<h2><a id="snapshot-lein"></a>Adding jclouds snapshots to your leiningen (clojure) project</h2>
@@ -270,8 +261,7 @@ Then, add jclouds to your <strong>build.
<span class="p">[</span><span class="nv">org.apache.jclouds/jclouds-allcompute</span> <span class="s">"1.6.2-SNAPSHOT"</span><span class="p">]</span>
<span class="p">[</span><span class="nv">org.apache.jclouds/jclouds-allblobstore</span> <span class="s">"1.6.2-SNAPSHOT"</span><span class="p">]]</span>
<span class="ss">:repositories</span> <span class="p">{</span> <span class="s">"jclouds-snapshot"</span> <span class="s">"https://oss.sonatype.org/content/repositories/snapshots"</span><span class="p">}</span>
-</code></pre>
-</div>
+</code></pre></div>
Modified: incubator/jclouds/site-content/documentation/userguide/karaf/index.html
URL: http://svn.apache.org/viewvc/incubator/jclouds/site-content/documentation/userguide/karaf/index.html?rev=1523548&r1=1523547&r2=1523548&view=diff
==============================================================================
--- incubator/jclouds/site-content/documentation/userguide/karaf/index.html (original)
+++ incubator/jclouds/site-content/documentation/userguide/karaf/index.html Mon Sep 16 07:17:44 2013
@@ -105,8 +105,7 @@ source and building it and go directly t
<div class="highlight"><pre><code class="sh">git clone git://github.com/jclouds/jclouds-karaf.git
<span class="nb">cd </span>jclouds-karaf
mvn clean install
-</code></pre>
-</div>
+</code></pre></div>
<ol>
@@ -116,8 +115,7 @@ mvn clean install
<div class="highlight"><pre><code class="text">features:addurl mvn:org.jclouds.karaf/feature/1.0/xml/features
features:install jclouds
-</code></pre>
-</div>
+</code></pre></div>
<ol>
@@ -126,8 +124,7 @@ features:install jclouds
<div class="highlight"><pre><code class="text">features:list | grep jclouds
-</code></pre>
-</div>
+</code></pre></div>
<p><em><em>Example</em></em></p>
@@ -138,8 +135,7 @@ features:install jclouds
<div class="highlight"><pre><code class="text">features:install jclouds-aws-s3
-</code></pre>
-</div>
+</code></pre></div>
<h2>Running the examples</h2>
@@ -153,15 +149,13 @@ can change dynamically, and they may be
<div class="highlight"><pre><code class="text">git clone https://iocanel@github.com/jclouds/jclouds-examples.git
cd jclouds-examples/blobstore-karaf-shell
mvn clean install
-</code></pre>
-</div>
+</code></pre></div>
<p>Then from Karaf shell you can install the example:</p>
<div class="highlight"><pre><code class="text">osgi:install -s mvn:org.jclouds.examples/blobstore-karaf-shell/1.0-SNAPSHOT
-</code></pre>
-</div>
+</code></pre></div>
<p>The command above installs in Karaf two new commands:</p>
@@ -182,16 +176,14 @@ config:propset provider aws-s3
config:propset accessKeyId XXXXXX
config:propset secretKey XXXXXX
config:update
-</code></pre>
-</div>
+</code></pre></div>
<p>Now you are ready to use the commands</p>
<div class="highlight"><pre><code class="text">jclouds:blobstore-write mybucket myblob JCloudsRocks
jclouds:blobstore-write mybucket myblob
-</code></pre>
-</div>
+</code></pre></div>
<p>At any point in time, you can edit the configuration, either using the shell or
Modified: incubator/jclouds/site-content/documentation/userguide/terremark/index.html
URL: http://svn.apache.org/viewvc/incubator/jclouds/site-content/documentation/userguide/terremark/index.html?rev=1523548&r1=1523547&r2=1523548&view=diff
==============================================================================
--- incubator/jclouds/site-content/documentation/userguide/terremark/index.html (original)
+++ incubator/jclouds/site-content/documentation/userguide/terremark/index.html Mon Sep 16 07:17:44 2013
@@ -110,8 +110,7 @@ description of the vApp template. Please
echo p4ssw0rd|sudo -S echo hello
echo nameserver 208.67.222.222 |sudo tee -a /etc/resolv.conf
echo nameserver 208.67.220.220 |sudo tee -a /etc/resolv.conf
-</code></pre>
-</div>
+</code></pre></div>
<h2>Extension Guide</h2>
@@ -136,8 +135,7 @@ You must have a default ssh key, althoug
<div class="highlight"><pre><code class="java"><span class="c1">// null for default org</span>
<span class="n">TerremarkOrg</span> <span class="n">org</span> <span class="o">=</span> <span class="n">vCloudExpressClient</span><span class="o">.</span><span class="na">findOrgNamed</span><span class="o">(</span><span class="kc">null</span><span class="o">);</span>
<span class="n">key</span> <span class="o">=</span> <span class="n">vCloudExpressClient</span><span class="o">.</span><span class="na">generateKeyPairInOrg</span><span class="o">(</span><span class="n">org</span><span class="o">.</span><span class="na">getHref</span><span class="o">(),</span> <span class="s">"livetest"</span><span class="o">,</span> <span class="kc">false</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div>
<h3>Listing Keys</h3>
@@ -145,8 +143,7 @@ You must have a default ssh key, althoug
<div class="highlight"><pre><code class="java"><span class="c1">// null for default org, note that the private part of the key is not stored at terremark</span>
<span class="n">Set</span><span class="o"><</span><span class="n">KeyPair</span><span class="o">></span> <span class="n">response</span> <span class="o">=</span> <span class="n">vCloudExpressClient</span><span class="o">.</span><span class="na">listKeyPairsInOrg</span><span class="o">(</span><span class="kc">null</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div>
<h3>Password management</h3>
@@ -164,8 +161,7 @@ You must have a default ssh key, althoug
<span class="n">CustomizationParameters</span> <span class="n">customizationOptions</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">getCustomizationOptions</span><span class="o">(</span><span class="n">item</span><span class="o">.</span><span class="na">getCustomizationOptions</span><span class="o">().</span><span class="na">getHref</span><span class="o">());</span>
<span class="k">if</span> <span class="o">(</span><span class="n">customizationOptions</span><span class="o">.</span><span class="na">canCustomizePassword</span><span class="o">())</span>
<span class="c1">// you can set it</span>
-</code></pre>
-</div>
+</code></pre></div>
<ul>
@@ -180,8 +176,7 @@ Here's is how you can get the descriptio
<span class="n">TerremarkCatalogItem</span> <span class="n">item</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">findCatalogItemInOrgCatalogNamed</span><span class="o">(</span><span class="kc">null</span><span class="o">,</span> <span class="kc">null</span><span class="o">,</span> <span class="s">"Ubuntu 8.04 LTS (x86)"</span><span class="o">);</span>
<span class="n">String</span> <span class="n">description</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">getVAppTemplate</span><span class="o">(</span><span class="n">item</span><span class="o">.</span><span class="na">getHref</span><span class="o">()).</span><span class="na">getDescription</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div>
<h3>Instantiating vApp Templates</h3>
@@ -218,8 +213,7 @@ Even though this happens, you need to ca
<span class="c1">// block until poweron task shows success</span>
<span class="k">if</span> <span class="o">(!</span><span class="n">taskTester</span><span class="o">.</span><span class="na">apply</span><span class="o">(</span><span class="n">onTask</span><span class="o">.</span><span class="na">getHref</span><span class="o">()))</span>
<span class="k">throw</span> <span class="k">new</span> <span class="nf">Exception</span><span class="o">(</span><span class="s">"could not turn on "</span><span class="o">+</span><span class="n">vApp</span><span class="o">.</span><span class="na">getHref</span><span class="o">());</span>
-</code></pre>
-</div>
+</code></pre></div>
<ul>
@@ -246,8 +240,7 @@ Static import <code>processorCount</code
<span class="o">...</span>
<span class="n">vApp</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">instantiateVAppTemplateInVDC</span><span class="o">(</span><span class="n">vdc</span><span class="o">.</span><span class="na">getHref</span><span class="o">(),</span> <span class="n">vAppTemplate</span><span class="o">.</span><span class="na">getHref</span><span class="o">(),</span> <span class="n">serverName</span><span class="o">,</span> <span class="n">processorCount</span><span class="o">(</span><span class="mi">2</span><span class="o">).</span><span class="na">memory</span><span class="o">(</span><span class="mi">1024</span><span class="o">));</span>
-</code></pre>
-</div>
+</code></pre></div>
<ul>
@@ -260,8 +253,7 @@ Static import <code>processorCount</code
<div class="highlight"><pre><code class="java"><span class="kn">import</span> <span class="nn">static</span> <span class="n">org</span><span class="o">.</span><span class="na">jclouds</span><span class="o">.</span><span class="na">vcloud</span><span class="o">.</span><span class="na">terremark</span><span class="o">.</span><span class="na">options</span><span class="o">.</span><span class="na">TerremarkInstantiateVAppTemplateOptions</span><span class="o">.</span><span class="na">Builder</span><span class="o">.</span><span class="na">sshKeyFingerprint</span><span class="o">;</span>
<span class="n">vApp</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">instantiateVAppTemplateInVDC</span><span class="o">(</span><span class="n">vdc</span><span class="o">.</span><span class="na">getHref</span><span class="o">(),</span> <span class="n">vAppTemplate</span><span class="o">.</span><span class="na">getHref</span><span class="o">(),</span> <span class="n">serverName</span><span class="o">,</span> <span class="n">sshKeyFingerprint</span><span class="o">(</span><span class="n">key</span><span class="o">.</span><span class="na">getFingerPrint</span><span class="o">()));</span>
-</code></pre>
-</div>
+</code></pre></div>
<ul>
@@ -278,8 +270,7 @@ Note that if a password is sent and not
<span class="o">...</span>
<span class="n">vApp</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">instantiateVAppTemplateInVDC</span><span class="o">(</span><span class="n">vdc</span><span class="o">.</span><span class="na">getHref</span><span class="o">(),</span> <span class="n">vAppTemplate</span><span class="o">.</span><span class="na">getHref</span><span class="o">(),</span> <span class="n">serverName</span><span class="o">,</span> <span class="n">withPassword</span><span class="o">(</span><span class="s">"robotsarefun"</span><span class="o">));</span>
-</code></pre>
-</div>
+</code></pre></div>
<h3>Configuring vApps</h3>
@@ -295,8 +286,7 @@ Note that if a password is sent and not
...
Task task = client.configureVApp(vApp, changeNameTo("eduardo"));
-</code></pre>
-</div>
+</code></pre></div>
<ul>
@@ -308,8 +298,7 @@ Note that if a password is sent and not
<span class="o">...</span>
<span class="n">Task</span> <span class="n">task</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">configureVApp</span><span class="o">(</span><span class="n">vApp</span><span class="o">,</span> <span class="n">changeProcessorCountTo</span><span class="o">(</span><span class="mi">2</span><span class="o">));</span>
-</code></pre>
-</div>
+</code></pre></div>
<ul>
@@ -321,8 +310,7 @@ Note that if a password is sent and not
<span class="o">...</span>
<span class="n">Task</span> <span class="n">task</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">configureVApp</span><span class="o">(</span><span class="n">vApp</span><span class="o">,</span> <span class="n">changeMemoryTo</span><span class="o">(</span><span class="mi">1024</span><span class="o">));</span>
-</code></pre>
-</div>
+</code></pre></div>
<ul>
@@ -333,8 +321,7 @@ Note that if a password is sent and not
<div class="highlight"><pre><code class="java"><span class="kn">import</span> <span class="nn">static</span> <span class="n">org</span><span class="o">.</span><span class="na">jclouds</span><span class="o">.</span><span class="na">vcloud</span><span class="o">.</span><span class="na">terremark</span><span class="o">.</span><span class="na">domain</span><span class="o">.</span><span class="na">VAppConfiguration</span><span class="o">.</span><span class="na">Builder</span><span class="o">.</span><span class="na">addDisk</span><span class="o">;</span>
<span class="o">...</span>
<span class="n">Task</span> <span class="n">task</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">configureVApp</span><span class="o">(</span><span class="n">vApp</span><span class="o">,</span> <span class="n">addDisk</span><span class="o">(</span><span class="mi">1048576</span><span class="o">));</span>
-</code></pre>
-</div>
+</code></pre></div>
<ul>
@@ -354,8 +341,7 @@ Get a reference to your vApp and select
<span class="c1">// delete the second disk</span>
<span class="n">Task</span> <span class="n">task</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">configureVApp</span><span class="o">(</span><span class="n">vApp</span><span class="o">,</span> <span class="n">deleteDiskWithAddressOnParent</span><span class="o">(</span><span class="n">disks</span><span class="o">.</span><span class="na">get</span><span class="o">(</span><span class="mi">1</span><span class="o">).</span><span class="na">getAddressOnParent</span><span class="o">()));</span>
-</code></pre>
-</div>
+</code></pre></div>
<h3>IP Addresses</h3>
@@ -401,8 +387,7 @@ Here's how:</p>
<span class="c1">// Everything is setup!</span>
<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">printf</span><span class="o">(</span><span class="s">"you can now connect to ssh://%s:22%n"</span><span class="o">,</span> <span class="n">publicIp</span><span class="o">.</span><span class="na">getHostAddress</span><span class="o">());</span>
<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">printf</span><span class="o">(</span><span class="s">"when you start a webserver it will be at http://%s%n"</span><span class="o">,</span> <span class="n">publicIp</span><span class="o">.</span><span class="na">getHostAddress</span><span class="o">());</span>
-</code></pre>
-</div>
+</code></pre></div>
<ul>
@@ -426,8 +411,7 @@ Here's how:</p>
<span class="n">ip</span> <span class="o">=</span> <span class="n">TerremarkECloudClient</span><span class="o">.</span><span class="na">class</span><span class="o">.</span><span class="na">cast</span><span class="o">(</span><span class="n">client</span><span class="o">).</span><span class="na">activatePublicIpInVDC</span><span class="o">(</span>
<span class="n">vdc</span><span class="o">.</span><span class="na">getHref</span><span class="o">());</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div>
<ul>
@@ -445,8 +429,7 @@ For example, if you want to open SSH and
<span class="c1">// a Node is a connection to a public IP on a particular port.</span>
<span class="n">Node</span> <span class="n">node</span> <span class="o">=</span> <span class="n">tmClient</span>
<span class="o">.</span><span class="na">addNode</span><span class="o">(</span><span class="n">is</span><span class="o">.</span><span class="na">getHref</span><span class="o">(),</span> <span class="n">privateAddress</span><span class="o">,</span> <span class="n">vApp</span><span class="o">.</span><span class="na">getName</span><span class="o">()</span> <span class="o">+</span> <span class="s">"-"</span> <span class="o">+</span> <span class="n">port</span><span class="o">,</span> <span class="n">port</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div>
<h2>Troubleshooting</h2>
@@ -461,8 +444,7 @@ For example, if you want to open SSH and
The list of available networks is in the exception message. For example:</p>
<div class="highlight"><pre><code class="text">1) Error in custom provider, java.lang.IllegalStateException: you must specify the property jclouds.vcloud.defaults.network as one of [10.1.1.160/27, 10.1.1.192/27, 10.1.1.224/27, 10.1.1.0/28]
-</code></pre>
-</div>
+</code></pre></div>
<p>`</p>
@@ -477,8 +459,7 @@ The list of available networks is in the
<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>
-</code></pre>
-</div>
+</code></pre></div>
Modified: incubator/jclouds/site-content/documentation/userguide/using-abiquo/index.html
URL: http://svn.apache.org/viewvc/incubator/jclouds/site-content/documentation/userguide/using-abiquo/index.html?rev=1523548&r1=1523547&r2=1523548&view=diff
==============================================================================
--- incubator/jclouds/site-content/documentation/userguide/using-abiquo/index.html (original)
+++ incubator/jclouds/site-content/documentation/userguide/using-abiquo/index.html Mon Sep 16 07:17:44 2013
@@ -61,8 +61,7 @@
<span class="o">.</span><span class="na">endpoint</span><span class="o">(</span><span class="s">"http://localhost/api"</span><span class="o">)</span>
<span class="o">.</span><span class="na">credentials</span><span class="o">(</span><span class="s">"user"</span><span class="o">,</span> <span class="s">"password"</span><span class="o">)</span>
<span class="o">.</span><span class="na">buildView</span><span class="o">(</span><span class="n">AbiquoContext</span><span class="o">.</span><span class="na">class</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div>
<h2>Context root services</h2>
@@ -76,8 +75,7 @@
<span class="c1">// Get access to the cloud API</span>
<span class="n">CloudService</span> <span class="n">cloud</span> <span class="o">=</span> <span class="n">context</span><span class="o">.</span><span class="na">getCloudService</span><span class="o">()</span>
<span class="n">List</span><span class="o"><</span><span class="n">VirtualMachine</span><span class="o">></span> <span class="n">vms</span> <span class="o">=</span> <span class="n">cloud</span><span class="o">.</span><span class="na">listVirtualMachines</span><span class="o">()</span>
-</code></pre>
-</div>
+</code></pre></div>
<h2>Using the domain objects to perform operations</h2>
@@ -95,8 +93,7 @@
<span class="n">datacenter</span><span class="o">.</span><span class="na">update</span><span class="o">();</span>
<span class="c1">// Delete the datacenter </span>
<span class="n">datacenter</span><span class="o">.</span><span class="na">delete</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div>
<h2>A more complete example</h2>
@@ -119,8 +116,7 @@
<span class="o">{</span>
<span class="n">context</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div>
<h1>The Administration API by example</h1>
@@ -165,8 +161,7 @@
<span class="c1">// At this point the compute infrastructure is ready and users will be able to start</span>
<span class="c1">// deploying virtual machines</span>
-</code></pre>
-</div>
+</code></pre></div>
<h2>Configuring the storage infrastructure</h2>
@@ -210,8 +205,7 @@
<span class="c1">// At this point the infrastructure is ready with one storage tier and users will be</span>
<span class="c1">// able to create volumes on demand.</span>
-</code></pre>
-</div>
+</code></pre></div>
<h2>Configuring the network infrastructure</h2>
@@ -270,8 +264,7 @@
<span class="c1">// At this point the infrastructure is ready with a public network that can be used by anyone, and an external</span>
<span class="c1">// and unmanaged network that have been assigned to a tenant.</span>
-</code></pre>
-</div>
+</code></pre></div>
<p>The default network creation enables all IP addresses inside the network range. To customize this, and disable a set of IPs so they cannot be used, or to put them in quarantine, you can iterate the available IPs and update them accordingly as shown in the example:</p>
@@ -282,8 +275,7 @@
<span class="n">publicIp</span><span class="o">.</span><span class="na">setAvailable</span><span class="o">(</span><span class="kc">false</span><span class="o">);</span>
<span class="n">publicIp</span><span class="o">.</span><span class="na">update</span><span class="o">();</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div>
<h2>Managing tenants</h2>
@@ -324,8 +316,7 @@
<span class="c1">// At this point, the new Enterprise is created and ready to begin consuming the resources</span>
<span class="c1">// of the cloud</span>
-</code></pre>
-</div>
+</code></pre></div>
<h1>The Cloud API by example</h1>
@@ -387,8 +378,7 @@
<span class="c1">// At this point the virtual infrastructure is ready and users will be able to start</span>
<span class="c1">// deploying virtual machines</span>
-</code></pre>
-</div>
+</code></pre></div>
<h2>Deploying virtual machines</h2>
@@ -424,8 +414,7 @@
<span class="c1">// At this point a deployment job has been started asynchronously and the </span>
<span class="c1">// virtual machine will be deployed in the background</span>
-</code></pre>
-</div>
+</code></pre></div>
<h3>Monitoring virtual machine deployments</h3>
@@ -445,8 +434,7 @@
<span class="c1">// At this point the deployment has finished and the virtual machine will provide detailed</span>
<span class="c1">// information about the status of the deployment.</span>
-</code></pre>
-</div>
+</code></pre></div>
<h4>Deploy a virtual machine and wait asynchronously</h4>
@@ -467,8 +455,7 @@
<span class="c1">// Handle timeout here</span>
<span class="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div>
<p>Once the handler has been defined, it only needs to be registered to start receiving events. It will receive <strong>ALL</strong> events from all objects, so if you only want to handle the events of a particular object, make sure to check against the <strong>event.getTarget()</strong> method in your handler code to ensure you are handling the right event.</p>
@@ -488,16 +475,14 @@
<span class="c1">// The 'monitor' method will not block and the program execution will continue</span>
<span class="c1">// normally. Events will be dispatched to handlers when the monitor completes, fails</span>
<span class="c1">// or reaches timeout.</span>
-</code></pre>
-</div>
+</code></pre></div>
<p>Do not forget to <strong>unregister</strong> your handler so you stop receiving events when you are done. This can be done by invoking the monitoring service as follows:</p>
<div class="highlight"><pre><code class="java"><span class="n">VirtualMachineMonitor</span> <span class="n">monitor</span> <span class="o">=</span> <span class="n">context</span><span class="o">.</span><span class="na">getMonitoringService</span><span class="o">().</span><span class="na">getVirtualMachineMonitor</span><span class="o">();</span>
<span class="n">monitor</span><span class="o">.</span><span class="na">unregister</span><span class="o">(</span><span class="n">handler</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div>
<p>You may want to unregister the handler inside the event handler methods. There is no limitation on that. Feel free to code your handlers however you like.</p>
@@ -543,8 +528,7 @@
<span class="c1">// At this point the virtual machine is configured with an additional 2GB hard</span>
<span class="c1">// disk, and a 20GB additional persistent iscsi volume.</span>
-</code></pre>
-</div>
+</code></pre></div>
<h2>Configuring networking in virtual machines</h2>
@@ -579,7 +563,7 @@
<span class="n">Datacenter</span> <span class="n">datacenter</span> <span class="o">=</span> <span class="n">vdc</span><span class="o">.</span><span class="na">getDatacenter</span><span class="o">();</span>
<span class="n">ExternalNetwork</span> <span class="n">extNet</span> <span class="o">=</span>
<span class="n">enterprise</span><span class="o">.</span><span class="na">findExternalNetwork</span><span class="o">(</span><span class="n">datacenter</span><span class="o">,</span>
- <span class="n">NetworkPredicates</span><span class="o">.<</span><span class="n">ExternalIp</span><span class="o">></span> <span class="n">name</span><span class="o">(</span><span class="s">"ExternalNetwork"</span><span class="o">));</span>
+ <span class="n">NetworkPredicates</span><span class="o">.<</span><span class="n">ExternalIp</span><span class="o">></span> <span class="nf">name</span><span class="o">(</span><span class="s">"ExternalNetwork"</span><span class="o">));</span>
<span class="n">ExternalIp</span> <span class="n">extIp</span> <span class="o">=</span> <span class="n">extNet</span><span class="o">.</span><span class="na">listUnusedIps</span><span class="o">().</span><span class="na">get</span><span class="o">(</span><span class="mi">0</span><span class="o">);</span>
<span class="c1">// Get an unused public IP from the public network</span>
@@ -587,7 +571,7 @@
<span class="c1">// Get a private IP from the privateNetwork</span>
<span class="n">PrivateNetwork</span> <span class="n">privNet</span> <span class="o">=</span> <span class="n">vdc</span><span class="o">.</span><span class="na">findPrivateNetwork</span><span class="o">(</span>
- <span class="n">NetworkPredicates</span><span class="o">.<</span><span class="n">PrivateIp</span><span class="o">></span> <span class="n">name</span><span class="o">(</span><span class="s">"PrivateNetwork"</span><span class="o">));</span>
+ <span class="n">NetworkPredicates</span><span class="o">.<</span><span class="n">PrivateIp</span><span class="o">></span> <span class="nf">name</span><span class="o">(</span><span class="s">"PrivateNetwork"</span><span class="o">));</span>
<span class="n">PrivateIp</span> <span class="n">privIp</span> <span class="o">=</span> <span class="n">privNet</span><span class="o">.</span><span class="na">listUnusedIps</span><span class="o">().</span><span class="na">get</span><span class="o">(</span><span class="mi">0</span><span class="o">);</span>
<span class="c1">// At this point we have everything we need to attach the IPs to the virtual machine.</span>
@@ -597,8 +581,7 @@
<span class="n">vm</span><span class="o">.</span><span class="na">setNics</span><span class="o">(</span><span class="n">ips</span><span class="o">);</span>
<span class="c1">// At this point we have the virtual machine with the IP addresses attached to it.</span>
-</code></pre>
-</div>
+</code></pre></div>
<h3>Configuring the default gateway</h3>
@@ -612,8 +595,7 @@
<span class="c1">// Option 2: Configure the network when configuring the NICs</span>
<span class="n">PublicNetwork</span> <span class="n">gateway</span> <span class="o">=</span> <span class="n">pubIp</span><span class="o">.</span><span class="na">getNetwork</span><span class="o">();</span>
<span class="n">vm</span><span class="o">.</span><span class="na">setNics</span><span class="o">(</span><span class="n">gateway</span><span class="o">,</span> <span class="n">extIp</span><span class="o">,</span> <span class="n">pubIp</span><span class="o">,</span> <span class="n">privIp</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div>
<h3>Attaching IPs from unmanaged networks</h3>
@@ -623,16 +605,15 @@
<p>To do that, we can call the <strong>setNics</strong> method providing as many unmanaged networks as we want, to indicate that an IP address in each network (or many IP addresses if an unmanaged network is provided more than once) must be attached to the virtual machine.</p>
<div class="highlight"><pre><code class="java"><span class="n">Unmanagednetwork</span> <span class="n">unmanagedNet</span> <span class="o">=</span> <span class="n">enterprise</span><span class="o">.</span><span class="na">findUnmanagedNetwork</span><span class="o">(</span><span class="n">datacenter</span><span class="o">,</span>
- <span class="n">NetworkPredicates</span><span class="o">.<</span><span class="n">UnmanagedIp</span><span class="o">></span> <span class="n">name</span><span class="o">(</span><span class="s">"UnmanagedNetwork"</span><span class="o">));</span>
+ <span class="n">NetworkPredicates</span><span class="o">.<</span><span class="n">UnmanagedIp</span><span class="o">></span> <span class="nf">name</span><span class="o">(</span><span class="s">"UnmanagedNetwork"</span><span class="o">));</span>
<span class="n">List</span><span class="o"><</span><span class="n">UnmanagedNetwork</span><span class="o">></span> <span class="n">unmanagedNicsFromNet</span> <span class="o">=</span>
- <span class="n">Lists</span><span class="o">.<</span><span class="n">UnmanagedNetwork</span><span class="o">></span> <span class="n">newArrayList</span><span class="o">(</span><span class="n">unmanagedNet</span><span class="o">);</span>
+ <span class="n">Lists</span><span class="o">.<</span><span class="n">UnmanagedNetwork</span><span class="o">></span> <span class="nf">newArrayList</span><span class="o">(</span><span class="n">unmanagedNet</span><span class="o">);</span>
<span class="c1">// This will attach the IPs provided in the first list, and the corresponding</span>
<span class="c1">// unmanaged IPs from the given unmanaged networks.</span>
<span class="n">vm</span><span class="o">.</span><span class="na">setNics</span><span class="o">(</span><span class="n">ips</span><span class="o">,</span> <span class="n">unmanagedNicsFromNet</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div>
<h1>Miscellaneous examples</h1>
@@ -716,8 +697,7 @@
<span class="o">}</span>
<span class="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div>
<h3>VmEventHandler.java</h3>
@@ -820,8 +800,7 @@
<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Terminating monitoring thread"</span><span class="o">);</span>
<span class="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div>
Modified: incubator/jclouds/site-content/documentation/userguide/using-ec2/index.html
URL: http://svn.apache.org/viewvc/incubator/jclouds/site-content/documentation/userguide/using-ec2/index.html?rev=1523548&r1=1523547&r2=1523548&view=diff
==============================================================================
--- incubator/jclouds/site-content/documentation/userguide/using-ec2/index.html (original)
+++ incubator/jclouds/site-content/documentation/userguide/using-ec2/index.html Mon Sep 16 07:17:44 2013
@@ -93,8 +93,7 @@ if you need this, you'll have to revise
<div class="highlight"><pre><code class="java"><span class="c1">// use the m1 small with amazon linux</span>
<span class="n">Template</span> <span class="n">template</span> <span class="o">=</span> <span class="n">compute</span><span class="o">.</span><span class="na">templateBuilder</span><span class="o">().</span><span class="na">hardwareId</span><span class="o">(</span><span class="n">InstanceType</span><span class="o">.</span><span class="na">M1_SMALL</span><span class="o">).</span><span class="na">osFamily</span><span class="o">(</span><span class="n">OsFamily</span><span class="o">.</span><span class="na">AMZN_LINUX</span><span class="o">).</span><span class="na">build</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div>
<p>In order to match an Ubuntu, or CentOs image, you'll need to see the Image Parsing section.</p>
@@ -112,8 +111,7 @@ ec2 across all 4 regions. We now by defa
<span class="c1">// pick version 10.04 of ubuntu from canonical</span>
<span class="n">Template</span> <span class="n">template</span> <span class="o">=</span> <span class="n">compute</span><span class="o">.</span><span class="na">templateBuilder</span><span class="o">().</span><span class="na">hardwareId</span><span class="o">(</span><span class="n">InstanceType</span><span class="o">.</span><span class="na">M1_SMALL</span><span class="o">)</span>
<span class="o">.</span><span class="na">osVersionMatches</span><span class="o">(</span><span class="s">"10.04"</span><span class="o">).</span><span class="na">imageDescriptionMatches</span><span class="o">(</span><span class="s">"ubuntu-images"</span><span class="o">).</span><span class="na">osFamily</span><span class="o">(</span><span class="n">OsFamily</span><span class="o">.</span><span class="na">UBUNTU</span><span class="o">).</span><span class="na">build</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div>
<h3>Image Filters [v1.1.0+]</h3>
@@ -130,19 +128,15 @@ ec2 across all 4 regions. We now by defa
<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>
-</code></pre>
-</div>
+</code></pre></div>
<h4>Properties to set cluster compute images</h4>
<p>Cluster compute images are assigned the following default query, corresponding to the property key constant AWSEC2Constants.PROPERTY_EC2_CC_AMI_QUERY
-```</p>
-
-<pre><code>virtualization-type=hvm;architecture=x86_64;owner-id=137112412989,099720109477;hypervisor=xen;state=available;image-type=machine;root-device-type=ebs
-</code></pre>
-
-<p>```
+<code>
+ virtualization-type=hvm;architecture=x86_64;owner-id=137112412989,099720109477;hypervisor=xen;state=available;image-type=machine;root-device-type=ebs
+</code>
In order to save time, we only look for cluster compute images in regions that support them. In order to change the default for this, affect the property PROPERTY_EC2_CC_REGIONS, currently set to "us-east-1"</p>
<h3>Lazy Image Fetching</h3>
@@ -163,8 +157,7 @@ We now provide the option to lazy-fetch
<span class="n">Template</span> <span class="n">template</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="na">templateBuilder</span><span class="o">().</span><span class="na">imageId</span><span class="o">(</span>
<span class="s">"ami-ccb35ea5"</span><span class="o">).</span><span class="na">build</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div>
<h4>Release 1.1.0 to 1.5.x</h4>
@@ -180,8 +173,7 @@ We now provide the option to lazy-fetch
<span class="n">Template</span> <span class="n">template</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="na">templateBuilder</span><span class="o">().</span><span class="na">imageId</span><span class="o">(</span>
<span class="s">"ami-ccb35ea5"</span><span class="o">).</span><span class="na">build</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div>
<h4>Release 1.6.0 and above</h4>
@@ -201,8 +193,7 @@ We now provide the option to lazy-fetch
<span class="n">Template</span> <span class="n">template</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="na">templateBuilder</span><span class="o">().</span><span class="na">imageId</span><span class="o">(</span>
<span class="s">"ami-ccb35ea5"</span><span class="o">).</span><span class="na">build</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div>
<h3>Private Images</h3>
@@ -228,9 +219,8 @@ managing image curation, and others usin
<span class="n">ComputeServiceContext</span> <span class="n">context</span> <span class="o">=</span> <span class="k">new</span> <span class="n">ComputeServiceContextFactory</span><span class="o">().</span><span class="na">createContext</span><span class="o">(</span><span class="s">"aws-ec2"</span><span class="o">,</span> <span class="s">"accesss"</span><span class="o">,</span> <span class="s">"secret"</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">JschSshClientModule</span><span class="o">()),</span> <span class="n">props</span><span class="o">);</span>
-</code></pre>
-</div>
+ <span class="n">ImmutableSet</span><span class="o">.<</span><span class="n">Module</span><span class="o">></span> <span class="nf">of</span><span class="o">(</span><span class="k">new</span> <span class="n">JschSshClientModule</span><span class="o">()),</span> <span class="n">props</span><span class="o">);</span>
+</code></pre></div>
<h4>Releases 1.1.0 through 1.5.x</h4>
@@ -245,9 +235,8 @@ managing image curation, and others usin
<span class="n">ComputeServiceContext</span> <span class="n">context</span> <span class="o">=</span> <span class="k">new</span> <span class="n">ComputeServiceContextFactory</span><span class="o">().</span><span class="na">createContext</span><span class="o">(</span><span class="s">"aws-ec2"</span><span class="o">,</span> <span class="s">"accesss"</span><span class="o">,</span> <span class="s">"secret"</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">JschSshClientModule</span><span class="o">()),</span> <span class="n">props</span><span class="o">);</span>
-</code></pre>
-</div>
+ <span class="n">ImmutableSet</span><span class="o">.<</span><span class="n">Module</span><span class="o">></span> <span class="nf">of</span><span class="o">(</span><span class="k">new</span> <span class="n">JschSshClientModule</span><span class="o">()),</span> <span class="n">props</span><span class="o">);</span>
+</code></pre></div>
<h4>Release 1.6.0 and abovex</h4>
@@ -267,8 +256,7 @@ managing image curation, and others usin
<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>
-</code></pre>
-</div>
+</code></pre></div>
<p>You can then create nodes using the templateBuilder.imageId() method.</p>
@@ -330,8 +318,7 @@ OsFamily.UNRECOGNIZED, with no image ver
<span class="n">builder</span><span class="o">.</span><span class="na">defaultCredentials</span><span class="o">(</span><span class="k">new</span> <span class="n">Credentials</span><span class="o">(</span><span class="s">"foo-user"</span><span class="o">,</span> <span class="s">"password"</span><span class="o">));</span>
<span class="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div>
<h4>Create a test for your parser</h4>
@@ -380,8 +367,7 @@ OsFamily.UNRECOGNIZED, with no image ver
<span class="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div>
<h4>Instruct jclouds to use your parser</h4>
@@ -402,8 +388,7 @@ OsFamily.UNRECOGNIZED, with no image ver
<span class="n">bind</span><span class="o">(</span><span class="n">AWSEC2ReviseParsedImage</span><span class="o">.</span><span class="na">class</span><span class="o">).</span><span class="na">to</span><span class="o">(</span><span class="n">FooAWSEC2ReviseParsedImage</span><span class="o">.</span><span class="na">class</span><span class="o">);</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>
-</code></pre>
-</div>
+</code></pre></div>
<h4>Use your image version</h4>
@@ -411,8 +396,7 @@ OsFamily.UNRECOGNIZED, with no image ver
<p>jclouds will now pick the lexicographic highest version, as it now can parse your images.</p>
<div class="highlight"><pre><code class="java"><span class="n">Template</span> <span class="n">template</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="na">templateBuilder</span><span class="o">().</span><span class="na">imageVersionMatches</span><span class="o">(</span><span class="s">"1.1.0.*"</span><span class="o">).</span><span class="na">build</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div>
<h2>ComputeService API extensions</h2>
@@ -427,8 +411,7 @@ We now allow you to control this a bit t
<div class="highlight"><pre><code class="java">
<span class="n">options</span><span class="o">.</span><span class="na">as</span><span class="o">(</span><span class="n">AWSEC2TemplateOptions</span><span class="o">.</span><span class="na">class</span><span class="o">).</span><span class="na">spotPrice</span><span class="o">(</span><span class="mf">0.3f</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div>
<p>AWSEC2ComputeServiceLiveTest.testExtendedOptionsAndLogin() uses the spot price option on the portable interface.</p>
@@ -445,8 +428,7 @@ spot request goes through, but perhaps t
<div class="highlight"><pre><code class="java"><span class="c1">// specify your own groups which already have the correct rules applied</span>
<span class="n">template</span><span class="o">.</span><span class="na">getOptions</span><span class="o">().</span><span class="na">as</span><span class="o">(</span><span class="n">EC2TemplateOptions</span><span class="o">.</span><span class="na">class</span><span class="o">).</span><span class="na">securityGroups</span><span class="o">(</span><span class="n">group1</span><span class="o">,</span> <span class="n">group2</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div>
<h3>Key Pairs</h3>
@@ -456,8 +438,7 @@ spot request goes through, but perhaps t
<span class="c1">// if your image doesn't use keypairs (ex enstratus), skip creating one</span>
<span class="n">template</span><span class="o">.</span><span class="na">getOptions</span><span class="o">().</span><span class="na">as</span><span class="o">(</span><span class="n">EC2TemplateOptions</span><span class="o">.</span><span class="na">class</span><span class="o">).</span><span class="na">noKeyPair</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div>
<h3>VPC</h3>
@@ -470,8 +451,7 @@ spot request goes through, but perhaps t
<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="n">group</span><span class="o">,</span> <span class="mi">1</span><span class="o">,</span>
<span class="n">options</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div>
<p>You can also checkout <code>EC2ComputeServiceListTest.testExtendedOptionsWithSubnetId()</code></p>
@@ -486,8 +466,7 @@ spot request goes through, but perhaps t
<span class="n">options</span><span class="o">.</span><span class="na">as</span><span class="o">(</span><span class="n">EC2TemplateOptions</span><span class="o">.</span><span class="na">class</span><span class="o">).</span><span class="na">enableMonitoring</span><span class="o">();</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">monitoredNodes</span> <span class="o">=</span> <span class="n">compute</span><span class="o">.</span><span class="na">runNodesInGroup</span><span class="o">(</span><span class="n">group</span><span class="o">,</span> <span class="mi">1</span><span class="o">,</span> <span class="n">options</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div>
<p>You can then use the !CloudWatchClient to get statistics on your nodes.</p>
@@ -501,8 +480,7 @@ spot request goes through, but perhaps t
<span class="n">Set</span><span class="o"><</span><span class="n">Datapoint</span><span class="o">></span> <span class="n">datapoints</span> <span class="o">=</span> <span class="n">monitoringContext</span><span class="o">.</span><span class="na">getApi</span><span class="o">().</span><span class="na">getMetricStatisticsInRegion</span><span class="o">(</span><span class="n">region</span><span class="o">,</span>
<span class="s">"CPUUtilization"</span><span class="o">,</span> <span class="n">before</span><span class="o">,</span> <span class="k">new</span> <span class="n">Date</span><span class="o">(),</span> <span class="mi">60</span><span class="o">,</span> <span class="s">"Average"</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div>
<h2>GovCloud</h2>
@@ -512,8 +490,7 @@ For EC2:</p>
<div class="highlight"><pre><code class="java"><span class="kd">public</span> <span class="kd">static</span> <span class="kd">final</span> <span class="n">String</span> <span class="n">GOV_CLOUD_ENDPOINT</span> <span class="o">=</span> <span class="s">"https://ec2.us-gov-west-1.amazonaws.com"</span><span class="o">;</span>
<span class="n">overrides</span><span class="o">.</span><span class="na">setProperty</span><span class="o">(</span><span class="s">"aws-ec2.endpoint"</span><span class="o">,</span> <span class="n">GOV_CLOUD_ENDPOINT</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div>
<p>You can find GovCloud endpoints for other services here: