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 版叢集的限制。
必要的角色
如要取得建立 Alpha 版叢集及與其互動所需的權限,請要求管理員授予您專案的 Kubernetes Engine 叢集管理員 (roles/container.clusterAdmin) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
為 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替換為上一個步驟中的專案編號。
建立 Alpha 版叢集
您可以使用 Google Cloud 控制台或 gcloud CLI 建立 Alpha 版叢集。建議您使用 gcloud CLI,原因如下:
- 您可以將叢集註冊至快速發布管道,這是 Alpha 版叢集的建議做法。
您可以指定 Alpha 或 Beta 版 feature gate,啟用或停用與預設值不同的功能。
控制台
在 Google Cloud 控制台中,前往「Create a Kubernetes cluster」(建立 Kubernetes 叢集) 頁面。
在「Cluster basics」(叢集基本資訊) 部分,完成下列操作:
選用:調整新叢集的其他設定。
選用:如要將新叢集註冊至機群,請前往「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值,建立空白節點集區。 - 取消勾選「Enable auto-upgrade」(啟用自動升級功能) 和「Enable auto-repair」(啟用自動修復功能)。
為執行節點的 VM 執行個體進行設定:
設定節點集區的安全性設定:
- 在導覽選單中,按一下所選節點集區展開部分中的「Security」(安全性)。
- 您可以視需要為節點指定自訂 IAM 服務帳戶:
- 在「進階設定」頁面中,展開「安全性」部分。
- 在「Service account」(服務帳戶) 選單中,選取偏好的服務帳戶。
強烈建議您指定權限最小的 IAM 服務帳戶,供節點使用,而非 Compute Engine 預設服務帳戶。如要瞭解如何建立僅具備必要權限的服務帳戶,請參閱「使用最小權限服務帳戶」。
在導覽窗格中,按一下「Advanced settings」(進階設定)。
在「Kubernetes alpha features」(Kubernetes Alpha 版功能) 列中,按一下 edit「Edit configuration」(編輯設定)。
選取「在這個叢集中啟用 Kubernetes Alpha 版功能」。
詳閱警告訊息,然後選取「我瞭解上述影響」。
按一下「儲存」。
點選「建立」。
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 修補程式版本,請按照下列步驟操作:
找出搶鮮版中可用的 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 版。請改用其他區域,或查看快速版版本資訊,瞭解版本資訊。
建立 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 版本的相容性。接著,請再次嘗試建立叢集。