使用 Azure Kubernetes 機群管理員在多個叢集上更新 Kubernetes 和節點映像

適用於: ✔️ 車隊管理器 ✔️ 中樞叢集版車隊管理器

管理大量叢集的平台管理員經常會遇到以安全且可預測的方式分階段更新多個叢集 (例如,升級節點作業系統映像或 Kubernetes 版本) 的問題。 為了應對這項挑戰,Azure Kubernetes 機群管理員 (機群) 可讓您使用更新執行來協調跨多個叢集的更新。

更新執行由階段、群組和策略組成,可手動套用 (適用於一次性更新) 或自動套用 (適用於使用自動升級設定檔進行持續定期更新)。 所有更新執行 (手動或自動化) 都會接受成員叢集維護時間範圍。

本指南涵蓋如何設定及手動執行更新執行。

先決條件

  • 請參閱本功能的概念性概觀,說明本指南所參考之更新策略、執行、階段和群組。

  • 您必須擁有一個包含一或多個成員叢集的艦隊資源。 如果沒有,請遵循快速入門來建立機群資源,並將 Azure Kubernetes Service (AKS) 叢集加入為成員。

  • 設定下列環境變數:

    export GROUP=<resource-group>
    export FLEET=<fleet-name>
    
  • 如要遵循本文的 Azure CLI 指示,您需要安裝 Azure CLI 2.58.0 版或更新版本。 若要安裝或升級,請參閱安裝 Azure CLI。

  • 您也需要 fleet Azure CLI 延伸模組,執行以下命令即可安裝:

    az extension add --name fleet
    

    執行 az extension update 命令,更新為已發行的最新版本延伸模組:

    az extension update --name fleet
    

定義叢集升級順序

更新執行支援叢集升級順序的兩個選項:

  • 逐一:如果您不在意叢集升級順序的控制權,one-by-one 可提供簡單的方法讓您以一次一個的順序升級機群的所有成員叢集。
  • 使用更新群組和階段控制叢集的順序:如果您想要控制叢集升級順序,則可以在更新群組和更新階段中建構成員叢集。 您可以將此順序儲存為更新策略形式的範本。 您稍後可以使用更新策略來建立更新執行,而不用在每次需要建立更新執行時定義順序。

附註

  • 計畫維護時段: 更新執行會遵守你在 AKS 叢集層級設定的 計畫維護視窗 。 詳情請參閱 跨多個成員叢集的計畫維護 。
  • AKS 平台發起的升級: 若成員叢集在平台支援寬限期後仍維持在不受支援的 Kubernetes 版本,AKS 可直接升級,在 Fleet Manager 的更新執行序列之外,且不受叢集維護視窗限制。 請參閱 AKS 平台發起的升級, 了解如何將成員叢集置於艦隊協調之下。

逐一更新所有叢集

  1. 在 Azure 入口網站中,瀏覽至您的 Azure Kubernetes 機群管理員資源。

  2. 從服務功能表,於 [設定] 底下,選取 [多重叢集更新]> [建立執行]。

  3. 輸入更新執行的名稱,然後針對升級類型選取 [逐一]。

    Azure 入口網站窗格螢幕擷取畫面:建立更新執行,在 Azure Kubernetes 機群管理員中逐一更新叢集。

  4. 針對 [升級範圍] 選取下列其中一個選項:

    • 控制平面和節點集區的 Kubernetes 版本
    • 僅限叢集控制平面的 Kubernetes 版本
    • 僅限節點映像版本
  5. 針對 [節點映像] 選取下列其中一個選項:

    • [最新映像]:將更新執行中的每個 AKS 叢集更新至其區域中該叢集可用的最新映像。
    • [一致映像]:當更新執行有機會使用多個區域的 AKS 叢集時,最新可用的節點映像會不相同 (如需詳細資訊,請參閱發行版本追蹤器)。 更新執行會挑選所有這些區域中的最新通用映像,以達到一致性。

    重要

    節點映像版本僅有效於原始發布日起 90 天內。 若更新所選目標節點映像版本在成員叢集升級時已超過 90 天窗口,該成員叢集的升級可能會失敗。

    Azure 入口網站窗格螢幕擷取畫面:建立更新執行。顯示 [升級範圍] 區段。

  6. 選取 [建立] 以建立更新執行。

  1. 使用 az fleet updaterun create 命令搭配您選擇的 --upgrade-type 和 --node-image-selection 旗標值來建立更新執行。 下列命令會建立更新執行,以升級控制平面和節點集區的 Kubernetes 版本,並使用其區域中每個叢集可用的最新節點映像。

    --upgrade-type 旗標支援下列值:

    • Full 會升級控制平面和節點集區的 Kubernetes 版本以及節點映像。
    • ControlPlaneOnly 只會升級叢集控制平面的 Kubernetes 版本。
    • NodeImageOnly 只會升級節點映像。

    --node-image-selection 旗標支援下列值:

    • Latest:將更新執行中的每個 AKS 叢集更新至其區域中該叢集可用的最新映像。
    • Consistent:當更新執行有機會使用多個區域的 AKS 叢集時,最新可用的節點映像會不相同 (如需詳細資訊,請參閱發行版本追蹤器)。 更新執行會挑選所有這些區域中的最新通用映像,以達到一致性。
    az fleet updaterun create \
     --resource-group $GROUP \
     --fleet-name $FLEET \
     --name run-1 \
     --upgrade-type Full \
     --kubernetes-version 1.26.0 \
     --node-image-selection Latest
    
  2. 使用 az fleet updaterun start 命令啟動更新執行。

    az fleet updaterun start \
     --resource-group $GROUP \
     --fleet-name $FLEET \
     --name run-1
    

在建立更新執行時,您可以控制更新執行的範圍。 --upgrade-type 旗標支援下列值:

  • ControlPlaneOnly 只會升級叢集控制平面的 Kubernetes 版本。
  • Full 會升級控制平面和節點集區的 Kubernetes 版本以及節點映像。
  • NodeImageOnly 只會升級節點映像。

此外,--node-image-selection 旗標也支援下列值:

  • [最新]:將更新執行中的每個 AKS 叢集更新至其區域中該叢集可用的最新映像。
  • [一致]:當更新執行有機會使用多個區域的 AKS 叢集時,最新可用的節點映像會不相同 (如需詳細資訊,請參閱發行版本追蹤器)。 更新執行會挑選所有這些區域中的最新通用映像,以達到一致性。

重要

節點映像版本僅有效於原始發布日起 90 天內。 若更新所選目標節點映像版本在成員叢集升級時已超過 90 天窗口,該成員叢集的升級可能會失敗。

啟動更新執行:

若要啟動更新執行,請執行下列命令:

az fleet updaterun start \
 --resource-group $GROUP \
 --fleet-name $FLEET \
 --name <run-name>

使用群組和階段更新叢集

您可以使用更新階段定義更新執行,以便循序將更新套用至不同的更新群組。 例如,第一個更新階段可能會更新測試環境成員叢集,而第二個更新階段則會接著更新實際執行環境成員叢集。 您也可以指定每個階段之前或之後需要哪些核准,以及更新階段之間的等待時間。 您可以將此順序儲存為更新策略形式的範本。

  1. 在 Azure 入口網站中,瀏覽至您的 Azure Kubernetes 機群管理員資源。

  2. 從服務功能表,於 [設定] 底下,選取 [多重叢集更新]> [建立執行]。

  3. 輸入更新執行的名稱,然後選取 [階段] 作為更新順序類型。

    Azure 入口網站頁面的螢幕擷取畫面,用於選擇更新執行內的階段模式。

  4. 選取建立 階段,然後輸入階段的名稱,並視需要設定核准和階段之間的等待時間。

    Azure 入口網站頁面螢幕擷取畫面:建立階段與定義等候時間。

  5. 選取此階段要包含的更新群組。 如果您想要以特定順序更新群組,也可以指定更新群組的順序。 當您完成時,選取 [建立]。

    Azure 入口網站頁面螢幕擷取畫面:建立階段,顯示選取的升級群組。

  6. 針對 [升級範圍] 選取下列其中一個選項:

    • 控制平面和節點集區的 Kubernetes 版本
    • 僅限叢集控制平面的 Kubernetes 版本
    • 僅限節點映像版本
  7. 針對 [節點映像] 選取下列其中一個選項:

    • [最新映像]:將更新執行中的每個 AKS 叢集更新至其區域中該叢集可用的最新映像。
    • [一致映像]:當更新執行有機會使用多個區域的 AKS 叢集時,最新可用的節點映像會不相同 (如需詳細資訊,請參閱發行版本追蹤器)。 更新執行會挑選所有這些區域中的最新通用映像,以達到一致性。

    Azure 入口網站窗格螢幕擷取畫面:建立更新執行。顯示 [升級範圍] 區段。

  8. 選取 [建立] 以建立更新執行。

    每次建立更新執行時都指定階段及其順序,可能會讓工作變得重複且繁瑣。 更新策略可讓您儲存更新執行範本,以簡化此程序。 如需詳細資訊,請參閱更新策略的建立和使用。

  9. 在 [多叢集更新] 功能表中,選取更新執行,然後選取 [開始]。

  1. 建立 JSON 檔案以定義更新執行的階段和群組。 以下是階段檔案的輸入範例 (example-stages.json):

    {
        "stages": [
            {
                "name": "stage1",
                "maxAllowedFailures": "2",
                "groups": [
                    {
                        "name": "group-1a"
                    },
                    {
                        "name": "group-1b"
                    },
                    {
                        "name": "group-1c"
                    }
                ],
                "afterStageWaitInSeconds": 3600
            },
            {
                "name": "stage2",
                "groups": [
                    {
                        "name": "group-2a",
                        "maxAllowedFailures": "1"
                    },
                    {
                        "name": "group-2b"
                    },
                    {
                        "name": "group-2c"
                    }
                ]
            }
        ]
    }
    

    附註

    選擇性 maxAllowedFailures 欄位可控制在區段或群組層級上,於區段被標記為失敗之前,可容忍多少次成員叢集升級失敗。 當 unset 或 "0"時,任何單一失敗都會停止更新執行。

    此設定只評估失敗次數,而非成功率。 因此,即使部分或全部成員失敗,只要設定閾值未超過,群組仍可達標 Completed 。 運行結束後,務必檢視 FailureCount、 的會員狀態和失敗訊息。

    數值可以是固定整數(例如 "2"),或百分比(例如 "25%")。 更多資訊請參閱最大允許失敗次數(預覽)。

  2. 使用 az fleet updaterun create 命令並將 --stages 旗標設定為您的 JSON 檔案的名稱,以及您針對 --upgrade-type 和 --node-image-selection 旗標選擇的值,建立更新執行。 下列命令會建立更新執行,以升級控制平面和節點集區的 Kubernetes 版本,並使用其區域中每個叢集可用的最新節點映像。

    --upgrade-type 旗標支援下列值:

    • Full 會升級控制平面和節點集區的 Kubernetes 版本以及節點映像。
    • ControlPlaneOnly 只會升級叢集控制平面的 Kubernetes 版本。
    • NodeImageOnly 只會升級節點映像。

    --node-image-selection 旗標支援下列值:

    • Latest:將更新執行中的每個 AKS 叢集更新至其區域中該叢集可用的最新映像。
    • Consistent:當更新執行有機會使用多個區域的 AKS 叢集時,最新可用的節點映像會不相同 (如需詳細資訊,請參閱發行版本追蹤器)。 更新執行會挑選所有這些區域中的最新通用映像,以達到一致性。
    az fleet updaterun create \
     --resource-group $GROUP \
     --fleet-name $FLEET \
     --name run-1 \
     --upgrade-type Full \
     --kubernetes-version 1.26.0 \
     --node-image-selection Latest \
     --stages example-stages.json
    
  3. 使用 az fleet updaterun start 命令啟動更新執行。

    az fleet updaterun start \
     --resource-group $GROUP \
     --fleet-name $FLEET \
     --name run-1
    

使用更新策略建立更新執行

建立更新執行需要您每次指定階段、群組、順序。 更新策略可讓您儲存更新執行範本,以簡化此程序。

附註

您可以使用相同的更新策略建立各有唯一名稱的多個更新執行。

您可以使用下列其中一種方法來建立更新策略:

建立更新執行時儲存更新策略

  • 在 Azure 入口網站中建立更新執行時儲存更新策略:

    Azure 入口網站螢幕擷取畫面:顯示儲存為更新策略的更新執行階段。

管理更新執行

下列各節說明如何使用 Azure 入口網站 和 Azure CLI 來管理更新執行。

  • 在機群資源的 [多叢集更新] 頁面上,您可以 [啟動] 處於 [未啟動] 或 [失敗] 狀態的更新執行:

    Azure 入口網站的螢幕擷取畫面,顯示如何啟動處於 [未啟動] 狀態的更新執行。

  • 在叢集資源的 [多叢集更新] 頁面上,您可以 停止 目前 執行中 或 擱置中的 更新執行:

    Azure 入口網站的螢幕擷取畫面,顯示如何停止處於 [執行中] 狀態的更新執行。

  • 在處於 [未啟動]、[失敗] 或 [執行中] 狀態的任何更新執行內,您可以選取任何 [階段] 並 [略過] 升級:

    Azure 入口網站的螢幕擷取畫面,顯示如何在更新執行中略過特定階段的升級。

    同樣地,您也可以在更新群組或成員叢集層級略過升級。

  • 您可以使用 命令,[啟動] 處於 [未啟動] 或 [失敗]az fleet updaterun start 狀態的更新執行:

    az fleet updaterun start \
     --resource-group $GROUP \
     --fleet-name $FLEET \
     --name <run-name>
    
  • 您可以使用 命令,[停止] 目前 [執行中]az fleet updaterun stop 的更新執行:

    az fleet updaterun stop \
     --resource-group $GROUP \
     --fleet-name $FLEET \
     --name <run-name>
    
  • 您可以使用 --targets 命令在 az fleet updaterun skip 旗標中指定更新階段或群組,以略過這些項目:

    az fleet updaterun skip \
     --resource-group $GROUP \
     --fleet-name $FLEET \
     --name <run-name> \
     --targets Group:my-group-name Stage:my-stage-name
    

    如需詳細資訊,請參閱關於更新執行狀態的概念概觀和關於執行/階段/群組的略過行為。

使用自動升級設定檔自動執行更新

當新的 Kubernetes 或節點映像版本可供使用時,自動升級設定檔會用來自動執行跨成員叢集的更新執行。

如需設定自動升級設定檔的詳細資訊,請參閱使用 Azure Kubernetes 機群管理員自動升級 Kubernetes 和節點映像。

從自動更新設定檔產生更新執行

當您建立自動升級設定檔時,叢集可以位於各種版本的 Kubernetes 或節點映像上。 視您選取的自動升級通道而定,可能需要經過一段時間,新版本的發布才會觸發自動升級,以建立並執行更新作業。

自動升級可讓您隨時使用az fleet autoupgradeprofile generate-update-run命令生成新的更新運行。 產生的更新執行是以目前 AKS 發佈的 Kubernetes 或節點映射版本為基礎。

az fleet autoupgradeprofile generate-update-run \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name $AUTOUPGRADEPROFILE

產生的更新執行不會自動啟動,讓你可以檢視它。 如果你對產生的更新執行感到滿意,可以依照「 管理更新執行」中的步驟開始並管理它。

附註

當您從自動升級設定檔手動建立更新執行作業時,所產生的更新執行作業可能已存在。 之所以會發生這種情況,是因為更新執行作業的名稱取決於自動升級設定檔的升級規範,而該規範只有在節點映像或 Kubernetes 版本等屬性變更時才會變更。 在這種情況下,現有的更新執行不會被修改。

後續步驟