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 [5/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/using-maven/index.html
URL: http://svn.apache.org/viewvc/incubator/jclouds/site-content/documentation/userguide/using-maven/index.html?rev=1523548&r1=1523547&r2=1523548&view=diff
==============================================================================
--- incubator/jclouds/site-content/documentation/userguide/using-maven/index.html (original)
+++ incubator/jclouds/site-content/documentation/userguide/using-maven/index.html Mon Sep 16 07:17:44 2013
@@ -88,8 +88,7 @@
<span class="n">Map</span><span class="o"><</span><span class="n">String</span><span class="o">,</span> <span class="n">InputStream</span><span class="o">></span> <span class="n">map</span> <span class="o">=</span> <span class="n">context</span><span class="o">.</span><span class="na">createInputStreamMap</span><span class="o">(</span><span class="s">"adrian.home"</span><span class="o">);</span>
<span class="c1">// do work</span>
<span class="n">context</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div>
<p>This also assumes that you do not have heavy-duty needs that warrant connection-pooling or NIO,
@@ -102,8 +101,7 @@ or that you are in an environment that c
<span class="nt"><artifactId></span>jclouds-blobstore<span class="nt"></artifactId></span>
<span class="nt"><version></span>1.2.1<span class="nt"></version></span>
<span class="nt"></dependency></span>
-</code></pre>
-</div>
+</code></pre></div>
<p>Using the above, you will gain access to the provider named <code>transient</code>. Note that this is in-memory. Typically, you will instead want to add dependencies on a specific provider of resources like those for S3:</p>
@@ -113,8 +111,7 @@ or that you are in an environment that c
<span class="nt"><artifactId></span>aws-s3<span class="nt"></artifactId></span>
<span class="nt"><version></span>1.2.1<span class="nt"></version></span>
<span class="nt"></dependency></span>
-</code></pre>
-</div>
+</code></pre></div>
<p>Noting that you could alternatively ask for all of our supported blobstores using the dependency <code>jclouds-allblobstore</code> instead.</p>
@@ -124,8 +121,7 @@ or that you are in an environment that c
<div class="highlight"><pre><code class="java"><span class="n">BlobStoreContext</span> <span class="n">context</span> <span class="o">=</span> <span class="n">ContextBuilder</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="s">"aws-s3"</span><span class="o">)</span>
<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">secret</span><span class="o">)</span>
<span class="o">.</span><span class="na">buildView</span><span class="o">(</span><span class="n">BlobStoreContext</span><span class="o">.</span><span class="na">class</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div>
<h3>BlobStore from Google App Engine</h3>
@@ -138,8 +134,7 @@ However, you do have to configure your c
<span class="o">.</span><span class="na">modules</span><span class="o">(</span><span class="n">ImmutableSet</span><span class="o">.</span><span class="na">of</span><span class="o">(</span>
<span class="k">new</span> <span class="nf">AsyncGoogleAppEngineConfigurationModule</span><span class="o">()))</span>
<span class="o">.</span><span class="na">buildView</span><span class="o">(</span><span class="n">BlobStoreContext</span><span class="o">.</span><span class="na">class</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div>
<p>Here are the dependencies needed to use google's UrlFetchService::</p>
@@ -154,8 +149,7 @@ However, you do have to configure your c
<span class="nt"><artifactId></span>jclouds-gae<span class="nt"></artifactId></span>
<span class="nt"><version></span>1.2.1<span class="nt"></version></span>
<span class="nt"></dependency></span>
-</code></pre>
-</div>
+</code></pre></div>
<h3>Logging</h3>
@@ -166,8 +160,7 @@ However, you do have to configure your c
<span class="o">.</span><span class="na">credentials</span><span class="o">(</span><span class="n">identity</span><span class="o">,</span> <span class="n">credential</span><span class="o">)</span>
<span class="o">.</span><span class="na">modules</span><span class="o">(</span><span class="n">ImmutableSet</span><span class="o">.</span><span class="na">of</span><span class="o">(</span><span class="k">new</span> <span class="n">Log4JLoggingModule</span><span class="o">()))</span>
<span class="o">.</span><span class="na">buildView</span><span class="o">(</span><span class="n">BlobStoreContext</span><span class="o">.</span><span class="na">class</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div>
<p>Here are the dependencies for BlobStore and log4j logging:</p>
@@ -182,8 +175,7 @@ However, you do have to configure your c
<span class="nt"><artifactId></span>jclouds-log4j<span class="nt"></artifactId></span>
<span class="nt"><version></span>1.2.1<span class="nt"></version></span>
<span class="nt"></dependency></span>
-</code></pre>
-</div>
+</code></pre></div>
<p>The log categories are set to package names, so plan on assigning <code>org.jclouds</code> appropriately in your log4j.xml.</p>
@@ -209,8 +201,7 @@ so that your credentials can be used for
<span class="nt"><test.provider.credential></span>password,secret,etc<span class="nt"></test.provider.credential></span>
<span class="nt"></properties></span>
<span class="nt"></profile></span>
-</code></pre>
-</div>
+</code></pre></div>
<p>Here is an example of a complete <em>settings.xml</em> file you can save to the ~/.m2 directory, just remember to add your personal credentials:</p>
@@ -231,8 +222,7 @@ so that your credentials can be used for
<span class="nt"></profile></span>
<span class="nt"></profiles></span>
<span class="nt"></settings></span>
-</code></pre>
-</div>
+</code></pre></div>
<h3>Testing SSH drivers</h3>
@@ -252,8 +242,7 @@ so that your credentials can be used for
<span class="nt"><test.ssh.password></span>LOCAL_SSH_PASSWORD<span class="nt"></test.ssh.password></span>
<span class="nt"></properties></span>
<span class="nt"></profile></span>
-</code></pre>
-</div>
+</code></pre></div>
<p>Here is an example of a complete <em>settings.xml</em> file you can save to the ~/.m2 directory, just remember to change the ssh credentials:</p>
@@ -272,8 +261,7 @@ so that your credentials can be used for
<span class="nt"></profile></span>
<span class="nt"></profiles></span>
<span class="nt"></settings></span>
-</code></pre>
-</div>
+</code></pre></div>
Modified: incubator/jclouds/site-content/documentation/userguide/vmware-vcloud-director/index.html
URL: http://svn.apache.org/viewvc/incubator/jclouds/site-content/documentation/userguide/vmware-vcloud-director/index.html?rev=1523548&r1=1523547&r2=1523548&view=diff
==============================================================================
--- incubator/jclouds/site-content/documentation/userguide/vmware-vcloud-director/index.html (original)
+++ incubator/jclouds/site-content/documentation/userguide/vmware-vcloud-director/index.html Mon Sep 16 07:17:44 2013
@@ -77,8 +77,7 @@ vAppTemplateApi = context.getApi().getVA
vdcApi = context.getApi().getVdcApi();
vmApi = context.getApi().getVmApi();
networkApi = context.getApi().getNetworkApi();
-</code></pre>
-</div>
+</code></pre></div>
<p>Each one of them allows you to access the API functionalities of any vCloud Director subsystem.</p>
@@ -92,8 +91,7 @@ Starting from a vApp template, in fact,
<span class="o">.</span><span class="na">name</span><span class="o">(</span><span class="n">name</span><span class="o">(</span><span class="s">"vApp-"</span><span class="o">))</span>
<span class="o">.</span><span class="na">instantiationParams</span><span class="o">(</span><span class="n">instantiationParams</span><span class="o">())</span>
<span class="o">.</span><span class="na">build</span><span class="o">());</span>
-</code></pre>
-</div>
+</code></pre></div>
<p>where instantiationParams() are in charge to create a 'vAppNetwork' attached to the orgNetwork 'networkURI':</p>
@@ -136,15 +134,13 @@ Starting from a vApp template, in fact,
<span class="k">return</span> <span class="n">networkConfiguration</span><span class="o">;</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div>
<p>Or you can always recompose an existing vApp</p>
<div class="highlight"><pre><code class="java"><span class="n">vAppApi</span><span class="o">.</span><span class="na">recompose</span><span class="o">(</span><span class="n">vApp</span><span class="o">.</span><span class="na">getHref</span><span class="o">(),</span> <span class="n">params</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div>
<p>where 'params' are RecomposeVAppParams.</p>
Modified: incubator/jclouds/site-content/documentation/userguide/vmware-vcloud/index.html
URL: http://svn.apache.org/viewvc/incubator/jclouds/site-content/documentation/userguide/vmware-vcloud/index.html?rev=1523548&r1=1523547&r2=1523548&view=diff
==============================================================================
--- incubator/jclouds/site-content/documentation/userguide/vmware-vcloud/index.html (original)
+++ incubator/jclouds/site-content/documentation/userguide/vmware-vcloud/index.html Mon Sep 16 07:17:44 2013
@@ -63,7 +63,6 @@ We also provide tools that make developi
<table>
<thead>
<tr>
-<th></th>
<th> <em>Company</em> </th>
<th> <em>Offering</em> </th>
<th> <em>Provider in jclouds</em> </th>
@@ -72,32 +71,28 @@ We also provide tools that make developi
</thead>
<tbody>
<tr>
-<td></td>
<td> <img src="http://www.vmware.com/files/images/vam/img-terremark.gif"> </td>
<td> <a href="http://vcloudexpress.terremark.com/blog.aspx">vCloud Express</a> </td>
<td> trmk-vcloudexpress </td>
-<td> 0.8a-ext1.6 |</td>
+<td> 0.8a-ext1.6 </td>
</tr>
<tr>
-<td></td>
<td> <img src="http://www.vmware.com/files/images/vam/img-terremark.gif"></td>
<td> <a href="http://www.terremark.com/services/cloudcomputing/theenterprisecloud.aspx">Enterprise Cloud</a> </td>
<td> trmk-ecloud </td>
-<td> 0.8b-ext2.3 |</td>
+<td> 0.8b-ext2.3 </td>
</tr>
<tr>
-<td></td>
<td> <img src="http://www.vmware.com/files/images/vam/img-bluelock.gif"> </td>
<td> <a href="http://www.bluelock.com/bluelock-cloud-hosting/virtual-cloud-enterprise/">vCloud Enterprise</a></td>
<td> bluelock-vcdirector </td>
-<td> 1.0 | </td>
+<td> 1.0 </td>
</tr>
<tr>
-<td></td>
<td> <a href="http://www.stratogen.net/products/vmware-hosting.html"><img src="http://www.stratogen.net/images/footerlogo.gif"></a> </td>
<td> <a href="http://www.stratogen.net/products/vmware-hosting.html">VMware Hosting</a></td>
<td> stratogen-vcloud-mycloud </td>
-<td> 1.0 |</td>
+<td> 1.0 </td>
</tr>
</tbody>
</table>
@@ -123,8 +118,7 @@ to either get a portable cloud computing
<span class="c1">// use context to obtain vcloud objects with terremark vCloud express extensions</span>
<span class="n">RestContext</span><span class="o"><</span><span class="n">TerremarkVCloudExpressClient</span><span class="o">,</span> <span class="n">TerremarkVCloudExpressAsyncClient</span><span class="o">></span> <span class="n">providerContext</span> <span class="o">=</span> <span class="n">context</span><span class="o">.</span><span class="na">getProviderContext</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div>
<ul>
@@ -141,8 +135,7 @@ to either get a portable cloud computing
<span class="c1">// use context to obtain vcloud objects with terremark eCloud extensions</span>
<span class="n">RestContext</span><span class="o"><</span><span class="n">TerremarkECloudClient</span><span class="o">,</span> <span class="n">TerremarkECloudAsyncClient</span><span class="o">></span> <span class="n">providerContext</span> <span class="o">=</span> <span class="n">context</span><span class="o">.</span><span class="na">getProviderContext</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div>
<ul>
@@ -158,8 +151,7 @@ to either get a portable cloud computing
<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">RestContext</span><span class="o"><</span><span class="n">VCloudClient</span><span class="o">,</span> <span class="n">VCloudAsyncClient</span><span class="o">></span> <span class="n">providerContext</span> <span class="o">=</span> <span class="n">context</span><span class="o">.</span><span class="na">getProviderContext</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div>
<ul>
@@ -176,8 +168,7 @@ to either get a portable cloud computing
<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">RestContext</span><span class="o"><</span><span class="n">VCloudClient</span><span class="o">,</span> <span class="n">VCloudAsyncClient</span><span class="o">></span> <span class="n">providerContext</span> <span class="o">=</span> <span class="n">context</span><span class="o">.</span><span class="na">getProviderContext</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div>
<ul>
@@ -196,8 +187,7 @@ to either get a portable cloud computing
<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">RestContext</span><span class="o"><</span><span class="n">VCloudClient</span><span class="o">,</span> <span class="n">VCloudAsyncClient</span><span class="o">></span> <span class="n">providerContext</span> <span class="o">=</span> <span class="n">context</span><span class="o">.</span><span class="na">getProviderContext</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div>
<h2>Portability</h2>
@@ -207,8 +197,7 @@ to either get a portable cloud computing
<div class="highlight"><pre><code class="text">// get a synchronous object to use for manipulating vcloud objects
CommonVCloudClient client = context.getApi()
-</code></pre>
-</div>
+</code></pre></div>
<p>If you are interacting with Terremark, you can cast to <code>VCloudExpressClient</code> and <code>VCloudExpressAsyncClient</code>
@@ -229,8 +218,7 @@ to use the common features between eClou
<span class="c1">// note that vcloud 0.8 vApp template is not compatible with 1.0. </span>
<span class="c1">// Use VCloudExpressVAppTemplate in that case</span>
<span class="n">VCloudExpressVAppTemplate</span> <span class="n">vAppTemplate</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">getEntity</span><span class="o">().</span><span class="na">getHref</span><span class="o">());</span>
-</code></pre>
-</div>
+</code></pre></div>
<h3>Instantiate, deploy, and powerOn a vApp template in vCloud 0.8 (Terremark)</h3>
@@ -260,8 +248,7 @@ to use the common features between eClou
<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>
<h3>Instantiate, deploy, and powerOn a vApp template in vCloud 1.0</h3>
@@ -285,8 +272,7 @@ to transition to powerOn state from inst
<span class="c1">// block until 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">task</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 deploy and powerOn "</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>
<h3>Getting vApp details</h3>
@@ -301,8 +287,7 @@ to transition to powerOn state from inst
<span class="c1">// for vCloud 1.0 based services</span>
<span class="n">vApp</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">getVApp</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>
<h3>Closing the context</h3>
@@ -310,8 +295,7 @@ to transition to powerOn state from inst
<p>The context object uses threads and other resources. When you are finished, close it.</p>
<div class="highlight"><pre><code class="java"> <span class="n">context</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div>
<h3>vApp Templates</h3>
@@ -337,8 +321,7 @@ No.</p></li>
<span class="n">VCloudExpressVApp</span> <span class="n">app</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">getVApp</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="o">}</span>
<span class="o">}</span>
-</code></pre>
-</div>
+</code></pre></div>
<ul>
@@ -360,8 +343,7 @@ Get a reference to the vApp object and q
<span class="c1">// be careful as you may have multiple disks</span>
<span class="kt">int</span> <span class="n">kbDisk</span> <span class="o">=</span> <span class="o">(</span><span class="kt">int</span><span class="o">)</span> <span class="n">find</span><span class="o">(</span><span class="n">hardware</span><span class="o">.</span><span class="na">getResourceAllocations</span><span class="o">(),</span> <span class="n">resourceType</span><span class="o">(</span><span class="n">ResourceType</span><span class="o">.</span><span class="na">DISK_DRIVE</span><span class="o">)).</span><span class="na">getVirtualQuantity</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div>
<ul>
@@ -381,8 +363,7 @@ Get a reference to the vApp object and q
<span class="c1">// be careful as you may have multiple disks</span>
<span class="kt">int</span> <span class="n">kbDisk</span> <span class="o">=</span> <span class="o">(</span><span class="kt">int</span><span class="o">)</span> <span class="n">find</span><span class="o">(</span><span class="n">vApp</span><span class="o">.</span><span class="na">getResourceAllocations</span><span class="o">(),</span> <span class="n">resourceType</span><span class="o">(</span><span class="n">ResourceType</span><span class="o">.</span><span class="na">DISK_DRIVE</span><span class="o">)).</span><span class="na">getVirtualQuantity</span><span class="o">();</span>
-</code></pre>
-</div>
+</code></pre></div>
<ul>
@@ -400,8 +381,7 @@ Get a reference to the vApp object and q
<span class="n">String</span> <span class="n">newName</span> <span class="o">=</span> <span class="s">"clone of "</span><span class="o">+</span><span class="n">sourceVApp</span><span class="o">.</span><span class="na">getName</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">cloneVAppInVDC</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">sourceVApp</span><span class="o">.</span><span class="na">getHref</span><span class="o">(),</span> <span class="n">newName</span><span class="o">);</span>
-</code></pre>
-</div>
+</code></pre></div>
<ul>
@@ -419,8 +399,7 @@ Get a reference to the vApp object and q
<span class="n">String</span> <span class="n">newName</span> <span class="o">=</span> <span class="s">"clone of "</span><span class="o">+</span><span class="n">sourceVApp</span><span class="o">.</span><span class="na">getName</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">cloneVAppInVDC</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">sourceVApp</span><span class="o">.</span><span class="na">getHref</span><span class="o">(),</span> <span class="n">newName</span><span class="o">,</span> <span class="n">deploy</span><span class="o">().</span><span class="na">powerOn</span><span class="o">());</span>
-</code></pre>
-</div>
+</code></pre></div>