From 32f45fb417fb3bf0fc29e6792fa059206af7ecd3 Mon Sep 17 00:00:00 2001
From: steveperry-53 <stevepe@google.com>
Date: Thu, 20 Oct 2016 11:05:23 -0700
Subject: [PATCH] Write new task: Defining a Command and Arguments for a
 Container.

---
 _data/tasks.yml                               |  2 +
 .../configure-pod-container/commands.yaml     | 12 ++++
 .../define-command-argument-container.md      | 69 +++++++++++++++++++
 docs/tasks/index.md                           |  5 ++
 4 files changed, 88 insertions(+)
 create mode 100644 docs/tasks/configure-pod-container/commands.yaml
 create mode 100644 docs/tasks/configure-pod-container/define-command-argument-container.md

diff --git a/_data/tasks.yml b/_data/tasks.yml
index 91bbe1bcca..90c1f3b8b2 100644
--- a/_data/tasks.yml
+++ b/_data/tasks.yml
@@ -6,6 +6,8 @@ toc:
   section:
   - title: Defining Environment Variables for a Container
     path: /docs/tasks/configure-pod-container/define-environment-variable-container/
+  - title: Defining a Command and Arguments for a Container
+    path: /docs/tasks/configure-pod-container/define-command-argument-container/
 - title: Accessing Applications in a Cluster
   section:
   - title: Using Port Forwarding to Access Applications in a Cluster
diff --git a/docs/tasks/configure-pod-container/commands.yaml b/docs/tasks/configure-pod-container/commands.yaml
new file mode 100644
index 0000000000..8d58007db4
--- /dev/null
+++ b/docs/tasks/configure-pod-container/commands.yaml
@@ -0,0 +1,12 @@
+apiVersion: v1
+kind: Pod
+metadata:
+  name: command-demo
+  labels:
+    purpose: demonstrate-command
+spec:
+  containers:
+  - name: command-demo-container
+    image: debian
+    command: ["printenv"]
+    args: ["HOSTNAME", "KUBERNETES_PORT"]
diff --git a/docs/tasks/configure-pod-container/define-command-argument-container.md b/docs/tasks/configure-pod-container/define-command-argument-container.md
new file mode 100644
index 0000000000..bbff487674
--- /dev/null
+++ b/docs/tasks/configure-pod-container/define-command-argument-container.md
@@ -0,0 +1,69 @@
+---
+---
+
+{% capture overview %}
+
+This page shows how to define commands and arguments when you run a container
+in a Kubernetes Pod.
+
+{% endcapture %}
+
+
+{% capture prerequisites %}
+
+{% include task-tutorial-prereqs.md %}
+
+{% endcapture %}
+
+
+{% capture steps %}
+
+### Defining a command when you create a Pod
+
+When you create a Pod, you can specify a command and arguments for the
+containers that run in the Pod. To specify a command, include the `command`
+field in the configuration file. To specify arguments for the command, include
+the `args` field in the configuration file. The command that you specify in the
+configuration file overrides the usual entry point for the container.
+
+In this exercise, you create a Pod that runs one container. The configuration
+file for the Pod defines a command and two arguments:
+
+{% include code.html language="yaml" file="commands.yaml" ghlink="/docs/tasks/configure-pod-container/commands.yaml" %}
+
+1. Create a Pod based on the YAML configuration file:
+
+        export REPO=https://raw.githubusercontent.com/kubernetes/kubernetes.github.io/master
+        kubectl create -f $REPO/docs/tasks/configure-pod-container/commands.yaml
+
+1. List the running Pods:
+
+        kubectl get pods
+
+    The output shows that the container that ran in the command-demo Pod has
+    completed.
+
+1. To see the output of the command that ran in the container, view the logs
+from the Pod:
+
+        kubectl logs command-demo
+
+    The output shows the values of the HOSTNAME and KUBERNETES_PORT environment
+    variables:
+
+        command-demo
+        tcp://10.3.240.1:443
+
+{% endcapture %}
+
+{% capture whatsnext %}
+
+* Learn more about [containers and commands](/docs/user-guide/containers/).
+* Learn more about [configuring containers](/docs/user-guide/configuring-containers/).
+* Learn more about [running commands in a container](/docs/user-guide/getting-into-containers/).
+* See [Container](/docs/api-reference/v1/definitions/#_v1_container).
+
+{% endcapture %}
+
+
+{% include templates/task.md %}
diff --git a/docs/tasks/index.md b/docs/tasks/index.md
index dcd9120e1b..fc08a0469a 100644
--- a/docs/tasks/index.md
+++ b/docs/tasks/index.md
@@ -3,6 +3,11 @@
 
 The Tasks section of the Kubernetes documentation is a work in progress
 
+#### Configuring Pods and Containers
+
+* [Defining Environment Variables for a Container](/docs/tasks/configure-pod-container/define-environment-variable-container/)
+* [Defining a Command and Arguments for a Container](/docs/tasks/configure-pod-container/define-command-argument-container/)
+
 #### Accessing Applications in a Cluster
 
 * [Using Port Forwarding to Access Applications in a Cluster](/docs/tasks/access-application-cluster/port-forward-access-application-cluster/)