Files
website/content/zh/docs/tasks/inject-data-application/environment-variable-expose-pod-information.md
Qiming 9bf026e951 Clean zh/docs directory for dangling YAML files (#17341)
There are many YAML manifests sneaking into the `zh/docs/` directory.
These files should go to the `zh/examples` directory instead. Having
these "garbage" files (not referenced anywhere) is creating confusion
for the release meister when merging branches. For example, some YAML
files found in the 'master' branch are no longer there in the
release-1.16 branch. It is tedious, if possible at all, to solve all
this kind of conflicts during a rebase.

The PR cleanses the zh/docs directory for all dangling YAML files.
2019-11-04 08:24:48 +08:00

4.2 KiB
Raw Permalink Blame History

title, content_template
title content_template
通过环境变量将Pod信息呈现给容器 templates/task

{{% capture overview %}}

此页面显示了Pod如何使用环境变量把自己的信息呈现给pod中运行的容器。环境变量可以呈现pod的字段和容器字段。

有两种方式可以将Pod和Container字段呈现给运行中的容器: 环境变量 和[DownwardAPIVolumeFiles](/docs/resources-reference/{{< param "version" >}}/#downwardapivolumefile-v1-core). 这两种呈现Pod和Container字段的方式都称为Downward API

{{% /capture %}}

{{% capture prerequisites %}}

{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}

{{% /capture %}}

{{% capture steps %}}

Downward API

有两种方式可以将Pod和Container字段呈现给运行中的容器:

  • 环境变量
  • [DownwardAPIVolumeFiles](/docs/resources-reference/{{< param "version" >}}/#downwardapivolumefile-v1-core)

这两种呈现Pod和Container字段的方式都称为Downward API

用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的字段获取它们的变量值。

{{< note >}} 注意: 本示例中的字段是Pod字段,不是Pod中容器的字段。 {{< /note >}}

创建Pod

kubectl apply -f https://k8s.io/examples/pods/inject/dapi-envars-pod.yaml

验证Pod中的容器运行正常:

kubectl get pods

查看容器日志:

kubectl logs dapi-envars-fieldref

输出信息显示了所选择的环境变量的值:

minikube
dapi-envars-fieldref
default
172.17.0.4
default

要了解为什么这些值在日志中,请查看配置文件中的commandargs字段。 当容器启动时,它将五个环境变量的值写入stdout。每十秒重复执行一次。

接下来,进入Pod中运行的容器,打开一个shell:

kubectl exec -it dapi-envars-fieldref -- sh

在shell中,查看环境变量:

/# printenv

输出信息显示环境变量已经指定为Pod的字段的值。

MY_POD_SERVICE_ACCOUNT=default
...
MY_POD_NAMESPACE=default
MY_POD_IP=172.17.0.4
...
MY_NODE_NAME=minikube
...
MY_POD_NAME=dapi-envars-fieldref

用容器字段作为环境变量的值

前面的练习中,你将Pod字段作为环境变量的值。接下来这个练习,你将用容器字段作为环境变量的值。这里是包含一个容器的pod的配置文件:

{{< codenew file="pods/inject/dapi-envars-container.yaml" >}}

这个配置文件中,你可以看到四个环境变量。env字段是一个[EnvVars](/docs/resources-reference/{{< param "version" >}}/#envvar-v1-core) 类型的数组。数组中第一个元素指定MY_CPU_REQUEST这个环境变量从容器的requests.cpu字段获取变量值。同样,其它环境变量也是从容器的字段获取它们的变量值。

创建Pod

kubectl apply -f https://k8s.io/examples/pods/inject/dapi-envars-container.yaml

验证Pod中的容器运行正常:

kubectl get pods

查看容器日志:

kubectl logs dapi-envars-resourcefieldref

输出信息显示了所选择的环境变量的值:

1
1
33554432
67108864

{{% /capture %}}

{{% capture whatsnext %}}

  • 给容器定义环境变量
  • [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)

{{% /capture %}}