Merge pull request #23189 from tengqm/zh-inject-envvar
[zh] Rework environment-variable-expose-pod-information
This commit is contained in:
Kubernetes Prow Robot
+143
-45
@@ -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的字段和容器字段。
|
||||
|
||||
有两种方式可以将Pod和Container字段呈现给运行中的容器：
|
||||
环境变量 和[DownwardAPIVolumeFiles](/docs/resources-reference/{{< param "version" >}}/#downwardapivolumefile-v1-core).
|
||||
这两种呈现Pod和Container字段的方式都称为*Downward API*。
|
||||
|
||||
|
||||
|
||||
<!--
|
||||
This page shows how a Pod can use environment variables to expose information
|
||||
about itself to Containers running in the Pod. Environment variables can expose
|
||||
Pod fields and Container fields.
|
||||
-->
|
||||
此页面展示 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/)
|
||||
* [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)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user