檢查有狀態工作負載

本頁說明如何檢查在 Google Distributed Cloud (GDC) 氣隙 Kubernetes 叢集中執行的現有有狀態工作負載。有狀態的工作負載可讓您執行應用程式,並使用常駐容器儲存空間。您可以使用 GDC 控制台或 kubectl CLI 查看有狀態工作負載,監控資源用量和工作負載健康狀態。

本頁內容適用於應用程式運算子群組的開發人員,他們負責管理所屬機構的應用程式工作負載。詳情請參閱 GDC air-gapped 說明文件適用對象

事前準備

如要對 Kubernetes 叢集執行指令,請確認您具備下列資源:

  1. 找出 Kubernetes 叢集名稱,或詢問平台管理員叢集名稱。

  2. 如果沒有 Kubernetes 叢集的 kubeconfig 檔案,請登入並產生該檔案。

  3. 請使用 Kubernetes 叢集的 kubeconfig 路徑,替換這些操作說明中的 KUBERNETES_CLUSTER_KUBECONFIG

如要取得必要權限,查看專案中部署的所有工作負載,請要求機構 IAM 管理員在專案命名空間中,授予您工作負載檢視者角色 (workload-viewer)。

如要取得檢查有狀態工作負載所需的權限,請要求機構 IAM 管理員在專案命名空間中授予您命名空間管理員角色 (namespace-admin)。

查看專案的容器工作負載

如要查看專案的容器工作負載,請完成下列步驟:

主控台

  • 在導覽選單中,依序選取「Kubernetes Engine」>「工作負載」

    您可以查看容器工作負載的詳細資料,例如:

    • 名稱
    • 類型
    • Pod 數量
    • Kubernetes 叢集
    • 上次修改日期

    容器工作負載會依所屬的 Kubernetes 叢集分類。選取「叢集」下拉式選單,切換叢集環境。

CLI

  • 執行下列指令,列出專案中的所有 Pod:

    kubectl get pods -n PROJECT_NAMESPACE
    

    輸出結果會與下列內容相似:

    NAME                        READY   STATUS    RESTARTS   AGE
    nginx-workload-ah-aa-1228   1/1     Running   0          12h
    nginx-workload-ah-ab-6784   1/1     Running   0          11h
    nginx-workload-ah-ac-0045   1/1     Running   0          12h
    

檢查 StatefulSet 資源

如要要求取得 StatefulSet 資源元件的詳細資訊,請執行直接以要檢查的實體為目標的指令。

取得 StatefulSet 物件資訊

如要取得 StatefulSet 物件的詳細資訊,請執行下列指令:

kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    describe statefulset STATEFULSET_NAME

更改下列內容:

  • KUBERNETES_CLUSTER_KUBECONFIG:執行 StatefulSet 物件的叢集 kubeconfig 檔案。

  • NAMESPACE:專案命名空間。

  • STATEFULSET_NAMEStatefulSet 物件的名稱。

以 YAML 格式顯示即時設定

如要以 YAML 格式顯示 StatefulSet 資源的即時設定,請執行下列指令:

kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    get statefulset STATEFULSET_NAME -o yaml

更改下列內容:

  • KUBERNETES_CLUSTER_KUBECONFIG:執行 StatefulSet 物件的叢集 kubeconfig 檔案。

  • NAMESPACE:專案命名空間。

  • STATEFULSET_NAMEStatefulSet 物件的名稱。

列出 Pod

如要列出 StatefulSet 建立的 Pod 物件,請執行:

kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    get pods -l app=APP_NAME

在這個指令中,-l 標記會列出標示為 APP_NAME 的所有 Pod 物件。

更改下列內容:

  • KUBERNETES_CLUSTER_KUBECONFIG:執行 StatefulSet 物件的叢集 kubeconfig 檔案。

  • NAMESPACE:專案命名空間。

  • APP_NAME:由 StatefulSet 物件管理的具狀態應用程式名稱。

取得特定 Pod 資訊

如要取得叢集中特定 Pod 的相關資訊,請執行:

kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    describe pod POD_NAME

更改下列內容:

  • KUBERNETES_CLUSTER_KUBECONFIG:執行 Pod 的叢集 kubeconfig 檔案。

  • NAMESPACE:專案命名空間。

  • POD_NAMEStatefulSet 物件管理的 Pod 名稱。

列出 PVC

如要列出叢集中的 PersistentVolumeClaim (PVC) 物件,請執行:

kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    get pvc

更改下列內容:

  • KUBERNETES_CLUSTER_KUBECONFIG:執行 PVC 的叢集 kubeconfig 檔案。

  • NAMESPACE:專案命名空間。

取得特定 PVC 資訊

如要取得叢集中特定 PersistentVolumeClaim (PVC) 的資訊,請執行:

kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    describe pvc PVC_NAME

更改下列內容:

  • KUBERNETES_CLUSTER_KUBECONFIG:執行 PVC 的叢集 kubeconfig 檔案。

  • NAMESPACE:專案命名空間。

  • PVC_NAME:為 StatefulSet 物件設定的 PVC 名稱。

取得 PV 資訊

如要取得叢集中特定 PersistentVolume (PV) 的資訊,請執行:

kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    describe pv PV_NAME

更改下列內容:

  • KUBERNETES_CLUSTER_KUBECONFIG:執行 PV 的叢集 kubeconfig 檔案。

  • NAMESPACE:專案命名空間。

  • PV_NAME:為 StatefulSet 物件設定的 PV 名稱。