From 6b4ab17902864efaee792017e7f0f705426abf56 Mon Sep 17 00:00:00 2001 From: Derek Carr Date: Thu, 5 Nov 2020 13:52:55 -0500 Subject: [PATCH] Add documentation for downward API hugepages --- .../command-line-tools-reference/feature-gates.md | 2 ++ .../downward-api-volume-expose-pod-information.md | 12 +++++++----- 2 files changed, 9 insertions(+), 5 deletions(-) diff --git a/content/en/docs/reference/command-line-tools-reference/feature-gates.md b/content/en/docs/reference/command-line-tools-reference/feature-gates.md index 303c90aae5..a0659fc597 100644 --- a/content/en/docs/reference/command-line-tools-reference/feature-gates.md +++ b/content/en/docs/reference/command-line-tools-reference/feature-gates.md @@ -91,6 +91,7 @@ different Kubernetes components. | `DevicePlugins` | `true` | Beta | 1.10 | | | `DisableAcceleratorUsageMetrics` | `false` | Alpha | 1.19 | 1.19 | | `DisableAcceleratorUsageMetrics` | `true` | Beta | 1.20 | 1.22 | +| `DownwardAPIHugePages` | `false` | Alpha | 1.20 | | | `DryRun` | `false` | Alpha | 1.12 | 1.12 | | `DryRun` | `true` | Beta | 1.13 | | | `DynamicKubeletConfig` | `false` | Alpha | 1.4 | 1.10 | @@ -438,6 +439,7 @@ Each feature gate is designed for enabling/disabling a specific feature: based resource provisioning on nodes. - `DefaultPodTopologySpread`: Enables the use of `PodTopologySpread` scheduling plugin to do [default spreading](/docs/concepts/workloads/pods/pod-topology-spread-constraints/#internal-default-constraints). +- `DownwardAPIHugePages`: Enables usage of hugepages in downward API. - `DryRun`: Enable server-side [dry run](/docs/reference/using-api/api-concepts/#dry-run) requests so that validation, merging, and mutation can be tested without committing. - `DynamicAuditing`(*deprecated*): Used to enable dynamic auditing before v1.19. diff --git a/content/en/docs/tasks/inject-data-application/downward-api-volume-expose-pod-information.md b/content/en/docs/tasks/inject-data-application/downward-api-volume-expose-pod-information.md index a46e065169..579adcb736 100644 --- a/content/en/docs/tasks/inject-data-application/downward-api-volume-expose-pod-information.md +++ b/content/en/docs/tasks/inject-data-application/downward-api-volume-expose-pod-information.md @@ -202,16 +202,18 @@ variables and `downwardAPI` volumes: * Information available via `fieldRef`: * `metadata.name` - the pod's name * `metadata.namespace` - the pod's namespace - * `metadata.uid` - the pod's UID, available since v1.8.0-alpha.2 - * `metadata.labels['']` - the value of the pod's label `` (for example, `metadata.labels['mylabel']`); available in Kubernetes 1.9+ - * `metadata.annotations['']` - the value of the pod's annotation `` (for example, `metadata.annotations['myannotation']`); available in Kubernetes 1.9+ + * `metadata.uid` - the pod's UID + * `metadata.labels['']` - the value of the pod's label `` (for example, `metadata.labels['mylabel']`) + * `metadata.annotations['']` - the value of the pod's annotation `` (for example, `metadata.annotations['myannotation']`) * Information available via `resourceFieldRef`: * A Container's CPU limit * A Container's CPU request * A Container's memory limit * A Container's memory request - * A Container's ephemeral-storage limit, available since v1.8.0-beta.0 - * A Container's ephemeral-storage request, available since v1.8.0-beta.0 + * A Container's hugepages limit (providing that the `DownwardAPIHugePages` [feature gate](/docs/reference/command-line-tools-reference/feature-gates/) is enabled) + * A Container's hugepages request (providing that the `DownwardAPIHugePages` [feature gate](/docs/reference/command-line-tools-reference/feature-gates/) is enabled) + * A Container's ephemeral-storage limit + * A Container's ephemeral-storage request In addition, the following information is available through `downwardAPI` volume `fieldRef`: