Add usage example for gcloud-java-examples

Ajay Kannan · Ajay Kannan · commit eac140ad4291 · 2015-10-09T14:06:38.000-07:00
diff --git a/gcloud-java-examples/README.md b/gcloud-java-examples/README.md
@@ -20,6 +20,33 @@ Add this to your pom.xml file
 </dependency>
 ```
 
+To run examples from your command line:
+
+1. Login using gcloud SDK (`gcloud auth login` in command line)
+
+2. Compile using Maven (`mvn compile` in command line from your base project directory)
+
+3. Run an example using Maven from command line.
+
+  Here's an example run of `DatastoreExample`.
+  
+  Note that you have to enable the Google Cloud Datastore API on the [Google Developers Console][developers-console] before running the following commands.
+  ```
+  $mvn exec:java -Dexec.mainClass="com.google.gcloud.examples.DatastoreExample" -Dexec.args="[<project_id>] [user] add my\ comment"
+  $mvn exec:java -Dexec.mainClass="com.google.gcloud.examples.DatastoreExample" -Dexec.args="[<project_id>] [user] display"
+  $mvn exec:java -Dexec.mainClass="com.google.gcloud.examples.DatastoreExample" -Dexec.args="[<project_id>] [user] delete"
+  ```
+
+  Here's an example run of `StorageExample`.
+
+  Before running the example, go to the [Google Developers Console][developers-console] to ensure that Google Cloud Storage API is enabled and that you have a bucket.  Also ensure that you have a test file (`test.txt` is chosen here) to upload to Cloud Storage stored locally on your machine.
+  ```
+  $mvn exec:java -Dexec.mainClass="com.google.gcloud.examples.StorageExample" -Dexec.args="<project_id> upload /path/to/test.txt <bucket_name>"
+  $mvn exec:java -Dexec.mainClass="com.google.gcloud.examples.StorageExample" -Dexec.args="<project_id> list <bucket_name>"
+  $mvn exec:java -Dexec.mainClass="com.google.gcloud.examples.StorageExample" -Dexec.args="<project_id> download <bucket_name> test.txt"
+  $mvn exec:java -Dexec.mainClass="com.google.gcloud.examples.StorageExample" -Dexec.args="<project_id> delete <bucket_name> test.txt"
+```
+
 Contributing
 ------------
 
@@ -50,3 +77,4 @@ Apache 2.0 - See [LICENSE] for more information.
 [CONTRIBUTING]:https://github.com/GoogleCloudPlatform/gcloud-java/blob/master/CONTRIBUTING.md
 [LICENSE]: https://github.com/GoogleCloudPlatform/gcloud-java/blob/master/LICENSE
 [cloud-platform]: https://cloud.google.com/
+[developers-console]:https://console.developers.google.com/
