定义相互依赖的环境变量

本页展示了如何为 Kubernetes Pod 中的容器定义相互依赖的环境变量。

准备开始

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

为容器定义相互依赖的环境变量

当创建一个 Pod 时,你可以为运行在 Pod 中的容器设置相互依赖的环境变量。 若要设置相互依赖的环境变量,你可以在配置清单文件的 envvalue 中使用 $(VAR_NAME)。

在本练习中,你会创建一个单容器的 Pod。 此 Pod 的配置文件定义了一个已定义常用用法的相互依赖的环境变量。 下面是此 Pod 的配置清单:

  1. pods/inject/dependent-envars.yaml
  1. apiVersion: v1
  2. kind: Pod
  3. metadata:
  4. name: dependent-envars-demo
  5. spec:
  6. containers:
  7. - name: dependent-envars-demo
  8. args:
  9. - while true; do echo -en '\n'; printf UNCHANGED_REFERENCE=$UNCHANGED_REFERENCE'\n'; printf SERVICE_ADDRESS=$SERVICE_ADDRESS'\n';printf ESCAPED_REFERENCE=$ESCAPED_REFERENCE'\n'; sleep 30; done;
  10. command:
  11. - sh
  12. - -c
  13. image: busybox:1.28
  14. env:
  15. - name: SERVICE_PORT
  16. value: "80"
  17. - name: SERVICE_IP
  18. value: "172.17.0.1"
  19. - name: UNCHANGED_REFERENCE
  20. value: "$(PROTOCOL)://$(SERVICE_IP):$(SERVICE_PORT)"
  21. - name: PROTOCOL
  22. value: "https"
  23. - name: SERVICE_ADDRESS
  24. value: "$(PROTOCOL)://$(SERVICE_IP):$(SERVICE_PORT)"
  25. - name: ESCAPED_REFERENCE
  26. value: "$$(PROTOCOL)://$(SERVICE_IP):$(SERVICE_PORT)"
  1. 依据清单创建 Pod:

    1. kubectl apply -f https://k8s.io/examples/pods/inject/dependent-envars.yaml
    1. pod/dependent-envars-demo created
  2. 列出运行的 Pod:

    1. kubectl get pods dependent-envars-demo
    1. NAME READY STATUS RESTARTS AGE
    2. dependent-envars-demo 1/1 Running 0 9s
  3. 检查 Pod 中运行容器的日志:

    1. kubectl logs pod/dependent-envars-demo
    1. UNCHANGED_REFERENCE=$(PROTOCOL)://172.17.0.1:80
    2. SERVICE_ADDRESS=https://172.17.0.1:80
    3. ESCAPED_REFERENCE=$(PROTOCOL)://172.17.0.1:80

如上所示,你已经定义了 SERVICE_ADDRESS 的正确依赖引用, UNCHANGED_REFERENCE 的错误依赖引用, 并跳过了 ESCAPED_REFERENCE 的依赖引用。

如果环境变量被引用时已事先定义,则引用可以正确解析, 比如 SERVICE_ADDRESS 的例子。

请注意,env 列表中的顺序很重要。如果某环境变量定义出现在列表的尾部, 则在解析列表前部环境变量时不会视其为“已被定义”。 这就是为什么 UNCHANGED_REFERENCE 在上面的示例中解析 $(PROTOCOL) 失败的原因。

当环境变量未定义或仅包含部分变量时,未定义的变量会被当做普通字符串对待, 比如 UNCHANGED_REFERENCE 的例子。 注意,解析不正确的环境变量通常不会阻止容器启动。

$(VAR_NAME) 这样的语法可以用两个 $ 转义,即:$$(VAR_NAME)。 无论引用的变量是否定义,转义的引用永远不会展开。 这一点可以从上面 ESCAPED_REFERENCE 的例子得到印证。

接下来