本文說明如何在 Google Distributed Cloud (GDC) 實體隔離的 Kubernetes 叢集中,建立及管理無狀態工作負載。無狀態工作負載可讓您根據工作負載需求調度應用程式部署作業,完全不必在 Kubernetes 叢集中管理永久儲存空間,即可儲存資料或應用程式狀態。這份文件可協助您開始使用,有效率地調整及最佳化應用程式的可用性。
本文適用於應用程式運算子群組中的開發人員,負責為所屬機構建立應用程式工作負載。詳情請參閱 GDC air-gapped 說明文件適用對象。
事前準備
如要完成本文中的工作,您必須要求必要的權限。
要求 IAM 角色
您必須具備特定角色,才能取得建立無狀態工作負載所需的權限。您需要的角色取決於您是在機構範圍的共用叢集,還是專案範圍的標準叢集中工作。詳情請參閱「Kubernetes 叢集設定」。
共用叢集角色
如要在共用叢集中建立、刪除、編輯或查看無狀態工作負載,請要求專案 IAM 管理員授予您命名空間管理員 (namespace-admin) 角色。這個角色會繫結至專案命名空間。
標準叢集角色
如要在標準叢集中建立、刪除、編輯或查看無狀態工作負載,請要求專案 IAM 管理員授予您叢集開發人員 (cluster-developer) 角色。這個角色會繫結至專案命名空間。
準備環境
如要使用 API 對 Kubernetes 叢集執行指令,請確認您具備下列資源:
找出 Kubernetes 叢集名稱,或向平台管理員群組成員詢問叢集名稱。
登入並產生 Kubernetes 叢集的 kubeconfig 檔案。
請使用 Kubernetes 叢集的 kubeconfig 路徑,替換這些操作說明中的
KUBERNETES_CLUSTER_KUBECONFIG。
建立 Deployment
如要建立部署作業,請編寫 Deployment 資訊清單,並執行 kubectl apply 來建立資源。這種方法保留對使用中資源所做的更新,而不會將變更併回資訊清單檔案。
如要從資訊清單檔案建立 Deployment,請執行:
kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
apply -f - <<EOF
apiVersion: apps/v1
kind: Deployment
metadata:
name: DEPLOYMENT_NAME
spec:
replicas: NUMBER_OF_REPLICAS
selector:
matchLabels:
run: APP_NAME
template:
metadata:
labels: # The labels given to each pod in the deployment, which are used
# to manage all pods in the deployment.
run: APP_NAME
spec: # The pod specification, which defines how each pod runs in the deployment.
containers:
- name: CONTAINER_NAME
image: CONTAINER_IMAGE
EOF
更改下列內容:
KUBERNETES_CLUSTER_KUBECONFIG:要部署容器工作負載的 Kubernetes 叢集 kubeconfig 檔案。NAMESPACE:要部署容器工作負載的命名空間。如果是共用叢集,這必須是專案命名空間。 如果是標準叢集,則可以是任何命名空間。DEPLOYMENT_NAME:Deployment物件的名稱。APP_NAME:要在部署作業中執行的應用程式名稱。NUMBER_OF_REPLICAS:Deployment 管理的複製Pod物件數量。CONTAINER_NAME:容器名稱。CONTAINER_IMAGE:容器映像檔的名稱。您必須加入映像檔的容器登錄路徑和版本,例如REGISTRY_PATH/hello-app:1.0。如要進一步瞭解如何設定容器登錄路徑,請參閱「Managed Harbor Service 總覽」。
例如:
apiVersion: apps/v1
kind: Deployment
metadata:
name: my-app
spec:
replicas: 3
selector:
matchLabels:
run: my-app
template:
metadata:
labels:
run: my-app
spec:
containers:
- name: hello-app
image: REGISTRY_PATH/hello-app:1.0
如要將 GPU 工作負載部署至容器,請參閱管理 GPU 容器工作負載一文。