定義相依環境變數

此頁面說明如何為 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:Use code_sample shortcode instead of code shortcode (e8b136c3b3)