建立地區叢集

本文說明如何建立標準區域叢集,在叢集升級、自動維護或可用區中斷期間,提高叢集控制層和工作負載的可用性。

GKE Autopilot 叢集一律為區域性。

總覽

建立區域叢集 (而非可用區叢集) 時,叢集的控制層會在指定區域的多個可用區中複製。如果是區域叢集中的節點集區,您可以手動指定要在哪些可用區執行節點集區,也可以使用預設設定,在控制層區域的三個可用區中複製每個節點集區。所有可用區都必須與叢集的控制層位於同一個區域。

地區叢集會複製跨多個區域的資源,並耗用額外的配額。

如要瞭解不同的叢集可用性類型,請參閱「關於叢集設定選項」。

以下各節的操作說明將示範如何:

區域叢集建立後,即無法轉換為可用區叢集。

建立新的區域叢集時,您至少須指定名稱、專案 (通常是目前的專案) 和區域 (通常是指令列工具的預設位置),其他值則一律採用預設設定。不過,還有更多可能的配置設定,本指南僅說明其中一部分,且部分設定在叢集建立後即無法變更。請務必瞭解哪些設定在叢集建立後無法變更,並在建立叢集時選擇正確的設定,以免需要重新建立。

如要查看叢集設定選項的總覽,請參閱「關於叢集設定選項」;如需可能選項的完整清單,請參閱 gcloud container clusters create 和 Terraform google_container_cluster 參考指南。

事前準備

開始之前,請確認您已執行下列工作:

  • 啟用 Google Kubernetes Engine API。
  • 啟用 Google Kubernetes Engine API
  • 如要使用 Google Cloud CLI 執行這項工作,請安裝並初始化 gcloud CLI。如果您先前已安裝 gcloud CLI,請執行 gcloud components update 指令,取得最新版本。較舊的 gcloud CLI 版本可能不支援執行本文件中的指令。

為 GKE 設定 IAM 服務帳戶

GKE 會使用附加至節點的 IAM 服務帳戶,執行記錄和監控等系統工作。這些節點服務帳戶至少必須具備專案的 Kubernetes Engine 預設節點服務帳戶 (roles/container.defaultNodeServiceAccount) 角色。根據預設,GKE 會使用 Compute Engine 預設服務帳戶做為節點服務帳戶,該帳戶會在專案中自動建立。

如要將 roles/container.defaultNodeServiceAccount 角色授予 Compute Engine 預設服務帳戶,請完成下列步驟:

控制台

  1. 前往「Welcome」(歡迎) 頁面:

    前往「歡迎」頁面

  2. 在「Project number」(專案編號) 欄位中,按一下 「Copy to clipboard」(複製到剪貼簿)。
  3. 前往「IAM」頁面:

    前往「身分與存取權管理」頁面

  4. 按一下「Grant access」(授予存取權)。
  5. 在「New principals」(新主體) 欄位中,指定下列值:
    PROJECT_NUMBER-compute@developer.gserviceaccount.com
    將 PROJECT_NUMBER 替換為您複製的專案編號。
  6. 在「Select a role」(選取角色) 選單中,選取「Kubernetes Engine Default Node Service Account」(Kubernetes Engine 預設節點服務帳戶) 角色。
  7. 按一下「儲存」。

gcloud

  1. 找出 Google Cloud 專案編號:
    gcloud projects describe PROJECT_ID \
        --format="value(projectNumber)"

    將 PROJECT_ID 替換為專案 ID。

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

    12345678901
    
  2. 將 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 CLI、 Google Cloud 控制台或 Terraform 建立叢集。

如果您使用 Cloud Code for VS Code 開發 GKE 應用程式,請嘗試使用 Cloud Code 建立叢集。

gcloud

執行 gcloud CLI 指令建立叢集前,請先執行下列指令,設定正確的專案:

gcloud config set project PROJECT_ID
# gcloud config set billing/quota_project PROJECT_ID

如要使用 gcloud CLI 建立區域叢集,請使用下列其中一個指令,並替換下列變數:

  • CLUSTER_NAME:新區域叢集的名稱。
  • CONTROL_PLANE_LOCATION:叢集控制層的 Compute Engine 區域。提供區域,例如 us-east4。
  • COMPUTE_ZONE:節點集區的可用區,例如 us-east4-a。可用區必須與叢集控制層位於相同區域。
  • CHANNEL:發布管道類型,可以是 rapid、regular、stable 或 None (已淘汰) 之一。根據預設,叢集會註冊至 regular 發布管道。
  • VERSION:要為叢集指定的版本。

強烈建議您指定權限最小的 IAM 服務帳戶,供節點使用,而非 Compute Engine 預設服務帳戶。如要瞭解如何建立僅具備必要權限的服務帳戶,請參閱「使用最小權限服務帳戶」。

如要在 gcloud CLI 中指定自訂服務帳戶,請在指令中加入下列旗標:

--service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com

將 SERVICE_ACCOUNT_NAME 替換為僅具備必要權限的服務帳戶名稱。

使用特定發布管道:

如要使用特定發布管道建立新叢集,請執行下列指令:

gcloud container clusters create CLUSTER_NAME \
    --location CONTROL_PLANE_LOCATION \
    --node-locations COMPUTE_ZONE \
    --release-channel CHANNEL

使用特定版本:

如要使用特定叢集版本建立新叢集,請執行下列指令:

gcloud container clusters create CLUSTER_NAME \
    --location CONTROL_PLANE_LOCATION \
    --node-locations COMPUTE_ZONE \
    --cluster-version VERSION

範例

下列指令會建立在 regular 發布管道 (預設) 註冊的區域叢集,並在 us-west1-c 可用區中建立三個節點 (預設):

gcloud container clusters create my-regional-cluster \
    --location us-west1 \
    --node-locations us-west1-c

範例

下列指令會建立在 regular 發布管道 (預設) 註冊的區域叢集,其中兩個節點位於 us-west1-c 可用區:

gcloud container clusters create my-regional-cluster \
    --location us-west1 \
    --node-locations us-west1-c \
    --num-nodes 2

控制台

  1. 在 Google Cloud 控制台中,前往「Create a Kubernetes cluster」(建立 Kubernetes 叢集) 頁面。

    前往「Create a Kubernetes cluster」(建立 Kubernetes 叢集)

  2. 在「Cluster basics」(叢集基本資訊) 部分,完成下列操作:

    1. 輸入叢集的名稱。
    2. 在「Location type」(位置類型) 部分,選取「Regional」(區域),然後選取叢集的區域。
    3. 如要覆寫預設節點位置 (例如在單一可用區中執行),請勾選「Specify default node locations」(指定預設節點位置) 核取方塊,然後選擇要執行節點集區的可用區。

    4. 選擇發布版本。您也可以選取「No channel」(無管道),但這個設定選項已淘汰,日後將會移除。詳情請參閱「未註冊發布管道的叢集」。

    5. 選用:從「Version」(版本) 下拉式選單中指定控制層版本。

  3. 選用:調整新叢集的其他設定。

  4. 選用:如要將新叢集註冊至機群,請前往「Advanced settings」(進階設定) 專區,然後按照 Google Cloud 控制台操作說明建立及註冊新叢集,完成叢集註冊。

  5. 如要建立及設定自己的節點集區,請按照下列步驟操作:

    1. 按一下 「Add node pool」(新增節點集區)。
    2. 在「需要變更」對話方塊中,按一下「執行變更」。

    導覽選單中會顯示名為 default-pool 的節點集區。

  6. 選用:如要建立沒有節點集區的叢集,請按照下列步驟操作:

    1. 在導覽選單中,按一下「default-pool」。
    2. 按一下 「Remove node pool」(移除節點集區)。
    3. 設定叢集的其餘設定,然後按一下「Create」(建立)。
  7. 選用:如要將節點集區新增至叢集,請按一下 「Add node pool」(新增節點集區)。導覽選單中會顯示新的節點集區。

  8. 設定節點集區的基本設定:

    1. 在導覽選單的「Node pools」(節點集區) 區段中,按一下節點集區的名稱。「User-managed node pool details」(使用者自行管理的節點集區詳細資料) 頁面隨即開啟。
    2. 在「Name」(名稱) 欄位中,輸入節點集區的名稱。
    3. 在「Size」(大小) 區段的「Number of nodes」(節點數量) 欄位中,指定要建立的節點數量。您必須有可用的資源配額,才能建立節點和相關資源 (例如防火牆路由)。在 GKE 1.37.1-gke.1153000 以上版本中,您可以指定 0 值,建立空白節點集區。
  9. 為執行節點的 VM 執行個體進行設定:

    1. 在導覽選單中,按一下所選節點集區展開部分中的「Nodes」(節點)。
    2. 在「Image type」(映像檔類型) 下拉式選單中,選取節點映像檔。
    3. 選擇要用於執行個體的預設機器設定。每種機器類型的計費方式都不同。預設機型為 e2-medium。如要瞭解機型定價資訊,請參閱機型價目表。
    4. 在「Boot disk type」(開機磁碟類型) 下拉式選單中,選取磁碟類型。
    5. 在「Boot disk size」(開機磁碟大小) 欄位中,指定開機磁碟的大小 (以 GB 為單位)。
  10. 設定節點集區的安全性設定:

    1. 在導覽選單中,按一下所選節點集區展開部分中的「Security」(安全性)。
    2. 您可以視需要為節點指定自訂 IAM 服務帳戶:
      1. 在「進階設定」頁面中,展開「安全性」部分。
      2. 在「Service account」(服務帳戶) 選單中,選取偏好的服務帳戶。

      強烈建議您指定權限最小的 IAM 服務帳戶,供節點使用,而非 Compute Engine 預設服務帳戶。如要瞭解如何建立僅具備必要權限的服務帳戶,請參閱「使用最小權限服務帳戶」。

  11. 點選「建立」。

Terraform

如要使用 Terraform 建立具有單一可用區節點集區的區域叢集,請參考下列範例:

resource "google_container_cluster" "default" {
  name               = "gke-standard-regional-single-zone"
  location           = "us-west1"
  node_locations     = ["us-west1-c"]
  initial_node_count = 2
}

如要進一步瞭解如何使用 Terraform,請參閱「GKE 的 Terraform 支援」。

使用 kubectl 與叢集互動

建立叢集之後,您必須先設定 kubectl,才能透過指令列與叢集進行互動。

建立具備多可用區節點集區的區域叢集

下列操作說明說明如何建立具有多可用區節點集區的區域叢集,這是預設設定。叢集的控制層和節點會在指定區域的多個可用區中複製。

您可以使用 gcloud CLI、 Google Cloud 控制台或 Terraform 建立叢集。

如果您使用 Visual Studio Code 開發 GKE 應用程式,請嘗試使用 Cloud Code 建立叢集。

gcloud

執行 gcloud CLI 指令建立叢集前,請先執行下列指令,設定正確的專案:

gcloud config set project PROJECT_ID
# The project set above is used for quota and billing by default.
# To use a different project for quota and billing, run the following command:
# gcloud config set billing/quota_project PROJECT_ID

如要使用 gcloud CLI 建立區域叢集,請使用下列其中一個指令,並替換下列變數:

  • CLUSTER_NAME:新區域叢集的名稱。
  • CONTROL_PLANE_LOCATION:叢集控制層的 Compute Engine 區域。提供區域,例如 us-east4。
  • CHANNEL:發布管道類型,可以是 rapid、regular、stable 或 None (已淘汰) 之一。根據預設,叢集會註冊至 regular 發布管道。
  • VERSION:要為叢集指定的版本。
  • 如果區域有三個以上的可用區,或您偏好較少的可用區,可以使用選用的 --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 \
    --location CONTROL_PLANE_LOCATION \
    --release-channel CHANNEL

使用特定版本:

如要使用特定叢集版本建立新叢集,請執行下列指令:

gcloud container clusters create CLUSTER_NAME \
    --location CONTROL_PLANE_LOCATION \
    --cluster-version VERSION

範例

下列指令會建立在 regular 發布管道註冊的區域叢集,並在 us-west1 中建立九個節點 (三個可用區,每個可用區有三個節點,這是預設值):

gcloud container clusters create my-regional-cluster --location us-west1

範例

下列指令會建立註冊 regular 發布管道的區域叢集,其中包含六個節點 (三個可用區,每個可用區有兩個節點,由 --num-nodes 指定):

gcloud container clusters create my-regional-cluster \
    --location us-west1 \
    --num-nodes 2

範例

下列指令會建立已註冊 regular 發布管道的區域叢集,並在兩個可用區中建立六個節點 (兩個可用區,由 --node-locations 指定,每個可用區有三個節點):

gcloud container clusters create my-regional-cluster \
    --location us-east4 \
    --node-locations us-east4-b,us-east4-c

控制台

  1. 在 Google Cloud 控制台中,前往「Create a Kubernetes cluster」(建立 Kubernetes 叢集) 頁面。

    前往「Create a Kubernetes cluster」(建立 Kubernetes 叢集)

  2. 在「Cluster basics」(叢集基本資訊) 部分,完成下列操作:

    1. 輸入叢集的名稱。
    2. 在「Location type」(位置類型) 部分,選取「Regional」(區域),然後選取叢集的區域。
    3. 如要覆寫預設節點位置 (例如在單一可用區中執行),請勾選「Specify default node locations」(指定預設節點位置) 核取方塊,然後選擇要執行節點集區的可用區。

    4. 選擇發布版本。您也可以選取「No channel」(無管道),但這個設定選項已淘汰,日後將會移除。詳情請參閱「未註冊發布管道的叢集」。

    5. 選用:從「Version」(版本) 下拉式選單中指定控制層版本。

  3. 選用:調整新叢集的其他設定。

  4. 選用:如要將新叢集註冊至機群,請前往「Advanced settings」(進階設定) 專區,然後按照 Google Cloud 控制台操作說明建立及註冊新叢集,完成叢集註冊。

  5. 如要建立及設定自己的節點集區,請按照下列步驟操作:

    1. 按一下 「Add node pool」(新增節點集區)。
    2. 在「需要變更」對話方塊中,按一下「執行變更」。

    導覽選單中會顯示名為 default-pool 的節點集區。

  6. 選用:如要建立沒有節點集區的叢集,請按照下列步驟操作:

    1. 在導覽選單中,按一下「default-pool」。
    2. 按一下 「Remove node pool」(移除節點集區)。
    3. 設定叢集的其餘設定,然後按一下「Create」(建立)。
  7. 選用:如要將節點集區新增至叢集,請按一下 「Add node pool」(新增節點集區)。導覽選單中會顯示新的節點集區。

  8. 設定節點集區的基本設定:

    1. 在導覽選單的「Node pools」(節點集區) 區段中,按一下節點集區的名稱。「User-managed node pool details」(使用者自行管理的節點集區詳細資料) 頁面隨即開啟。
    2. 在「Name」(名稱) 欄位中,輸入節點集區的名稱。
    3. 在「Size」(大小) 區段的「Number of nodes」(節點數量) 欄位中,指定要建立的節點數量。您必須有可用的資源配額,才能建立節點和相關資源 (例如防火牆路由)。在 GKE 1.37.1-gke.1153000 以上版本中,您可以指定 0 值,建立空白節點集區。
  9. 為執行節點的 VM 執行個體進行設定:

    1. 在導覽選單中,按一下所選節點集區展開部分中的「Nodes」(節點)。
    2. 在「Image type」(映像檔類型) 下拉式選單中,選取節點映像檔。
    3. 選擇要用於執行個體的預設機器設定。每種機器類型的計費方式都不同。預設機型為 e2-medium。如要瞭解機型定價資訊,請參閱機型價目表。
    4. 在「Boot disk type」(開機磁碟類型) 下拉式選單中,選取磁碟類型。
    5. 在「Boot disk size」(開機磁碟大小) 欄位中,指定開機磁碟的大小 (以 GB 為單位)。
  10. 設定節點集區的安全性設定:

    1. 在導覽選單中,按一下所選節點集區展開部分中的「Security」(安全性)。
    2. 您可以視需要為節點指定自訂 IAM 服務帳戶:
      1. 在「進階設定」頁面中,展開「安全性」部分。
      2. 在「Service account」(服務帳戶) 選單中,選取偏好的服務帳戶。

      強烈建議您指定權限最小的 IAM 服務帳戶,供節點使用,而非 Compute Engine 預設服務帳戶。如要瞭解如何建立僅具備必要權限的服務帳戶,請參閱「使用最小權限服務帳戶」。

  11. 點選「建立」。

Terraform

如要使用 Terraform 建立具有多可用區節點集區的區域叢集,請參考下列範例:

resource "google_container_cluster" "default" {
  name               = "gke-standard-regional-multi-zone"
  location           = "us-central1"
  node_locations     = ["us-central1-b", "us-central1-c"]
  initial_node_count = 2
}

如要進一步瞭解如何使用 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。

    如果您指定任何其他節點集區設定旗標,例如 --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 替換為空白節點集區的名稱。您可以指定其他節點設定旗標,自訂空白節點集區中的節點。

控制台

  1. 在 Google Cloud 控制台中,前往「Create a Kubernetes cluster」(建立 Kubernetes 叢集) 頁面。

    前往「Create a Kubernetes cluster」(建立 Kubernetes 叢集)

  2. 指定叢集名稱。

  3. 在「位置類型」部分,選取「區域」。

  4. 在「Region」(區域) 下拉式選單中,選取叢集控制層的區域。

  5. 略過建立預設節點集區,或建立空白節點集區:

    • 如要略過建立預設節點集區,請在「Default mode」(預設模式) 專區中,確認已選取「Autopilot」選項。或者,您也可以觸發預設節點集區的建立作業,然後將其移除:

      1. 按一下 「Add node pool」(新增節點集區)。
      2. 在「需要變更」對話方塊中,按一下「執行變更」。系統會顯示名為 default-pool 的節點集區。
      3. 在導覽選單中,按一下「default-pool」。
      4. 按一下 「Remove node pool」(移除節點集區)。

      這些步驟會建立沒有節點集區的叢集,並使用 Autopilot 模式執行未選取 ComputeClass 的工作負載。您也可以在「Default mode」(預設模式) 區段中選取「User-managed node pool」(使用者管理的節點集區) 選項,禁止使用 Autopilot 模式。

    • 如要建立空白節點集區,請按照下列步驟操作:

      1. 按一下 「Add node pool」(新增節點集區)。
      2. 在「需要變更」對話方塊中,按一下「執行變更」。系統會顯示名為 default-pool 的節點集區。
      3. 在導覽選單中,按一下「default-pool」。
      4. 在「Number of nodes (per zone)」(節點數量 (每個可用區)) 欄位中,指定 0 值。
  6. 設定叢集的其餘設定,然後按一下「Create」(建立)。

Terraform

建立沒有節點的叢集後,您可以透過下列方式佈建節點:

後續步驟