定義相依環境變數
此頁面說明如何為 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。