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 2015/05/04 14:29:30 UTC
svn commit: r1677592 - /jclouds/site-content/guides/google/index.html
Author: nacx
Date: Mon May 4 12:29:30 2015
New Revision: 1677592
URL: http://svn.apache.org/r1677592
Log:
Updated Google docs
Modified:
jclouds/site-content/guides/google/index.html
Modified: jclouds/site-content/guides/google/index.html
URL: http://svn.apache.org/viewvc/jclouds/site-content/guides/google/index.html?rev=1677592&r1=1677591&r2=1677592&view=diff
==============================================================================
--- jclouds/site-content/guides/google/index.html (original)
+++ jclouds/site-content/guides/google/index.html Mon May 4 12:29:30 2015
@@ -159,9 +159,27 @@
<p>This guide helps you to get started with <a href="https://cloud.google.com/">Google Cloud Platform</a> development using jclouds.</p>
-<p>Currently, <a href="https://developers.google.com/compute/">Google Compute Engine</a> is covered. This is a <a href="http://jclouds.apache.org/start/compute/">compute service</a> that allows you to run vitual machines on Google's infrastructure.</p>
+<p>Currently, <a href="https://developers.google.com/compute/">Google Compute Engine</a> is covered. This is a <a href="http://jclouds.apache.org/start/compute/">compute service</a> that allows you to run vitual machines on Google's infrastructure. There is also an implementation of the <a href="http://jclouds.apache.org/start/blobstore/">blob store</a> abstraction for managing key-value storage.</p>
-<p>This guide assumes you have a Google Cloud project. If you do not have a project yet, you can sign up via the <a href="https://console.developers.google.com/">Developer Console</a>. For GCE, you need to set up billing.</p>
+<p>Working with the Google Cloud Platform requires a project. If you do not have a project yet, you can sign up via the <a href="https://console.developers.google.com/">Developer Console</a>. There is a free trial availible <a href="https://cloud.google.com/free-trial/">here</a>.</p>
+
+<h2><a id="examples"></a>Running examples</h2>
+
+<p>A great starting point for using jclouds on GCE is to run the examples provided on <a href="https://github.com/jclouds/jclouds-examples">github</a>.</p>
+
+<p>Important Setup</p>
+
+<ul>
+<li>Create a project on the <a href="https://console.developers.google.com/">Developer Console</a> (instruction availible <a href="https://developers.google.com/console/help/#creatingdeletingprojects">here</a>)</li>
+<li>Go to the <a href="https://console.developers.google.com/">Developer Console</a> and choose your project.</li>
+<li>Enable the Google Compute Engine API under APIs & auth > APIs</li>
+<li>Create a service account under APIs & auth > Credentials > Create new Client ID and download the Json key. This is described more throughly below under Authentication.</li>
+</ul>
+
+
+<p>Once you have completed the setup, checkout the <a href="https://github.com/jclouds/jclouds-examples">jclouds-examples</a> repository and look at either <a href="https://github.com/jclouds/jclouds-examples/tree/master/compute-basics">compute-basic</a> for an example of using the compute service abstraction or <a href="https://github.com/jclouds/jclouds-examples/tree/master/google-lb">google-lb</a> for an example of using the GCE api directly.</p>
+
+<p>If you are having trouble feel free to <a href="https://jclouds.apache.org/community/">reach out</a>.</p>
<h2><a id="auth"></a>Authentication</h2>
@@ -170,11 +188,11 @@
<ol>
<li>You can ask a user for consent to perform operations in their name.</li>
<li>You can create a service account and authenticate using its private key.</li>
-<li>Unless configured otherwise, programs running on a GCE instance can perform operations as the project's default service account (<a href="https://developers.google.com/compute/docs/authentication">documentation</a>).</li>
+<li>Unless configured otherwise, programs running on a GCE instance can perform operations as the project's default service account (<a href="https://cloud.google.com/compute/docs/authentication">documentation</a>).</li>
</ol>
-<p>You can find all the details in <a href="https://developers.google.com/accounts/docs/OAuth2">the documentation</a>, while in these examples we will focus on option 2: service accounts.</p>
+<p>You can find all the details in <a href="https://developers.google.com/accounts/docs/OAuth2">the documentation</a>, in the jclouds-examples repository we focus on option 2: service accounts.</p>
<p>To create a new service account:</p>
@@ -183,19 +201,13 @@
<li>Choose your project.</li>
<li>Choose API & auth > Credentials.</li>
<li>Click "Create new Client ID".</li>
-<li>Select "Service account" and click "Create service ID".</li>
-<li>Details of the new service account will be displayed. You will also be able to download the private key for this account, which you will need for authentication. Make a note of the service account email address - you will need it to use the account.</li>
-<li>To keep the examples simple, we use private keys without passwords. It might be something you will not do in a production environment, but to create a private key without a password for use in the examples, run: <code>openssl pkcs12 -in {downloaded_file}.p12 -nodes -out gcp-example.pem -passin pass:notasecret</code>.</li>
+<li>Select "Service account" and click "Create Client ID".</li>
+<li>Details of the new service account will be displayed.</li>
+<li>Download a JSON key for a service account by clicking Generate new JSON key. JSON keys are used for authentication when running jclouds on GCE. Make a note of the service account email address - this is the identity that goes with the key.</li>
</ul>
-<h2><a id="examples"></a>Running examples</h2>
-
-<p>A good starting point for using GCE vis jclouds is to run <a href="https://github.com/jclouds/jclouds-examples/tree/master/google/src/main/java/org/jclouds/examples/google/computeengine">examples programs</a>. For this, download the <a href="https://github.com/jclouds/jclouds-examples">jclouds-example</a> repository and build the "google" Maven project. Each example can be run by passing the service account email as the first parameter and the path to the gcp-example.pem file (created by removing the password from the *.p12 file by the command above) as the second.</p>
-
-<p>For example, running <a href="https://github.com/jclouds/jclouds-examples/blob/master/google/src/main/java/org/jclouds/examples/google/computeengine/CreateServer.java">org.jclouds.examples.google.computeengine.CreateServer</a> will create a new virtual machine running Debian (and its persistent disk). Open the <a href="https://console.developers.google.com/">Developer Console</a> and navigate to your project and choose "Compute Engine" to see it. You can use gcutil from Google Cloud SDK to ssh to that machine - see the SSH button on that page.</p>
-
-<p>If anything failed, you can see the operation status on Compute Engine > Operations page of the <a href="https://console.developers.google.com/">Developer Console</a>.</p>
+<p>If you are having trouble feel free to <a href="https://jclouds.apache.org/community/">reach out</a>.</p>
</div>
<div class="row clearfix">