適用於: ✔️ 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。
你也需要
fleetAzure CLI 擴充功能。 要安裝它,請執行以下指令:az extension add --name fleetaz extension update執行 命令以更新至發行的最新版本的延伸模組:az extension update --name fleet
安裝最新版的 Azure CLI。 若要安裝或升級,請參閱安裝 Azure CLI。 你可以使用 Azure CLI 來驗證 Terraform 所建立的更新策略。
你也需要
fleetAzure 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"
建立更新策略
更新策略包含一或多個階段,其中階段可以包含一或多個更新群組。
建立 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%")。 若未包含,系統會套用預設值。 有關系統如何解析這些值及其上限的詳細資訊,請參閱「最大並行數」。- 該
使用將
--stages旗標設定為 JSON 檔案名稱的指令,建立新的更新策略az fleet updatestrategy create。az fleet updatestrategy create \ --resource-group $GROUP \ --fleet-name $FLEET \ --name $STRATEGY \ --stages example-labels-strategy.json
使用更新群組建立更新策略
你可以在更新策略中選擇叢集,將它們指派到單一更新群組。 定義一個更新策略,將這些更新群組分配到階段。 在更新階段內,更新會平行套用至每個更新群組。 在更新群組內,成員叢集會循序更新。
附註
車隊成員只能是一個更新群組的一部分,但更新群組可以指派多個車隊成員。 更新群組本身不是個別的資源類型。 更新群組只是代表機群成員參考的字串。 因此,如果所有參考同一更新群組的艦隊成員都被刪除,該特定更新群組也將不再存在。
指派叢集以更新群組
在將成員叢集新增至機群時指派給群組
使用 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
將現有的車隊成員指派給更新群組
使用 az fleet member update 命令 --update-group 將現有的機隊成員指派給更新群組,並將旗標設定為更新群組的名稱。
az fleet member update \
--resource-group $GROUP \
--fleet-name $FLEET \
--name member1 \
--update-group group-1
建立更新策略
更新策略包含一或多個階段,其中階段可以包含一或多個更新群組。
在 Azure 入口網站 中,流覽至您的 Azure Kubernetes Fleet Manager 資源。
從服務功能表,於 [設定] 底下,選取 [多重叢集更新]> [策略],然後選取 [建立]。
輸入策略的名稱。
第一次檢視頁面時,會顯示更新策略說明圖表,以協助可視化策略的運作方式。
選取 [ 建立階段 ],然後輸入:
- 階段名稱 ——為階段命名——必須在策略中所有階段名稱中唯一。
- (選填)階段核准 - 如果您想在此階段開始前或完成後等待核准,請選擇此選項。 如需詳細資訊,請參閱 新增核准以更新群組和階段。
- (可選)階段後暫停 - 若您希望在進入下一階段前定義暫停,請選擇此選項。
- (可選)暫停時間 - 選擇預先定義的持續時間,或輸入自訂的秒數值。
將一個或多個 更新群組 指派到該階段,然後選擇 建立。
附註
每個更新階段的更新群組數目上限為 50。
在此案例中,我們會建立階段和群組,以符合用於 Azure 入口網站流程的詳細資料。
建立 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%")。 關於這些數值如何解決,請參閱 「最大允許失敗次數(預覽)」。使用
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 程式碼
附註
本文的範例程式代碼位於 Azure Terraform GitHub 存放庫中。 查看包含 目前及先前版本 Terraform 測試結果的日誌檔案。
建立一個目錄來測試範例 Terraform 程式碼,並將其設為目前的目錄。
建立名為
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 {} }建立名為
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" } }建立名為
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" } } }建立名為
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 }將範例
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 以及此範例所建立的資源群組,而非僅是策略本身。 在執行這個指令前,先確認資源群組中沒有你想保留的其他資源。
下一步
您可以使用更新策略作為手動更新執行或自動升級配置檔的一部分。 請參閱: