維護期間與排除時段

本頁面說明維護期間和維護排除項目,這些政策可讓您控管 Google Kubernetes Engine (GKE) 叢集何時可以及何時不能執行某些叢集維護作業,例如自動升級。舉例來說,零售業可將維護作業限制在平日晚上進行,並在重要產業特價活動期間禁止自動維護。

關於 GKE 維護政策

GKE 維護政策包含維護期間和排除時段,可讓您控管叢集自動維護作業的執行時間,包括叢集升級和其他節點設定變更,或叢集的 Network Topology。

「維護期間」是指可以自動執行 GKE 維護作業的一段週期性時間。

「維護作業排除項目」是指禁止自動執行 GKE 維護作業的一段非週期性時間。

如果維護期間已開始,而且您未設定維護作業排除時段,GKE 就會根據叢集的維護政策自動進行變更。您可以為每個叢集設定一個週期性維護期間,以及多個維護排除項目。

其他類型的維護作業不依賴 GKE 維護政策,包括控制層修復作業,以及 GKE 依賴的服務 (例如 Compute Engine) 的維護作業。詳情請參閱「不遵循維護政策的自動維護作業」。

哪些變更會遵循 GKE 維護政策,哪些不會

設定 GKE 維護政策 (維護期間和排除項目) 之前,請詳閱下列各節,瞭解 GKE 和相關服務是否會遵循這些政策。

自動維護作業會遵循 GKE 維護政策

您可以透過 GKE 維護政策,控管下列事件的發生時間,這些事件會暫時中斷叢集運作:

其他類型的自動維護作業則不受維護政策影響。詳情請參閱「不遵循維護政策的自動維護作業」。

不遵循 GKE 維護政策的自動維護作業

GKE 維護期間和排除項目不會封鎖所有類型的自動維護作業。設定 GKE 叢集的維護政策前,請務必瞭解哪些類型的變更不會遵循維護期間和排除項目。

其他 Google Cloud 維護

GKE 維護期間和排除項目不會阻止基礎 Google Cloud 服務 (主要是 Compute Engine) 或將應用程式安裝至叢集的服務 (例如 Cloud Deploy) 進行自動維護。

例如,GKE 節點是 GKE 為叢集管理的 Compute Engine VM。Compute Engine VM 有時會發生主機事件,包括維護事件或主機錯誤。VM 在這些事件期間的行為取決於 VM 的主機維護政策,根據預設,大多數 VM 的政策都是即時遷移。這通常表示節點幾乎不會停機,而且對大多數工作負載來說,預設政策已足夠。對於某些 VM 機器家族,您可以監控及規劃主機維護事件,並觸發主機維護事件,以便配合 GKE 維護政策。

建議您查看主機事件和主機維護政策的相關資訊,並確認工作負載已做好中斷準備,尤其是執行於無法執行即時遷移的節點上的工作負載。

自動修復及調整大小

GKE 會自動修復控制層。這包括將控制層擴充至適當大小,或重新啟動控制層來解決問題。大部分的修復作業都會忽略維護期間和排除時段,因為不執行修復作業可能會導致叢集無法運作。

您無法停用控制層修復功能。不過,大多數類型的叢集 (包括 Autopilot 叢集和標準區域叢集) 都有多個控制層副本,因此即使在維護事件期間,Kubernetes API 伺服器也能維持高可用性。Standard 可用區叢集只有一個控制層,因此在控制層設定變更和叢集維護期間無法修改。包括部署工作負載

節點也具備自動修復功能,您可以停用 Standard 叢集的這項功能。

重大安全漏洞修補

維護期間和排除時段可能會導致安全性修補程式延遲。不過,如果發生重大安全漏洞,GKE 有權覆寫維護政策。

維護以 Spanner 為基礎的叢集狀態資料庫

部分 GKE 叢集會使用 Spanner 鍵/值資料庫,儲存 Kubernetes API 資源的狀態。這個資料庫的維護作業會忽略任何有效的維護期間和排除時段。不過,Spanner 叢集狀態資料庫會複製,並在維護事件期間保持可用。

遵循 GKE 維護政策的手動變更

如要變更節點或網路設定,您必須重新建立節點,才能套用新設定,包括下列部分變更:

這些變更會遵循 GKE 維護政策,也就是說,GKE 會等待維護期間開始,且沒有任何有效的維護作業排除時段,才會進行節點維護。如要手動將變更套用至節點,請使用 Google Cloud CLI 呼叫 gcloud container clusters upgrade 指令,並傳遞 --cluster-version 旗標,以及節點集區已執行的相同 GKE 版本。

手動變更不符合 GKE 維護政策

部分手動變更會立即使用節點升級策略重新建立節點,而不遵循維護政策。詳情請參閱「手動變更,使用節點升級策略重新建立節點,而不遵循維護政策」。

維護期間

維護期間可讓您控管適用的自動維護作業 (包括控制層和節點的自動升級) 的執行時間,降低工作負載發生暫時性服務中斷的可能性。維護期間適用於下列類型的情境:

  • 離峰時段:安排在流量較小的離峰時段自動升級,盡可能降低停機機率。
  • 值班待命:一定要在工作時間內進行升級,以利相關人員監控升級作業並管理突發狀況。
  • 多叢集升級:按照指定的間隔,逐一升級分佈在不同地區的多個叢集。

除了自動升級之外,Google 有時可能需要執行其他維護工作,並盡可能遵守叢集的維護期間。

如果工作在維護期間結束後仍未完成,GKE 會嘗試暫停工作,並在下一個維護期間嘗試恢復工作。

GKE 保留權利,可在維護期間以外推出未排定的緊急升級。此外,如果軟體已淘汰或過時,系統可能會在維護期間外自動執行強制升級。

如要瞭解如何為新叢集或現有叢集設定維護期間,請參閱「設定維護期間」。

如果是進階用途,您也可以使用叢集 disruption budget,自訂特定類型叢集升級作業 (包括修補程式或子版本升級) 之間的最短時間間隔。

維護期間的時區

設定及查看維護期間時,時間會因使用的工具而異:

設定維護期間時

時間一律以世界標準時間儲存。不過,設定維護期間時,您可以使用世界標準時間或當地時區。

使用較通用的 --maintenance-window 旗標設定維護期間時,無法指定時區。使用 gcloud CLI 或 API 時,系統會採用世界標準時間,而 Google Cloud 控制台則會以當地時區顯示時間。

使用更精細的旗標 (例如 --maintenance-window-start) 時,您可以將時區指定為值的一部分。如果省略時區,系統會使用您的當地時區。

查看維護期間時

查看叢集相關資訊時,維護期間的時間戳記可能會以世界標準時間 (UTC) 或當地時區顯示,具體取決於您查看資訊的方式:

  • 使用 Google Cloud 控制台查看叢集相關資訊時,系統一律會以您所在時區顯示時間。
  • 使用 gcloud CLI 查看叢集相關資訊時,時間一律會以世界標準時間 (UTC) 顯示。

無論是哪一種情況,RRULE 一律以世界標準時間為準。也就是說,如果指定星期幾,則這些日期會以世界標準時間為準。

維護作業排除時段

您可以透過維護作業排除項目,禁止在特定時間範圍內執行適用的自動維護作業。舉例來說,許多零售業者的業務指南禁止在年底假期期間變更基礎架構。另一個例子是,如果公司使用的 API 即將淘汰,可以使用維護排除項目暫停次要升級,以便有時間遷移應用程式。

對於已知的高影響事件,建議您將任何內部變更限制與維護排除項目進行比對,該排除項目應在事件發生前一週開始,並持續到事件結束。

排除項目不會重複。請改為分別建立每個週期性排除項目。

如果排除時段和維護期間重疊,則以排除時段為準。

如要瞭解如何為新的或現有叢集設定維護作業排除時段,請參閱「設定維護作業排除時段」。

維護作業排除時段類型

您可以為整個叢集設定維護排除時段,也可以視需要為個別節點集區設定維護排除時段。請參閱下列各節,瞭解不同類型的維護排除作業如何運作。

叢集維護作業排除時段

在叢集層級,您可以指定何時禁止對叢集進行自動維護,以及可能發生的自動更新範圍。請參閱下列叢集維護排除範圍,以及相關情境範例:

  • 不升級 - 避免任何維護作業:您想在特定時間內暫時避免對叢集進行任何變更。這是預設範圍。
  • 不進行子版本升級 - 維持目前的 Kubernetes 子版本:您想維持叢集的子版本,例如避免 API 變更或驗證下一個子版本。
  • 不執行子版本或節點升級作業 - 避免節點中斷:您希望避免因節點升級而導致工作負載遭到淘汰及重新排程。

下表列出各範圍如何限制叢集控制層或節點的子版本或修補程式升級。

維護作業排除範圍、升級限制和排除時間長度上限
範圍 控制層:自動升級子版本 控制層:自動修補程式升級 節點:自動升級子版本 節點:自動修補程式升級 排除時間長度上限
不執行任何升級作業 (預設) 不允許 不允許 不允許 不允許 不得超過 90 天 (建議少於 30 天)。
不執行任何次要升級作業 不允許 已允許 不允許 已允許 直到子版本支援期結束,使用固定的結束時間或支援期結束追蹤 (建議少於六個月)。
不執行任何次要或節點升級作業 不允許 已允許 不允許 不允許 直到子版本支援期結束,使用固定的結束時間或支援期結束追蹤 (建議少於六個月)。

如果是「不執行子版本升級作業」和「不執行子版本或節點升級作業」範圍,您可以透過下列任一方式設定維護作業排除時段的結束時間:

GKE 升級叢集時,控制層和節點的 VM 會重新啟動。在控制層方面,Autopilot 和區域性 Standard 叢集會維持 Kubernetes API 伺服器的可用性。可用區叢集只有一個控制層節點,因此 VM 重新啟動時,控制層會暫時無法使用。如果是節點,VM 重新啟動會觸發 Pod 重新排程,這可能會暫時中斷現有的工作負載。您可以使用 Pod 中斷預算 (PDB) 設定工作負載中斷容許度。

節點集區維護作業排除時段

如要防止 Standard 叢集中的部分 (而非全部) 節點集區自動升級叢集節點,可以使用節點集區維護排除項目。舉例來說,如果叢集中的某些節點集區需要 GKE 自動升級節點,但其他節點集區需要您自行管理升級作業,則可只針對需要更多手動控制的節點集區設定排除項目。

啟用這類維護作業排除時段後,GKE 只會在節點集區的子版本支援期結束時,視需要自動升級叢集。詳情請參閱「支援終止後的自動升級作業」。

下表說明這項維護作業排除項目如何防止節點集區自動升級:

維護作業排除時段類型 節點 排除時間長度上限
自動子版本升級 自動修補程式升級
節點集區 不允許 不允許 結束時間會追蹤叢集子版本的支援終止時間。 如果您未在支援期結束前,手動將叢集升級至下一個子版本,GKE 會在支援期結束時執行必要的自動升級,然後重新啟用維護作業排除時段,並將結束時間設為新子版本的支援期結束時間。詳情請參閱「維護作業排除設定如何追蹤支援終止日期」。

如要使用這類維護排除作業,請執行下列任一操作:

排除條件到期和啟用

叢集維護作業排除時段會立即生效,或在您設定排除時段時指定的日期和時間生效。

維護作業排除時段會在下列時間到期或失效:

  • 固定結束時間:您為排除項目指定的固定結束時間已過。
  • 追蹤支援終止日期:如果叢集尚未升級至下一個子版本,且您以下列任一方式使用維護作業排除時段,則維護作業排除時段會在支援終止日期開始時暫時停用:

    • 設定叢集維護排除項目的結束時間,追蹤叢集子版本的支援終止日期。
    • 設定節點集區維護作業排除時段。

    發生下列任一情況後,GKE 會重新啟用維護作業排除時段:

維護作業排除時段到期 (即目前時間已超過排除時段指定的結束時間) 或暫時停用時,就不會再阻止 GKE 更新。其他仍有效的排除項目會繼續阻止 GKE 更新。

如果沒有排除項目或其他因素阻止叢集升級,GKE 會逐步將叢集升級至符合資格的自動升級目標。

如果叢集因排除時段而錯過多個子版本升級,GKE 會安排每月約一次的子版本升級,同時升級叢集控制層和節點,確保叢集執行支援的版本。您隨時可以手動升級,更快將叢集升級至特定子版本。

維護作業排除設定如何追蹤支援期結束時間

您可以設定叢集維護作業排除時段,範圍為「不執行子版本升級作業」或「不執行子版本或節點升級作業」,追蹤叢集子版本的支援終止日期,而非手動設定結束日期。節點集區維護作業排除設定也會追蹤支援期結束時間。

如果您設定其中一種維護排除類型來追蹤支援結束日期,則在下列情況下,GKE 會更新維護排除的結束時間,以反映新的支援結束日期:

  • 您或 GKE 將叢集升級至新的子版本。
  • 您將叢集註冊至 Extended 管道,或從 Extended 管道取消註冊叢集。
  • GKE 會更新叢集子版本的支援終止日期。

如果設定這類維護作業排除時段,但未手動將叢集升級至下一個子版本,GKE 就會在支援期結束時執行必要的自動升級,然後重新啟用維護作業排除時段,並根據新子版本的支援期結束時間,設定排除時段的結束時間。

如要進一步瞭解終止支援,請參閱「GKE 子版本生命週期」。如要查看叢集子版本的支援終止日期,請參閱「查看叢集子版本的支援終止日期」。

在支援結束時,暫時緊急防止自動升級

在沒有其他選擇的緊急情況下,您可以設定維護作業排除時段,並將預設範圍設為「不執行任何升級作業」,將支援終止時的自動升級作業延後最多 90 天,做為臨時措施。我們不建議這麼做,因為執行不支援的版本會有相關風險。維護排除期結束後,GKE 會升級叢集。

如果叢集使用的 GKE 版本不受支援,則會面臨重大的安全性、可靠性和相容性風險,因為 GKE 不會為終止支援的版本提供安全性修補程式或修正錯誤。GKE 無法承諾為終止支援的版本提供修補程式或更新。

詳情請參閱「支援終止時自動升級」。

維護排除作業與設定推出作業序列範圍的運作方式

如果您使用自訂階段的推出作業排序功能,可以指定 GKE 執行自動叢集升級的範圍,類似於維護排除項目。不過,使用推出排序時,您會為推出排序中的所有叢集設定這些範圍,而不是為具有維護排除項目的個別叢集設定。如果叢集位於推出作業序列中,且您也設定了維護排除項目,GKE 會在執行叢集自動升級作業時,遵守更嚴格的範圍。舉例來說,如果您允許 GKE 在維護作業排除時段執行控制層修補程式升級,但不允許在推出序列的範圍內執行,GKE 就不會執行這類升級。詳情請參閱「選擇 GKE 在推出序列中執行的升級類型」。

設定維護作業排除時段的限制

叢集維護作業排除時段有下列限制:

  • 您只能在維護排除項目中,限制已註冊發布管道的叢集自動升級範圍。如果是未註冊發布管道的叢集 (已淘汰),您只能建立預設「不升級」範圍的維護作業排除時段。
  • 您最多可以新增三個排除所有升級作業的維護排除時段 (即「不執行升級作業」的範圍)。設定這些排除項目時,必須在 92 天的滾動週期內,保留至少 48 小時的維護時間。
  • 每個叢集最多可有 20 個叢集維護排除項目。
  • 如未在排除條件中指定範圍,系統會預設為「不升級」。
  • 設定維護作業排除時段時,不得包含或超過叢集註冊的發布管道對應子版本的支援終止日期,除非是暫時性的緊急措施,且範圍為「不執行升級作業」。如要將固定結束時間設在支援終止日期前後,請參考以下範例:

    • 叢集在穩定版中執行子版本,而 GKE 發布時間表指出 Standard 支援服務結束日期為 2025 年 6 月 5 日。維護作業排除時段的結束時間必須設為 2025-06-05T00:00:00Z或更早。
    • 某個叢集在擴充頻道中執行子版本,GKE 發布時間表指出擴充支援結束日期為 2026 年 4 月 5 日。維護作業排除時段的結束時間必須設為 2026-04-0500:00:00Z或更早。如要將叢集的發布管道變更為其他管道,請務必變更維護排除作業的結束時間,以免超過 Standard 支援服務期。詳情請參閱「變更擴充版中的叢集」。

    您可以選擇讓排除設定追蹤支援期結束日期,這樣一來,排除設定就會在支援期結束日期開始時暫時停用,直到叢集升級至下一個子版本為止。

節點集區維護作業排除時段有下列限制:

  • 叢集必須在發布管道註冊。
  • 每個節點集區只能設定一個節點集區維護排除項目。
  • 您無法將節點集區維護作業排除時段設為在未來日期和時間開始。啟用後,維護排除作業會立即開始。
  • Autopilot 叢集的節點由 GKE 管理,因此您無法對 Autopilot 叢集使用節點集區維護排除項目。
  • 節點集區維護作業排除項目只會防止節點升級 (版本更新),不會防止其他類型的節點更新。

維護作業排除時段不會影響手動升級和新節點的版本

維護作業排除項目可防止現有控制層和節點自動升級,具體取決於維護作業排除項目的範圍。不過,維護作業排除項目無法防止下列變更:

  • 手動升級叢集的控制層或節點。
  • 建立新的 Standard 節點集區,版本比現有 Standard 節點集區新,且維護作業排除項目會防止自動升級。
  • 自動佈建節點功能建立下列資源,版本比現有節點新,但維護作業排除時段禁止自動升級:
    • 新的 Standard 節點集區。
    • Autopilot 叢集中的新節點。

假設您為叢集建立維護作業排除時段,並設定 GKE 自動將控制層 (而非節點) 升級至後續修補程式版本的範圍。在這種情況下,GKE 可能會建立新的節點集區,或透過自動佈建建立節點,執行較新的控制層修補程式版本。

叢集節點只能執行與控制層相同或更早的 GKE 版本。維護作業排除項目可防止現有節點自動升級。如果控制層的版本高於現有節點,則新建立或手動升級的節點,可能會執行比因維護排除項目而無法自動升級的節點更新的 GKE 版本。

多項排除條件

您可以為叢集設定多個排除項目,包括節點集區排除項目。這些排除項目可以有不同的範圍和重疊的日期範圍。年末節慶季節用途是重疊排除項目的範例,其中同時使用「不升級」和「不執行子版本升級作業」範圍。

如果排除項目重疊,且有任何有效的排除項目 (即目前時間在排除時間範圍內) 封鎖升級,升級作業就會延後。

以年末節慶季節用途為例,叢集指定了下列排除項目:

  • 不執行任何次要升級作業:9 月 30 日至 1 月 15 日
  • 不執行升級作業:11 月 19 日至 12 月 4 日
  • 不執行升級作業:12 月 15 日至 1 月 5 日

由於這些排除時段重疊,叢集將無法執行下列升級作業:

  • 11 月 25 日對節點集區進行修補程式升級 (因「不執行升級作業」排除條件而遭拒)
  • 12 月 20 日對控制層進行子版本升級 (遭「不執行子版本升級作業」和「不執行升級作業」排除項目拒絕)
  • 12 月 25 日對控制層進行修補程式升級 (因「不升級」排除項目而遭拒)
  • 1 月 1 日對節點集區進行次要升級 (因「不執行次要升級」和「不執行升級」排除條件而遭拒)

叢集可進行下列維護作業:

  • 11 月 10 日對控制層執行修補程式升級 (「不執行子版本升級」排除項目允許這項作業)
  • 12 月 10 日因 GKE 維護作業而導致 VM 中斷 (「不執行子版本升級」排除項目允許)

使用範例

以下舉例說明如何限制更新範圍。

範例:零售商準備迎接年末節慶檔期

在這個例子中,零售商不希望在銷售量最高的時期發生中斷,也就是從黑色星期五到網購星期一的四天,以及 12 月到新年開始。為了因應購物季,叢集管理員設定了下列排除條件:

  • 不執行子版本升級:9 月 30 日至 1 月 15 日期間,只允許在控制層和節點上執行修補程式更新。
  • 不執行任何升級作業:11 月 19 日至 12 月 4 日期間,凍結所有升級作業。
  • 不執行升級作業:12 月 15 日至 1 月 5 日期間,凍結所有升級作業。

如果維護作業排除時段到期時,沒有其他適用的排除時段,則在 9 月 30 日至 1 月 6 日之間,叢集會升級至新的 GKE 子版本 (如有)。

範例:公司在 Kubernetes 中使用即將移除的 Beta 版 API

在這個範例中,某公司使用 CustomResourceDefinition apiextensions.k8s.io/v1beta1 API,但該 API 將在 1.22 版中移除。當公司執行 1.22 之前的版本時,叢集管理員會設定下列排除項目:

  • 不執行子版本升級作業:將客戶應用程式從 apiextensions.k8s.io/v1beta1 遷移至 apiextensions.k8s.io/v1 時,凍結子版本升級作業三個月。

範例:公司的舊版資料庫無法彈性升級節點集區

在這個範例中,某公司執行的資料庫在節點集區升級期間,對 Pod 淘汰和重新排程作業的回應不佳。叢集管理員設定下列排除項目:

  • 不執行子版本或節點升級作業:凍結節點升級作業三個月。當公司準備好接受資料庫停機時,就會觸發手動節點升級。

範例:公司混合執行一般用途和容錯工作負載

在這個範例中,某公司使用一個叢集執行混合工作負載,其中有些工作負載可以容忍節點自動升級,有些則不行。叢集管理員希望 GKE 處理部分節點集區的節點升級作業,但不處理其他節點集區。叢集管理員會針對只能手動升級的節點集區,使用節點集區維護排除項目。

後續步驟