kubernetes
/
website
mirror of https://github.com/kubernetes/website.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

document pod downwardAPI fieldRef values (#8217)

This commit is contained in:
Jordan Liggitt 2018-05-04 18:11:51 -04:00 committed by k8s-ci-robot
parent 3ceca3fb05
commit 6c816ff9ff
1 changed files with 20 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
docs/tasks/inject-data-application/downward-api-volume-expose-pod-information.md
View File

@ -190,26 +190,30 @@ You can use similar commands to view the `cpu_request`, `mem_limit` and
## Capabilities of the Downward API ## Capabilities of the Downward API
The following information is available to Containers through environment The following information is available to containers through environment
variables and DownwardAPIVolumeFiles: variables and `downwardAPI` volumes:
* The Node’s name * Information available via `fieldRef`:
* The Node's IP * `spec.nodeName` - the node’s name
* The Pod’s name * `status.hostIP` - the node's IP
* The Pod’s namespace * `metadata.name` - the pod’s name
* The Pod’s IP address * `metadata.namespace` - the pod’s namespace
* The Pod’s service account name * `status.podIP` - the pod’s IP address
* The Pod’s UID * `spec.serviceAccountName` - the pod’s service account name
* A Container’s CPU limit * `metadata.uid` - the pod’s UID
* A Container’s CPU request * `metadata.labels['<KEY>']` - the value of the pod’s label `<KEY>` (for example, `metadata.labels['mylabel']`); available in Kubernetes 1.9+
* A Container’s memory limit * `metadata.annotations['<KEY>']` - the value of the pod’s annotation `<KEY>` (for example, `metadata.annotations['myannotation']`); available in Kubernetes 1.9+
* A Container’s memory request * Information available via `resourceFieldRef`:
* A Container’s CPU limit
* A Container’s CPU request
* A Container’s memory limit
* A Container’s memory request
In addition, the following information is available through In addition, the following information is available through
DownwardAPIVolumeFiles. `downwardAPI` volume `fieldRef`:
* The Pod's labels * `metadata.labels` - all of the pod’s labels, formatted as `label-key="escaped-label-value"` with one label per line
* The Pod's annotations * `metadata.annotations` - all of the pod’s annotations, formatted as `annotation-key="escaped-annotation-value"` with one annotation per line
**Note:** If CPU and memory limits are not specified for a Container, the **Note:** If CPU and memory limits are not specified for a Container, the
Downward API defaults to the node allocatable value for CPU and memory. Downward API defaults to the node allocatable value for CPU and memory.