Usare la manutenzione pianificata per pianificare e controllare gli aggiornamenti per il cluster servizio Azure Kubernetes

• Questo articolo presuppone che si disponga di un cluster del servizio Azure Kubernetes esistente. Se non si ha un cluster del servizio Azure Kubernetes, vedere Creare un cluster del servizio Azure Kubernetes.

• Sottoscrizione attiva Azure. Se non si ha una sottoscrizione Azure, creare un account free prima di iniziare.

• Impostare il contesto della sottoscrizione usando il az account set comando . Per esempio:

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

• Terraform installato localmente. Per istruzioni di installazione, vedere Installare Terraform.

Creare il file di configurazione terraform

I file di configurazione terraform definiscono l'infrastruttura creata e gestita da Terraform.

Creare un file denominato main.tf e aggiungere il codice seguente per definire la versione di Terraform e specificare il provider Azure:

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

Creare un gruppo di risorse

Aggiungere il codice seguente a main.tf per creare un gruppo di risorse Azure. Aggiornare i valori location e name in modo che corrispondano all'ambiente.

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

Crea un cluster AKS

Aggiungere il codice seguente a main.tf per creare un cluster AKS. Aggiornare i valori in base alle esigenze per l'ambiente in uso.

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"
 }
}

Aggiungere una configurazione della finestra di manutenzione a un cluster AKS usando il comando az aks maintenanceconfiguration add.

Il primo esempio aggiunge una nuova default configurazione che pianifica l'esecuzione della manutenzione dalle 13:00 alle 5:00 ogni lunedì nel UTC fuso orario. Nel secondo esempio viene aggiunta una nuova configurazione aksManagedAutoUpgradeSchedule che pianifica l’esecuzione della manutenzione ogni terzo venerdì tra le 12:00 e le 8:00 nel fuso orario UTC+5:30.

# 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. Nel portale di Azure, vai alla risorsa del cluster AKS.

2. Dal menu del servizio, in Impostazioni, selezionare Aggiornamenti.

3. In Aggiorna>Utilità di pianificazione aggiornamento automatico selezionare Aggiungi pianificazione.

   

4. Nel riquadro Aggiungi programma di manutenzione configurare le impostazioni della finestra di manutenzione seguenti:

   • Ripetizioni: selezionare la frequenza per la finestra di manutenzione. È consigliabile selezionare Settimanale.
   • Frequenza: selezionare il giorno della settimana per la finestra di manutenzione. È consigliabile selezionare Domenica.
   • Data di inizio manutenzione: selezionare la data di inizio per la finestra di manutenzione.
   • Ora di inizio manutenzione: selezionare l'ora di inizio per la finestra di manutenzione.
   • Differenza dall'ora UTC: selezionare la differenza dall'ora UTC per la finestra di manutenzione. L'impostazione predefinita è +00:00.

   

5. Seleziona Salva.

È possibile usare un file JSON per creare una configurazione di manutenzione anziché usare i parametri. Quando si usa questo metodo, è possibile impedire la manutenzione durante un intervallo di date specificando notAllowedDates per defaultle configurazioni , aksManagedAutoUpgradeSchedulee aksManagedNodeOSUpgradeSchedule .

1. Creare un file JSON con le impostazioni della finestra di manutenzione.

   Nell'esempio seguente viene creato un default.json file che pianifica l'esecuzione della manutenzione dalle 13:00 alle 5:00 ogni martedì nel UTC fuso orario. Esiste anche un'eccezione da 2021-05-26 a 2021-05-30 in cui la manutenzione non è consentita, anche se si sovrappone a una finestra di manutenzione.

   {
     "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"
               }
           ]
       }
     }
   }
   

   Nell'esempio seguente viene creato un file autoUpgradeWindow.json che pianifica l'esecuzione della manutenzione ogni tre mesi, il primo giorno mese tra le 9.00 e le 13.00 nel fuso orario UTC-08. Esiste anche un'eccezione da 2023-12-23 a 2024-01-05 in cui la manutenzione non è consentita, anche se si sovrappone a una finestra di manutenzione.

   {
     "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. Aggiungere la configurazione della finestra di manutenzione usando il az aks maintenanceconfiguration add comando con il --config-file parametro .

   Nel primo esempio viene aggiunta una nuova configurazione default usando il file default.json. Nel secondo esempio viene aggiunta una nuova configurazione aksManagedAutoUpgradeSchedule usando il file autoUpgradeWindow.json.

   # 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
   

Aggiungere la configurazione della finestra di manutenzione a main.tf utilizzando la risorsa azapi_resource.

Configurazione di manutenzione predefinita

L'esempio seguente crea una default configurazione di manutenzione che pianifica l'esecuzione della manutenzione dalle 2:00 alle 6:00 ogni sabato nel UTC-04:00 fuso orario:

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"
     }
   }
 }
}

Configurazione della manutenzione dell'aggiornamento automatico

L'esempio seguente crea una aksManagedAutoUpgradeSchedule configurazione di manutenzione che pianifica l'esecuzione della manutenzione ogni domenica dalle 13:00 alle 5:00 nel UTC-04:00 fuso orario, a partire dal 20 aprile 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
         }
       }
     }
   }
 }
}

Configurazione di manutenzione dell'aggiornamento del sistema operativo del nodo

L'esempio seguente crea una aksManagedNodeOSUpgradeSchedule configurazione di manutenzione che pianifica l'esecuzione della manutenzione ogni lunedì dalle 3:00 alle 7:00 nel UTC-04:00 fuso orario, a partire dal 21 aprile 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
         }
       }
     }
   }
 }
}

Aggiornare una configurazione di manutenzione esistente usando il az aks maintenanceconfiguration update comando .

L'esempio seguente aggiorna la configurazione default per pianificare l'esecuzione della manutenzione dalle 2:00 alle 6:00 ogni venerdì.

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. Nel portale di Azure, passare alla risorsa del cluster AKS.

2. Dal menu del servizio, in Impostazioni, selezionare Aggiornamenti.

3. In Aggiorna>Utilità di pianificazione aggiornamento automatico selezionare Modifica pianificazione.

   

4. Nel riquadro Modifica programma di manutenzione, aggiornare le impostazioni della finestra di manutenzione in base alle esigenze.

5. Seleziona Salva.

1. Aggiornare il file JSON di configurazione con le nuove impostazioni della finestra di manutenzione.

   L'esempio seguente aggiorna il default.json file dalla sezione precedente per pianificare l'esecuzione della manutenzione dalle 2:00 alle 6:00 ogni lunedì:

   {
     "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. Aggiornare la configurazione della finestra di manutenzione usando il az aks maintenanceconfiguration update comando con il --config-file parametro :

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

Se si dispone già di un cluster del servizio Azure Kubernetes gestito da Terraform, è possibile aggiornare la configurazione della finestra di manutenzione modificando il file di configurazione terraform e applicando le modifiche usando il terraform apply comando .

Inizializzare Terraform

Inizializzare Terraform nella directory contenente il main.tf file usando il terraform init comando . Questo comando scarica il provider di Azure necessario per gestire le risorse Azure con Terraform.

terraform init

Crea un piano di esecuzione di Terraform

Creare un piano di esecuzione terraform usando il comando terraform plan. Questo comando mostra le risorse che Terraform creerà o modificherà nella sottoscrizione Azure.

terraform plan

Applicare la configurazione di Terraform

Dopo aver esaminato e confermato il piano di esecuzione, applicare la configurazione di Terraform usando il terraform apply comando . Questo comando crea o modifica le risorse definite nel file main.tf nella sottoscrizione Azure.

terraform apply

Eliminare una finestra di configurazione di manutenzione nel cluster del servizio Azure Kubernetes usando il comando az aks maintenanceconfiguration delete.

Nell'esempio seguente viene eliminata la configurazione di manutenzione autoUpgradeSchedule:

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

1. Nel portale di Azure, passare alla risorsa del cluster AKS.

2. Nel menu del servizio, in Impostazioni, selezionare Configurazione cluster.

3. In Aggiorna>Utilità di pianificazione aggiornamento automatico selezionare Modifica pianificazione.

   

4. Nel riquadro Modifica programma di manutenzione selezionare Rimuovi pianificazione.

   

Eliminare una finestra di configurazione di manutenzione nel cluster del servizio Azure Kubernetes usando il comando az aks maintenanceconfiguration delete.

Nell'esempio seguente viene eliminata la configurazione di manutenzione autoUpgradeSchedule:

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

Per eliminare una configurazione di manutenzione, rimuovere il blocco corrispondente dalla configurazione di Terraform e applicare le modifiche usando il terraform apply comando .