Use a manutenção planeada para agendar e controlar atualizações para o seu cluster Azure Kubernetes Service

• Este artigo pressupõe que você tenha um cluster AKS existente. Se você não tiver um cluster AKS, consulte Criar um cluster AKS.

• Uma subscrição ativa do Azure. Se não tiver uma subscrição Azure, crie uma conta gratuita antes de começar.

• Defina o seu contexto de subscrição usando o az account set comando. Por exemplo:

  az account set --subscription "00000000-0000-0000-0000-000000000000"
  

• Terraform instalado localmente. Para instruções de instalação, consulte Instalar Terraform.

Criar o ficheiro de configuração do Terraform

Os ficheiros de configuração do Terraform definem a infraestrutura que o Terraform cria e gere.

Crie um ficheiro chamado main.tf e adicione o seguinte código para definir a versão do Terraform e especificar o fornecedor Azure:

terraform {
 required_providers {
   azurerm = {
     source  = "hashicorp/azurerm"
     version = "~>4.0"
   }
   azapi = {
     source  = "azure/azapi"
     version = "~>2.0"
   }
 }
}
provider "azurerm" {
 features {}
}
provider "azapi" {}

Criar um grupo de recursos

Adicione o código seguinte a main.tf para criar um grupo de recursos Azure. Atualize os valores de location e name para corresponder ao seu ambiente.

resource "azurerm_resource_group" "rg" {
 name     = "aks-maintenance-rg"
 location = "East US"
}

Criar um cluster do AKS

Adicione o seguinte código ao main.tf para criar um cluster AKS. Atualize quaisquer valores conforme necessário para corresponder ao seu ambiente.

resource "azurerm_kubernetes_cluster" "aks" {
 name                = "aks-maintenance-cluster"
 location            = azurerm_resource_group.rg.location
 resource_group_name = azurerm_resource_group.rg.name
 dns_prefix          = "aksmaintenance"
 default_node_pool {
   name       = "nodepool1"
   node_count = 1
   vm_size    = "Standard_DS2_v2"
 }
 identity {
   type = "SystemAssigned"
 }
}

Adicione uma configuração de janela de manutenção a um cluster AKS usando o az aks maintenanceconfiguration add comando.

O primeiro exemplo adiciona uma nova default configuração que agenda a manutenção para ser executada de 1h00 às 5h00 todas as segundas-feiras no fuso UTC horário. O segundo exemplo adiciona uma nova aksManagedAutoUpgradeSchedule configuração que agenda a manutenção para ser executada toda terceira sexta-feira entre 12h00 e 8h00 no fuso UTC+5:30 horário.

# Add a new default configuration
az aks maintenanceconfiguration add --resource-group $RESOURCE_GROUP --cluster-name $CLUSTER_NAME --name default --schedule-type Weekly --day-of-week Monday --interval-weeks 1 --duration 4 --utc-offset +00:00 --start-time 01:00

# Add a new aksManagedAutoUpgradeSchedule configuration
az aks maintenanceconfiguration add --resource-group $RESOURCE_GROUP --cluster-name $CLUSTER_NAME --name aksManagedAutoUpgradeSchedule --schedule-type Weekly --day-of-week Friday --interval-weeks 3 --duration 8 --utc-offset +05:30 --start-time 00:00

1. No portal do Azure, aceda ao recurso do teu cluster AKS.

2. No menu de serviço, em Definições, selecione Upgrades.

3. Em Atualização>Agendador de atualização automática, selecione Adicionar agenda.

   

4. No painel Adicionar agenda de manutenção, defina as seguintes configurações da janela de manutenção:

   • Repetições: Selecione a frequência para a janela de manutenção. Recomendamos selecionar Semanal.
   • Frequência: Selecione o dia da semana para a janela de manutenção. Recomendamos selecionar Domingo.
   • Data de início da manutenção: Selecione a data de início da janela de manutenção.
   • Hora de início da manutenção: Selecione a hora de início para a janela de manutenção.
   • Deslocamento UTC: Selecione o deslocamento UTC para a janela de manutenção. O padrão é +00:00.

   

5. Selecione Guardar.

Você pode usar um arquivo JSON para criar uma configuração de manutenção em vez de usar parâmetros. Ao usar este método, pode evitar a manutenção durante um intervalo de datas especificando notAllowedDates para default, aksManagedAutoUpgradeSchedule, e aksManagedNodeOSUpgradeSchedule configurações.

1. Crie um arquivo JSON com as configurações da janela de manutenção.

   O exemplo a seguir cria um default.json arquivo que agenda a manutenção para ser executada de 1h00 às 5h00 todas as terças-feiras no fuso UTC horário. Há também uma exceção de 2021-05-26 a 2021-05-30 em que a manutenção não é permitida, mesmo que se sobreponha a uma janela de manutenção.

   {
     "properties": {
       "maintenanceWindow": {
           "schedule": {
               "weekly": {
                   "intervalWeeks": 1,
                   "dayOfWeek": "Tuesday"
               }
           },
           "durationHours": 4,
           "utcOffset": "+00:00",
           "startTime": "01:00",
           "notAllowedDates": [
               {
                   "start": "2021-05-26",
                   "end": "2021-05-30"
               }
           ]
       }
     }
   }
   

   O exemplo a seguir cria um autoUpgradeWindow.json arquivo que agenda a manutenção para ser executada a cada três meses no primeiro dia do mês entre 9h00 e 13h00 no fuso UTC-08 horário. Há também uma exceção de 2023-12-23 a 2024-01-05 em que a manutenção não é permitida, mesmo que se sobreponha a uma janela de manutenção.

   {
     "properties": {
       "maintenanceWindow": {
           "schedule": {
               "absoluteMonthly": {
                   "intervalMonths": 3,
                   "dayOfMonth": 1
               }
           },
           "durationHours": 4,
           "utcOffset": "-08:00",
           "startTime": "09:00",
           "notAllowedDates": [
               {
                   "start": "2023-12-23",
                   "end": "2024-01-05"
               }
           ]
       }
     }
   }
   

2. Adiciona a configuração da janela de manutenção usando o az aks maintenanceconfiguration add comando com o --config-file parâmetro.

   O primeiro exemplo adiciona uma nova default configuração usando o default.json arquivo. O segundo exemplo adiciona uma nova aksManagedAutoUpgradeSchedule configuração usando o autoUpgradeWindow.json arquivo.

   # Add a new default configuration
   az aks maintenanceconfiguration add --resource-group $RESOURCE_GROUP --cluster-name $CLUSTER_NAME --name default --config-file ./default.json
   
   # Add a new aksManagedAutoUpgradeSchedule configuration
   az aks maintenanceconfiguration add --resource-group $RESOURCE_GROUP --cluster-name $CLUSTER_NAME --name aksManagedAutoUpgradeSchedule --config-file ./autoUpgradeWindow.json
   

Adicione a configuração da janela de manutenção a main.tf usando o recurso azapi_resource.

Configuração padrão de manutenção

O exemplo seguinte cria uma default configuração de manutenção que agenda a manutenção para decorrer das 2:00 às 6:00 da manhã todos os sábados no UTC-04:00 fuso horário:

resource "azapi_resource" "default_maintenance" {
 type      = "Microsoft.ContainerService/managedClusters/maintenanceConfigurations@2025-10-01"
 name      = "default"
 parent_id = azurerm_kubernetes_cluster.aks.id
 schema_validation_enabled = false
 body = {
   properties = {
     maintenanceWindow = {
       schedule = {
         weekly = {
           dayOfWeek     = "Saturday"
           intervalWeeks = 1
         }
       }
       durationHours = 4
       startTime     = "02:00"
       utcOffset     = "-04:00"
     }
   }
 }
}

Configuração de manutenção de atualização automática

O exemplo seguinte cria uma aksManagedAutoUpgradeSchedule configuração de manutenção que agenda a manutenção para decorrer todos os domingos, das 1:00 às 5:00 da manhã no UTC-04:00 fuso horário, a partir de 20 de abril de 2026:

resource "azapi_resource" "auto_upgrade" {
 type      = "Microsoft.ContainerService/managedClusters/maintenanceConfigurations@2025-10-01"
 name      = "aksManagedAutoUpgradeSchedule"
 parent_id = azurerm_kubernetes_cluster.aks.id
 schema_validation_enabled = false
 body = {
   properties = {
     maintenanceWindow = {
       startDate     = "2026-04-20"
       startTime     = "01:00"
       durationHours = 4
       utcOffset     = "-04:00"
       schedule = {
         weekly = {
           dayOfWeek     = "Sunday"
           intervalWeeks = 1
         }
       }
     }
   }
 }
}

Configuração de manutenção da atualização do sistema operativo Node

O exemplo seguinte cria uma aksManagedNodeOSUpgradeSchedule configuração de manutenção que agenda a manutenção para todas as segundas-feiras das 3:00 às 7:00 da manhã no UTC-04:00 fuso horário, a partir de 21 de abril de 2026:

resource "azapi_resource" "node_os_upgrade" {
 type      = "Microsoft.ContainerService/managedClusters/maintenanceConfigurations@2025-10-01"
 name      = "aksManagedNodeOSUpgradeSchedule"
 parent_id = azurerm_kubernetes_cluster.aks.id
 schema_validation_enabled = false
 body = {
   properties = {
     maintenanceWindow = {
       startDate     = "2026-04-21"
       startTime     = "03:00"
       durationHours = 4
       utcOffset     = "-04:00"
       schedule = {
         weekly = {
           dayOfWeek     = "Monday"
           intervalWeeks = 1
         }
       }
     }
   }
 }
}

Atualize uma configuração de manutenção existente usando o az aks maintenanceconfiguration update comando.

O exemplo a seguir atualiza a configuração para agendar a default manutenção para ser executada das 2h00 às 6h00 todas as sextas-feiras:

az aks maintenanceconfiguration update --resource-group $RESOURCE_GROUP --cluster-name $CLUSTER_NAME --name default --schedule-type Weekly --day-of-week Friday --interval-weeks 1 --duration 4 --utc-offset +00:00 --start-time 02:00

1. No portal do Azure, navegue até ao recurso do seu cluster AKS.

2. No menu de serviço, em Definições, selecione Upgrades.

3. Em Atualização>Programador de atualização automática, selecione Editar agendamento.

   

4. No painel Editar agenda de manutenção, atualize as configurações da janela de manutenção conforme necessário.

5. Selecione Guardar.

1. Atualize o arquivo JSON de configuração com as novas configurações da janela de manutenção.

   O exemplo a seguir atualiza o arquivo da default.json para agendar a manutenção para ser executada das 2h00 às 6h00 todas as segundas-feiras:

   {
     "properties": {
       "maintenanceWindow": {
           "schedule": {
               "weekly": {
                   "intervalWeeks": 1,
                   "dayOfWeek": "Monday"
               }
           },
           "durationHours": 4,
           "utcOffset": "+00:00",
           "startTime": "02:00",
           "notAllowedDates": [
               {
                   "start": "2021-05-26",
                   "end": "2021-05-30"
               }
           ]
       }
     }
   }
   

2. Atualize a configuração da janela de manutenção usando o az aks maintenanceconfiguration update comando com o --config-file parâmetro:

   az aks maintenanceconfiguration update --resource-group $RESOURCE_GROUP --cluster-name $CLUSTER_NAME --name default --config-file ./default.json
   

Se já tiver um cluster AKS existente gerido pelo Terraform, pode atualizar a configuração da janela de manutenção modificando o ficheiro de configuração do Terraform e aplicando as alterações usando o terraform apply comando.

Inicializar Terraform

Inicialize o Terraform no diretório que contém o seu main.tf ficheiro usando o terraform init comando. Este comando descarrega o fornecedor Azure necessário para gerir os recursos do Azure com o Terraform.

terraform init

Criar um plano de execução do Terraform

Crie um plano de execução Terraform usando o terraform plan comando. Este comando mostra-te os recursos que o Terraform irá criar ou modificar na tua subscrição do Azure.

terraform plan

Aplicar a configuração Terraform

Após rever e confirmar o plano de execução, aplique a configuração do Terraform usando o terraform apply comando. Este comando cria ou modifica os recursos definidos no seu ficheiro main.tf na sua subscrição Azure.

terraform apply

Elimina uma janela de configuração de manutenção no teu cluster AKS usando o az aks maintenanceconfiguration delete comando.

O exemplo seguinte elimina a configuração de manutenção autoUpgradeSchedule.

az aks maintenanceconfiguration delete --resource-group $RESOURCE_GROUP --cluster-name $CLUSTER_NAME --name autoUpgradeSchedule

1. No portal do Azure, navegue até ao recurso do seu cluster AKS.

2. No menu de serviço, em Configurações, selecione Configuração de cluster.

3. Em Atualização>Programador de atualização automática, selecione Editar agendamento.

   

4. No painel Editar agenda de manutenção, selecione Remover agendamento.

   

Elimina uma janela de configuração de manutenção no teu cluster AKS usando o az aks maintenanceconfiguration delete comando.

O exemplo seguinte elimina a configuração de manutenção autoUpgradeSchedule.

az aks maintenanceconfiguration delete --resource-group $RESOURCE_GROUP --cluster-name $CLUSTER_NAME --name autoUpgradeSchedule

Para eliminar uma configuração de manutenção, remova o bloco correspondente da sua configuração Terraform e aplique as alterações usando o terraform apply comando.