定义依赖环境变量

此页面展示了如何在 Kubernetes Pod 中为容器定义依赖环境变量。

开始之前

您需要拥有一个 Kubernetes 集群,并且 kubectl 命令行工具必须配置为与您的集群通信。建议在至少有两个节点(不充当控制平面主机)的集群上运行本教程。如果您还没有集群,可以使用 minikube 创建一个集群,或者可以使用以下 Kubernetes 游乐场之一

为容器定义依赖环境变量

创建 Pod 时,可以为在 Pod 中运行的容器设置依赖环境变量。要设置依赖环境变量,可以在配置文件的 env 中的 value 中使用 $(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 shortcode 代替 code shortcode (e8b136c3b3)