定义依赖环境变量
此页面展示了如何在 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)"
根据该清单创建 Pod
kubectl apply -f https://k8s.io/examples/pods/inject/dependent-envars.yaml
pod/dependent-envars-demo created
列出正在运行的 Pod
kubectl get pods dependent-envars-demo
NAME READY STATUS RESTARTS AGE dependent-envars-demo 1/1 Running 0 9s
检查 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
案例中看出。
下一步
- 详细了解 环境变量。
- 查看 EnvVarSource。