move user docs to their new home

docs/user-guide/secrets/README.md

@@ -0,0 +1,78 @@
+<!-- BEGIN MUNGE: UNVERSIONED_WARNING -->
+
+<!-- BEGIN STRIP_FOR_RELEASE -->
+
+<h1>*** PLEASE NOTE: This document applies to the HEAD of the source
+tree only. If you are using a released version of Kubernetes, you almost
+certainly want the docs that go with that version.</h1>
+
+<strong>Documentation for specific releases can be found at
+[releases.k8s.io](http://releases.k8s.io).</strong>
+
+<!-- END STRIP_FOR_RELEASE -->
+
+<!-- END MUNGE: UNVERSIONED_WARNING -->
+# Secrets example
+
+Following this example, you will create a secret and a pod that consumes that secret in a volume.
+You can learn more about secrets [Here](https://github.com/GoogleCloudPlatform/kubernetes/blob/master/docs/secrets.md).
+
+## Step Zero: Prerequisites
+
+This example assumes 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.
+
+## Step One: Create the secret
+
+A secret contains a set of named byte arrays.
+
+Use the [`examples/secrets/secret.yaml`](secret.yaml) file to create a secret:
+
+```shell
+$ kubectl create -f examples/secrets/secret.yaml
+```
+
+You can use `kubectl` to see information about the secret:
+
+```shell
+$ kubectl get secrets
+NAME          TYPE      DATA
+test-secret   Opaque    2
+
+$ kubectl describe secret test-secret
+Name:          test-secret
+Labels:        <none>
+Annotations:   <none>
+
+Type:   Opaque
+
+Data
+====
+data-1: 9 bytes
+data-2: 11 bytes
+```
+
+## Step Two: Create a pod that consumes a secret
+
+Pods consume secrets in volumes.  Now that you have created a secret, you can create a pod that
+consumes it.
+
+Use the [`examples/secrets/secret-pod.yaml`](secret-pod.yaml) file to create a Pod that consumes the secret.
+
+```shell
+$ kubectl create -f examples/secrets/secret-pod.yaml
+```
+
+This pod runs a binary that displays the content of one of the pieces of secret data in the secret
+volume: 
+
+```shell
+$ kubectl logs secret-test-pod
+2015-04-29T21:17:24.712206409Z content of file "/etc/secret-volume/data-1": value-1
+```
+
+
+<!-- BEGIN MUNGE: GENERATED_ANALYTICS -->
+[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/examples/secrets/README.md?pixel)]()
+<!-- END MUNGE: GENERATED_ANALYTICS -->

docs/user-guide/secrets/secret-pod.yaml

@@ -0,0 +1,18 @@
+apiVersion: v1
+kind: Pod
+metadata:
+  name: secret-test-pod
+spec:
+  containers:
+    - name: test-container
+      image: kubernetes/mounttest:0.1
+      command: [ "/mt", "--file_content=/etc/secret-volume/data-1" ]
+      volumeMounts:
+          # name must match the volume name below
+          - name: secret-volume
+            mountPath: /etc/secret-volume
+  volumes:
+    - name: secret-volume
+      secret:
+        secretName: test-secret
+  restartPolicy: Never

docs/user-guide/secrets/secret.yaml

@@ -0,0 +1,7 @@
+apiVersion: v1
+kind: Secret
+metadata:
+  name: test-secret
+data:
+  data-1: dmFsdWUtMQ0K
+  data-2: dmFsdWUtMg0KDQo=