Automatizar as atualizações do Kubernetes e das imagens de nós em vários clusters usando o Gerenciador de Frota de Kubernetes do Azure

• Defina as seguintes variáveis de ambiente a serem usadas nos comandos da 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>
  

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

• Instale a extensão de CLI do Azure mais recente fleet . 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
  

• Instale e configure o Terraform.

• Instale a versão mais recente do CLI do Azure. Para instalar ou atualizar, confira Instalar a CLI do Azure. Use o CLI do Azure para verificar o perfil de atualização automática criado pelo Terraform.

• Instale a extensão de CLI do Azure mais recente fleet . 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 usado neste artigo cria seu próprio grupo de recursos e o Azure Kubernetes Fleet Manager, e não adiciona nenhum cluster do AKS como membro da frota. Depois de aplicar o exemplo, adicione os clusters AKS existentes como membros do Fleet para testar o perfil de atualização automática resultante em execuções reais de atualização. Para obter mais informações, confira o 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.

É possível desabilitar um perfil de atualização automática incluindo o sinalizador --disabled com o comando az fleet autoupgradeprofile create. Para reabilitar um perfil de atualização automática desabilitado, execute novamente o az fleet autoupgradeprofile create comando sem o --disabled sinalizador.

Atualizações do canal estável do Kubernetes

Atualize para o patch mais recente com suporte do Kubernetes na versão menor N-1, onde N é a versão menor com suporte mais recente.

Atualizar clusters membros um por um

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

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

Atualizar clusters de membros usando uma estratégia de atualização existente

Atualize os clusters de membros usando uma estratégia de atualização existente. Use o comando az fleet autoupgradeprofile create com o parâmetro --update-strategy-id definido 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 Stable

Atualizar clusters membros usando uma estratégia de atualização existente com a imagem de nó consistente

Atualize os clusters membros usando uma estratégia de atualização existente e verifique se a mesma versão da imagem do nó seja 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 do nó.

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

Atualizar clusters membros usando uma estratégia de atualização existente com a imagem de nó mais recente

Atualize os clusters de membros usando uma estratégia de atualização existente e verifique se a versão mais recente da imagem do nó disponível é usada para cada região Azure. Use o az fleet autoupgradeprofile create comando com o --node-image-selection parâmetro definido como Latest. Os clusters membros podem executar várias versões de imagens 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 imagens de nós

Atualize os nós com uma imagem de máquina recém-atualizada que inclui correções de segurança e correções de erros.

Atualizar imagens de nós uma por uma

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

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

Atualizar imagens de nós usando uma estratégia de atualização existente

Atualize as imagens dos nós dos clusters de membros usando uma estratégia de atualização existente. Use o az fleet autoupgradeprofile create comando e defina o --update-strategy-id parâmetro para a 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 

Definir como alvo atualizações de versões menores do Kubernetes

Atualize para uma versão secundária de destino especificada do Kubernetes usando o parâmetro --target-kubernetes-version. Forneça a versão no formato {versão principal}.{versão secundária} (por exemplo, 1.33). A atualização automática do Fleet Manager atualiza automaticamente os clusters de membros para a versão de patch mais recente da versão de destino especificada quando o patch está disponível.

Atualizar clusters de membros para uma versão secundária específica do Kubernetes

Atualize os clusters de membros 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 desejada. O exemplo a seguir atualiza os clusters de membros para o Kubernetes versão 1.33.

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

Atualizar clusters membros com o LTS habilitado para uma versão secundária específica do Kubernetes

Atualize clusters membros com o LTS habilitado 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 como a versão desejada e o sinalizador --long-term-support habilitado. O exemplo a seguir atualiza os clusters de membros para o Kubernetes versão 1.29 com LTS habilitado.

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 patches de segurança

Atualize os nós do Linux com correções de segurança. Aplique atualizações usando a aplicação de patches em tempo real sempre que possível. Caso contrário, implante uma imagem de computador recém-corrigida que contenha correções de segurança.

Atualize os nós com correções de segurança individualmente

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

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

Atualizar nós com patches de segurança usando uma estratégia de atualização existente

Atualize as imagens dos nós dos clusters de membros usando uma estratégia de atualização existente. Use o az fleet autoupgradeprofile create comando e defina o --update-strategy-id parâmetro para a 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 

Exibir perfis de atualização automática

Perfis de atualização automática são recursos no nível da frota. Eles não são vinculados diretamente a clusters individuais do AKS. Para determinar quais perfis podem atualizar seus clusters do AKS, primeiro liste os membros da Frota e confirme se 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 para a Frota usando o az fleet autoupgradeprofile list comando.

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

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

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

Se updateStrategyId estiver vazio, o perfil usará a sequência de atualização Um por um e incluirá os clusters de membros da frota sequencialmente. Se updateStrategyId contiver um ID de recurso, exiba a estratégia referenciada para analisar os estágios, grupos ou seletores de membros que determinam quais membros do Fleet são incluídos nas execuções de atualização geradas.

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

Excluir um perfil de atualização automática

Use o comando az fleet autoupgradeprofile delete para excluir um perfil de atualização automática existente. Depois de executar esse comando, você será solicitado a confirmar a exclusão. Para ignorar a confirmação e excluir 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 do Terraform nesta seção cria um grupo de recursos, um Azure Kubernetes Fleet Manager (sem um cluster de hub) e um perfil de atualização automática de frota. Por padrão, o perfil usa o canal Stable, com a seleção de imagem de nó Latest, e está habilitado. Defina as variáveis auto_upgrade_channel, node_image_selection, auto_upgrade_disabled, target_kubernetes_version e long_term_support para que correspondam ao canal e às opções descritas nas seções anteriores. O exemplo não define uma estratégia de atualização, portanto, o perfil resultante sempre usa a sequência de atualização Um por uma .

Revisar o código Terraform

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

2. Crie um arquivo chamado providers.tf, depois insira o código a seguir:

   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.tf, depois insira o código a seguir:

   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.tf, depois insira o código a seguir:

   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.tf, depois insira o código a seguir:

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

   cp terraform.tfvars.example terraform.tfvars
   

Inicializar, validar e aplicar a configuração

Execute terraform init para inicializar a implantação do Terraform. Esse comando baixa os provedores de Azure necessários para gerenciar seus recursos de Azure.

terraform init

Execute o terraform fmt para formatar os arquivos de configuração de forma consistente.

terraform fmt

Execute terraform validate para confirmar que os arquivos 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

Execute o comando terraform apply para aplicar o plano de execução à sua infraestrutura de nuvem.

terraform apply main.tfplan

Exibir perfis de atualização automática

Obtenha os nomes do grupo de recursos, do Fleet Manager e dos perfis de atualização automática 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, o status e a 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; portanto updateStrategyId na saída fica vazio, e o perfil atualiza os clusters membros da frota sequencialmente usando a sequência de atualização Um por um. Liste os membros atuais da Frota com o comando a seguir.

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

Excluir um perfil de atualização automática

Execute o plano do terraform com a sinalização -destroy para criar um plano de execução de 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

Exibir perfis de atualização automática

Perfis de atualização automática são recursos no nível da frota. Eles não são vinculados diretamente a clusters individuais do AKS. Para determinar quais perfis podem atualizar seus clusters do AKS, confirme se os clusters são membros da Frota e examine os perfis da Frota e suas sequências de atualização.

1. No portal do Azure, navegue até o recurso do Gerenciador de Frota de Kubernetes do Azure.
2. No menu de serviço, selecione membros da Frota e confirme se os clusters do AKS aparecem na lista de membros.
3. Em Configurações, selecione Atualização de multicluster>.
4. Selecione um perfil de atualização automática para exibir seu canal, status e sequência de atualizações.
5. Se a sequência de atualização for Um por um, o perfil incluirá os clusters membros da Frota sequencialmente. Se a sequência de atualização usar Estágios, examine os estágios, grupos e seletores de membros da estratégia associada para determinar quais membros da Frota as execuções de atualização geradas incluem.

Excluir um perfil de atualização automática

1. No portal do Azure, navegue até o recurso do Gerenciador de Frota de Kubernetes do Azure.
2. No menu de serviço, em Configurações, selecione Atualização Multicluster>Perfis de atualização automática.
3. Selecione o perfil que você deseja excluir e, em seguida, selecione Excluir>Sim para confirmar.