建立 Alpha 版叢集

Alpha 版叢集是短期 Google Kubernetes Engine (GKE) 叢集,可啟用 Kubernetes Alpha 版 API 和功能,並執行即將推出的子版本 Alpha 版。本文說明如何建立 Alpha 版叢集、啟用或停用特定 feature gate,以及在快速發布管道中執行 Alpha 修補程式版本。Alpha 版叢集適用於早期採用者和平台管理員,方便他們試用即將推出的 Kubernetes 功能和版本。

如要進一步瞭解 GKE 叢集的運作方式,以及如何選擇要建立的 GKE 叢集類型,請參閱「GKE 叢集架構」和「關於叢集設定選項」。

事前準備

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

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

必要的角色

如要取得建立 Alpha 版叢集及與其互動所需的權限,請要求管理員授予您專案的 Kubernetes Engine 叢集管理員 (roles/container.clusterAdmin) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色,取得必要權限。

為 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 替換為上一個步驟中的專案編號。

建立 Alpha 版叢集

您可以使用 Google Cloud 控制台或 gcloud CLI 建立 Alpha 版叢集。建議您使用 gcloud CLI,原因如下:

  • 您可以將叢集註冊至快速發布管道,這是 Alpha 版叢集的建議做法。
  • 您可以指定 Alpha 或 Beta 版 feature gate,啟用或停用與預設值不同的功能。

控制台

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

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

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

    1. 輸入叢集的名稱。
    2. 在「Location type」(位置類型) 部分,選取「Zonal」(可用區),然後選取叢集的可用區。
    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 值,建立空白節點集區。
    4. 取消勾選「Enable auto-upgrade」(啟用自動升級功能) 和「Enable auto-repair」(啟用自動修復功能)。
  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. 在導覽窗格中,按一下「Advanced settings」(進階設定)。

  12. 在「Kubernetes alpha features」(Kubernetes Alpha 版功能) 列中,按一下 「Edit configuration」(編輯設定)。

  13. 選取「在這個叢集中啟用 Kubernetes Alpha 版功能」。

  14. 詳閱警告訊息,然後選取「我瞭解上述影響」。

  15. 按一下「儲存」。

  16. 點選「建立」。

gcloud

執行下列指令:

gcloud container clusters create CLUSTER_NAME \
    --release-channel=CHANNEL \
    --enable-kubernetes-alpha \
    --no-enable-autorepair \
    --no-enable-autoupgrade \
    --location CONTROL_PLANE_LOCATION [\
    --alpha-cluster-feature-gates FEATURE_GATES_LIST]

更改下列內容:

  • CLUSTER_NAME:您為叢集選擇的名稱。
  • CHANNEL:發布管道類型。這個值必須是下列其中一個:

    • rapid:加入快速發布管道,這是 Alpha 版叢集的建議管道。
    • regular:註冊一般發布版本。
    • stable:註冊穩定版發布管道。
    • none:不註冊發布管道。這個選項已淘汰,日後將會移除。
  • CONTROL_PLANE_LOCATION:叢集控制層的 Compute Engine 位置。提供區域叢集的區域,或可用區叢集的可用區。

  • --cluster-version VERSION:(選用) 指定要在叢集中執行的 GKE 版本。如省略,叢集會執行所選發布管道的叢集建立預設修補程式版本,如目前版本表格所示。

  • FEATURE_GATES_LIST:要啟用或停用的 feature gate 清單,與預設值不同。每個字串代表啟用或停用 feature gate。例如:featureX=true, featureY=false。如果省略這個旗標,GKE 會使用 GKE 的預設值建立叢集,也就是啟用 Kubernetes 版本可用的所有 Alpha 版功能 feature gate。Kubernetes 預設啟用的 Beta 版 feature gate 也會啟用。如要進一步瞭解特定版本可用的 feature gate,以及預設啟用的 Beta 版功能,請參閱 Kubernetes 說明文件中的「Alpha 或 Beta 版功能的 feature gate」。加入這個旗標後,您就能修改要啟用哪些 feature gate,而非使用 GKE 預設設定。詳情請參閱「Feature gate 和 Alpha 版叢集」。

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

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

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

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

系統會提示您確認 Alpha 測試版叢集未升級,並會在 30 天後刪除的警告:

This will create a cluster with Kubernetes alpha features enabled.
- This cluster will not be covered by the GKE SLA and should
  not be used for production workloads.
- You will not be able to upgrade the master or nodes.
- The cluster will be deleted after 30 days.

使用 kubectl 與叢集互動

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

檢查 Alpha 版叢集的 feature gate 狀態

您可以選擇啟用或停用 Alpha 版叢集的 feature gate。詳情請參閱「Feature gate 和 Alpha 版叢集」。

如要查看叢集的 feature gate 狀態,請參閱「查看 feature gate 狀態」。

在 Alpha 版叢集中執行 Alpha 修補程式版本

在快速發布管道註冊的 Alpha 版叢集,可以執行即將推出的 Kubernetes 子版本 Alpha 修補程式版本。在 GKE 將子版本提供給搶鮮版中的所有叢集之前,這些 Alpha 版可讓您搶先體驗測試功能和下一個子版本的變更。

如要找出並在 Alpha 版叢集執行 Alpha 修補程式版本,請按照下列步驟操作:

  1. 找出搶鮮版中可用的 Alpha 版:

    gcloud container get-server-config \
        --flatten="channels" --filter="channels.channel=RAPID" \
        --location=LOCATION \
        --format="yaml(channels.channel,channels.previewVersions)"
    

    將 LOCATION 替換為您要建立 Alpha 版叢集的區域,例如 us-east4。

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

    channels:
      channel: RAPID
      previewVersions:
      - 1.37.0-gke.1173000+preview
    

    如果輸出內容空白,表示該區域不提供 Alpha 版。請改用其他區域,或查看快速版版本資訊,瞭解版本資訊。

  2. 建立 Alpha 版叢集:

    gcloud container clusters create CLUSTER_NAME \
        --release-channel=rapid \
        --enable-kubernetes-alpha \
        --no-enable-autorepair \
        --no-enable-autoupgrade \
        --location=CONTROL_PLANE_LOCATION \
        --cluster-version=ALPHA_VERSION
    

    更改下列內容:

    • CLUSTER_NAME:Alpha 版叢集的名稱。
    • CONTROL_PLANE_LOCATION:叢集控制層所在的區域或可用區。請使用您在上一步檢查 Alpha 版可用性的相同區域,或該區域中的可用區。
    • ALPHA_VERSION:要在叢集中執行的特定 Alpha 修補程式版本,取自上一個步驟的輸出內容。

查看 Alpha 版叢集的到期時間

如要查看 Alpha 測試版叢集的到期日,請執行以下指令:

gcloud container clusters list

疑難排解使用 feature gate 建立 Alpha 版叢集的問題

如果嘗試建立叢集時,使用的 feature gate 無效,或叢集的 Kubernetes 版本不支援該 feature gate,叢集可能會在錯誤狀態下建立。

您可以在 Cloud Logging 中找到類似下列的訊息:

failed to set feature gates from initial flags-based config:
unrecognized feature gate: UNRECOGNIZED_FEATURE_GATE_NAME

如果遇到這個錯誤,請刪除失敗的叢集。請檢查拼字,以及 feature gate 與指定 Kubernetes 版本的相容性。接著,請再次嘗試建立叢集。

後續步驟