Automatisera uppgraderingar av Kubernetes- och nodavbildningar i flera kluster med Azure Kubernetes Fleet Manager

• Ange följande miljövariabler som ska användas i Azure CLI-kommandona:

  export GROUP=<resource-group>
  export FLEET=<fleet-name>
  export AUTOUPGRADEPROFILE=<upgrade-profile-name>
  # Optional
  export STRATEGYID=<strategy-id>
  export CLUSTER=<aks-cluster-name>
  

• Installera den senaste Azure CLI versionen. Information om hur du installerar eller uppgraderar finns i Installera Azure CLI.

• Installera det senaste fleet Azure CLI tillägget. az extension add Använd kommandot för att installera tillägget.

  az extension add --name fleet
  

  az extension update Använd kommandot för att uppdatera till den senaste versionen av tillägget.

  az extension update --name fleet
  

• Installera och konfigurera Terraform.

• Installera den senaste Azure CLI versionen. Information om hur du installerar eller uppgraderar finns i Installera Azure CLI. Du använder Azure CLI för att verifiera den profil för automatisk uppgradering som Terraform skapar.

• Installera det senaste fleet Azure CLI tillägget. az extension add Använd kommandot för att installera tillägget.

  az extension add --name fleet
  

  az extension update Använd kommandot för att uppdatera till den senaste versionen av tillägget.

  az extension update --name fleet
  

• Terraform-exemplet som används i den här artikeln skapar en egen resursgrupp och Azure Kubernetes Fleet Manager och ansluter inte några AKS-kluster som medlemmar i flottan. Om du vill använda den resulterande profilen för automatisk uppgradering mot verkliga uppdateringskörningar ansluter du befintliga AKS-kluster som medlemmar i flottan när du har tillämpat exemplet. Mer information finns i snabbstarten.

Skapa profiler för automatisk uppgradering

Skapa profiler för automatisk uppgradering med kommandot az fleet autoupgradeprofile create.

Du kan inaktivera en profil för automatisk uppgradering genom att inkludera --disabled flaggan med az fleet autoupgradeprofile create kommandot . Om du vill återaktivera en inaktiverad profil för automatisk uppgradering kör du kommandot az fleet autoupgradeprofile create igen utan flaggan --disabled.

Kubernetes-uppdateringar för stabil kanal

Uppdatera till den senaste kubernetes-korrigeringsversionen som stöds på delversion N-1, där N är den senaste delversionen som stöds.

Uppdatera medlemskluster en i taget

Uppdatera medlemskluster sekventiellt med hjälp az fleet autoupgradeprofile create av kommandot .

az fleet autoupgradeprofile create \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --name $AUTOUPGRADEPROFILE \
  --channel Stable

Uppdatera medlemskluster med hjälp av en befintlig uppdateringsstrategi

Uppdatera medlemskluster med hjälp av en befintlig uppdateringsstrategi. az fleet autoupgradeprofile create Använd kommandot med parametern --update-strategy-id inställd på ID för den befintliga uppdateringsstrategin.

az fleet autoupgradeprofile create \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --name $AUTOUPGRADEPROFILE \
  --update-strategy-id $STRATEGYID \
  --channel Stable

Uppdatera medlemskluster med hjälp av en befintlig uppdateringsstrategi med konsekvent nodavbildning

Uppdatera medlemskluster med hjälp av en befintlig uppdateringsstrategi och se till att samma nodavbildningsversion används i varje Azure region. Använd kommandot az fleet autoupgradeprofile create med parametern --node-image-selection inställd på Consistent. Alla medlemskluster kör samma nodbildversion.

az fleet autoupgradeprofile create \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --name $AUTOUPGRADEPROFILE \
  --update-strategy-id $STRATEGYID \
  --channel Stable \
  --node-image-selection Consistent

Uppdatera medlemskluster med hjälp av en befintlig uppdateringsstrategi med den senaste nodavbildningen

Uppdatera medlemskluster med hjälp av en befintlig uppdateringsstrategi och se till att den senaste tillgängliga nodavbildningsversionen används för varje Azure region. Använd kommandot az fleet autoupgradeprofile create med parametern --node-image-selection inställd på Latest. Medlemskluster kan köra flera nodavbildningsversioner.

az fleet autoupgradeprofile create \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --name $AUTOUPGRADEPROFILE \
  --update-strategy-id $STRATEGYID \
  --channel Stable \
  --node-image-selection Latest

Uppdateringar av nodbildkanal

Uppdatera noder med en nyligen korrigerad datorbild som innehåller säkerhetskorrigeringar och felkorrigeringar.

Uppdatera nodbilder en i taget

Uppdatera nodavbildningar för medlemskluster sekventiellt med hjälp az fleet autoupgradeprofile create av kommandot .

az fleet autoupgradeprofile create \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --name $AUTOUPGRADEPROFILE \
  --channel NodeImage

Uppdatera nodbilder med hjälp av en befintlig uppdateringsstrategi

Uppdatera nodavbildningar för medlemskluster med hjälp av en befintlig uppdateringsstrategi. az fleet autoupgradeprofile create Använd kommandot och ange parametern --update-strategy-id till ID för den befintliga uppdateringsstrategin.

az fleet autoupgradeprofile create \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --name $AUTOUPGRADEPROFILE \
  --update-strategy-id $STRATEGYID \
  --channel NodeImage 

Uppdateringar av Kubernetes-måldelversion

Uppdatera till en definierad kubernetes-målversion med hjälp av parametern --target-kubernetes-version . Ange versionen i {huvudversionen}.{ delversion} format (till exempel 1.33). Automatisk uppgradering av Fleet Manager uppgraderar automatiskt medlemskluster till den senaste korrigeringsversionen av den angivna målversionen när korrigeringen är tillgänglig.

Uppdatera medlemskluster till en specifik Kubernetes-delversion

Uppdatera medlemskluster till en specifik delversion av Kubernetes med kommandot az fleet autoupgradeprofile create och parametern --target-kubernetes-version inställd på den önskade versionen. I följande exempel uppdateras medlemskluster till Kubernetes version 1.33.

az fleet autoupgradeprofile create \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --name $AUTOUPGRADEPROFILE \
  --channel TargetKubernetesVersion \
  --target-kubernetes-version "1.33"

Uppdatera medlemskluster med LTS aktiverat till en specifik Kubernetes-delversion

Uppdatera medlemskluster med LTS aktiverat till en specifik Kubernetes-delversion genom att använda kommandot az fleet autoupgradeprofile create med parametern --target-kubernetes-version inställd på den önskade versionen och flaggan --long-term-support aktiverad. I följande exempel uppdateras medlemskluster till Kubernetes version 1.29 med LTS aktiverat.

az fleet autoupgradeprofile create \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --name $AUTOUPGRADEPROFILE \
  --channel TargetKubernetesVersion \
  --target-kubernetes-version "1.29" \
  --long-term-support

Uppdateringar av säkerhetskorrigeringskanalen

Uppdatera Linux-noder med säkerhetskorrigeringar. Tillämpa uppdateringar med hjälp av live-korrigering när det är möjligt. Annars distribuerar du en nyligen korrigerad datorbild som innehåller säkerhetskorrigeringar.

Uppdatera noder med säkerhetskorrigeringar en i taget

Uppdatera nodavbildningar för medlemskluster sekventiellt med hjälp az fleet autoupgradeprofile create av kommandot .

az fleet autoupgradeprofile create \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --name $AUTOUPGRADEPROFILE \
  --channel SecurityPatch

Uppdatera noder med säkerhetskorrigeringar med hjälp av en befintlig uppdateringsstrategi

Uppdatera nodavbildningar för medlemskluster med hjälp av en befintlig uppdateringsstrategi. az fleet autoupgradeprofile create Använd kommandot och ange parametern --update-strategy-id till ID för den befintliga uppdateringsstrategin.

az fleet autoupgradeprofile create \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --name $AUTOUPGRADEPROFILE \
  --update-strategy-id $STRATEGYID \
  --channel SecurityPatch 

Visa profiler för automatisk uppgradering

Profiler för automatisk uppgradering är resurser på fleet-nivå. De är inte direkt kopplade till enskilda AKS-kluster. Om du vill ta reda på vilka profiler som kan uppdatera dina AKS-kluster anger du först medlemmarna i flottan och bekräftar att klustren är medlemmar i flottan.

az fleet member list \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --query "[].{memberName:name,clusterResourceId:clusterResourceId}" \
  --output table

Visa en lista över alla profiler för automatisk uppgradering för flottan med kommandot az fleet autoupgradeprofile list .

az fleet autoupgradeprofile list \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --output table

Visa en specifik profil för automatisk uppgradering för flottan med kommandot az fleet autoupgradeprofile show . Granska kanalen, status och updateStrategyId i utmatningen.

az fleet autoupgradeprofile show \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --name $AUTOUPGRADEPROFILE

Om updateStrategyId är tom använder profilen uppdateringssekvensen En i taget och inkluderar Fleet-medlemsklustren i tur och ordning. Om updateStrategyId innehåller ett resurs-ID visar du den refererade strategin för att granska de steg, grupper eller medlemsväljare som avgör vilka Fleet-medlemmar som ingår i de genererade uppdateringskörningarna.

PROFILE_STRATEGY_ID=$(az fleet autoupgradeprofile show \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --name $AUTOUPGRADEPROFILE \
  --query updateStrategyId \
  --output tsv)

if [[ -n "$PROFILE_STRATEGY_ID" ]]; then
  az fleet updatestrategy show \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name "${PROFILE_STRATEGY_ID##*/}"
fi

Ta bort en profil för automatisk uppgradering

az fleet autoupgradeprofile delete Använd kommandot för att ta bort en befintlig profil för automatisk uppgradering. När du har kört det här kommandot uppmanas du att bekräfta borttagningen. Om du vill kringgå bekräftelsen och omedelbart ta bort profilen tar du med --yes i kommandot .

az fleet autoupgradeprofile delete \
  --resource-group $GROUP \
  --fleet-name $FLEET \
  --name $AUTOUPGRADEPROFILE

Skapa profiler för automatisk uppgradering

Terraform-exemplet i det här avsnittet skapar en resursgrupp, en Azure Kubernetes Fleet Manager (utan hubbkluster) och en profil för automatisk uppgradering av fleet. Som standard använder profilen kanalen Latest med nodbildsvalet Stable och är aktiverad. Ange variablerna auto_upgrade_channel, node_image_selection, auto_upgrade_disabled, target_kubernetes_versionoch long_term_support så att de matchar kanalen och alternativen som beskrivs i föregående avsnitt. Exemplet anger ingen uppdateringsstrategi, så den resulterande profilen använder alltid uppdateringssekvensen En efter en .

Granska Terraform-koden

1. Skapa en katalog för att testa Terraform-exempelkoden och gör den till den aktuella katalogen.

2. Skapa en fil med namnet providers.tfoch infoga följande kod:

   terraform {
     required_version = ">= 1.9.0"
   
     required_providers {
       azurerm = {
         source  = "hashicorp/azurerm"
         version = "~> 4.0"
       }
       azapi = {
         source  = "Azure/azapi"
         version = "~> 2.0"
       }
       random = {
         source  = "hashicorp/random"
         version = "~> 3.0"
       }
     }
   }
   
   provider "azurerm" {
     features {}
   }
   
   provider "azapi" {
   }
   

3. Skapa en fil med namnet variables.tfoch infoga följande kod:

   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 "auto_upgrade_profile_name" {
     type        = string
     description = "Name of the Fleet auto-upgrade profile. If null, a unique name is generated."
     default     = null
   }
   
   variable "auto_upgrade_channel" {
     type        = string
     description = "Auto-upgrade channel used by the profile."
     default     = "Stable"
   
     validation {
       condition     = contains(["Rapid", "Stable", "NodeImage", "TargetKubernetesVersion"], var.auto_upgrade_channel)
       error_message = "Auto-upgrade channel must be one of: Rapid, Stable, NodeImage, TargetKubernetesVersion."
     }
   }
   
   variable "target_kubernetes_version" {
     type        = string
     description = "Target Kubernetes version in major.minor format, for example 1.31. Required when auto_upgrade_channel is TargetKubernetesVersion; otherwise leave null."
     default     = null
   
     validation {
       condition     = var.target_kubernetes_version == null || can(regex("^[0-9]+\\.[0-9]+$", var.target_kubernetes_version))
       error_message = "Target Kubernetes version must be in major.minor format, for example 1.31."
     }
   
     validation {
       condition     = var.auto_upgrade_channel != "TargetKubernetesVersion" || var.target_kubernetes_version != null
       error_message = "Target Kubernetes version is required when auto_upgrade_channel is TargetKubernetesVersion."
     }
   }
   
   variable "node_image_selection" {
     type        = string
     description = "Node image selection type. Latest uses the newest image per region; Consistent waits for the same image version across all member regions."
     default     = "Latest"
   
     validation {
       condition     = contains(["Latest", "Consistent"], var.node_image_selection)
       error_message = "Node image selection must be either Latest or Consistent."
     }
   }
   
   variable "auto_upgrade_disabled" {
     type        = bool
     description = "Set to true to stop the profile from creating new automatic update runs. In-progress update runs aren't cancelled."
     default     = false
   }
   
   variable "long_term_support" {
     type        = bool
     description = "Whether the profile targets long-term support Kubernetes versions. Only supported on the TargetKubernetesVersion channel."
     default     = false
   
     validation {
       condition     = !var.long_term_support || var.auto_upgrade_channel == "TargetKubernetesVersion"
       error_message = "Long-term support can only be enabled when auto_upgrade_channel is TargetKubernetesVersion."
     }
   }
   
   variable "tags" {
     type        = map(string)
     description = "Tags to apply to created resources."
     default = {
       environment = "demo"
       managed_by  = "terraform"
     }
   }
   

4. Skapa en fil med namnet main.tfoch infoga följande kod:

   resource "random_string" "suffix" {
     length  = 5
     lower   = true
     numeric = true
     special = false
     upper   = false
   }
   
   locals {
     resource_group_name       = coalesce(var.resource_group_name, "rg-fleet-update-${random_string.suffix.result}")
     fleet_name                = coalesce(var.fleet_name, "fleet-update-${random_string.suffix.result}")
     auto_upgrade_profile_name = coalesce(var.auto_upgrade_profile_name, "stable-profile-${random_string.suffix.result}")
   
     # targetKubernetesVersion is only valid on the TargetKubernetesVersion channel.
     auto_upgrade_properties = merge(
       {
         channel         = var.auto_upgrade_channel
         disabled        = var.auto_upgrade_disabled
         longTermSupport = var.long_term_support
         nodeImageSelection = {
           type = var.node_image_selection
         }
       },
       var.auto_upgrade_channel == "TargetKubernetesVersion" ? {
         targetKubernetesVersion = var.target_kubernetes_version
       } : {}
     )
   }
   
   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
   }
   
   # autoUpgradeProfiles is only available on the preview API version, which requires schema validation to be disabled.
   resource "azapi_resource" "auto_upgrade_profile" {
     type                      = "Microsoft.ContainerService/fleets/autoUpgradeProfiles@2025-04-01-preview"
     name                      = local.auto_upgrade_profile_name
     parent_id                 = azurerm_kubernetes_fleet_manager.example.id
     schema_validation_enabled = false
   
     body = {
       properties = local.auto_upgrade_properties
     }
   }
   

5. Skapa en fil med namnet outputs.tfoch infoga följande kod:

   output "resource_group_name" {
     description = "Name of the created resource group."
     value       = azurerm_resource_group.example.name
   }
   
   output "fleet_manager_name" {
     description = "Name of the Azure Kubernetes Fleet Manager."
     value       = azurerm_kubernetes_fleet_manager.example.name
   }
   
   output "fleet_manager_id" {
     description = "Resource ID of the Azure Kubernetes Fleet Manager."
     value       = azurerm_kubernetes_fleet_manager.example.id
   }
   
   output "auto_upgrade_profile_name" {
     description = "Name of the Fleet auto-upgrade profile."
     value       = azapi_resource.auto_upgrade_profile.name
   }
   
   output "auto_upgrade_profile_id" {
     description = "Resource ID of the Fleet auto-upgrade profile."
     value       = azapi_resource.auto_upgrade_profile.id
   }
   

6. Kopiera exemplets terraform.tfvars.example fil till terraform.tfvars i samma katalog och redigera sedan värdena så att de matchar kanalen för automatisk uppgradering, val av nodbild och andra alternativ som du vill använda.

   cp terraform.tfvars.example terraform.tfvars
   

Initiera, verifiera och tillämpa konfigurationen

Kör terraform init för att initiera Terraform-distributionen. Det här kommandot laddar ned de Azure providers som krävs för att hantera dina Azure resurser.

terraform init

Kör terraform fmt för att formatera konfigurationsfilerna konsekvent.

terraform fmt

Kör terraform-verifiering för att bekräfta att konfigurationsfilerna är syntaktiskt giltiga.

terraform validate

Kör terraform plan för att skapa en utförandeplan.

terraform plan -out main.tfplan

Kör terraform apply för att applicera genomförandeplanen på din molninfrastruktur.

terraform apply main.tfplan

Visa profiler för automatisk uppgradering

Hämta resursgruppen, Fleet Manager och profilnamnen för automatisk uppgradering från Terraform-utdata.

resource_group_name=$(terraform output -raw resource_group_name)
fleet_manager_name=$(terraform output -raw fleet_manager_name)
auto_upgrade_profile_name=$(terraform output -raw auto_upgrade_profile_name)

Visa den automatiska uppgraderingsprofilens kanal, status och uppdateringssekvens med hjälp az fleet autoupgradeprofile show av kommandot .

az fleet autoupgradeprofile show \
  --resource-group $resource_group_name \
  --fleet-name $fleet_manager_name \
  --name $auto_upgrade_profile_name

Exemplet anger ingen uppdateringsstrategi, så updateStrategyId i utdata är tom och profilen uppdaterar flottans medlemskluster sekventiellt med uppdateringssekvensen One by one. Visa en lista över aktuella medlemmar i flottan med följande kommando.

az fleet member list \
  --resource-group $resource_group_name \
  --fleet-name $fleet_manager_name \
  --output table

Ta bort en profil för automatisk uppgradering

Kör terraform plan med flaggan -destroy för att skapa en exekveringsplan för destruktion.

terraform plan -destroy -out main.destroy.tfplan

Kör terraform apply för att verkställa destroy-planen.

terraform apply main.destroy.tfplan

Skapa profiler för automatisk uppgradering

Visa profiler för automatisk uppgradering

Profiler för automatisk uppgradering är resurser på fleet-nivå. De är inte direkt kopplade till enskilda AKS-kluster. För att avgöra vilka profiler som kan uppdatera dina AKS-kluster kontrollerar du att klustren är medlemmar i flottan och granskar sedan flottans profiler och deras uppdateringssekvenser.

1. I Azure Portal går du till din Azure Kubernetes Fleet Manager-resurs.
2. På tjänstmenyn väljer du Medlemmar i flottan och bekräftar att dina AKS-kluster visas i medlemslistan.
3. Under Inställningar väljer du Uppdatering för flera kluster>.
4. Välj en profil för automatisk uppgradering för att visa dess kanal, status och uppdateringssekvens.
5. Om uppdateringssekvensen är En i taget innehåller profilen flottans medlemskluster sekventiellt. Om uppdateringssekvensen använder Faser granskar du den associerade strategins faser, grupper och medlemsväljare för att avgöra vilka Fleet-medlemmar som de genererade uppdateringskörningarna inkluderar.

Ta bort en profil för automatisk uppgradering

1. I Azure Portal går du till din Azure Kubernetes Fleet Manager-resurs.
2. På tjänstmenyn går du till Inställningar, väljer Multiklusteruppdatering> och Profiler för automatisk uppgradering.
3. Välj den profil som du vill ta bort och välj sedan Ta bort>Ja för att bekräfta.