为容器设置环境变量

本页将展示如何为 Kubernetes Pod 下的容器设置环境变量。

准备开始

你必须拥有一个 Kubernetes 的集群,同时你必须配置 kubectl 命令行工具与你的集群通信。 建议在至少有两个不作为控制平面主机的节点的集群上运行本教程。 如果你还没有集群,你可以通过 Minikube 构建一个你自己的集群,或者你可以使用下面的 Kubernetes 练习环境之一:

为容器设置一个环境变量

创建 Pod 时,可以为其下的容器设置环境变量。通过配置文件的 env 或者 envFrom 字段来设置环境变量。

envenvFrom 字段具有不同的效果。

env :可以为容器设置环境变量,直接为你所给的每个变量指定一个值。

envFrom :你可以通过引用 ConfigMap 或 Secret 来设置容器的环境变量。 使用 envFrom 时,引用的 ConfigMap 或 Secret 中的所有键值对都被设置为容器的环境变量。 你也可以指定一个通用的前缀字符串。

你可以阅读有关 ConfigMapSecret 的更多信息。

本页介绍如何使用 env

本示例中,将创建一个只包含单个容器的 Pod。此 Pod 的配置文件中设置环境变量的名称为 DEMO_GREETING, 其值为 "Hello from the environment"。下面是此 Pod 的配置清单:

pods/inject/envars.yaml为容器设置环境变量 - 图1

  1. apiVersion: v1
  2. kind: Pod
  3. metadata:
  4. name: envar-demo
  5. labels:
  6. purpose: demonstrate-envars
  7. spec:
  8. containers:
  9. - name: envar-demo-container
  10. image: gcr.io/google-samples/node-hello:1.0
  11. env:
  12. - name: DEMO_GREETING
  13. value: "Hello from the environment"
  14. - name: DEMO_FAREWELL
  15. value: "Such a sweet sorrow"
  1. 基于配置清单创建一个 Pod:

    1. kubectl apply -f https://k8s.io/examples/pods/inject/envars.yaml
  2. 获取正在运行的 Pod 信息:

    1. kubectl get pods -l purpose=demonstrate-envars
    1. 查询结果应为:
    1. NAME READY STATUS RESTARTS AGE
    2. envar-demo 1/1 Running 0 9s
  3. 列出 Pod 容器的环境变量:

    1. kubectl exec envar-demo -- printenv
    1. 打印结果应为:
    1. NODE_VERSION=4.4.2
    2. EXAMPLE_SERVICE_PORT_8080_TCP_ADDR=10.3.245.237
    3. HOSTNAME=envar-demo
    4. ...
    5. DEMO_GREETING=Hello from the environment
    6. DEMO_FAREWELL=Such a sweet sorrow

说明:

通过 envenvFrom 字段设置的环境变量将覆盖容器镜像中指定的所有环境变量。

说明:

环境变量可以互相引用,但是顺序很重要。 使用在相同上下文中定义的其他变量的变量必须在列表的后面。 同样,请避免使用循环引用。

在配置中使用环境变量

你在 Pod 的配置中定义的、位于 .spec.containers[*].env[*] 下的环境变量 可以在配置的其他地方使用,例如可用在为 Pod 的容器设置的命令和参数中。 在下面的示例配置中,环境变量 GREETINGHONORIFICNAME 分别设置为 Warm greetings toThe Most HonorableKubernetes。 环境变量 MESSAGE 将所有这些环境变量的集合组合起来, 然后再传递给容器 env-print-demo 的 CLI 参数中使用。

环境变量名由字母、数字、下划线、点或连字符组成,但第一个字符不能是数字。 如果启用了 RelaxedEnvironmentVariableValidation 特性门控, 则所有可打印的 ASCII 字符(”=” 除外)都可以用于环境变量名。

  1. apiVersion: v1
  2. kind: Pod
  3. metadata:
  4. name: print-greeting
  5. spec:
  6. containers:
  7. - name: env-print-demo
  8. image: bash
  9. env:
  10. - name: GREETING
  11. value: "Warm greetings to"
  12. - name: HONORIFIC
  13. value: "The Most Honorable"
  14. - name: NAME
  15. value: "Kubernetes"
  16. command: ["echo"]
  17. args: ["$(GREETING) $(HONORIFIC) $(NAME)"]

创建后,命令 echo Warm greetings to The Most Honorable Kubernetes 将在容器中运行。

接下来