History

Jeff Lowdermilk 553f9f822b Add ga-beacon analytics to gendocs scripts hack/run-gendocs.sh puts ga-beacon analytics link into all md files, hack/verify-gendocs.sh verifies presence of link.		2015-05-15 18:56:38 -07:00
..
README.md	Add ga-beacon analytics to gendocs scripts	2015-05-15 18:56:38 -07:00
dapi-pod.yaml	Change EnvVarSource.FieldPath -> FieldRef and add example	2015-05-04 18:41:09 -04:00

README.md

Downward API example

Following this example, you will create a pod with a containers that consumes the pod's name and namespace using the downward API.

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 for installation instructions for your platform.

Step One: Create the pod

Containers consume the downward API using environment variables. The downward API allows containers to be injected with the name and namespace of the pod the container is in.

Use the examples/downward-api/dapi-pod.yaml file to create a Pod with a container that consumes the downward API.

$ kubectl create -f examples/downward-api/dapi-pod.yaml

Examine the logs

This pod runs the env command in a container that consumes the downward API. You can grep through the pod logs to see that the pod was injected with the correct values:

$ kubectl log dapi-test-pod | grep POD_
2015-04-30T20:22:18.568024817Z POD_NAME=dapi-test-pod
2015-04-30T20:22:18.568087688Z POD_NAMESPACE=default