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

適用於: ✔️ Fleet Manager ✔️ 具有中樞叢集的 Fleet Manager

管理員可以透過定義一系列階段和群組來控制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。 若要安裝或升級,請參閱安裝 Azure CLI。

  • 你也需要 fleet Azure CLI 擴充功能。 要安裝它,請執行以下指令:

    az extension add --name fleet
    

    az extension update執行 命令以更新至發行的最新版本的延伸模組:

    az extension update --name fleet
    
  • 安裝並設定 Terraform。

  • 安裝最新版的 Azure CLI。 若要安裝或升級,請參閱安裝 Azure CLI。 你可以使用 Azure CLI 來驗證 Terraform 所建立的更新策略。

  • 你也需要 fleet Azure CLI 擴充功能。 要安裝它,請執行以下指令:

    az extension add --name fleet
    

    執行 az extension update 指令更新到擴充功能最新版本。

    az extension update --name fleet
    
  • 本文所用的 Terraform 範例會建立自己的資源群組,並建立一個沒有樞紐叢集的 Azure Kubernetes 艦隊管理器。 它不會以艦隊成員身份加入任何AKS群體。 樣本的更新策略參考更新群組名稱 group-1、 group-2、 group-3。 若要讓此策略套用至實際更新執行作業,請將現有的 Fleet 成員叢集指派給這些更新群組名稱,或編輯範例中的 group 區塊,使其符合你自己的更新群組名稱。

為您的策略選擇叢集

有兩種方法可以選擇每個階段和群組中包含哪些叢集,以控制更新順序:

  • 成員標籤(建議):為每個艦隊成員指派標籤,並使用 memberSelector 依據這些標籤選擇成員。 每個成員可以有多個標籤。
  • 更新群組:為每個艦隊成員指派一個更新群組,然後在您的策略中定義符合這些群組名稱的群組。 每位成員只能屬於一個團體。

使用成員選擇器建立更新策略

在更新策略中,使用成員標籤來選擇叢集。 它們提供了更多彈性。 關於概念細節,請參見 使用成員標籤的群組群集。

對成員叢集套用標籤

在將成員叢集加入到集群時套用標籤

使用 az fleet member create 指令為你的艦隊成員套用標籤。 以下範例將兩個標籤應用於成員叢集: env=staging 和 tier=frontend:

az fleet member create \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name member1 \
    --member-cluster-id $CLUSTERID \
    --labels "env=staging tier=frontend"

為現有車隊成員套用標籤

使用 az fleet member update 指令為你的艦隊成員套用標籤。

az fleet member update \
 --resource-group $GROUP \
 --fleet-name $FLEET \
 --name member1 \
 --labels "env=staging tier=frontend"

建立更新策略

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

  1. 建立 JSON 檔案,以定義更新執行的階段和群組。 階段會依它們出現在 JSON 檔案中的順序循序執行。 每個階段內的群組會平行運行。 以下範例檔案(example-labels-strategy.json)定義了一種策略,採用兩個階段 memberSelector ,透過標籤選擇叢集,並包含可選 maxConcurrency 設定:

    • 該 staging 階段使用階段層 memberSelector 級選擇所有帶有標籤 env=staging 的叢集,並建立一個隱含群組。
    • 該 production 階段使用階段層 memberSelector 級對所有帶有標籤 env=production的叢集進行預過濾,然後定義兩個群組,每組有自己的 memberSelector 群組,以依標籤 tier 選擇叢集。

    當 memberSelector 被設定在群組時,該群組的 name 欄位僅用作顯示識別碼,以供狀態報告和日誌之用,並不再用於根據更新群組來選擇車隊成員。

    {
        "stages": [
            {
                "name": "staging",
                "memberSelector": { "byLabel": "env=staging" },
                "maxConcurrency": "1",
                "afterStageWaitInSeconds": 600
            },
            {
                "name": "production",
                "memberSelector": { "byLabel": "env=production" },
                "maxConcurrency": "4",
                "groups": [
                    {
                        "name": "frontend",
                        "memberSelector": { "byLabel": "tier=frontend" },
                        "maxConcurrency": "3"
                    },
                    {
                        "name": "backend",
                        "memberSelector": { "byLabel": "tier=backend" },
                        "maxConcurrency": "3"
                    }
                ]
            }
        ]
    }
    

    附註

    該 maxConcurrency 欄位為可選,控制在階段或群組層級可同時升級的叢集數量。 使用較大的數值以加快整個車隊的叢集升級速度,或使用較小的數值以更受控地部署,減少問題發生時的影響。

    當一個階段使用 memberSelector 但沒有群組(例如 staging),所有匹配的成員會組成一個隱含的群組,該階段的 maxConcurrency 控制項會直接並行。 當你定義群組(例如 production),階段層級 maxConcurrency 會作為所有群組的整體上限。

    在此範例中,staging 階段將 maxConcurrency 設定為 "1",因此暫存階段叢集會逐個升級。 該production階段允許最多"4"個叢集同時存在,且frontend與backend各群的限制為"3"。

    數值可以是固定整數(例如 "3"),或百分比(例如 "50%")。 若未包含,系統會套用預設值。 有關系統如何解析這些值及其上限的詳細資訊,請參閱「最大並行數」。

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

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

使用更新群組建立更新策略

你可以在更新策略中選擇叢集,將它們指派到單一更新群組。 定義一個更新策略,將這些更新群組分配到階段。 在更新階段內,更新會平行套用至每個更新群組。 在更新群組內,成員叢集會循序更新。

附註

車隊成員只能是一個更新群組的一部分,但更新群組可以指派多個車隊成員。 更新群組本身不是個別的資源類型。 更新群組只是代表機群成員參考的字串。 因此,如果所有參考同一更新群組的艦隊成員都被刪除,該特定更新群組也將不再存在。

指派叢集以更新群組

在將成員叢集新增至機群時指派給群組

  1. 在 Azure 入口網站 中,流覽至您的 Azure Kubernetes Fleet Manager 資源。

  2. 從服務功能表中的 [設定] 底下,選取 [

    Azure Kubernetes Fleet Manager Azure 入口網站頁面的螢幕截圖,用於新增成員叢集。

  3. 選取您要新增的叢集,然後選取 [下一步:檢閱 + 新增]。

  4. 輸入您要指派叢集的更新群組名稱,然後選取 [ 新增]。

    Azure Portal 頁面的螢幕截圖,針對 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

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

  1. 在 Azure 入口網站 中,流覽至您的 Azure Kubernetes Fleet Manager 資源。

  2. 從服務功能表中的 [設定] 底下,選取 [成員叢集]。

  3. 選取您要指派給更新群組的叢集,然後選取 [ 指派更新群組]

    Azure 入口網站頁面的螢幕截圖,用於將現有成員叢集指派給群組。

  4. 輸入您要指派叢集的更新群組名稱,然後選取 [ 指派]。

    Azure 成員叢集入口網站頁面的螢幕擷圖,顯示更新成員叢集群組的表單。

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

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

建立更新策略

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

  1. 在 Azure 入口網站 中,流覽至您的 Azure Kubernetes Fleet Manager 資源。

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

  3. 輸入策略的名稱。

  4. 第一次檢視頁面時,會顯示更新策略說明圖表,以協助可視化策略的運作方式。

    Azure 入口網站的截圖,顯示更新策略的建立過程。

  5. 選取 [ 建立階段 ],然後輸入:

    • 階段名稱 ——為階段命名——必須在策略中所有階段名稱中唯一。
    • (選填)階段核准 - 如果您想在此階段開始前或完成後等待核准,請選擇此選項。 如需詳細資訊,請參閱 新增核准以更新群組和階段。
    • (可選)階段後暫停 - 若您希望在進入下一階段前定義暫停,請選擇此選項。
    • (可選)暫停時間 - 選擇預先定義的持續時間,或輸入自訂的秒數值。

    Azure 入口網站的螢幕截圖,顯示建立 Azure Kubernetes Fleet Manager 更新策略階段的過程。

  6. 將一個或多個 更新群組 指派到該階段,然後選擇 建立。

    附註

    每個更新階段的更新群組數目上限為 50。

    Azure 入口網站的截圖,顯示建立 Azure Kubernetes Fleet Manager 更新策略階段,選取要包含的更新群組。

在此案例中,我們會建立階段和群組,以符合用於 Azure 入口網站流程的詳細資料。

  1. 建立 JSON 檔案,以定義更新執行的階段和群組。 階段會依它們出現在 JSON 檔案中的順序循序執行。 群組會在每個階段內平行執行,因此順序並不重要。 以下範例檔案(example-stages.json)定義了一套包含兩個階段的策略,並包含可選 maxConcurrency 與 maxAllowedFailures 設定:

    {
        "stages": [
            {
                "name": "stage-1",
                "maxConcurrency": "7",
                "maxAllowedFailures": "2",
                "groups": [
                    {
                        "name": "group-1",
                        "maxConcurrency": "3",
                        "maxAllowedFailures": "1"
                    },
                    {
                        "name": "group-2",
                        "maxConcurrency": "50%",
                        "maxAllowedFailures": "25%"
                    }
                ],
                "afterStageWaitInSeconds": 300
            },
            {
                "name": "stage-2",
                "maxConcurrency": "100%",
                "maxAllowedFailures": "0",
                "groups": [
                    {
                        "name": "group-3",
                        "maxConcurrency": "2",
                        "maxAllowedFailures": "0"
                    }
                ]
            }
        ]
    }
    

    maxConcurrency

    該 maxConcurrency 欄位為可選,控制在階段或群組層級可同時升級的叢集數量。 用較大的數值來加快整個艦隊的叢集升級,或用較小的數值來控制部署,限制爆炸範圍,以防出現問題。

    在此範例中,將 stage-1 設定 maxConcurrency 為 "7",允許最多此 "7" 階段的叢集同時升級。 在 stage-1 內,group-1 將並發限制到 "3" 個叢集,意味著該群組中最多有 "3" 個可同時升級。 group-2 允許最多 "50%" 其中一個叢集同時升級(例如,若群組包含 4 個叢集,最多可同時升級 2 個叢集)。

    數值可以是固定整數(例如 "3"),或百分比(例如 "100%")。 若未包含,系統會套用預設值。 有關這些值如何解析及其上限的詳細資訊,請參閱 「最大並發性」。

    maxAllowedFailures

    該 maxAllowedFailures 欄位為可選,控制容忍多少成員叢集升級失敗,直到群組或階段被標記為失敗。 預設情況下(當未設定或 "0"時),單一失敗將停止整個更新執行。

    此設定僅評估失敗次數。 它並不強制執行最低成功率。 因此,即使部分或全部成員失敗,只要 Fleet 做出排程決策時失敗門檻未被超過,該群組或階段仍可在 Completed 中結束。

    在此範例中,stage-1 將 maxAllowedFailures 設為 "2",可容忍整個階段中最多兩個成員失效。 在 stage-1內,容group-1忍失敗並"1"容group-2忍其成員失敗(例如,若群組包含 4 個叢集,最多容忍 "25%" 1 次失敗)。 stage-2 設定 maxAllowedFailures 為 "0",表示任何故障都會立即停止運行,且通常對生產階段有用。

    對大多數推出作業,建議優先使用以百分比為基礎的值,因為這類值在不同群組規模下有較佳的延展性。 除非你有意讓該區段呈現實際上「永不失敗」的行為,否則應避免將該值設為等於總成員數。

    數值可以是固定整數(例如 "3"),或百分比(例如 "25%")。 關於這些數值如何解決,請參閱 「最大允許失敗次數(預覽)」。

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

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

本節的 Terraform 範例建立了與前述 Azure CLI 範例相同的兩階段策略圖形: stage-1 contains group-1 和 group-2,並同步更新,接著等待 300 秒,然後stage-2更新group-3。 與 CLI JSON 範例不同,範例不會設定 maxConcurrency 或 maxAllowedFailures 在任何階段或群組,因此 Fleet 會套用預設值。 若要新增這些設定,請在 stage 中擴充 group 和 main.tf 區塊,並加入對應的 azurerm_kubernetes_fleet_update_strategy 參數。

檢視 Terraform 程式碼

  1. 建立一個目錄來測試範例 Terraform 程式碼,並將其設為目前的目錄。

  2. 建立名為 providers.tf的檔案,並插入下列程序代碼:

    terraform {
      required_version = ">= 1.9.0"
    
      required_providers {
        azurerm = {
          source  = "hashicorp/azurerm"
          version = "~> 4.77"
        }
        random = {
          source  = "hashicorp/random"
          version = "~> 3.0"
        }
      }
    }
    
    provider "azurerm" {
      features {}
    }
    
  3. 建立名為 variables.tf的檔案,並插入下列程序代碼:

    variable "location" {
      type        = string
      description = "Azure region where the resource group and Fleet Manager are created."
      default     = "eastus"
    }
    
    variable "resource_group_name" {
      type        = string
      description = "Name of the resource group. If null, a unique name is generated."
      default     = null
    }
    
    variable "fleet_name" {
      type        = string
      description = "Name of the Azure Kubernetes Fleet Manager. If null, a unique name is generated."
      default     = null
    }
    
    variable "update_strategy_name" {
      type        = string
      description = "Name of the Fleet update strategy."
      default     = "example-update-strategy"
    }
    
    variable "tags" {
      type        = map(string)
      description = "Tags to apply to created resources."
      default = {
        environment = "demo"
        managed_by  = "terraform"
      }
    }
    
  4. 建立名為 main.tf的檔案,並插入下列程序代碼:

    resource "random_string" "suffix" {
      length  = 6
      lower   = true
      numeric = true
      special = false
      upper   = false
    }
    
    locals {
      resource_group_name = coalesce(var.resource_group_name, "rg-fleet-update-strategy-${random_string.suffix.result}")
      fleet_name          = coalesce(var.fleet_name, "fleet-update-strategy-${random_string.suffix.result}")
    }
    
    resource "azurerm_resource_group" "example" {
      name     = local.resource_group_name
      location = var.location
      tags     = var.tags
    }
    
    resource "azurerm_kubernetes_fleet_manager" "example" {
      name                = local.fleet_name
      location            = azurerm_resource_group.example.location
      resource_group_name = azurerm_resource_group.example.name
      tags                = var.tags
    }
    
    resource "azurerm_kubernetes_fleet_update_strategy" "example" {
      name                        = var.update_strategy_name
      kubernetes_fleet_manager_id = azurerm_kubernetes_fleet_manager.example.id
    
      stage {
        name = "stage-1"
    
        group {
          name = "group-1"
        }
    
        group {
          name = "group-2"
        }
    
        after_stage_wait_in_seconds = 300
      }
    
      stage {
        name = "stage-2"
    
        group {
          name = "group-3"
        }
      }
    }
    
  5. 建立名為 outputs.tf的檔案,並插入下列程序代碼:

    output "resource_group_name" {
      description = "Name of the created resource group."
      value       = azurerm_resource_group.example.name
    }
    
    output "fleet_manager_id" {
      description = "Resource ID of the Azure Kubernetes Fleet Manager."
      value       = azurerm_kubernetes_fleet_manager.example.id
    }
    
    output "fleet_manager_name" {
      description = "Name of the Azure Kubernetes Fleet Manager."
      value       = azurerm_kubernetes_fleet_manager.example.name
    }
    
    output "update_strategy_id" {
      description = "Resource ID of the Fleet update strategy."
      value       = azurerm_kubernetes_fleet_update_strategy.example.id
    }
    
  6. 將範例terraform.tfvars.example檔案複製到terraform.tfvars同一個目錄,然後編輯 Azure 區域、資源群組名稱、艦隊名稱、更新策略名稱和你想使用的標籤值。

    cp terraform.tfvars.example terraform.tfvars
    

初始化、驗證並套用設定

執行 terraform init 來初始化 Terraform 部署。 此指令會下載管理 Azure 資源所需的 Azure 提供者。

terraform init

執行 terraform fmt 來穩定格式化設定檔。

terraform fmt

執行 terraform valid 以確認設定檔在語法上是否有效。

terraform validate

執行 terraform plan 以建立執行計畫。

terraform plan -out main.tfplan

執行terraform apply指令將執行計劃套用至您的雲端基礎設施。

terraform apply main.tfplan

驗證更新策略

從 Terraform 輸出取得資源群組和艦隊管理員名稱,並從輸出中提取策略名稱 update_strategy_id 。

resource_group_name=$(terraform output -raw resource_group_name)
fleet_manager_name=$(terraform output -raw fleet_manager_name)
update_strategy_name=$(terraform output -raw update_strategy_id | awk -F'/' '{print $NF}')

透過指令 az fleet updatestrategy show 顯示策略的階段與團隊。

az fleet updatestrategy show \
  --resource-group $resource_group_name \
  --fleet-name $fleet_manager_name \
  --name $update_strategy_name

指令輸出的 stages 陣列顯示,stage-1 具有 afterStageWaitInSeconds 和 group-2,且 group-1 值為 300;接著是具有 group-3 的 stage-2,與 main.tf 中定義的策略相符。

清理資源

執行 terraform plan 並搭配 -destroy 旗標,以建立銷毀執行計畫。

terraform plan -destroy -out main.destroy.tfplan

執行 terraform apply 以套用銷毀計畫。

terraform apply main.destroy.tfplan

Warning

此指令會刪除更新策略、Azure Kubernetes Fleet Manager 以及此範例所建立的資源群組,而非僅是策略本身。 在執行這個指令前,先確認資源群組中沒有你想保留的其他資源。

下一步

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