diff --git a/content/zh-cn/docs/tasks/inject-data-application/downward-api-volume-expose-pod-information.md b/content/zh-cn/docs/tasks/inject-data-application/downward-api-volume-expose-pod-information.md index 90b56dfad6..672a02f00d 100644 --- a/content/zh-cn/docs/tasks/inject-data-application/downward-api-volume-expose-pod-information.md +++ b/content/zh-cn/docs/tasks/inject-data-application/downward-api-volume-expose-pod-information.md @@ -20,7 +20,7 @@ A `downwardAPI` volume can expose Pod fields and container fields. {{< note >}} 本示例中的字段是 Pod 字段,不是 Pod 中容器的字段。 diff --git a/content/zh-cn/docs/tasks/inject-data-application/environment-variable-expose-pod-information.md b/content/zh-cn/docs/tasks/inject-data-application/environment-variable-expose-pod-information.md index 6b52b73b46..16845e892f 100644 --- a/content/zh-cn/docs/tasks/inject-data-application/environment-variable-expose-pod-information.md +++ b/content/zh-cn/docs/tasks/inject-data-application/environment-variable-expose-pod-information.md @@ -12,66 +12,63 @@ weight: 30 -此页面展示 Pod 如何使用环境变量把自己的信息呈现给 Pod 中运行的容器。 -环境变量可以呈现 Pod 的字段和容器字段。 +此页面展示 Pod 如何使用环境变量把自身的信息呈现给 Pod 中运行的容器。 +使用 **downward API** 你可以使用环境变量来呈现 Pod 的字段、容器字段或两者。 + + +在 Kubernetes 中有两种方式可以将 Pod 和 容器字段呈现给运行中的容器: + +* 如本任务所述的**环境变量**。 +* [卷文件](/zh-cn/docs/tasks/inject-data-application/downward-api-volume-expose-pod-information/) + +这两种呈现 Pod 和 容器字段的方式统称为 downward API。 + ## {{% heading "prerequisites" %}} -{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}} +{{< include "task-tutorial-prereqs.md" >}} -## Downward API - - - -有两种方式可以将 Pod 和 Container 字段呈现给运行中的容器: - -* 环境变量 -* [卷文件](/zh-cn/docs/tasks/inject-data-application/downward-api-volume-expose-pod-information/#the-downward-api) - -这两种呈现 Pod 和 Container 字段的方式统称为 *Downward API*。 - ## 用 Pod 字段作为环境变量的值 -在这个练习中,你将创建一个包含一个容器的 Pod。这是该 Pod 的配置文件: +在这部分练习中,你将创建一个包含一个容器的 Pod。并将 Pod 级别的字段作为环境变量映射到正在运行的容器中。 {{< codenew file="pods/inject/dapi-envars-pod.yaml" >}} -这个配置文件中,你可以看到五个环境变量。`env` 字段是一个 -[EnvVars](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#envvar-v1-core). -对象的数组。 +这个清单中,你可以看到五个环境变量。`env` 字段定义了一组环境变量。 + 数组中第一个元素指定 `MY_NODE_NAME` 这个环境变量从 Pod 的 `spec.nodeName` 字段获取变量值。 同样,其它环境变量也是从 Pod 的字段获取它们的变量值。 {{< note >}} 本示例中的字段是 Pod 字段,不是 Pod 中 Container 的字段。 @@ -91,16 +88,17 @@ Verify that the Container in the Pod is running: --> 验证 Pod 中的容器运行正常: -``` +```shell +# 如果新创建的 Pod 还是处于不健康状态,请重新运行此命令几次。 kubectl get pods ``` 查看容器日志: -``` +```shell kubectl logs dapi-envars-fieldref ``` @@ -119,17 +117,17 @@ default -要了解为什么这些值在日志中,请查看配置文件中的`command` 和 `args`字段。 -当容器启动时,它将五个环境变量的值写入 stdout。每十秒重复执行一次。 +要了解为什么这些值出现在日志中,请查看配置文件中的 `command` 和 `args` 字段。 +当容器启动时,它将五个环境变量的值写入标准输出。每十秒重复执行一次。 接下来,通过打开一个 Shell 进入 Pod 中运行的容器: -``` +```shell kubectl exec -it dapi-envars-fieldref -- sh ``` @@ -138,8 +136,9 @@ In your shell, view the environment variables: --> 在 Shell 中,查看环境变量: -``` -/# printenv +```shell +# 在容器内的 `shell` 中运行 +printenv ``` -## 用 Container 字段作为环境变量的值 +## 使用容器字段作为环境变量的值 -前面的练习中,你将 Pod 字段作为环境变量的值。 -接下来这个练习中,你将用 Container 字段作为环境变量的值。这里是包含一个容器的 Pod 的配置文件: +前面的练习中,你将 Pod 级别的字段作为环境变量的值。 +接下来这个练习中,你将传递属于 Pod 定义的字段,但这些字段取自特定容器而不是整个 Pod。 + +这里是只包含一个容器的 Pod 的清单: {{< codenew file="pods/inject/dapi-envars-container.yaml" >}} -这个配置文件中,你可以看到四个环境变量。`env` 字段是一个 -[EnvVars](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#envvar-v1-core). -对象的数组。数组中第一个元素指定 `MY_CPU_REQUEST` 这个环境变量从 Container 的 `requests.cpu` -字段获取变量值。同样,其它环境变量也是从 Container 的字段获取它们的变量值。 - -{{< note >}} -本例中使用的是 Container 的字段而不是 Pod 的字段。 -{{< /note >}} +这个清单中,你可以看到四个环境变量。`env` 字段定义了一组环境变量。 +数组中第一个元素指定 `MY_CPU_REQUEST` 这个环境变量从容器的 `requests.cpu` +字段获取变量值。同样,其它的环境变量也是从特定于这个容器的字段中获取它们的变量值。 创建Pod: @@ -204,20 +202,21 @@ kubectl apply -f https://k8s.io/examples/pods/inject/dapi-envars-container.yaml ``` 验证 Pod 中的容器运行正常: -``` +```shell +# 如果新创建的 Pod 还是处于不健康状态,请重新运行此命令几次。 kubectl get pods ``` 查看容器日志: -``` +```shell kubectl logs dapi-envars-resourcefieldref ``` @@ -236,7 +235,20 @@ The output shows the values of selected environment variables: ## {{% heading "whatsnext" %}} +* 阅读[给容器定义环境变量](/zh-cn/docs/tasks/inject-data-application/define-environment-variable-container/) +* 阅读 Pod 的 [`spec`](/zh-cn/docs/reference/kubernetes-api/workload-resources/pod-v1/#PodSpec) + API 包括容器(Pod 的一部分)的定义。 +* 阅读可以使用 downward API 公开的[可用字段](/zh-cn/docs/concepts/workloads/pods/downward-api/#available-fields)列表。 + + +在旧版 API 参考中阅读有关 Pod、容器和环境变量的信息: -* [给容器定义环境变量](/zh-cn/docs/tasks/inject-data-application/define-environment-variable-container/) * [PodSpec](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#podspec-v1-core) * [Container](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#container-v1-core) * [EnvVar](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#envvar-v1-core)