Merge pull request #23189 from tengqm/zh-inject-envvar

[zh] Rework environment-variable-expose-pod-information

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
 ---
-
+<!--
+title: Expose Pod Information to Containers Through Environment Variables
+content_type: task
+weight: 30
+-->
 <!-- overview -->
 
-此页面显示了Pod如何使用环境变量把自己的信息呈现给pod中运行的容器。环境变量可以呈现pod的字段和容器字段。
+<!--
-
+This page shows how a Pod can use environment variables to expose information
-有两种方式可以将Pod和Container字段呈现给运行中的容器：
+about itself to Containers running in the Pod. Environment variables can expose
-环境变量 和[DownwardAPIVolumeFiles](/docs/resources-reference/{{< param "version" >}}/#downwardapivolumefile-v1-core).
+Pod fields and Container fields.
-这两种呈现Pod和Container字段的方式都称为*Downward API*。
+-->
-
+此页面展示 Pod 如何使用环境变量把自己的信息呈现给 Pod 中运行的容器。
-
+环境变量可以呈现 Pod 的字段和容器字段。
-
 
 ## {{% heading "prerequisites" %}}
 
-
 {{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}
 
-
-
-
 <!-- steps -->
 
 ## Downward API
 
-有两种方式可以将Pod和Container字段呈现给运行中的容器：
+<!--
+There are two ways to expose Pod and Container fields to a running Container:
+
+* Environment variables
+* [Volume Files](/docs/tasks/inject-data-application/downward-api-volume-expose-pod-information/#the-downward-api)
+
+Together, these two ways of exposing Pod and Container fields are called the
+*Downward API*.
+-->
+
+有两种方式可以将 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*。
 
+<!--
+## Use Pod fields as values for environment variables
 
-## 用Pod字段作为环境变量的值
+In this exercise, you create a Pod that has one Container. Here is the
+configuration file for the Pod:
+-->
+## 用 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的字段获取它们的变量值。
+In the configuration file, you can see five environment variables. The `env`
+field is an array of
+[EnvVars](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#envvar-v1-core).
+The first element in the array specifies that the `MY_NODE_NAME` environment
+variable gets its value from the Pod's `spec.nodeName` field. Similarly, the
+other environment variables get their names from Pod fields.
+-->
+这个配置文件中，你可以看到五个环境变量。`env` 字段是一个
+[EnvVars](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#envvar-v1-core).
+对象的数组。
+数组中第一个元素指定 `MY_NODE_NAME` 这个环境变量从 Pod 的 `spec.nodeName` 字段获取变量值。
+同样，其它环境变量也是从 Pod 的字段获取它们的变量值。
 
+<!--
+The fields in this example are Pod fields. They are not fields of the
+Container in the Pod.
+-->
 {{< note >}}
-本示例中的字段是Pod字段，不是Pod中容器的字段。
+本示例中的字段是 Pod 字段，不是 Pod 中 Container 的字段。
 {{< /note >}}
 
+<!--
+Create the Pod:
+-->
 创建Pod：
 
 ```shell
 kubectl apply -f https://k8s.io/examples/pods/inject/dapi-envars-pod.yaml
 ```
 
-验证Pod中的容器运行正常：
+<!--
+Verify that the Container in the Pod is running:
+-->
+验证 Pod 中的容器运行正常：
 
 ```
 kubectl get pods
 ```
 
+<!--
+View the Container's logs:
+-->
 查看容器日志：
 
 ```
 kubectl logs dapi-envars-fieldref
 ```
 
+<!--
+The output shows the values of selected environment variables:
+-->
 输出信息显示了所选择的环境变量的值：
 
 ```
@@ -75,21 +117,36 @@ default
 default
 ```
 
-要了解为什么这些值在日志中，请查看配置文件中的`command` 和 `args`字段。 当容器启动时，它将五个环境变量的值写入stdout。每十秒重复执行一次。
+<!--
+To see why these values are in the log, look at the `command` and `args` fields
+in the configuration file. When the Container starts, it writes the values of
+five environment variables to stdout. It repeats this every ten seconds.
 
-接下来，进入Pod中运行的容器，打开一个shell：
+Next, get a shell into the Container that is running in your Pod:
+-->
+要了解为什么这些值在日志中，请查看配置文件中的`command` 和 `args`字段。
+当容器启动时，它将五个环境变量的值写入 stdout。每十秒重复执行一次。
+
+接下来，通过打开一个 Shell 进入 Pod 中运行的容器：
 
 ```
 kubectl exec -it dapi-envars-fieldref -- sh
 ```
 
-在shell中，查看环境变量：
+<!--
+In your shell, view the environment variables:
+-->
+在 Shell 中，查看环境变量：
 
 ```
 /# printenv
 ```
 
-输出信息显示环境变量已经指定为Pod的字段的值。
+<!--
+The output shows that certain environment variables have been assigned the
+values of Pod fields:
+-->
+输出信息显示环境变量已经设置为 Pod 字段的值。
 
 ```
 MY_POD_SERVICE_ACCOUNT=default
@@ -102,14 +159,43 @@ MY_NODE_NAME=minikube
 MY_POD_NAME=dapi-envars-fieldref
 ```
 
-## 用容器字段作为环境变量的值
+<!--
+## Use Container fields as values for environment variables
 
-前面的练习中，你将Pod字段作为环境变量的值。接下来这个练习，你将用容器字段作为环境变量的值。这里是包含一个容器的pod的配置文件：
+In the preceding exercise, you used Pod fields as the values for environment
+variables. In this next exercise, you use Container fields as the values for
+environment variables. Here is the configuration file for a Pod that has one
+container:
+-->
+## 用 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`字段获取变量值。同样，其它环境变量也是从容器的字段获取它们的变量值。
+In the configuration file, you can see four environment variables. The `env`
+field is an array of
+[EnvVars](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#envvar-v1-core).
+The first element in the array specifies that the `MY_CPU_REQUEST` environment
+variable gets its value from the `requests.cpu` field of a Container named
+`test-container`. Similarly, the other environment variables get their values
+from Container fields.
+
+The fields in this example are Pod fields. They are not fields of the
+Container in the Pod.
+
+Create the Pod:
+-->
+这个配置文件中，你可以看到四个环境变量。`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中的容器运行正常：
+<!--
+Verify that the Container in the Pod is running:
+-->
+验证 Pod 中的容器运行正常：
 
 ```
 kubectl get pods
 ```
 
+<!--
+View the Container's logs:
+-->
 查看容器日志：
 
 ```
 kubectl logs dapi-envars-resourcefieldref
 ```
 
+<!--
+The output shows the values of selected environment variables:
+-->
 输出信息显示了所选择的环境变量的值：
 
 ```
@@ -138,20 +233,23 @@ kubectl logs dapi-envars-resourcefieldref
 67108864
 ```
 
-
-
 ## {{% heading "whatsnext" %}}
 
+<!--
+* [Defining Environment Variables for a Container](/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)
+-->
 
-* [给容器定义环境变量](/docs/tasks/configure-pod-container/define-environment-variable-container/)
+* [给容器定义环境变量](/zh/docs/tasks/inject-data-application/define-environment-variable-container/)
-* [PodSpec](/docs/resources-reference/{{< param "version" >}}/#podspec-v1-core)
+* [PodSpec](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#podspec-v1-core)
-* [Container](/docs/resources-reference/{{< param "version" >}}/#container-v1-core)
+* [Container](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#container-v1-core)
-* [EnvVar](/docs/resources-reference/{{< param "version" >}}/#envvar-v1-core)
+* [EnvVar](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#envvar-v1-core)
-* [EnvVarSource](/docs/resources-reference/{{< param "version" >}}/#envvarsource-v1-core)
+* [EnvVarSource](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#envvarsource-v1-core)
-* [ObjectFieldSelector](/docs/resources-reference/{{< param "version" >}}/#objectfieldselector-v1-core)
+* [ObjectFieldSelector](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#objectfieldselector-v1-core)
-* [ResourceFieldSelector](/docs/resources-reference/{{< param "version" >}}/#resourcefieldselector-v1-core)
+* [ResourceFieldSelector](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#resourcefieldselector-v1-core)
-
-
-
-