代管控制層現代化

在支援終止期限前,您必須將 Cloud Service Mesh 機群從已淘汰的 ISTIOD 控制層實作,翻新為 TRAFFIC_DIRECTOR 實作。您可以自行安排現代化作業,也可以在組織符合條件後,讓 Google 自動安排。

現代化途徑有兩種,您也可以混合搭配:

  • 客戶觸發的翻新作業 (自助式):您可以使用 Google Cloud CLI 自行啟動及控制機群翻新作業的確切時間,不受 Google 驅動的排程影響。
  • Google 導向的翻新作業 (預設):Google 會評估機群相容性,並根據維護期間和提前通知,自動安排組織內的翻新作業。Google 會等到貴組織中的所有機群都相容,因此只要有一個不相容的機群,就會阻礙現代化。

無論選擇哪種途徑,都必須完成下列核心步驟,才能翻新控制層:

  1. 檢查相容性:啟用相容性檢查,瞭解機群是否與現代化作業相容。
  2. 規劃及設定現代化作業:選擇路徑、設定叢集和機群推出順序,或延遲特定機群。
  3. 修正相容性落差:確保機群符合所有相容性規定,再開始翻新。
  4. 啟動翻新作業:按照您的排程啟動客戶觸發的翻新作業,或等待 Google 安排排程。
  5. 主動叢集現代化:在設定的維護期間,雙控制層會並行運作,Deployment (工作負載和閘道) 會自動轉換至新的控制層。您必須手動重新啟動 StatefulSet 和 DaemonSet 工作負載。
  6. 監控狀態、觀察及完成:監控條件進度、解決任何停滯問題、在觀察期間 (至少 6 個工作天) 觀察工作負載,並在機群層級完成前提供完整復原支援。

檢查機群相容性並解決落差

無論是客戶觸發或 Google 驅動的現代化作業,機群都必須先經過驗證,確認相容後才能進行現代化作業。您必須啟用相容性報告,才能檢查潛在的阻礙條件,並修正設定落差。詳情請參閱「瞭解 Cloud Service Mesh 相容性」。

  • Google 導向現代化:Google 只會為所有非延遲機群都相容的組織排定時程。
  • 客戶觸發的翻新作業:您必須先確認目標機群回報 MODERNIZATION_COMPATIBLE,才能啟動翻新作業。

相容性檢查會評估機群的 Istio CRD 設定、Pod 註解、基礎架構依附元件 (例如 Workload Identity) 和規模參數。

處理不支援的功能

ISTIOD 控制層淘汰後, Google Cloud 將停止支援與TRAFFIC_DIRECTOR控制層實作不相容的功能。查看 API 支援詳細資料。

如果您使用不支援的功能,則必須在支援終止前採取下列任一行動 (請參閱「淘汰」):

  • 重構設定 (建議):移除不支援的欄位,或改用支援的 Cloud Service Mesh 替代方案,讓機群回報 MODERNIZATION_COMPATIBLE,然後改用 TRAFFIC_DIRECTOR 控制層實作。
  • 遷移至開放原始碼 (OSS) Istio:如果工作負載嚴格要求採用 TRAFFIC_DIRECTOR 託管 Cloud Service Mesh 不支援的功能,則無法將這些叢集現代化至 TRAFFIC_DIRECTOR。您必須將這些工作負載遷移至自行管理的開放原始碼 Istio。
  • 解除安裝 Cloud Service Mesh:您可以解除安裝代管 Cloud Service Mesh。

規劃及設定翻新作業

規劃機群翻新方式。如未執行這項操作,系統會以預設方式套用 Google 導向的現代化。您必須採取行動,確保非正式環境機群最先翻新,重要機群最後翻新。此外,在整個組織中,非延遲機群必須 100% 相容,Google 才會排定現代化作業,因此本機不相容可能會導致現代化作業受阻。

開始現代化之前,請先查看選項,並在貴組織的機群和叢集中,調整推出設定。

可用的路徑

做法 說明 適用情境 範圍 必要條件 提前告知 復原功能
客戶觸發的現代化 您可以按照自己的排程,逐一翻新機群。 精細控管機群現代化作業的時間 (由您決定何時啟動及復原機群層級)。運用現有的應用程式監控功能,在需要復原時發出警示。 逐一更新機群 (FLEET_PROJECT_ID)。 目標機群必須與現代化相容。 不適用。 使用 Google Cloud CLI 立即自助復原。
Google 導向的翻新作業 (預設) Google 會自動為整個組織排定現代化作業。 貴組織的所有機群都相容後,系統就會自動執行現代化作業。 整個 Google Cloud 組織 (所有非延遲機群)。 組織中所有非延遲機群都必須與現代化相容,並支援 Google 導向的現代化。 開始前 14 天以上發出機群通知,並在 24 小時前發出叢集通知。 如果標準化監控顯示錯誤,Google 會復原。如果應用程式監控顯示錯誤,請務必與 Cloud Customer Care 團隊聯絡。

管理組織中的多個機群

如果 Google Cloud 貴組織管理多個機群,則不需為所有機群選擇單一方法。您可以結合多種策略,例如:

  • 延後複雜或重要的機群:使用 --modernization-strategy deferred 將特定機群固定至舊版實作,以便在修復依附元件或規劃客戶觸發的執行作業時,將這些機群排除在 Google 驅動的排程之外。
  • 先在所選機群上由客戶觸發翻新作業:先翻新測試、開發或評估機群,按照自己的時間表驗證行為。
  • 允許 Google 翻新剩餘機群:任何相容、未延遲的機群仍會加入 Google 驅動的排程。

延後機群現代化 (選擇不採用)

如要讓個別機群退出 Google 導向的現代化作業,請將其策略設為 DEFERRED:

gcloud alpha container fleet mesh update \
  --modernization-strategy deferred \
  --project FLEET_PROJECT_ID

將 FLEET_PROJECT_ID 替換為機群主專案的 ID。

建議透過設定 --modernization-strategy deferred 執行下列操作:

  • 您打算自行安排時間,透過客戶觸發的現代化作業更新特定機群,因此不希望 Google 安排這些機群的更新作業。
  • 在修復依附元件時,暫時停止對複雜或重要機群進行現代化,讓組織中其他相容機群繼續執行 Google 驅動的排程。

請注意,系統仍會採用舊版專案標籤 mesh-modernization-mode=manual,但建議使用 --modernization-strategy deferred。貴機構中其他非延遲機群只要全部相容,仍可由 Google 安排排程。

設定推出作業順序

您可以使用 mesh-modernization-order 標籤 (early、default 或 late),控制叢集和機群的依序推出順序。

叢集推出順序 (適用於兩種路徑)

如果機群包含多個叢集,您可以為每個叢集套用 mesh-modernization-order 標籤,控制叢集現代化的順序。當您或 Google 觸發機群現代化作業時,每個叢集群組都會依序進行現代化作業,等待目前群組完成自動現代化作業步驟,再開始下一個群組:

gcloud container clusters update CLUSTER_NAME \
  --location LOCATION \
  --update-labels="mesh-modernization-order=VALUE"

將 CLUSTER_NAME 替換為叢集名稱,LOCATION 替換為叢集位置,VALUE 則替換為下列其中一項:

  • early:叢集會在第一波翻新作業中翻新。
  • default:叢集會在第二波翻新作業中翻新。
  • late:叢集會在第三波 (也是最後一波) 現代化作業中完成現代化。

機群推出順序 (僅限 Google 驅動)

如果組織有多個機群由 Google 進行現代化作業,您可以設定機群主專案的專案層級標籤,控管 Google 現代化機群的順序:

gcloud alpha projects update FLEET_PROJECT_ID \
  --update-labels="mesh-modernization-order=VALUE"

將 FLEET_PROJECT_ID 替換為機群主專案的 ID,並將 VALUE 替換為下列其中一項:

  • early:機群會在第一波翻新作業中翻新。
  • default:在第二波翻新作業中翻新機群。
  • late:在第三波 (也是最後一波) 翻新作業中,機群已完成翻新。

Google 會先完成各個機群級別的現代化作業,再開始下一個級別,順序為早期、預設 (和未標示),然後是晚期。標示為延遲的機群不包含在這個排序中。

舉例來說,您可以將非正式環境機群設為 early,將特別重要的機群設為 late,其他機群則保留預設值。

如果不使用 Google Cloud 組織,系統會獨立排定及翻新機群,您無法控制順序。

客戶觸發的現代化作業 (自助式)

客戶觸發的現代化作業可讓您直接控管個別機群的現代化作業啟動時間。

觸發機群翻新

目標機群回報MODERNIZATION_COMPATIBLE後,請使用下列指令觸發現代化作業:

gcloud alpha container fleet mesh update \
  --modernization-strategy automatic \
  --project FLEET_PROJECT_ID

將 FLEET_PROJECT_ID 替換為機群主專案的 ID。

  • 維護期間:Google 會遵守設定的叢集維護期間和排除時段。叢集現代化作業會在叢集的下一個開放維護期間開始。
  • 叢集排序:如果您在叢集上設定 mesh-modernization-order 標籤,Google 會遵循該排序。

監控進度

請按照「檢查現代化狀態」一文的操作說明,監控機群和叢集現代化進度。請監控應用程式,判斷是否需要復原,尤其是在 MODERNIZATION_PREPARING 和 MODERNIZATION_MIGRATING_WORKLOADS 狀態期間。

復原客戶觸發的翻新作業

如果在叢集現代化作業期間或機群浸潤期間 (機群層級完成前) 發現問題,可以立即觸發復原作業:

gcloud alpha container fleet mesh update \
  --modernization-strategy deferred \
  --project FLEET_PROJECT_ID

將 FLEET_PROJECT_ID 替換為機群主專案的 ID。

這會使機群處於延遲狀態,也就是不會列入 Google 導向現代化作業的考量。準備好重新嘗試翻新時,請重新執行指令,觸發機群翻新。

Google 導向的現代化 (自動預設)

如果您未啟動客戶觸發的現代化作業,Google 會自動管理整個組織的現代化作業。

機構層級排程

Google 會持續監控機群。在貴組織中,所有啟用網格的機群 (不含任何延遲機群) 都符合翻新條件 (MODERNIZATION_COMPATIBLE) 並支援 Google 導向的翻新作業後,Google 就會為貴組織安排翻新作業。

支援 Google 導向的現代化

某些條件會阻礙 Google 執行的翻新作業,並要求客戶觸發機群翻新作業。您會看到機群層級條件 MODERNIZATION_REQUIRES_CUSTOMER_TRIGGER,以及其他機群或叢集層級條件的詳細資料。

在您使用客戶觸發的現代化作業或延後機群,將該機群現代化之前,這項條件會封鎖 Google 驅動現代化作業的全組織排程。

提前通知和排程

在開始現代化之前,Google 會提供兩個層級的提前通知:

機群層級通知

首先,當系統判定您的機群適合翻新,並選定在日後由 Google 進行翻新時,您會收到通知。

  • 叢集翻新作業最快可在收到通知後,下個月第一個美國工作天起 14 天後開始。舉例來說,如果 Google 判定貴組織在 2027 年 1 月 10 日準備就緒,我們會在 2027 年 1 月 31 日前通知您,最早可開始現代化的日期是 2027 年 2 月 15 日。

  • 組織中的每個機群 (不含已延遲的機群) 都會同時收到通知。您可以在機群層級功能狀態條件 (MODERNIZATION_WILL_BE_SCHEDULED) 中查看這項通知。

叢集層級通知

在叢集現代化作業開始前至少 1 天 (24 小時),您會在叢集層級收到通知,得知 Google 預計開始對該叢集進行現代化作業的日期。

在機群層級通知後,您就能更精確地掌握個別叢集的現代化時間。您可以在叢集層級功能狀態條件 (MODERNIZATION_SCHEDULED) 中查看這項通知。

要求復原 Google 導向的翻新作業

如果在 Google 驅動的現代化機群上,主動現代化或浸泡期間發生問題,請與 Cloud Customer Care 聯絡,要求復原。

主動現代化期間會發生的情況

本節說明機群和叢集主動進行現代化作業時,會發生什麼情況。

翻新機群

對於每個進行現代化的機群 (無論是由 Google 驅動或由客戶觸發),我們會根據順序 (早期 → 預設 → 晚期),為所有叢集啟用新的控制層實作。

為所有叢集啟用控制層後,我們會根據順序 (早期 → 預設 → 晚期),將所有叢集的流量轉移至新的控制層實作。

如要查看目前狀態,請參閱「查看機群現代化狀態」。

機群過渡期

所有叢集的流量都轉移後,機群就會進入觀察期。所有叢集完成現代化後,機群會維持在過渡期 (MODERNIZATION_MODERNIZED) 至少 6 個工作天,然後才會轉換至 MODERNIZATION_FINALIZED。在觀察期內,系統會保留完整的復原功能。現代化作業完成後,就無法復原,且 ISTIOD 元件可能會取消佈建。

翻新叢集

在叢集現代化期間,兩個控制層實作會暫時並行,並以安全且受控的方式處理下列工作:

  1. 啟用新的控制層實作。如果您已為叢集設定維護期間,這項作業會在維護期間開始,並持續到完成為止。請留意下列細節:
    • 如要啟用健康狀態檢查,系統會在叢集的 kube-system 命名空間中建立 snk DaemonSet,並建立各叢集的防火牆規則。
    • 如要啟用網路端點群組 (NEG) 擷取功能,請將註解 cloud.google.com/neg 新增至所有 Kubernetes 服務。
    • 系統會在叢集中建立新的 Google Cloud 資源,例如網格、路徑、後端服務和健康狀態檢查。
    • 部分新資源有配額限制。您可以查看配額,並視需要要求更多配額。
    • 在浸泡時間內,系統會監控叢集,然後再進入下一個步驟。
  2. 將流量轉移至新的控制層實作。如果您為叢集設定了維護期間,這個步驟會在維護期間開始,並持續到完成為止。請留意下列細節:
    • Kubernetes Deployment 管理的 Pod 如果有 Cloud Service Mesh Proxy,就會重新啟動,以便重新連線至新的控制層。
    • Pod 會分批重新啟動,每批數量逐漸增加,並在每批重新啟動後進行浸泡時間以供監控。
  3. 手動重新啟動非 Deployment 工作負載 (客戶須採取行動)。

    • Google 會自動重新啟動由 Kubernetes Deployment 管理的工作負載。由其他類型 Kubernetes 資源 (例如 StatefulSet 或 DaemonSet) 管理的工作負載,則必須手動重新啟動。如果叢集包含這些工作負載,就會回報 MODERNIZATION_REQUIRES_MANUAL_WORKLOAD_RESTART 條件,機群則會回報 MODERNIZATION_REQUIRES_CUSTOMER_TRIGGER 條件。
    • 在主動叢集現代化期間,Deployment 工作負載重新啟動後,我們會回報 MODERNIZATION_AWAITING_MANUAL_WORKLOAD_RESTART 的叢集層級條件 (以及 MODERNIZATION_MIGRATING_WORKLOADS)。
    • 此時,您應手動重新啟動其餘工作負載,讓 Proxy 連線至 TRAFFIC_DIRECTOR 控制層實作。
    • Google 會等待至少 60 天,讓您重新啟動所有工作負載,然後才會繼續處理後續叢集 (在多叢集機群中),或啟動機群浸泡期。如果工作負載仍連結至 ISTIOD,將無法獲得支援。
    • 如要查看哪些 Proxy 仍連線至 ISTIOD,請執行 gcloud beta container fleet mesh debug proxy-status 指令,如「查看控制層狀態」所述。如果 Proxy 在指令輸出的 ISTIOD 欄中含有 Istiod 執行個體 ID,則仍會連線至 ISTIOD,且需要手動重新啟動。
    • 叢集中的所有網格工作負載連線至 TRAFFIC_DIRECTOR 後,MODERNIZATION_AWAITING_MANUAL_WORKLOAD_RESTART 和 MODERNIZATION_REQUIRES_MANUAL_WORKLOAD_RESTART 條件會自動清除,叢集狀態也會轉換為 MODERNIZATION_COMPLETED。
  4. 叢集中的所有工作負載都轉換完畢後,叢集會等待機群觀察期結束。

如要監控叢集的有效現代化狀態,請參閱「查看現代化狀態」。

查看現代化狀態並採取行動

您可以使用 Google Cloud CLI 監控機群和叢集的現代化進度:

gcloud container fleet mesh describe --project FLEET_PROJECT_ID

將 FLEET_PROJECT_ID 替換為機群主專案的 ID。

輸出內容大致如下:

  membershipStates:
    projects/123456789/locations/global/memberships/cluster-1:
      servicemesh:
        conditions:
        - code: MODERNIZATION_MIGRATING_WORKLOADS
          documentationLink: https://cloud.google.com/service-mesh/docs/...
          severity: INFO
  state:
    servicemesh:
      conditions:
      - code: MODERNIZATION_MODERNIZING
        documentationLink: https://cloud.google.com/service-mesh/docs/...
        severity: INFO

現代化狀態會回報在 state.servicemesh.conditions (機群層級) 和 membershipStates.<MEMBERSHIP_NAME>.servicemesh.conditions (叢集層級) 欄位中:

成功翻新機群的狀態

如果機群翻新成功,機群狀態會從 MODERNIZATION_MODERNIZING 開始。

每個叢集都會經歷以下狀態:

  • MODERNIZATION_SCHEDULED
  • MODERNIZATION_PREPARING
  • MODERNIZATION_PREPARED
  • MODERNIZATION_MIGRATING_WORKLOADS
  • (選用) MODERNIZATION_MIGRATING_WORKLOADS 搭配 MODERNIZATION_AWAITING_MANUAL_WORKLOAD_RESTART
  • MODERNIZATION_COMPLETED

機群中的所有叢集都完成現代化後,機群會經歷以下狀態:

  • MODERNIZATION_MODERNIZED
  • MODERNIZATION_FINALIZED

復原

Google 導向的現代化作業會在整個現代化過程中監控部署作業的準備程度和健康狀態,並在偵測到問題時自動觸發復原作業。如果發現問題,請與 Cloud Customer Care 聯絡,要求復原。

如果是客戶觸發的現代化作業,您隨時可以觸發復原作業。

復原期間,機群會顯示 MODERNIZATION_ROLLING_BACK_FLEET 狀態,叢集則會顯示 MODERNIZATION_ROLLING_BACK_CLUSTER 狀態。

叢集復原完成後,會暫時顯示 MODERNIZATION_ABORTED 狀態。

處理錯誤和停滯 (僅限客戶觸發)

在客戶觸發的現代化作業期間,如果叢集遇到問題而無法繼續,其條件會轉換為 MODERNIZATION_STALLED。Google 不會針對客戶觸發的現代化作業觸發復原。您必須分類問題,並決定要修正問題,還是觸發復原。

當叢集回報 MODERNIZATION_STALLED 時,請檢查條件詳細資料,取得相關錯誤區段的直接連結:

使用者可採取行動的錯誤

如果偵測到不相容的網格或叢集設定,就會停止現代化作業。請確認已啟用相容性回報功能,並檢查機群和叢集層級條件是否有落差,詳情請參閱「瞭解 Cloud Service Mesh 相容性」。

  • 立即重試:解決阻礙後,系統會偵測到變更並立即恢復現代化作業,不會等到下一個維護期間。

內部錯誤

Google 工程師會審查內部 Google 服務問題,並在可能的情況下繼續現代化作業。請注意,現代化作業可能會在維護期間以外的時間恢復,就像使用者可採取行動的錯誤一樣。如要避免這種情況,您可以觸發復原。

如果現代化作業停滯超過 24 小時,且沒有相容性落差,請與 Cloud Customer Care 聯絡,瞭解詳情。如果正式環境工作負載受到影響,請觸發復原作業。

機群層級條件參考資料

條件 說明
MODERNIZATION_COMPATIBLE 機群與新的控制層實作相容。
MODERNIZATION_REQUIRES_CUSTOMER_TRIGGER 機群現代化作業必須由客戶觸發,Google 無法自動排程。
MODERNIZATION_WILL_BE_SCHEDULED Google 導向的現代化作業:組織中所有非延遲機群都相容,並已排入排程佇列。
MODERNIZATION_MODERNIZING 機群中有一或多個叢集正在進行現代化作業。
MODERNIZATION_MODERNIZED 所有叢集都已完成主動現代化作業。機群處於浸潤期。
MODERNIZATION_FINALIZED 現代化作業已完成並定案。系統會移除舊版 Istiod 元件。無法再復原。
MODERNIZATION_ROLLING_BACK_FLEET 正在復原機群。

叢集層級條件參考資料

條件 說明
MODERNIZATION_REQUIRES_MANUAL_WORKLOAD_RESTART 叢集包含非 Deployment 網格工作負載 (例如 StatefulSet 或 DaemonSet),Cloud Service Mesh 無法自動重新啟動這類工作負載,必須在現代化期間手動重新啟動。
MODERNIZATION_SCHEDULED 叢集預定在條件指定的日期或之後進行現代化。如果叢集已設定維護期間/排除時段,日期會指出目標維護期間。
MODERNIZATION_PREPARING 啟用新的控制層實作。
MODERNIZATION_PREPARED 已啟用新的控制層實作。尚未開始遷移工作負載。
MODERNIZATION_MIGRATING_WORKLOADS 叢集正在將工作負載遷移至新的控制層。
MODERNIZATION_AWAITING_MANUAL_WORKLOAD_RESTART 自動化工作負載遷移作業已完成。重新啟動非 Deployment 網格工作負載 (例如 StatefulSet、DaemonSet 或工作),讓 Proxy 連線至 TRAFFIC_DIRECTOR 控制層實作。
MODERNIZATION_COMPLETED 叢集已完成翻新,目前處於觀察期。
MODERNIZATION_STALLED 現代化作業因錯誤而停滯 (僅限客戶觸發)。請查看條件詳細資料,瞭解解決方法。
MODERNIZATION_ROLLING_BACK_CLUSTER 叢集正在復原。
MODERNIZATION_ABORTED 叢集已復原至舊版控制層。回報時間不長。