Automatize atualizações de Kubernetes e imagens de nó em vários clusters usando o Azure Kubernetes Fleet Manager

• Defina as seguintes variáveis de ambiente para usar nos comandos CLI do Azure:

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

• Instalar a versão mais recente do CLI do Azure. Para instalar ou atualizar, consulte Instalar a CLI do Azure.

• Instale a mais recente fleet extensão CLI do Azure. Use o az extension add comando para instalar a extensão.

  az extension add --name fleet
  

  Use o az extension update comando para atualizar para a versão mais recente da extensão.

  az extension update --name fleet
  

• Instala e configura o Terraform.

• Instalar a versão mais recente do CLI do Azure. Para instalar ou atualizar, consulte Instalar a CLI do Azure. Usa a CLI do Azure para verificar o perfil de atualização automática que o Terraform cria.

• Instale a mais recente fleet extensão CLI do Azure. Use o az extension add comando para instalar a extensão.

  az extension add --name fleet
  

  Use o az extension update comando para atualizar para a versão mais recente da extensão.

  az extension update --name fleet
  

• O exemplo do Terraform utilizado neste artigo cria o seu próprio grupo de recursos e o Azure Kubernetes Fleet Manager, e não adiciona nenhum cluster AKS ao Fleet como membro. Para testar o perfil de atualização automática resultante com execuções reais de atualização, adicione os clusters AKS existentes como membros da Fleet depois de aplicar o exemplo. Para obter mais informações, consulte o guia de início rápido.

Criar perfis de atualização automática

Crie perfis de atualização automática usando o az fleet autoupgradeprofile create comando.

Podes desativar um perfil de atualização automática incluindo a --disabled bandeira com o az fleet autoupgradeprofile create comando. Para reativar um perfil de atualização automática desativado, execute novamente o az fleet autoupgradeprofile create comando sem a --disabled bandeira.

Atualizações do canal estável do Kubernetes

Atualize para a mais recente versão de patch de Kubernetes suportada na versão menor N-1, onde N é a versão menor suportada mais recente.

Atualizar os clusters de membros um a um

Atualize os clusters de membros sequencialmente usando o az fleet autoupgradeprofile create comando.

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

Atualize clusters de membros utilizando uma estratégia de atualização existente

Atualize os clusters de membros utilizando uma estratégia de atualização existente. Utilize o comando az fleet autoupgradeprofile create com o parâmetro --update-strategy-id definido com o ID da estratégia de atualização existente.

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

Atualize clusters de membros utilizando uma estratégia de atualização existente com imagem consistente do nó

Atualize os clusters membros usando uma estratégia de atualização existente e assegure que a mesma versão da imagem do nó é usada em todas as regiões do Azure. Use o az fleet autoupgradeprofile create comando com o --node-image-selection parâmetro definido como Consistent. Todos os clusters membros executam a mesma versão de imagem de nó.

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

Atualize clusters membros utilizando uma estratégia de atualização existente com a imagem mais recente do nó

Atualize os clusters membros utilizando uma estratégia de atualização existente e assegure que a versão mais recente disponível da imagem do nó é usada para cada região do Azure. Use o az fleet autoupgradeprofile create comando com o --node-image-selection parâmetro definido como Latest. Os clusters membros podem executar múltiplas versões de imagem de nós.

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

Atualizações do canal de imagem do nó

Atualize os nós com uma imagem de máquina recentemente corrigida que inclua correções de segurança e correções de bugs.

Atualize as imagens dos nós uma a uma

Atualize as imagens dos nós dos clusters de membros sequencialmente, utilizando o comando az fleet autoupgradeprofile create.

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

Atualize as imagens dos nós utilizando uma estratégia de atualização existente

Atualize as imagens dos nós dos clusters-membro utilizando uma estratégia de atualização existente. Use o az fleet autoupgradeprofile create comando e defina o --update-strategy-id parâmetro para o ID da estratégia de atualização existente.

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

Atualizações menores de versão do Target Kubernetes

Atualize para uma versão menor Kubernetes alvo definida usando o --target-kubernetes-version parâmetro. Fornece a versão na {versão maior}.{ versão menor} (por exemplo, 1.33). A Atualização automática do Fleet Manager atualiza automaticamente os clusters membros para a última versão de patch da versão de destino especificada, assim que o patch esteja disponível.

Atualizar clusters membros para uma versão menor específica do Kubernetes

Atualize clusters de membros para uma versão menor específica do Kubernetes usando o az fleet autoupgradeprofile create comando com o --target-kubernetes-version parâmetro definido para a versão desejada. O exemplo seguinte atualiza os clusters de membros para a versão 1.33 do Kubernetes.

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

Atualizar clusters membros com LTS ativado para uma versão menor específica do Kubernetes

Atualize os clusters membros com o LTS ativado para uma versão secundária específica do Kubernetes usando o comando az fleet autoupgradeprofile create com o parâmetro --target-kubernetes-version definido para a versão pretendida e a opção --long-term-support ativada. O exemplo seguinte atualiza clusters membros para a versão 1.29 do Kubernetes com LTS ativado.

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

Atualizações do canal de correções de segurança

Atualize os nós Linux com correções de segurança. Aplicar atualizações usando patches em tempo real sempre que possível. Caso contrário, implemente uma imagem de máquina recém-corrigida que contenha correções de segurança.

Atualizar os nós com atualizações de segurança um a um

Atualize as imagens dos nós dos clusters de membros sequencialmente, utilizando o comando az fleet autoupgradeprofile create.

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

Atualize os nós com patches de segurança utilizando uma estratégia de atualização existente

Atualize as imagens dos nós dos clusters-membro utilizando uma estratégia de atualização existente. Use o az fleet autoupgradeprofile create comando e defina o --update-strategy-id parâmetro para o ID da estratégia de atualização existente.

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

Ver perfis de atualização automática

Perfis de atualização automática são recursos ao nível da Frota. Não estão associados diretamente a clusters AKS individuais. Para determinar quais os perfis que podem atualizar os seus clusters AKS, liste primeiro os membros da Frota e confirme que os clusters são membros da Frota.

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

Liste todos os perfis de atualização automática da Frota usando o az fleet autoupgradeprofile list comando.

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

Mostrar um perfil específico de atualização automática para a Frota usando o az fleet autoupgradeprofile show comando. Reveja, na saída, o canal, o estado e updateStrategyId.

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

Se updateStrategyId estiver vazio, o perfil utiliza a sequência de atualização Um a um e inclui sequencialmente os clusters membros da Frota. Se updateStrategyId contiver um ID de recurso, mostre a estratégia referenciada para rever os estágios, grupos ou selecionadores de membros que determinam quais os membros da Frota que a atualização gerada inclui.

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

Eliminar um perfil de atualização automática

Use o az fleet autoupgradeprofile delete comando para excluir um perfil de atualização automática existente. Depois de executar este comando, é solicitado confirmar a eliminação. Para ignorar a confirmação e eliminar imediatamente o perfil, inclua --yes no comando.

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

Criar perfis de atualização automática

O exemplo de Terraform nesta secção cria um grupo de recursos, um Gestor de Frotas Azure Kubernetes (sem cluster de hub) e um perfil de atualização automática da frota. Por predefinição, o perfil utiliza o canal Stable com a seleção da imagem do nó Latest e vem ativado. Defina as auto_upgrade_channelvariáveis , node_image_selection, auto_upgrade_disabled, target_kubernetes_version, e long_term_support para corresponder ao canal e às opções descritas nas secções anteriores. O exemplo não define uma estratégia de atualização, por isso o perfil resultante usa sempre a sequência de atualização um a um .

Revise o código do Terraform

1. Crie um diretório para testar o código de exemplo do Terraform e torne-o o diretório atual.

2. Crie um arquivo chamado providers.tfe insira o seguinte código:

   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. Crie um arquivo chamado variables.tfe insira o seguinte código:

   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. Crie um arquivo chamado main.tfe insira o seguinte código:

   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. Crie um arquivo chamado outputs.tfe insira o seguinte código:

   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. Copie o ficheiro de exemplo terraform.tfvars.example para terraform.tfvars no mesmo diretório e, em seguida, edite os valores para corresponderem ao canal de atualização automática, à seleção da imagem do nó e a outras opções que pretender.

   cp terraform.tfvars.example terraform.tfvars
   

Inicializar, validar e aplicar a configuração

Execute terraform init para inicializar a implantação do Terraform. Este comando descarrega os fornecedores Azure necessários para gerir os seus recursos Azure.

terraform init

Executa o terraform fmt para formatar os ficheiros de configuração de forma consistente.

terraform fmt

Execute terraform validate para confirmar que os ficheiros de configuração são sintaticamente válidos.

terraform validate

Execute o comando terraform plan para criar um plano de execução.

terraform plan -out main.tfplan

Executa o Terraform Application para aplicar o plano de execução à tua infraestrutura cloud.

terraform apply main.tfplan

Ver perfis de atualização automática

Obtenha os nomes do grupo de recursos, do Gestor de Frotas e do perfil de atualização automática a partir das saídas do Terraform.

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)

Mostre o canal, estado e sequência de atualização do perfil de atualização automática usando o az fleet autoupgradeprofile show comando.

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

O exemplo não define uma estratégia de atualização, pelo que updateStrategyId no resultado fica vazio e o perfil atualiza sequencialmente os clusters membro do Fleet utilizando a sequência de atualização Um a um. Liste os membros atuais da Frota com o seguinte comando.

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

Eliminar um perfil de atualização automática

Execute terraform plan com a opção -destroy para criar um plano de execução para destruição.

terraform plan -destroy -out main.destroy.tfplan

Execute terraform apply para aplicar o plano de destruição.

terraform apply main.destroy.tfplan

Criar perfis de atualização automática

Ver perfis de atualização automática

Perfis de atualização automática são recursos ao nível da Frota. Não estão associados diretamente a clusters AKS individuais. Para determinar quais os perfis que podem atualizar os seus clusters AKS, confirme que os clusters são membros da Frota e depois reveja os perfis da Frota e as suas sequências de atualização.

1. No portal do Azure, navegue até o recurso do Azure Kubernetes Fleet Manager.
2. No menu de serviço, selecione Membros da Frota e confirme que os seus clusters AKS aparecem na lista de membros.
3. Em Definições, selecione Atualização multicluster>Perfis de atualização automática.
4. Selecione um perfil de atualização automática para ver o seu canal, estado e sequência de atualização.
5. Se a sequência de atualização for Uma a uma, o perfil inclui os clusters membros da Frota sequencialmente. Se a sequência de atualização usar Estágios, reveja os estágios, grupos e seletores de membros da estratégia associada para determinar quais os membros da Frota que as atualizações geradas incluem.

Eliminar um perfil de atualização automática

1. No portal do Azure, navegue até o recurso do Azure Kubernetes Fleet Manager.
2. No menu de serviço, em Definições, selecione Atualização> de MulticlusterPerfis de atualização automática.
3. Selecione o perfil que quer eliminar e depois selecione Eliminar>Sim para confirmar.