Merge pull request #1351 from steveperry-53/assign-pods

Create task page: Assigning Pods to Nodes.

_data/tasks.yml

@@ -10,4 +10,8 @@ toc:
   section:
   - title: Using an HTTP Proxy to Access the Kubernetes API
     path: /docs/tasks/access-kubernetes-api/http-proxy-access-api/
+- title: Administering a Cluster
+  section:
+  - title: Assigning Pods to Nodes
+    path: /docs/tasks/administer-cluster/assign-pods-nodes/
 

docs/tasks/administer-cluster/assign-pods-nodes.md

@@ -0,0 +1,88 @@
+---
+---
+
+{% capture overview %}
+This page shows how to assign a Kubernetes Pod to a particular node in a
+Kubernetes cluster.
+{% endcapture %}
+
+{% capture prerequisites %}
+
+* Install [kubectl](http://kubernetes.io/docs/user-guide/prereqs).
+
+* Create a Kubernetes cluster, including a running Kubernetes
+  API server. One way to create a new cluster is to use
+  [Minikube](/docs/getting-started-guides/minikube).
+
+* Configure `kubectl` to communicate with your Kubernetes API server. This
+  configuration is done automatically if you use Minikube.
+
+{% endcapture %}
+
+{% capture steps %}
+
+### Adding a label to a node
+
+1. List the nodes in your cluster:
+
+        kubectl get nodes
+
+    The output is similar to this:
+
+        NAME      STATUS    AGE
+        worker0   Ready     1d
+        worker1   Ready     1d
+        worker2   Ready     1d
+
+1. Chose one of your nodes, and add a label to it:
+
+        kubectl label nodes <your-node-name> disktype=ssd
+
+    where <your-node-name> is the name of your chosen node.
+
+1. Verify that your chosen node has a `disktype=ssd` label:
+
+        kubectl get nodes --show-labels
+
+
+    The output is similar to this:
+
+        NAME      STATUS    AGE       LABELS
+        worker0   Ready     1d        ...,disktype=ssd,kubernetes.io/hostname=worker0
+        worker1   Ready     1d        ...,kubernetes.io/hostname=worker1
+        worker2   Ready     1d        ...,kubernetes.io/hostname=worker2
+
+    In the preceding output, you can see that the `worker0` node has a
+    `disktype=ssd` label.
+
+### Creating a pod that gets scheduled to your chosen node
+
+This pod configuration file describes a pod that has a node selector,
+`disktype: ssd`. This means that the pod will get scheduled on a node that has
+a `disktype=ssd` label.
+
+{% include code.html language="yaml" file="pod.yaml" ghlink="/docs/tasks/administer-cluster/pod.yaml" %}
+
+1. Use the configuration file to create a pod that will get scheduled on your
+   chosen node:
+
+        export REPO=https://raw.githubusercontent.com/kubernetes/kubernetes.github.io/master
+        kubectl create -f $REPO/docs/tasks/administer-cluster/pod.yaml
+
+1. Verify that the pod is running on your chosen node:
+
+        kubectl get pods --output=wide
+
+    The output is similar to this:
+
+        NAME     READY     STATUS    RESTARTS   AGE    IP           NODE
+        nginx    1/1       Running   0          13s    10.200.0.4   worker0
+
+{% endcapture %}
+
+{% capture whatsnext %}
+Learn more about
+[labels and selectors](/docs/user-guide/labels/).
+{% endcapture %}
+
+{% include templates/task.md %}

docs/tasks/administer-cluster/pod.yaml

@@ -0,0 +1,13 @@
+apiVersion: v1
+kind: Pod
+metadata:
+  name: nginx
+  labels:
+    env: test
+spec:
+  containers:
+  - name: nginx
+    image: nginx
+    imagePullPolicy: IfNotPresent
+  nodeSelector:
+    disktype: ssd

docs/tasks/index.md

@@ -11,6 +11,9 @@ The Tasks section of the Kubernetes documentation is a work in progress
 
 * [Using an HTTP Proxy to Access the Kubernetes API](/docs/tasks/access-kubernetes-api/http-proxy-access-api)
 
+#### Administering a Cluster
+
+* [Assigning Pods to Nodes](/docs/tasks/administer-cluster/assign-pods-nodes/)
 
 ### What's next
 

docs/tutorials/index.md

@@ -7,7 +7,7 @@ The Tutorials section of the Kubernetes documentation is a work in progress.
 
 * [Running a Stateless Application Using a Deployment](/docs/tutorials/stateless-application/run-stateless-application-deployment/)
 
-* [Exposing an External IP Address Using a Service](/docs/tutorials/stateless-application/expose-external-ip-address-service/)
+* [Using a Service to Access an Application in a Cluster](/docs/tutorials/stateless-application/expose-external-ip-address-service/)
 
 ### What's next