定義依賴的環境變數

本頁介紹如何在 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 PST:使用 code_sample 簡碼代替 code 簡碼 (e8b136c3b3)