定义依赖的环境变量

本页介绍如何在 Kubernetes Pod 中的容器定义依赖的环境变量。

准备工作

你需要拥有一个 Kubernetes 集群,并且 kubectl 命令行工具已配置为与你的集群通信。建议你在至少有两个不作为控制平面主机的节点的集群上运行本教程。如果你还没有集群,你可以使用 minikube 创建一个,或者你可以使用这些 Kubernetes 演练场中的一个。

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

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

在本练习中,你将创建一个运行一个容器的 Pod。Pod 的配置文件定义了一个具有常用定义的依赖环境变量。下面是 Pod 的配置清单。

apiVersion: v1
kind: Pod
metadata:
  name: dependent-envars-demo
spec:
  containers:
    - name: dependent-envars-demo
      args:
        - 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;
      command:
        - sh
        - -c
      image: busybox:1.28
      env:
        - name: SERVICE_PORT
          value: "80"
        - name: SERVICE_IP
          value: "172.17.0.1"
        - name: UNCHANGED_REFERENCE
          value: "$(PROTOCOL)://$(SERVICE_IP):$(SERVICE_PORT)"
        - name: PROTOCOL
          value: "https"
        - name: SERVICE_ADDRESS
          value: "$(PROTOCOL)://$(SERVICE_IP):$(SERVICE_PORT)"
        - name: ESCAPED_REFERENCE
          value: "$$(PROTOCOL)://$(SERVICE_IP):$(SERVICE_PORT)"
  1. 根据该清单创建一个 Pod。

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

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

    kubectl logs pod/dependent-envars-demo
    
    
    UNCHANGED_REFERENCE=$(PROTOCOL)://172.17.0.1:80
    SERVICE_ADDRESS=https://172.17.0.1:80
    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 例子中看出。

下一步

最后修改于 2023 年 8 月 24 日下午 6:38 PST:使用 code_sample 简码代替 code 简码 (e8b136c3b3)