本頁面說明如何在 Google Kubernetes Engine (GKE) 中,建立已啟用預設功能的標準可用區叢集。可用區叢集在單一可用區中只有一個控制層執行個體。您可以根據可用性需求,選擇將可用區叢集的節點分布在單一可用區或多個可用區。
本頁面適用於需要建立及設定叢集,並在 GKE 上部署工作負載的操作員、Cloud 架構師和開發人員。如要進一步瞭解 Google Cloud內容中提及的常見角色和工作範例,請參閱「常見的 GKE 使用者角色和工作」。
閱讀本頁面前,請確認您已熟悉叢集設定選項。
事前準備
開始之前,請確認您已執行下列工作:
- 啟用 Google Kubernetes Engine API。 啟用 Google Kubernetes Engine API
- 如要使用 Google Cloud CLI 執行這項工作,請安裝並初始化 gcloud CLI。如果您先前已安裝 gcloud CLI,請執行
gcloud components update指令,取得最新版本。較舊的 gcloud CLI 版本可能不支援執行本文件中的指令。
- 請確認您具備建立叢集的適當權限。您至少應具備 Kubernetes Engine 叢集管理員權限。
- 如要將新叢集註冊至機群,請確認您具備必要的 API 和權限。
為 GKE 設定 IAM 服務帳戶
GKE 會使用附加至節點的 IAM 服務帳戶,執行記錄和監控等系統工作。這些節點服務帳戶至少必須具備專案的 Kubernetes Engine 預設節點服務帳戶 (roles/container.defaultNodeServiceAccount) 角色。根據預設,GKE 會使用 Compute Engine 預設服務帳戶做為節點服務帳戶,該帳戶會在專案中自動建立。
如要將 roles/container.defaultNodeServiceAccount 角色授予 Compute Engine 預設服務帳戶,請完成下列步驟:
控制台
- 前往「Welcome」(歡迎) 頁面:
- 在「Project number」(專案編號) 欄位中,按一下 「Copy to clipboard」(複製到剪貼簿)。
- 前往「IAM」頁面:
- 按一下「Grant access」(授予存取權)。
- 在「New principals」(新主體) 欄位中,指定下列值:
將PROJECT_NUMBER-compute@developer.gserviceaccount.comPROJECT_NUMBER替換為您複製的專案編號。 - 在「Select a role」(選取角色) 選單中,選取「Kubernetes Engine Default Node Service Account」(Kubernetes Engine 預設節點服務帳戶) 角色。
- 按一下「儲存」。
gcloud
- 找出 Google Cloud 專案編號:
gcloud projects describe PROJECT_ID \ --format="value(projectNumber)"
將
PROJECT_ID替換為專案 ID。輸出結果會與下列內容相似:
12345678901
- 將
roles/container.defaultNodeServiceAccount角色授予 Compute Engine 預設服務帳戶:gcloud projects add-iam-policy-binding PROJECT_ID \ --member="serviceAccount:PROJECT_NUMBER-compute@developer.gserviceaccount.com" \ --role="roles/container.defaultNodeServiceAccount"
將
PROJECT_NUMBER替換為上一個步驟中的專案編號。
建立可用區叢集
建立新的可用區叢集時,您至少需要指定名稱、專案 (通常是目前的專案) 和可用區 (通常是指令列工具的預設位置),並使用所有其他值的預設設定。不過,還有更多可能的配置設定,本節僅說明其中一部分,有些設定在叢集建立後無法變更。請務必瞭解哪些設定在叢集建立後無法變更,並在建立叢集時選擇正確的設定,以免需要重新建立。
如要查看叢集設定選項的總覽,請參閱「關於叢集設定選項」;如需可能選項的完整清單,請參閱 gcloud container clusters create 和 Terraform google_container_cluster 參考指南。
您可以使用 gcloud CLI、Google Cloud 控制台或 Terraform 建立可用區叢集。
如果您使用 Cloud Code for VS Code 開發 GKE 應用程式,請嘗試使用 Cloud Code 建立叢集。
gcloud
如要使用 gcloud CLI 建立可用區叢集,請使用下列其中一個指令。
更改下列內容:
CLUSTER_NAME:新叢集的名稱。CHANNEL:發布管道類型,可以是rapid、regular、stable或None(已淘汰) 之一。根據預設,叢集會註冊至regular發布管道。CONTROL_PLANE_LOCATION:叢集控制層的 Compute Engine 可用區。VERSION:要為叢集指定的版本。COMPUTE_ZONE,COMPUTE_ZONE1,[...]:建立節點的可用區。您可以視需要為叢集指定多個可用區。所有可用區都必須與叢集的控制層位於同一個區域,由--location旗標指定。如果是可用區叢集,--node-locations必須包含叢集的主要可用區。
強烈建議您指定權限最小的 IAM 服務帳戶,供節點使用,而非 Compute Engine 預設服務帳戶。如要瞭解如何建立僅具備必要權限的服務帳戶,請參閱「使用最小權限服務帳戶」。
如要在 gcloud CLI 中指定自訂服務帳戶,請在指令中加入下列旗標:
--service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com將 SERVICE_ACCOUNT_NAME 替換為僅具備必要權限的服務帳戶名稱。
使用特定發布管道:
如要使用特定發布管道建立新叢集,請執行下列指令:
gcloud container clusters create CLUSTER_NAME \
--release-channel CHANNEL \
--location CONTROL_PLANE_LOCATION \
--node-locations COMPUTE_ZONE,COMPUTE_ZONE1
使用特定版本:
如要使用特定叢集版本建立新叢集,請執行下列指令:
gcloud container clusters create CLUSTER_NAME \
--cluster-version VERSION \
--location CONTROL_PLANE_LOCATION \
--node-locations COMPUTE_ZONE,COMPUTE_ZONE1
範例
下列指令會建立名為 example-cluster 的多可用區叢集,其中叢集控制層位於 us-east4-a 可用區,且有三個節點位置。叢集已在 regular 發布管道註冊。
如果省略 --num-nodes 旗標,叢集預設會為每個可用區建立三個節點。由於指定了三個可用區,這個指令會建立一個九節點叢集,其中 us-east4-a、us-east4-b 和 us-east4-c 各有三個節點。在 GKE 1.37.1-gke.1153000 以上版本中,您可以將 --num-nodes 旗標設為 0,建立沒有節點的叢集。
gcloud container clusters create example-cluster \
--location us-east4-a \
--node-locations us-east4-a,us-east4-b,us-east4-c
控制台
如要使用 Google Cloud 控制台建立可用區叢集,請執行下列工作:
在 Google Cloud 控制台中,前往「Create a Kubernetes cluster」(建立 Kubernetes 叢集) 頁面。
在「Cluster basics」(叢集基本資訊) 部分,完成下列操作:
- 輸入叢集的名稱。
- 在「Location type」(位置類型) 部分,選取「Zonal」(可用區),然後選取叢集的可用區。
- 如要建立多可用區叢集,請勾選「Specify default node locations」(指定預設節點位置) 核取方塊,然後選擇要執行節點集區的其他可用區。
選擇發布版本。您也可以選取「No channel」(無管道),但這個設定選項已淘汰,日後將會移除。詳情請參閱「未註冊發布管道的叢集」。
選用:從「Version」(版本) 下拉式選單中指定控制層版本。
選用:調整新叢集的其他設定。
選用:如要將新叢集註冊至機群,請前往「Advanced settings」(進階設定) 專區,然後按照 Google Cloud 控制台操作說明建立及註冊新叢集,完成叢集註冊。
如要建立及設定自己的節點集區,請按照下列步驟操作:
- 按一下 「Add node pool」(新增節點集區)。
- 在「需要變更」對話方塊中,按一下「執行變更」。
導覽選單中會顯示名為
default-pool的節點集區。選用:如要建立沒有節點集區的叢集,請按照下列步驟操作:
- 在導覽選單中,按一下「default-pool」。
- 按一下 「Remove node pool」(移除節點集區)。
- 設定叢集的其餘設定,然後按一下「Create」(建立)。
選用:如要將節點集區新增至叢集,請按一下 「Add node pool」(新增節點集區)。導覽選單中會顯示新的節點集區。
設定節點集區的基本設定:
- 在導覽選單的「Node pools」(節點集區) 區段中,按一下節點集區的名稱。「User-managed node pool details」(使用者自行管理的節點集區詳細資料) 頁面隨即開啟。
- 在「Name」(名稱) 欄位中,輸入節點集區的名稱。
- 在「Size」(大小) 區段的「Number of nodes」(節點數量) 欄位中,指定要建立的節點數量。您必須有可用的資源配額,才能建立節點和相關資源 (例如防火牆路由)。在 GKE 1.37.1-gke.1153000 以上版本中,您可以指定
0值,建立空白節點集區。
為執行節點的 VM 執行個體進行設定:
設定節點集區的安全性設定:
- 在導覽選單中,按一下所選節點集區展開部分中的「Security」(安全性)。
- 您可以視需要為節點指定自訂 IAM 服務帳戶:
- 在「進階設定」頁面中,展開「安全性」部分。
- 在「Service account」(服務帳戶) 選單中,選取偏好的服務帳戶。
強烈建議您指定權限最小的 IAM 服務帳戶,供節點使用,而非 Compute Engine 預設服務帳戶。如要瞭解如何建立僅具備必要權限的服務帳戶,請參閱「使用最小權限服務帳戶」。
點選「建立」。
Terraform
如要使用 Terraform 建立具有單一可用區節點集區的可用區叢集,請參考下列範例:
如要使用 Terraform 建立具有多可用區節點集區的可用區叢集,請參考下列範例:
如要進一步瞭解如何使用 Terraform,請參閱「GKE 的 Terraform 支援」。
使用 kubectl 與叢集互動
建立叢集之後,您必須先設定 kubectl,才能透過指令列與叢集進行互動。
建立沒有節點的可用區叢集
在 GKE 1.37.1-gke.1153000 以上版本中,您可以透過下列任一方式,建立沒有節點的可用區叢集:
- 略過建立預設節點集區:GKE 不會將任何節點集區新增至叢集。如果您打算使用 Autopilot ComputeClasses、自動建立節點集區,或稍後建立的自訂節點集區來執行工作負載,請使用這個選項。
- 建立空白節點集區:GKE 會建立節點數量為零的節點集區。如要在建立叢集時自訂節點集區設定,而不建立實際節點,請使用這個選項。
建立沒有節點的叢集時,系統 Pod 會維持在無法排程的狀態,直到叢集中至少有一個節點為止。如要建立沒有節點的可用區叢集,請選取下列其中一個選項:
gcloud
如要略過建立預設節點集區,請在
gcloud container clusters create指令中僅使用--num-nodes=0旗標:gcloud container clusters create CLUSTER_NAME \ --location=CONTROL_PLANE_LOCATION \ --num-nodes=0更改下列內容:
CLUSTER_NAME:新可用區叢集的名稱。CONTROL_PLANE_LOCATION:叢集控制層的 Compute Engine 可用區,例如us-central1-a。
如果您指定任何其他節點集區設定旗標,例如
--machine-type、--disk-type或--disk-size旗標,指令會失敗,因為 GKE 沒有可設定的節點集區。如要建立含有空白節點集區的叢集,請在
gcloud container clusters create指令中使用--num-nodes=0旗標和--node-pool-name旗標:gcloud container clusters create CLUSTER_NAME \ --location=CONTROL_PLANE_LOCATION \ --num-nodes=0 \ --node-pool-name=NODEPOOL_NAME將
NODEPOOL_NAME替換為空白節點集區的名稱。您可以指定其他節點設定旗標,自訂空白節點集區中的節點。
控制台
在 Google Cloud 控制台中,前往「Create a Kubernetes cluster」(建立 Kubernetes 叢集) 頁面。
指定叢集名稱。
在「位置類型」部分,選取「可用區」。
在「Zone」(可用區) 下拉式選單中,選取叢集控制層的可用區。
略過建立預設節點集區,或建立空白節點集區:
如要略過建立預設節點集區,請在「Default mode」(預設模式) 專區中,確認已選取「Autopilot」選項。或者,您也可以觸發預設節點集區的建立作業,然後將其移除:
- 按一下 「Add node pool」(新增節點集區)。
- 在「需要變更」對話方塊中,按一下「執行變更」。系統會顯示名為
default-pool的節點集區。 - 在導覽選單中,按一下「default-pool」。
- 按一下 「Remove node pool」(移除節點集區)。
這些步驟會建立沒有節點集區的叢集,並使用 Autopilot 模式執行未選取 ComputeClass 的工作負載。您也可以在「Default mode」(預設模式) 區段中選取「User-managed node pool」(使用者管理的節點集區) 選項,禁止使用 Autopilot 模式。
如要建立空白節點集區,請按照下列步驟操作:
- 按一下 「Add node pool」(新增節點集區)。
- 在「需要變更」對話方塊中,按一下「執行變更」。系統會顯示名為
default-pool的節點集區。 - 在導覽選單中,按一下「default-pool」。
- 在「Number of nodes」(節點數量) 欄位中,指定
0的值。
設定叢集的其餘設定,然後按一下「Create」(建立)。
Terraform
- 如要略過建立預設節點集區,請在
google_container_cluster資源中,將initial_node_count欄位的值設為0。 如要建立空白的初始節點集區,請按照下列步驟操作:
- 在
google_container_cluster資源中,將initial_node_count欄位設為0。 - 新增
google_container_node_pool資源,並將node_count欄位設為0。
- 在
建立沒有節點的叢集後,您可以透過下列方式佈建節點:
- 設定 Standard 叢集,預設使用 Autopilot,或在 Autopilot 模式中執行特定工作負載。
- 使用 ComputeClasses,自動為傳入的工作負載建立節點。
- 手動新增節點集區,或調整現有空白節點集區的大小。
叢集範本
GKE 先前支援叢集範本,這些範本已從 Google Cloud 控制台移除,但仍可透過下列連結存取: