使用發布管道

平台管理員可以為叢集選擇特定發布版本，確保 GKE 會自動將叢集升級至合適的版本，在可用功能與穩定性之間權衡。如要進一步瞭解發布管道，請參閱「關於發布管道」。

GKE 會將所有 Autopilot 叢集註冊至發布管道，並預設將 Standard 叢集註冊至發布管道。您可以為所有叢集模式選擇特定發布管道。對於 Standard 叢集，您可以選擇不將叢集註冊至發布管道，但這項設定選項已淘汰，並將於 2027 年 6 月 14 日移除。

本頁面說明如何對發布管道執行下列操作：

• 在特定發布管道中註冊叢集。
• 找出叢集的發布管道。
• 查看發布版本的預設版本和可用版本。
• 變更叢集的發布管道。
• 取消叢集註冊發布版本。

事前準備

開始之前，請確認您已完成下列工作：

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

• 如要在延長版註冊叢集，請務必先詳閱延長支援服務的價格。以 GKE 叢集來說，如果叢集註冊於延長版，叢集的子版本也進入延長支援期限，就會按照用量計費。

在發布管道中註冊叢集

本節說明如何為新叢集選取特定發布管道，或為先前未使用發布管道的現有叢集選取發布管道。您也可以變更已註冊發布管道的現有叢集。

在特定發布管道中註冊新叢集

根據預設，所有叢集都會註冊「一般」發布管道。建立叢集時，您可以選擇叢集的特定發布管道，也可以在叢集建立後變更發布管道。Autopilot 叢集必須註冊發布管道。Standard 叢集可以註冊或取消註冊發布管道。如要使用「延長版」管道，請先參閱「透過延長版管道取得長期支援」。

您可以使用Cloud de Confiance 控制台或 gcloud CLI，在特定發布管道中建立及註冊新叢集。

gcloud container clusters create-auto CLUSTER_NAME \
    --location=COMPUTE_LOCATION
    --release-channel=CHANNEL

gcloud container clusters create CLUSTER_NAME \
    --location=COMPUTE_LOCATION \
    --release-channel=CHANNEL

在特定發布管道中註冊現有叢集

以下說明如何將未註冊發布管道的現有叢集註冊至發布管道。如果叢集已停用節點自動升級功能，請參閱「為未註冊發布管道且已停用節點自動升級功能的現有叢集註冊」。

請按照下列步驟，在發布管道中註冊叢集：

1. 選擇發布管道：選擇穩定版，或更符合您需求的管道。穩定版是最成熟的管道，且所有子版本都適用於未註冊管道的叢集。如要盡早使用新功能，或需要子版本的延長支援服務，請按照下列步驟操作：
   1. 為叢集選擇最合適的發布管道。
   2. 查看發布管道的預設和可用版本，確認叢集的控制層子版本是否適用於目標發布管道。只要叢集的控制層子版本適用於目標發布管道，您就能註冊現有叢集。如要進一步瞭解如何將叢集的控制層版本與目標發布管道的可用版本保持一致，請參閱「變更叢集的發布管道」。
2. 考慮使用維護期間和排除時段：GKE 變更叢集的發布管道註冊時，不需要任何停機時間。不過，GKE 可能會在不同的發布管道中提供不同的自動升級，這表示變更後，GKE 可能會自動升級叢集。建議使用維護期間和排除時段來控管升級時間。
3. 將叢集發布管道更新為目標版本CHANNEL：選取目標發布管道，可以是 None 以外的任何選項。

註冊時，GKE 不會立即將叢集控制層和節點升級至該發布管道的自動升級目標子版本。而是由 GKE 自動升級程序逐步升級。如要取得特定叢集的自動升級目標，請參閱「取得叢集升級資訊」。

註冊已停用節點自動升級功能的現有叢集

如果現有 Standard 叢集未註冊發布管道，且您已停用一或多個叢集節點集區的節點自動升級功能，請按照下列操作說明進行。如要存取發布管道的其他功能，並從這個已淘汰的設定選項遷移，您可以將叢集加入發布管道，不必進行任何額外變更。

將叢集註冊至管道時，GKE 不會自動為節點集區啟用節點自動升級設定。無論如何，這項設定是舊版設定，將叢集註冊至管道時，我們也建議您使用節點集區維護排除時段，以相同方式防止節點集區層級的節點集區升級。

如要在發布管道中註冊現有叢集，請按照下列步驟操作：

1. 透過更新管道，並指定 stable，將現有叢集註冊到目標發布管道。穩定版是發展最成熟的管道，適用於未註冊管道的叢集。
2. 選用：如要改用維護排除條件，而非透過設定停用節點自動升級的舊版設定，請完成下列額外步驟。在發布管道中註冊叢集後，隨時可以執行下列步驟：
   1. 如要避免節點自動升級，請採取下列其中一種做法：
      1. 僅適用於部分節點集區：為已停用節點自動升級功能的所有節點集區設定節點集區維護作業排除時段。停用節點自動升級功能並設定排除時段後，系統就不會自動升級任何節點集區，但支援期限結束時的自動升級除外。無論您是否已註冊發布管道，以及如何停用節點自動升級功能，系統都會在支援期限結束時自動升級。
      2. 針對所有節點集區：設定維護排除項目，範圍為「不執行任何次要或節點升級作業」。這項排除作業會禁止所有升級作業，但控制層的修補程式升級除外。叢集註冊發布管道後，您就可以使用這個維護排除範圍，最長可持續到叢集發布管道中子版本的支援期限為止。
   2. 移除用於停用節點自動升級的舊版欄位，因為您在上一個步驟中設定的維護排除項目，現在會執行這項功能。針對每個節點集區，按照操作說明為現有節點集區啟用節點自動升級功能。

找出叢集的發布管道

您可以使用 Cloud de Confiance 控制台或 gcloud CLI，判斷叢集的發布管道。

gcloud container clusters describe CLUSTER_NAME \
    --location=COMPUTE_LOCATION --format="value(releaseChannel.channel)"

查看發布管道的預設版本和可用版本

如要使用Cloud de Confiance 控制台或 gcloud CLI，查看特定發布管道可用的版本，請按照操作說明查看可用和預設版本。

變更叢集的發布管道

如果目標發布管道提供控制層的次要版本，您就可以變更叢集的發布管道。您可能需要將叢集的控制層升級或降級至可用版本。

如要檢查叢集的控制層版本是否適用於目標發布管道，請查看發布管道的預設和可用版本。目標管道必須提供該版本。

• 如果叢集的控制層版本已在目標發布版本中提供，您可以選取新的發布版本。
• 如果叢集的控制層版本不適用於目標發布管道，您可以將叢集的控制層升級至適用版本。或者，如果目標管道只有較舊的版本，只要目標版本是同一次要版本的較舊修補程式版本，您就可以降級叢集。

如要選取新的發布版本，請將叢集發布版本更新為目標 CHANNEL。如要在選取新管道時暫時禁止叢集自動升級，請先設定維護排除項目，再選取新管道。

如果叢集執行的版本不適用於目標發布管道，您就無法選取該版本。此時，您可以採取下列做法：

1. 設定維護作業排除時段，範圍為「不得執行子版本升級作業」。
2. 等待目標發布管道提供叢集的 Kubernetes 子版本。
3. 在目標發布管道中註冊現有叢集。

或者，您也可以在目標管道中建立新叢集，然後遷移工作負載。

將叢集變更為延長版

如要取得長期支援，盡可能讓叢集維持在該版本，請在延長版註冊叢集。

請務必詳閱將叢集註冊至擴充管道的定價，以及功能限制。如果叢集使用特定功能，就無法註冊至擴充管道。

將叢集從延長版變更為其他版本

如果叢集在延長支援期間註冊延長版，叢集可以繼續執行其他管道不支援的子版本。如要將叢集從延長版變更為不支援子版本的管道，請按照下列步驟操作：

1. 請完成下列兩個步驟，順序不拘：
   1. 手動將叢集升級至標準支援期內可用的子版本，該版本位於目標發布管道。
   2. 移除或修改任何維護作業排除時段，確保結束日期不會超過較新支援子版本的標準支援結束日期。
2. 更新叢集的發布管道。

更新叢集發布管道

您可以使用 Cloud de Confiance 控制台或 gcloud CLI 變更叢集的發布管道。

gcloud container clusters update CLUSTER_NAME \
  --release-channel CHANNEL

取消訂閱發布管道

雖然您可以在 2027 年 6 月 14 日前，取消訂閱標準叢集的發布管道，但這項設定選項已淘汰，因此強烈建議您參閱這篇文章，比較已註冊和未註冊發布管道的叢集。請務必瞭解在發布管道註冊叢集與否的取捨。

您可以使用 Cloud de Confiance 控制台、gcloud CLI 或 GKE API 執行這項操作。您也可以指定在建立叢集時，不要將 Standard 叢集加入發布管道。Autopilot 叢集無法取消訂閱發布管道。

gcloud container clusters update CLUSTER_NAME \
  --release-channel None

找出未註冊發布管道的叢集

如果您有未註冊發布管道的 GKE Standard 叢集，且所有節點集區都已啟用節點自動升級功能，GKE 建議您將叢集註冊至發布管道，並透過 Recommender 服務提供洞察資訊和建議。這項指南不適用於 Autopilot 叢集，因為這類叢集一律會註冊加入發布管道。

如要找出未註冊發布管道的叢集，請使用下列任一方式：

• 使用 Cloud de Confiance 控制台。
• 使用 gcloud CLI 或 Recommender API，並指定 CLUSTER_RELEASE_CHANNEL_UNSPECIFIED recommender 子類型。

如需操作說明，請參閱這篇文章，瞭解如何查看洞察資料和建議。

如要導入這項建議，請按照操作說明註冊現有叢集。如要進一步瞭解是否要導入這項建議，請參閱「關於發布管道」。如要比較已註冊和未註冊發布管道的叢集功能，請參閱已註冊和未註冊發布管道的叢集比較。

使用加速修補程式自動升級功能

您可以啟用加速修補程式自動升級，讓 GKE 在發布管道推出修補程式版本時，立即自動升級叢集，而不是等到 GKE 將這些版本設為自動升級目標 (至少一週後) 才升級。

如要使用加速修補程式自動升級功能，請在建立叢集或更新叢集時，使用 gcloud CLI 設定 --patch-update=accelerated 旗標。

這項設定僅適用於在發布管道中註冊的叢集，且不會影響子版本升級。

停用加速修補程式自動升級功能

您可以更新叢集，停用叢集的加速修補程式自動升級功能，這樣一來，叢集只會在 GKE 將修補程式版本設為自動升級目標後，才會收到修補程式版本。這項動作會將叢集還原為預設設定，但不會停用自動升級功能。

如要更新叢集，請設定 --patch-update=default 旗標。

後續步驟

• 發布版本簡介