From eaa9867ce53db7c8247772de2ce5206694f94018 Mon Sep 17 00:00:00 2001 From: Qiming Teng Date: Mon, 17 Aug 2020 10:57:07 +0800 Subject: [PATCH] [zh] Rework environment-variable-expose-pod-information The original English text are missing and there are contents out of sync. --- ...ronment-variable-expose-pod-information.md | 188 +++++++++++++----- 1 file changed, 143 insertions(+), 45 deletions(-) diff --git a/content/zh/docs/tasks/inject-data-application/environment-variable-expose-pod-information.md b/content/zh/docs/tasks/inject-data-application/environment-variable-expose-pod-information.md index 46e101baa5..189606aab6 100644 --- a/content/zh/docs/tasks/inject-data-application/environment-variable-expose-pod-information.md +++ b/content/zh/docs/tasks/inject-data-application/environment-variable-expose-pod-information.md @@ -1,70 +1,112 @@ --- -title: 通过环境变量将Pod信息呈现给容器 +title: 通过环境变量将 Pod 信息呈现给容器 content_type: task +weight: 30 --- - + -此页面显示了Pod如何使用环境变量把自己的信息呈现给pod中运行的容器。环境变量可以呈现pod的字段和容器字段。 - -有两种方式可以将Pod和Container字段呈现给运行中的容器： -环境变量 和[DownwardAPIVolumeFiles](/docs/resources-reference/{{< param "version" >}}/#downwardapivolumefile-v1-core). -这两种呈现Pod和Container字段的方式都称为*Downward API*。 - - - + +此页面展示 Pod 如何使用环境变量把自己的信息呈现给 Pod 中运行的容器。 +环境变量可以呈现 Pod 的字段和容器字段。 ## {{% heading "prerequisites" %}} - {{< include "task-tutorial-prereqs.md" >}} {{< version-check >}} - - - ## Downward API -有两种方式可以将Pod和Container字段呈现给运行中的容器： + + +有两种方式可以将 Pod 和 Container 字段呈现给运行中的容器： * 环境变量 -* [DownwardAPIVolumeFiles](/docs/resources-reference/{{< param "version" >}}/#downwardapivolumefile-v1-core) +* [卷文件](/docs/resources-reference/{{< param "version" >}}/#downwardapivolumefile-v1-core) -这两种呈现Pod和Container字段的方式都称为*Downward API*。 +这两种呈现 Pod 和 Container 字段的方式统称为 *Downward API*。 + +## 用 Pod 字段作为环境变量的值 -在这个练习中，你将创建一个包含一个容器的pod。这是该pod的配置文件： +在这个练习中，你将创建一个包含一个容器的 Pod。这是该 Pod 的配置文件： {{< codenew file="pods/inject/dapi-envars-pod.yaml" >}} -这个配置文件中，你可以看到五个环境变量。`env`字段是一个[EnvVars](/docs/resources-reference/{{< param "version" >}}/#envvar-v1-core)类型的数组。 -数组中第一个元素指定`MY_NODE_NAME`这个环境变量从Pod的`spec.nodeName`字段获取变量值。同样，其它环境变量也是从Pod的字段获取它们的变量值。 + +这个配置文件中，你可以看到五个环境变量。`env` 字段是一个 +[EnvVars](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#envvar-v1-core). +对象的数组。 +数组中第一个元素指定 `MY_NODE_NAME` 这个环境变量从 Pod 的 `spec.nodeName` 字段获取变量值。 +同样，其它环境变量也是从 Pod 的字段获取它们的变量值。 + {{< note >}} -本示例中的字段是Pod字段，不是Pod中容器的字段。 +本示例中的字段是 Pod 字段，不是 Pod 中 Container 的字段。 {{< /note >}} + 创建Pod： ```shell kubectl apply -f https://k8s.io/examples/pods/inject/dapi-envars-pod.yaml ``` -验证Pod中的容器运行正常： + +验证 Pod 中的容器运行正常： ``` kubectl get pods ``` + 查看容器日志： ``` kubectl logs dapi-envars-fieldref ``` + 输出信息显示了所选择的环境变量的值： ``` @@ -75,21 +117,36 @@ default default ``` -要了解为什么这些值在日志中，请查看配置文件中的`command` 和 `args`字段。 当容器启动时，它将五个环境变量的值写入stdout。每十秒重复执行一次。 + +要了解为什么这些值在日志中，请查看配置文件中的`command` 和 `args`字段。 +当容器启动时，它将五个环境变量的值写入 stdout。每十秒重复执行一次。 + +接下来，通过打开一个 Shell 进入 Pod 中运行的容器： ``` kubectl exec -it dapi-envars-fieldref -- sh ``` -在shell中，查看环境变量： + +在 Shell 中，查看环境变量： ``` /# printenv ``` -输出信息显示环境变量已经指定为Pod的字段的值。 + +输出信息显示环境变量已经设置为 Pod 字段的值。 ``` MY_POD_SERVICE_ACCOUNT=default @@ -102,14 +159,43 @@ MY_NODE_NAME=minikube MY_POD_NAME=dapi-envars-fieldref ``` -## 用容器字段作为环境变量的值 + +## 用 Container 字段作为环境变量的值 + +前面的练习中，你将 Pod 字段作为环境变量的值。 +接下来这个练习中，你将用 Container 字段作为环境变量的值。这里是包含一个容器的 Pod 的配置文件： {{< codenew file="pods/inject/dapi-envars-container.yaml" >}} -这个配置文件中，你可以看到四个环境变量。`env`字段是一个[EnvVars](/docs/resources-reference/{{< param "version" >}}/#envvar-v1-core) -类型的数组。数组中第一个元素指定`MY_CPU_REQUEST`这个环境变量从容器的`requests.cpu`字段获取变量值。同样，其它环境变量也是从容器的字段获取它们的变量值。 + +这个配置文件中，你可以看到四个环境变量。`env` 字段是一个 +[EnvVars](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#envvar-v1-core). +对象的数组。数组中第一个元素指定 `MY_CPU_REQUEST` 这个环境变量从 Container 的 `requests.cpu` +字段获取变量值。同样，其它环境变量也是从 Container 的字段获取它们的变量值。 + +{{< note >}} +本例中使用的是 Container 的字段而不是 Pod 的字段。 +{{< /note >}} 创建Pod： @@ -117,18 +203,27 @@ MY_POD_NAME=dapi-envars-fieldref kubectl apply -f https://k8s.io/examples/pods/inject/dapi-envars-container.yaml ``` -验证Pod中的容器运行正常： + +验证 Pod 中的容器运行正常： ``` kubectl get pods ``` + 查看容器日志： ``` kubectl logs dapi-envars-resourcefieldref ``` + 输出信息显示了所选择的环境变量的值： ``` @@ -138,20 +233,23 @@ kubectl logs dapi-envars-resourcefieldref 67108864 ``` - - ## {{% heading "whatsnext" %}} + -* [给容器定义环境变量](/docs/tasks/configure-pod-container/define-environment-variable-container/) -* [PodSpec](/docs/resources-reference/{{< param "version" >}}/#podspec-v1-core) -* [Container](/docs/resources-reference/{{< param "version" >}}/#container-v1-core) -* [EnvVar](/docs/resources-reference/{{< param "version" >}}/#envvar-v1-core) -* [EnvVarSource](/docs/resources-reference/{{< param "version" >}}/#envvarsource-v1-core) -* [ObjectFieldSelector](/docs/resources-reference/{{< param "version" >}}/#objectfieldselector-v1-core) -* [ResourceFieldSelector](/docs/resources-reference/{{< param "version" >}}/#resourcefieldselector-v1-core) - - - - +* [给容器定义环境变量](/zh/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) +* [EnvVarSource](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#envvarsource-v1-core) +* [ObjectFieldSelector](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#objectfieldselector-v1-core) +* [ResourceFieldSelector](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#resourcefieldselector-v1-core)