定义依赖的环境变量

本页面介绍如何在 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 (太平洋标准时间): 使用 code_sample shortcode 代替 code shortcode (e8b136c3b3)