定义依赖的环境变量
本页面介绍如何在 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。