Add more instructions for Spring Boot Hello World.

tswast · tswast · commit 72e20e86c4fc · 2016-04-05T12:47:09.000-07:00
This sample is linked to from https://cloud.google.com/java/
diff --git a/helloworld-springboot/README.md b/helloworld-springboot/README.md
@@ -1,17 +1,83 @@
 # Spring Boot based Hello World app
 
-## Requirements
-* [Apache Maven](http://maven.apache.org) 3.1 or greater
-* JDK 8 in order to run
-* [Cloud SDK for Managed VMs](https://cloud.google.com/appengine/docs/managed-vms/)
+This sample shows how to run a [Spring Boot][spring-boot] application on [Google
+Cloud Platform][cloud-java]. It uses the [Google App Engine flexible
+environment][App Engine-flexible].
 
-## Run the Application locally
-1. Set the correct Cloud SDK project via `gcloud config set project YOUR_PROJECT`
-id of your application.
-2. Run `mvn spring-boot:run`
-4. Visit http://localhost:8080
+[App Engine-flexible]: https://cloud.google.com/appengine/docs/flexible/
+[cloud-java]: https://cloud.google.com/java/
+[spring-boot]: http://projects.spring.io/spring-boot/
 
-## Deploy to AppEngine Managed VMs
 
-5. `mvn gcloud:deploy`
-6. Visit `http://YOUR_PROJECT.appspot.com`.
+## Before you begin
+
+This sample assumes you have [Java 8][java8] installed.
+
+[java8]: http://www.oracle.com/technetwork/java/javase/downloads/
+
+### Download Maven
+
+These samples use the [Apache Maven][maven] build system. Before getting
+started, be sure to [download][maven-download] and [install][maven-install] it.
+When you use Maven as described here, it will automatically download the needed
+client libraries.
+
+[maven]: https://maven.apache.org
+[maven-download]: https://maven.apache.org/download.cgi
+[maven-install]: https://maven.apache.org/install.html
+
+### Create a Project in the Google Cloud Platform Console
+
+If you haven't already created a project, create one now. Projects enable you to
+manage all Google Cloud Platform resources for your app, including deployment,
+access control, billing, and services.
+
+1. Open the [Cloud Platform Console][cloud-console].
+1. In the drop-down menu at the top, select **Create a project**.
+1. Give your project a name.
+1. Make a note of the project ID, which might be different from the project
+   name. The project ID is used in commands and in configurations.
+
+[cloud-console]: https://console.cloud.google.com/
+
+### Enable billing for your project.
+
+If you haven't already enabled billing for your project, [enable
+billing][enable-billing] now.  Enabling billing allows the application to
+consume billable resources such as running instances and storing data.
+
+[enable-billing]: https://console.cloud.google.com/project/_/settings
+
+### Install the Google Cloud SDK.
+
+If you haven't already installed the Google Cloud SDK, [install and initialize
+the Google Cloud SDK][cloud-sdk] now. The SDK contains tools and libraries that
+enable you to create and manage resources on Google Cloud Platform.
+
+[cloud-sdk]: https://cloud.google.com/sdk/
+
+### Install the Google App Engine SDK for Java
+
+
+```
+gcloud components update app-engine-java
+gcloud components update
+```
+
+
+## Run the application locally
+
+1. Set the correct Cloud SDK project via `gcloud config set project
+   YOUR_PROJECT` to the ID of your application.
+1. Run `mvn spring-boot:run`
+1. Visit http://localhost:8080
+
+
+## Deploy to App Engine flexible environment
+
+1. `mvn gcloud:deploy`
+1. Visit `http://YOUR_PROJECT.appspot.com`.
+
+
+Java is a registered trademark of Oracle Corporation and/or its affiliates.
+
