Gepland onderhoud gebruiken om upgrades voor uw Azure Kubernetes Service-cluster te plannen en te beheren

• In dit artikel wordt ervan uitgegaan dat u een bestaand AKS-cluster hebt. Als u geen AKS-cluster hebt, zie een AKS-cluster maken.

• Een actief Azure-abonnement. Als u geen Azure-abonnement hebt, maakt u een vrij account voordat u begint.

• Stel de abonnementscontext in met behulp van de az account set opdracht. Voorbeeld:

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

• Terraform lokaal geïnstalleerd. Zie Terraform installeren voor installatie-instructies.

Het Terraform-configuratiebestand maken

Terraform-configuratiebestanden definiëren de infrastructuur die Terraform maakt en beheert.

Maak een bestand met de naam main.tf en voeg de volgende code toe om de Terraform-versie te definiëren en geef de Azure-provider op:

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

Een brongroep maken

Voeg de volgende code toe aan main.tf om een Azure resourcegroep te maken. Werk de location en name waarden bij zodat deze overeenkomen met uw omgeving.

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

Een AKS-cluster maken

Voeg de volgende code toe aan main.tf om een AKS-cluster te maken. Werk indien nodig alle waarden bij zodat deze overeenkomen met uw omgeving.

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

Voeg een onderhoudsvensterconfiguratie toe aan een AKS-cluster met behulp van de az aks maintenanceconfiguration add opdracht.

In het eerste voorbeeld wordt een nieuwe default configuratie toegevoegd waarmee het onderhoud van 1:00 tot 05:00 uur elke maandag in de UTC tijdzone wordt gepland. In het tweede voorbeeld wordt een nieuwe aksManagedAutoUpgradeSchedule configuratie toegevoegd die onderhoud plant om elke derde vrijdag tussen 12:00 en 8:00 uur in de UTC+5:30 tijdzone uit te voeren.

# 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. Ga in de Azure-portal naar uw AKS-clusterresource.

2. Selecteer Upgrades in het servicemenu onder Instellingen.

3. Onder Upgrade>Automatic upgrade scheduler, selecteer Schema toevoegen.

   

4. In het deelvenster Onderhoudsschema toevoegen configureert u de volgende instellingen voor de onderhoudsperiode:

   • Herhaalt: Selecteer de frequentie voor het onderhoudsvenster. U wordt aangeraden Wekelijks te selecteren.
   • Frequentie: Selecteer de dag van de week voor het onderhoudsvenster. We raden u aan zondag te selecteren.
   • Begindatum van onderhoud: Selecteer de begindatum voor het onderhoudsvenster.
   • Begintijd van onderhoud: Selecteer de begintijd voor het onderhoudsvenster.
   • UTC-offset: selecteer de UTC-offset voor het onderhoudsvenster. De standaardwaarde is +00:00.

   

5. Selecteer Opslaan.

U kunt een JSON-bestand gebruiken om een onderhoudsconfiguratie te maken in plaats van parameters te gebruiken. Wanneer u deze methode gebruikt, kunt u onderhoud voorkomen tijdens een datumbereik door op te notAllowedDates geven voor default, aksManagedAutoUpgradeScheduleen aksManagedNodeOSUpgradeSchedule configuraties.

1. Maak een JSON-bestand met de instellingen voor het onderhoudsvenster.

   In het volgende voorbeeld wordt een default.json bestand gemaakt waarin het onderhoud wordt gepland om elke dinsdag in de UTC tijdzone van 1:00 tot 17:00 uur te worden uitgevoerd. Er is ook een uitzondering van 2021-05-26 tot 2021-05-30 waar onderhoud niet is toegestaan, zelfs als het overlapt met een onderhoudsvenster.

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

   In het volgende voorbeeld wordt een autoUpgradeWindow.json bestand gemaakt dat onderhoud elke drie maanden plant op de eerste van de maand tussen 9:00 en 13:00 uur in de UTC-08 tijdzone. Er is ook een uitzondering van 2023-12-23 tot 2024-01-05 waar onderhoud niet is toegestaan, zelfs als het overlapt met een onderhoudsvenster.

   {
     "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. Voeg de configuratie van het onderhoudsvenster toe met behulp van de az aks maintenanceconfiguration add opdracht met de --config-file parameter.

   In het eerste voorbeeld wordt een nieuwe default configuratie toegevoegd met behulp van het default.json bestand. In het tweede voorbeeld wordt een nieuwe aksManagedAutoUpgradeSchedule configuratie toegevoegd met behulp van het autoUpgradeWindow.json bestand.

   # 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
   

Voeg de configuratie van het onderhoudsvenster toe aan main.tf met behulp van de azapi_resource resource.

Standaardonderhoudsconfiguratie

In het volgende voorbeeld wordt een default onderhoudsconfiguratie gemaakt waarmee onderhoud wordt gepland om elke zaterdag in de UTC-04:00 tijdzone van 2:00 tot 16:00 uur uit te voeren:

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

Onderhoudsconfiguratie automatisch upgraden

In het volgende voorbeeld wordt een aksManagedAutoUpgradeSchedule onderhoudsconfiguratie gemaakt waarmee het onderhoud elke zondag wordt gepland van 1:00 tot 17:00 uur in de UTC-04:00 tijdzone, te beginnen op 20 april 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
         }
       }
     }
   }
 }
}

Onderhoudsconfiguratie voor upgrade van knoopbesturingssystemen

In het volgende voorbeeld wordt een aksManagedNodeOSUpgradeSchedule onderhoudsconfiguratie gemaakt waarmee het onderhoud elke maandag van 03:00 tot 7:00 uur in de UTC-04:00 tijdzone wordt gepland, te beginnen op 21 april 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
         }
       }
     }
   }
 }
}

Werk een bestaande onderhoudsconfiguratie bij met behulp van de az aks maintenanceconfiguration update opdracht.

In het volgende voorbeeld wordt de default configuratie bijgewerkt om te plannen dat het onderhoud elke vrijdag van 2:00 tot 06:00 uur wordt uitgevoerd:

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. Navigeer in de Azure-portal naar uw AKS-clusterresource.

2. Selecteer Upgrades in het servicemenu onder Instellingen.

3. Selecteer Onder Upgrade>Automatic Upgrade Scheduler de optie Schema bewerken.

   

4. Werk in het deelvenster Onderhoudschema bewerken de instellingen van het onderhoudsvenster indien nodig bij.

5. Selecteer Opslaan.

1. Werk het JSON-configuratiebestand bij met de nieuwe instellingen voor het onderhoudsvenster.

   In het volgende voorbeeld wordt het default.json bestand van de vorige sectie bijgewerkt om onderhoud te plannen om elke maandag van 2:00 tot 16:00 uur uit te voeren:

   {
     "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. Werk de configuratie van het onderhoudsvenster bij met behulp van de az aks maintenanceconfiguration update opdracht met de --config-file parameter:

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

Als u al een bestaand AKS-cluster hebt dat wordt beheerd door Terraform, kunt u de configuratie van het onderhoudsvenster bijwerken door het Terraform-configuratiebestand te wijzigen en de wijzigingen toe te passen met behulp van de terraform apply opdracht.

Terraform initialiseren

Initialiseer Terraform in de map met het main.tf bestand met behulp van de terraform init opdracht. Met deze opdracht wordt de Azure-provider gedownload die is vereist voor het beheren van Azure resources met Terraform.

terraform init

Een Terraform-uitvoeringsplan maken

Maak een Terraform-uitvoeringsplan met behulp van de terraform plan opdracht. Met deze opdracht ziet u de resources die Terraform maakt of wijzigt in uw Azure-abonnement.

terraform plan

De Terraform-configuratie toepassen

Nadat u het uitvoeringsplan hebt bekeken en bevestigd, past u de Terraform-configuratie toe met behulp van de terraform apply opdracht. Met deze opdracht maakt of wijzigt u de resources die zijn gedefinieerd in uw main.tf-bestand in uw Azure-abonnement.

terraform apply

Verwijder een onderhoudsconfiguratievenster in uw AKS-cluster met behulp van de az aks maintenanceconfiguration delete opdracht.

In het volgende voorbeeld wordt de autoUpgradeSchedule onderhoudsconfiguratie verwijderd:

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

1. Navigeer in de Azure-portal naar uw AKS-clusterresource.

2. Selecteer clusterconfiguratie in het servicemenu onder Instellingen.

3. Selecteer Onder Upgrade>Automatic Upgrade Scheduler de optie Schema bewerken.

   

4. Selecteer Planning verwijderen in het deelvenster Onderhoudsplanning bewerken.

   

Verwijder een onderhoudsconfiguratievenster in uw AKS-cluster met behulp van de az aks maintenanceconfiguration delete opdracht.

In het volgende voorbeeld wordt de autoUpgradeSchedule onderhoudsconfiguratie verwijderd:

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

Als u een onderhoudsconfiguratie wilt verwijderen, verwijdert u het bijbehorende blok uit uw Terraform-configuratie en past u de wijzigingen toe met behulp van de terraform apply opdracht.