Moving docs from /vX to /docs; we will use branches for old versions.

docs/user-guide/secrets/index.md

@@ -0,0 +1,59 @@
+---
+---
+
+Following this example, you will create a secret and a [pod](/docs/user-guide/pods/) that consumes that secret in a [volume](/docs/user-guide/volumes/). See [Secrets design document](https://github.com/kubernetes/kubernetes/blob/{{page.githubbranch}}/docs/design/secrets.md) for more information.
+
+## 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`](/docs/user-guide/secrets/secret.yaml) file to create a secret:
+
+```shell
+$ kubectl create -f docs/user-guide/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`](/docs/user-guide/secrets/secret-pod.yaml) file to create a Pod that consumes the secret.
+
+```shell
+$ kubectl create -f docs/user-guide/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
+```

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=