From c2a3e4e8117f7332118906c07425a56c4ff3232e Mon Sep 17 00:00:00 2001
From: Jeff Mendoza <jeffmendoza@google.com>
Date: Thu, 16 Apr 2015 11:47:59 -0700
Subject: [PATCH] Add Environment Guide example.

This example shows a simple two tier setup in Kubernetes, and
simply prints the environment information that each pod sees.
Querying the service multiple times will show services at work
load balancing requests.
---
 examples/environment-guide/README.md          |  92 +++++++++++++++++
 examples/environment-guide/backend-rc.yaml    |  30 ++++++
 examples/environment-guide/backend-srv.yaml   |  13 +++
 .../environment-guide/containers/README.md    |  23 +++++
 .../containers/backend/Dockerfile             |   2 +
 .../containers/backend/backend.go             |  37 +++++++
 .../containers/show/Dockerfile                |   2 +
 .../environment-guide/containers/show/show.go |  95 ++++++++++++++++++
 examples/environment-guide/diagram.png        | Bin 0 -> 18765 bytes
 examples/environment-guide/show-rc.yaml       |  32 ++++++
 examples/environment-guide/show-srv.yaml      |  15 +++
 11 files changed, 341 insertions(+)
 create mode 100644 examples/environment-guide/README.md
 create mode 100644 examples/environment-guide/backend-rc.yaml
 create mode 100644 examples/environment-guide/backend-srv.yaml
 create mode 100644 examples/environment-guide/containers/README.md
 create mode 100644 examples/environment-guide/containers/backend/Dockerfile
 create mode 100644 examples/environment-guide/containers/backend/backend.go
 create mode 100644 examples/environment-guide/containers/show/Dockerfile
 create mode 100644 examples/environment-guide/containers/show/show.go
 create mode 100644 examples/environment-guide/diagram.png
 create mode 100644 examples/environment-guide/show-rc.yaml
 create mode 100644 examples/environment-guide/show-srv.yaml

diff --git a/examples/environment-guide/README.md b/examples/environment-guide/README.md
new file mode 100644
index 0000000000000..bd796f161c627
--- /dev/null
+++ b/examples/environment-guide/README.md
@@ -0,0 +1,92 @@
+Environment Guide Example
+=========================
+This example demonstrates running pods, replication controllers, and
+services. It shows two types of pods: frontend and backend, with
+services on top of both. Accessing the frontend pod will return
+environment information about itself, and a backend pod that it has
+accessed through the service. The goal is to illuminate the
+environment metadata available to running containers inside the
+Kubernetes cluster. The documentation for the kubernetes environment
+is [here](/docs/container-environment.md).
+
+![Diagram](diagram.png)
+
+Prerequisites
+-------------
+This example assumes that you have a Kubernetes cluster installed and
+running, and that you have installed the `kubectl` command line tool
+somewhere in your path.  Please see the [getting
+started](/docs/getting-started-guides) for installation instructions
+for your platform.
+
+Optional: Build your own containers
+-----------------------------------
+The code for the containers is under
+[containers/](containers)
+
+Get everything running
+----------------------
+
+    kubectl create -f ./backend-rc.yaml
+    kubectl create -f ./backend-srv.yaml
+    kubectl create -f ./show-rc.yaml
+    kubectl create -f ./show-srv.yaml
+
+Query the service
+-----------------
+Use `kubectl describe service show-srv` to determine the public IP of
+your service.
+
+> Note: If your platform does not support external load balancers,
+  you'll need to open the proper port and direct traffic to the
+  internal IP shown for the frontend service with the above command
+
+Run `curl <public ip>:80` to query the service. You should get
+something like this back:
+
+```
+Pod Name: show-rc-xxu6i
+Pod Namespace: default
+USER_VAR: important information
+
+Kubenertes environment variables
+BACKEND_SRV_SERVICE_HOST = 10.147.252.185
+BACKEND_SRV_SERVICE_PORT = 5000
+KUBERNETES_RO_SERVICE_HOST = 10.147.240.1
+KUBERNETES_RO_SERVICE_PORT = 80
+KUBERNETES_SERVICE_HOST = 10.147.240.2
+KUBERNETES_SERVICE_PORT = 443
+KUBE_DNS_SERVICE_HOST = 10.147.240.10
+KUBE_DNS_SERVICE_PORT = 53
+
+Found backend ip: 10.147.252.185 port: 5000
+Response from backend
+Backend Container
+Backend Pod Name: backend-rc-6qiya
+Backend Namespace: default
+```
+
+First the frontend pod's information is printed. The pod name and
+[namespace](/docs/design/namespaces.md) are retreived from the
+[Downward API](/docs/downward_api.md). Next, `USER_VAR` is the name of
+an environment variable set in the [pod
+definition](show-rc.yaml). Then, the dynamic kubernetes environment
+variables are scanned and printed. These are used to find the backend
+service, named `backend-srv`. Finally, the frontend pod queries the
+backend service and prints the information returned. Again the backend
+pod returns its own pod name and namespace.
+
+Try running the `curl` command a few times, and notice what
+changes. Ex: `watch -n 1 curl -s <ip>` Firstly, the frontend service
+is directing your request to different frontend pods each time. The
+frontend pods are always contacting the backend through the backend
+service. This results in a different backend pod servicing each
+request as well.
+
+Cleanup
+-------
+    kubectl delete rc,service -l type=show-type
+    kubectl delete rc,service -l type=backend-type
+
+
+[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/examples/environment-guide/README.md?pixel)]()
diff --git a/examples/environment-guide/backend-rc.yaml b/examples/environment-guide/backend-rc.yaml
new file mode 100644
index 0000000000000..6c57b95dac912
--- /dev/null
+++ b/examples/environment-guide/backend-rc.yaml
@@ -0,0 +1,30 @@
+---
+apiVersion: v1
+kind: ReplicationController
+metadata:
+  name: backend-rc
+  labels:
+    type: backend-type
+spec:
+  replicas: 3
+  template:
+    metadata:
+      labels:
+        type: backend-type
+    spec:
+      containers:
+      - name: backend-container
+        image: gcr.io/google-samples/env-backend:1.1
+        imagePullPolicy: Always
+        ports:
+        - containerPort: 5000
+          protocol: TCP
+        env:
+        - name: POD_NAME
+          valueFrom:
+            fieldRef:
+              fieldPath: metadata.name
+        - name: POD_NAMESPACE
+          valueFrom:
+            fieldRef:
+              fieldPath: metadata.namespace
diff --git a/examples/environment-guide/backend-srv.yaml b/examples/environment-guide/backend-srv.yaml
new file mode 100644
index 0000000000000..7083b37bf88e0
--- /dev/null
+++ b/examples/environment-guide/backend-srv.yaml
@@ -0,0 +1,13 @@
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: backend-srv
+  labels:
+    type: backend-type
+spec:
+  ports:
+  - port: 5000
+    protocol: TCP
+  selector:
+    type: backend-type
diff --git a/examples/environment-guide/containers/README.md b/examples/environment-guide/containers/README.md
new file mode 100644
index 0000000000000..2e08760ce14b8
--- /dev/null
+++ b/examples/environment-guide/containers/README.md
@@ -0,0 +1,23 @@
+Building
+--------
+For each container, the build steps are the same. The examples below
+are for the `show` container. Replace `show` with `backend` for the
+backend container.
+
+GCR
+---
+    docker build -t gcr.io/<project-name>/show .
+    gcloud preview docker push gcr.io/<project-name>/show
+
+Docker Hub
+----------
+    docker build -t <username>/show .
+    docker push <username>/show
+
+Change Pod Definitions
+----------------------
+Edit both `show-rc.yaml` and `backend-rc.yaml` and replace the
+specified `image:` with the one that you built.
+
+
+[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/examples/environment-guide/containers/README.md?pixel)]()
diff --git a/examples/environment-guide/containers/backend/Dockerfile b/examples/environment-guide/containers/backend/Dockerfile
new file mode 100644
index 0000000000000..3fa58ff7abe43
--- /dev/null
+++ b/examples/environment-guide/containers/backend/Dockerfile
@@ -0,0 +1,2 @@
+FROM golang:onbuild
+EXPOSE 8080
diff --git a/examples/environment-guide/containers/backend/backend.go b/examples/environment-guide/containers/backend/backend.go
new file mode 100644
index 0000000000000..b4edf75ff5ddd
--- /dev/null
+++ b/examples/environment-guide/containers/backend/backend.go
@@ -0,0 +1,37 @@
+/*
+Copyright 2015 The Kubernetes Authors All rights reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+package main
+
+import (
+	"fmt"
+	"log"
+	"net/http"
+	"os"
+)
+
+func printInfo(resp http.ResponseWriter, req *http.Request) {
+	name := os.Getenv("POD_NAME")
+	namespace := os.Getenv("POD_NAMESPACE")
+	fmt.Fprintf(resp, "Backend Container\n")
+	fmt.Fprintf(resp, "Backend Pod Name: %v\n", name)
+	fmt.Fprintf(resp, "Backend Namespace: %v\n", namespace)
+}
+
+func main() {
+	http.HandleFunc("/", printInfo)
+	log.Fatal(http.ListenAndServe(":5000", nil))
+}
diff --git a/examples/environment-guide/containers/show/Dockerfile b/examples/environment-guide/containers/show/Dockerfile
new file mode 100644
index 0000000000000..3fa58ff7abe43
--- /dev/null
+++ b/examples/environment-guide/containers/show/Dockerfile
@@ -0,0 +1,2 @@
+FROM golang:onbuild
+EXPOSE 8080
diff --git a/examples/environment-guide/containers/show/show.go b/examples/environment-guide/containers/show/show.go
new file mode 100644
index 0000000000000..56bd988b4000f
--- /dev/null
+++ b/examples/environment-guide/containers/show/show.go
@@ -0,0 +1,95 @@
+/*
+Copyright 2015 The Kubernetes Authors All rights reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+package main
+
+import (
+	"fmt"
+	"io"
+	"log"
+	"net/http"
+	"os"
+	"sort"
+	"strings"
+)
+
+func getKubeEnv() (map[string]string, error) {
+	environS := os.Environ()
+	environ := make(map[string]string)
+	for _, val := range environS {
+		split := strings.Split(val, "=")
+		if len(split) != 2 {
+			return environ, fmt.Errorf("Some weird env vars")
+		}
+		environ[split[0]] = split[1]
+	}
+	for key := range environ {
+		if !(strings.HasSuffix(key, "_SERVICE_HOST") ||
+			strings.HasSuffix(key, "_SERVICE_PORT")) {
+			delete(environ, key)
+		}
+	}
+	return environ, nil
+}
+
+func printInfo(resp http.ResponseWriter, req *http.Request) {
+	kubeVars, err := getKubeEnv()
+	if err != nil {
+		http.Error(resp, err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	backendHost := os.Getenv("BACKEND_SRV_SERVICE_HOST")
+	backendPort := os.Getenv("BACKEND_SRV_SERVICE_PORT")
+	backendRsp, backendErr := http.Get(fmt.Sprintf(
+		"http://%v:%v/",
+		backendHost,
+		backendPort))
+	if backendErr == nil {
+		defer backendRsp.Body.Close()
+	}
+
+	name := os.Getenv("POD_NAME")
+	namespace := os.Getenv("POD_NAMESPACE")
+	fmt.Fprintf(resp, "Pod Name: %v \n", name)
+	fmt.Fprintf(resp, "Pod Namespace: %v \n", namespace)
+
+	envvar := os.Getenv("USER_VAR")
+	fmt.Fprintf(resp, "USER_VAR: %v \n", envvar)
+
+	fmt.Fprintf(resp, "\nKubenertes environment variables\n")
+	var keys []string
+	for key := range kubeVars {
+		keys = append(keys, key)
+	}
+	sort.Strings(keys)
+	for _, key := range keys {
+		fmt.Fprintf(resp, "%v = %v \n", key, kubeVars[key])
+	}
+
+	fmt.Fprintf(resp, "\nFound backend ip: %v port: %v\n", backendHost, backendPort)
+	if backendErr == nil {
+		fmt.Fprintf(resp, "Response from backend\n")
+		io.Copy(resp, backendRsp.Body)
+	} else {
+		fmt.Fprintf(resp, "Error from backend: %v", backendErr.Error())
+	}
+}
+
+func main() {
+	http.HandleFunc("/", printInfo)
+	log.Fatal(http.ListenAndServe(":8080", nil))
+}
diff --git a/examples/environment-guide/diagram.png b/examples/environment-guide/diagram.png
new file mode 100644
index 0000000000000000000000000000000000000000..dd5d1551631f2adce68bfa4555050a2fa1250af0
GIT binary patch
literal 18765
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
Jilj}R{4WuILE8WT

literal 0
HcmV?d00001

diff --git a/examples/environment-guide/show-rc.yaml b/examples/environment-guide/show-rc.yaml
new file mode 100644
index 0000000000000..4de94c06ca30b
--- /dev/null
+++ b/examples/environment-guide/show-rc.yaml
@@ -0,0 +1,32 @@
+---
+apiVersion: v1
+kind: ReplicationController
+metadata:
+  name: show-rc
+  labels:
+    type: show-type
+spec:
+  replicas: 3
+  template:
+    metadata:
+      labels:
+        type: show-type
+    spec:
+      containers:
+      - name: show-container
+        image: gcr.io/google-samples/env-show:1.1
+        imagePullPolicy: Always
+        ports:
+        - containerPort: 8080
+          protocol: TCP
+        env:
+        - name: USER_VAR
+          value: important information
+        - name: POD_NAME
+          valueFrom:
+            fieldRef:
+              fieldPath: metadata.name
+        - name: POD_NAMESPACE
+          valueFrom:
+            fieldRef:
+              fieldPath: metadata.namespace
diff --git a/examples/environment-guide/show-srv.yaml b/examples/environment-guide/show-srv.yaml
new file mode 100644
index 0000000000000..25a2d7473e021
--- /dev/null
+++ b/examples/environment-guide/show-srv.yaml
@@ -0,0 +1,15 @@
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: show-srv
+  labels:
+    type: show-type
+spec:
+  type: LoadBalancer
+  ports:
+  - port: 80
+    protocol: TCP
+    targetPort: 8080
+  selector:
+    type: show-type