使用 Azure Kubernetes Fleet Manager 定義可重複使用的更新策略

發行項
12/04/2024

系統管理員可以藉由定義階段、群組和選擇性的階段間暫停，來控制佇列受控叢集的更新順序。這些序列可以儲存為可獨立管理更新執行或自動升級的更新策略，允許視需要重複使用策略。

本文說明如何使用群組和階段來定義更新策略。

必要條件

閱讀 Fleet 更新的概念概觀，其中提供本指南所參考更新執行、階段、群組和策略的說明。
您必須有一或多個成員叢集的 Fleet 資源。如果沒有，請遵循快速入門來建立機群資源，並將 Azure Kubernetes Service (AKS) 叢集加入為成員。

設定下列環境變數：

export GROUP=<resource-group>
export FLEET=<fleet-name>
export CLUSTERID=<aks-cluster-resource-id>
export STRATEGY=<strategy-name>

如果您遵循本文中的 Azure CLI 指示，您需要安裝 Azure CLI 2.61.0 版或更新版本。若要安裝或升級，請參閱安裝 Azure CLI。
您也需要 fleet Azure CLI 延伸模組，執行以下命令即可安裝:
```
az extension add --name fleet
```
az extension update執行命令以更新至發行的最新版本的延伸模組：
```
az extension update --name fleet
```

指派叢集以更新群組

在叢集可用於更新策略之前，必須將叢集新增至可在更新階段中使用的更新群組。在更新階段內，更新會平行套用至每個更新群組。在更新群組內，成員叢集會循序更新。

您可以使用下列兩種方式之一，將成員叢集指派給特定更新群組：

將成員叢集新增至車隊時，指派給群組。
將現有的機隊成員指派給更新群組。

注意

車隊成員只能是一個更新群組的一部分，但更新群組可以指派多個車隊成員。更新群組本身不是獨立的資源類型。更新群組只是代表機群成員參考的字串。因此，如果刪除參考通用更新群組的所有機群成員，則該特定更新群組也將不復存在。

在 Azure 入口網站中，流覽至您的 Azure Kubernetes Fleet Manager 資源。
從服務功能表中的 [設定] 底下，選取 [成員叢集>新增]。
選取您要新增的叢集，然後選取 [下一步：檢閱 + 新增]。
輸入您要指派叢集的更新群組名稱，然後選取 [ 新增]。

使用 az fleet member create 命令將成員叢集新增至佇列時，將成員叢集指派給更新群組，並將 --update-group 參數設定為更新群組的名稱。

az fleet member create \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name member1 \
    --member-cluster-id $CLUSTERID \
    --update-group group-1a

將現有的車隊成員指派給更新群組

Azure 入口網站
Azure CLI

在 Azure 入口網站中，流覽至您的 Azure Kubernetes Fleet Manager 資源。
從服務功能表中的 [設定] 底下，選取 [成員叢集]。
選取您要指派給更新群組的叢集，然後選取 [ 指派更新群組]
輸入您要指派叢集的更新群組名稱，然後選取 [ 指派]。

使用 az fleet member update 命令 --update-group 將現有的機隊成員指派給更新群組，並將旗標設定為更新群組的名稱。

az fleet member update \
 --resource-group $GROUP \
 --fleet-name $FLEET \
 --name member1 \
 --update-group group-1a

建立更新策略

更新策略包含一或多個階段，其中階段可以包含一或多個更新群組。

Azure 入口網站
Azure CLI

在 Azure 入口網站中，流覽至您的 Azure Kubernetes Fleet Manager 資源。
從服務功能表中的 [設定] 底下，選取 [多重叢集更新>策略]，然後選取 [建立]。
輸入策略的名稱。
第一次檢視頁面時，會顯示更新策略說明圖表，以協助可視化策略的運作方式。
選取 [ 建立階段 ]，然後輸入：
- 階段名稱 - 將階段命名為階段 - 在車隊中的所有階段名稱中都必須是唯一的。
- （選擇性）階段 后暫停 - 如果您想要在移至下一個階段之前定義暫停，請選取此選項。
- （選擇性）暫停持續時間 - 選取預先定義的持續時間，或以秒為單位輸入自定義值。
將一或多個 更新群組 指派給階段，然後選取 [ 建立]。

在此案例中，我們將建立階段和群組，以符合用於 Azure 入口網站程式的詳細數據。

建立 JSON 檔案，以定義更新執行的階段和群組。以下是階段檔案（example-stages.json）輸入的範例，代表透過 Azure 入口網站建立所顯示的策略：

{
    "stages": [
        {
            "name": "stage-1",
            "groups": [
                {
                    "name": "group-1"
                },
                {
                    "name": "group-2"
                }
            ],
            "afterStageWaitInSeconds": 300
        },
        {
            "name": "stage-2",
            "groups": [
                {
                    "name": "group-3"
                }
            ]
        }
    ]
}

使用命令建立新的更新策略，az fleet updatestrategy create--stages並將旗標設定為 JSON 檔案的名稱。

az fleet updatestrategy create \
 --resource-group $GROUP \
 --fleet-name $FLEET \
 --name $STRATEGY \
 --stages example-stages.json

下一步

您可以使用更新策略作為手動更新執行或自動升級配置檔的一部分。請參閱：

操作說明：使用 Azure Kubernetes Fleet Manager 更新執行升級多個叢集。
操作說明：使用 Azure Kubernetes Fleet Manager 自動升級多個叢集。

共用方式為