From f528ef80189f7d1ad11bd788791e4941fe6eaca9 Mon Sep 17 00:00:00 2001 From: Johan Euphrosine Date: Sat, 7 Jun 2014 01:50:26 -0700 Subject: [PATCH 1/3] guestbook: add link to cluster setup instruction --- examples/guestbook/guestbook.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/examples/guestbook/guestbook.md b/examples/guestbook/guestbook.md index 9c678dc5b42..ef5848a61ee 100644 --- a/examples/guestbook/guestbook.md +++ b/examples/guestbook/guestbook.md @@ -5,7 +5,7 @@ This example shows how to build a simple multi-tier web application using Kubern The example combines a web frontend, a redis master for storage and a replicated set of redis slaves. ### Step Zero: Prerequisites -This example assumes that you have forked the repository and turned up a Kubernetes cluster. +This example assumes that you have forked the repository and [turned up a Kubernetes cluster](https://github.com/GoogleCloudPlatform/kubernetes-new#setup). ### Step One: Turn up the redis master. From 859f5a1552a94c63e55c090d850e51fb1232d139 Mon Sep 17 00:00:00 2001 From: Johan Euphrosine Date: Sat, 7 Jun 2014 02:02:32 -0700 Subject: [PATCH 2/3] guestbook: s/services/tasks/ --- examples/guestbook/guestbook.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/examples/guestbook/guestbook.md b/examples/guestbook/guestbook.md index ef5848a61ee..aa3a86493d1 100644 --- a/examples/guestbook/guestbook.md +++ b/examples/guestbook/guestbook.md @@ -73,7 +73,7 @@ cluster/cloudcfg.sh -c redis-master-service.json create /services Once created, the service proxy on each minion is configured to set up a proxy on the specified port (in this case port 10000). -### Step Three: Turn up the replicated slave service. +### Step Three: Turn up the replicated slave tasks. Although the redis master is a single task, the redis read slaves are a 'replicated' task, in Kubernetes, a replication controller is responsible for managing multiple instances of a replicated task. Create a file named `redis-slave-controller.json` that contains: ```javascript @@ -139,7 +139,7 @@ Now that you have created the service specification, create it in your cluster w cluster/cloudcfg.sh -c redis-slave-service.json create /services ``` -### Step Five: Create the frontend service. +### Step Five: Create the frontend task. This is a simple PHP server that is configured to talk to both the slave and master services depdending on if the request is a read or a write. It exposes a simple AJAX interface, and serves an angular based U/X. Like the redis read slaves it is a replicated service instantiated by a replication controller. Create a file named `frontend-controller.json`: From c4b07b16dfeeccd3c8febc6a94369dfc527160df Mon Sep 17 00:00:00 2001 From: Johan Euphrosine Date: Sat, 7 Jun 2014 02:11:23 -0700 Subject: [PATCH 3/3] guestbook: add link to cloud console --- examples/guestbook/guestbook.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/examples/guestbook/guestbook.md b/examples/guestbook/guestbook.md index aa3a86493d1..bc2292298b2 100644 --- a/examples/guestbook/guestbook.md +++ b/examples/guestbook/guestbook.md @@ -219,4 +219,6 @@ if (isset($_GET['cmd']) === true) { } ?> ``` -To play with the service itself, find the name of a frontend, grab the external IP of that host from the Google Cloud Console, and visit http://<host-ip>:8080. Note, you may need to open the firewall for port 8080 using the console or the gcloud tool. +To play with the service itself, find the name of a frontend, grab the external IP of that host from the [Google Cloud Console][cloud-console], and visit `http://:8080`. Note, you may need to open the firewall for port 8080 using the [console][cloud-console] or the `gcloud` tool. + +[cloud-console]: https://console.developer.google.com