本文說明如何檢查 Google Distributed Cloud (GDC) 實體隔離 Kubernetes 叢集中執行的現有無狀態工作負載。無狀態工作負載可讓您執行應用程式部署作業,而不必儲存資料或應用程式狀態。您可以使用 GDC 控制台或 kubectl CLI 查看無狀態工作負載,監控資源用量和工作負載健康狀態。
本文適用於應用程式營運商群組中的開發人員,他們負責管理組織的應用程式工作負載。詳情請參閱「GDC 實體隔離方案說明文件的目標對象」。
事前準備
如要完成本文件中的工作,您必須要求必要權限並準備環境。
要求 IAM 角色
您必須具備特定角色,才能取得查看及檢查無狀態工作負載所需的權限。所需角色取決於您是在組織範圍的共用叢集,還是專案範圍的標準叢集內作業。詳情請參閱「Kubernetes 叢集設定」。
共用叢集角色
請要求 IAM 專案管理員根據要執行的工作,在專案命名空間中授予您下列角色:
- 工作負載檢視者 (
workload-viewer):查看部署至共用叢集的所有工作負載。 - 命名空間管理員 (
namespace-admin):在共用叢集專案命名空間中建立、刪除、編輯或查看工作負載。
這些角色會繫結至專案命名空間。
標準叢集角色
如要在標準叢集中建立、刪除、編輯或查看工作負載,請要求 IAM 專案管理員授予您叢集開發人員 (cluster-developer) 角色。這個角色會繫結至專案命名空間。
準備環境
如要使用 API 對 Kubernetes 叢集執行指令,請確認您具備下列資源:
找出 Kubernetes 叢集名稱,或向平台管理員群組成員詢問叢集名稱。
登入並產生 Kubernetes 叢集的 kubeconfig 檔案。
請使用 Kubernetes 叢集的 kubeconfig 路徑,取代這些操作說明中的
KUBERNETES_CLUSTER_KUBECONFIG。
查看專案的容器工作負載
如要查看專案的容器工作負載,請完成下列步驟:
控制台
在導覽選單中,依序選取「Kubernetes Engine」>「工作負載」。
您可以查看容器工作負載的詳細資料,例如:
- 名稱
- 類型
- Pod 數量
- Kubernetes 叢集
- 上次修改日期
容器工作負載會依所屬的 Kubernetes 叢集分類。選取「Cluster」(叢集) 下拉式選單,切換叢集背景資訊。
kubectl
執行下列指令,列出專案中的所有 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
檢查部署作業
如要要求 Deployment 資源元件的詳細資訊,請執行直接指定要檢查實體的指令。
取得 Deployment 物件資訊
如要取得 Deployment 物件的詳細資訊,請執行:
kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
describe deployment DEPLOYMENT_NAME
更改下列內容:
KUBERNETES_CLUSTER_KUBECONFIG:執行 Deployment 的叢集 kubeconfig 檔案。NAMESPACE:命名空間。如果是共用叢集,則必須是專案命名空間。如果是標準叢集,則可以是任何命名空間。DEPLOYMENT_NAME:Deployment物件的名稱。
以 YAML 格式顯示即時設定
如要查看 Deployment 物件的資訊清單,請執行下列指令:
kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
get deployments DEPLOYMENT_NAME -o yaml
這個指令會以 YAML 格式顯示 Deployment 物件的即時設定。
列出 Pod
如要列出 Deployment 建立的 Pod 物件,請執行下列指令:
kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
get pods -l KEY=VALUE
在這個指令中,-l 旗標會列出指定叢集中,具有指定鍵/值組合標籤的所有 Pod 物件。
更改下列內容:
KUBERNETES_CLUSTER_KUBECONFIG:執行 Deployment 的叢集 kubeconfig 檔案。NAMESPACE:命名空間。如果是共用叢集,則必須是專案命名空間。如果是標準叢集,則可以是任何命名空間。KEY:在部署作業中設定的鍵/值組合標籤鍵。舉例來說,如果.template.metadata.labels欄位已設定app: myapp標籤,則鍵為app。VALUE:部署作業中設定的鍵/值組合標籤值。舉例來說,如果.template.metadata.labels欄位已設定app: myapp標籤,則值為my-app。
舉例來說,如果您將 Deployment 物件標示為 app: my-app,請執行下列指令,查看具有該標籤的 Pod 物件:
kubectl --kubeconfig /tmp/kubeconfig.yaml -n my-namespace \
get pods -l app=my-app
取得特定 Pod 資訊
如要取得特定 Pod 物件的資訊,請執行:
kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
describe pod POD_NAME
更改下列內容:
KUBERNETES_CLUSTER_KUBECONFIG:執行 Deployment 的叢集 kubeconfig 檔案。NAMESPACE:命名空間。如果是共用叢集,則必須是專案命名空間。如果是標準叢集,則可以是任何命名空間。POD_NAME:Deployment 管理的 Pod 名稱。