透過環境變數將 Pod 資訊暴露給容器

本頁面說明 Pod 如何使用環境變數，透過向下 API 將其自身的資訊暴露給在 Pod 中執行的容器。您可以使用環境變數來暴露 Pod 欄位、容器欄位或兩者。

在 Kubernetes 中，有兩種方式將 Pod 和容器欄位暴露給執行中的容器

環境變數，如本任務中所述
磁碟區檔案

這兩種暴露 Pod 和容器欄位的方式統稱為向下 API。

由於服務是 Kubernetes 管理的容器化應用程式之間的主要通訊模式，因此能夠在執行階段探索它們很有幫助。

在此處閱讀更多關於存取服務的資訊：這裡。

準備開始

您需要有一個 Kubernetes 叢集，並且必須設定 kubectl 命令列工具以與您的叢集通訊。建議在至少有兩個非作為控制平面主機的節點的叢集上執行本教學課程。如果您還沒有叢集，可以使用 minikube 建立一個，或者您可以使用以下 Kubernetes playground 之一

使用 Pod 欄位作為環境變數的值

在本練習的這一部分，您將建立一個具有一個容器的 Pod，並將 Pod 層級欄位以環境變數的形式投射到執行中的容器中。

pods/inject/dapi-envars-pod.yaml

apiVersion: v1
kind: Pod
metadata:
  name: dapi-envars-fieldref
spec:
  containers:
    - name: test-container
      image: registry.k8s.io/busybox
      command: [ "sh", "-c"]
      args:
      - while true; do
          echo -en '\n';
          printenv MY_NODE_NAME MY_POD_NAME MY_POD_NAMESPACE;
          printenv MY_POD_IP MY_POD_SERVICE_ACCOUNT;
          sleep 10;
        done;
      env:
        - name: MY_NODE_NAME
          valueFrom:
            fieldRef:
              fieldPath: spec.nodeName
        - name: MY_POD_NAME
          valueFrom:
            fieldRef:
              fieldPath: metadata.name
        - name: MY_POD_NAMESPACE
          valueFrom:
            fieldRef:
              fieldPath: metadata.namespace
        - name: MY_POD_IP
          valueFrom:
            fieldRef:
              fieldPath: status.podIP
        - name: MY_POD_SERVICE_ACCOUNT
          valueFrom:
            fieldRef:
              fieldPath: spec.serviceAccountName
  restartPolicy: Never

在該資訊清單中，您可以看到五個環境變數。env 欄位是環境變數定義的陣列。陣列中的第一個元素指定 MY_NODE_NAME 環境變數的值來自 Pod 的 spec.nodeName 欄位。同樣地，其他環境變數的名稱來自 Pod 欄位。

注意

本範例中的欄位是 Pod 欄位。它們不是 Pod 中容器的欄位。

建立 Pod

kubectl apply -f https://k8s.io/examples/pods/inject/dapi-envars-pod.yaml

驗證 Pod 中的容器是否正在執行

# If the new Pod isn't yet healthy, rerun this command a few times.
kubectl get pods

檢視容器的日誌

kubectl logs dapi-envars-fieldref

輸出顯示選取的環境變數的值

minikube
dapi-envars-fieldref
default
172.17.0.4
default

若要查看為何這些值在日誌中，請查看組態檔中的 command 和 args 欄位。當容器啟動時，它會將五個環境變數的值寫入 stdout。它每十秒重複執行此操作。

接下來，取得進入在您的 Pod 中執行的容器的 shell

kubectl exec -it dapi-envars-fieldref -- sh

在您的 shell 中，檢視環境變數

# Run this in a shell inside the container
printenv

輸出顯示某些環境變數已被指派 Pod 欄位的值

MY_POD_SERVICE_ACCOUNT=default
...
MY_POD_NAMESPACE=default
MY_POD_IP=172.17.0.4
...
MY_NODE_NAME=minikube
...
MY_POD_NAME=dapi-envars-fieldref

使用容器欄位作為環境變數的值

在先前的練習中，您使用 Pod 層級欄位的資訊作為環境變數的值。在接下來的練習中，您將傳遞屬於 Pod 定義一部分的欄位，但這些欄位取自特定的容器，而不是來自整個 Pod。

以下是另一個 Pod 的資訊清單，它再次只有一個容器

pods/inject/dapi-envars-container.yaml

apiVersion: v1
kind: Pod
metadata:
  name: dapi-envars-resourcefieldref
spec:
  containers:
    - name: test-container
      image: registry.k8s.io/busybox:1.24
      command: [ "sh", "-c"]
      args:
      - while true; do
          echo -en '\n';
          printenv MY_CPU_REQUEST MY_CPU_LIMIT;
          printenv MY_MEM_REQUEST MY_MEM_LIMIT;
          sleep 10;
        done;
      resources:
        requests:
          memory: "32Mi"
          cpu: "125m"
        limits:
          memory: "64Mi"
          cpu: "250m"
      env:
        - name: MY_CPU_REQUEST
          valueFrom:
            resourceFieldRef:
              containerName: test-container
              resource: requests.cpu
        - name: MY_CPU_LIMIT
          valueFrom:
            resourceFieldRef:
              containerName: test-container
              resource: limits.cpu
        - name: MY_MEM_REQUEST
          valueFrom:
            resourceFieldRef:
              containerName: test-container
              resource: requests.memory
        - name: MY_MEM_LIMIT
          valueFrom:
            resourceFieldRef:
              containerName: test-container
              resource: limits.memory
  restartPolicy: Never

在此資訊清單中，您可以看到四個環境變數。env 欄位是環境變數定義的陣列。陣列中的第一個元素指定 MY_CPU_REQUEST 環境變數的值來自名為 test-container 的容器的 requests.cpu 欄位。同樣地，其他環境變數的值來自特定於此容器的欄位。