Użyj planowanej konserwacji do harmonogramowania i kontrolowania uaktualnień klastra Azure Kubernetes Service

W tym artykule pokazano, jak wykorzystać planowane prace konserwacyjne do planowania i kontrolowania uaktualnień obrazów klastra i węzłów w Azure Kubernetes Service (AKS).

Regularna konserwacja w klastrze AKS jest wykonywana automatycznie. Istnieją dwa typy operacji konserwacji:

Prace konserwacyjne przeprowadzane przez AKS obejmują cotygodniowe wydania, które AKS wykonuje, aby zapewnić, że klaster będzie na bieżąco z najnowszymi funkcjami i poprawkami.
Konserwacja inicjowana przez użytkownika obejmuje automatyczne uaktualnienia klastra i automatyczne aktualizacje zabezpieczeń systemu operacyjnego węzła.

W przypadku korzystania z funkcji planowanej konserwacji w usłudze AKS można uruchamiać oba typy konserwacji w wybranym okresie, aby zminimalizować wpływ obciążenia.

Uwaga

Planowana konserwacja umożliwia zaplanowanie harmonogramu automatycznych uaktualnień, ale włączanie lub wyłączanie planowanej konserwacji nie włącza ani nie wyłącza automatycznych uaktualnień.

Zanim rozpoczniesz

W tym artykule założono, że masz istniejący klaster AKS. Jeśli nie masz klastra usługi AKS, zobacz Tworzenie klastra usługi AKS.

Jeśli używasz Azure CLI, przeprowadź uaktualnienie do najnowszej wersji przy użyciu polecenia az upgrade.

Aktywna subskrypcja Azure. Jeśli nie masz subskrypcji Azure, przed rozpoczęciem utwórz konto free.
Ustaw kontekst subskrypcji przy użyciu az account set polecenia . Przykład:
```
az account set --subscription "00000000-0000-0000-0000-000000000000"
```
Narzędzie Terraform zainstalowane lokalnie. Aby uzyskać instrukcje dotyczące instalacji, zobacz Instalowanie programu Terraform.

Kwestie wymagające rozważenia

W przypadku korzystania z planowanej konserwacji mają zastosowanie następujące zagadnienia:

Usługa AKS zastrzega sobie prawo do przerwania zaplanowanych okien konserwacji dla nieplanowanych, reaktywnych operacji konserwacji, które są pilne lub krytyczne. Te operacje konserwacji mogą być nawet uruchamiane w okresach notAllowedTime lub notAllowedDates zdefiniowanych w konfiguracji.
Operacje konserwacji są uznawane tylko za najlepsze nakłady pracy i nie mają gwarancji, że występują w określonym oknie.

Planowanie typów konfiguracji na potrzeby planowanej konserwacji

Do planowanej konserwacji są dostępne trzy typy konfiguracji harmonogramu:

default to podstawowa konfiguracja umożliwiająca kontrolowanie wydań AKS, obejmująca składniki płaszczyzny kontrolnej oraz aktualizację dodatków systemowych. Wdrożenie wersji od momentu początkowej wysyłki do wszystkich regionów może potrwać do dwóch tygodni z powodu praktyk bezpiecznego wdrażania Azure.

Wybierz default , aby zaplanować te aktualizacje w sposób najmniej destrukcyjny dla Ciebie. Stan bieżącej wersji usługi AKS można monitorować za pomocą monitora cotygodniowego wydania według regionu.
aksManagedAutoUpgradeSchedule określa, kiedy przeprowadzić uaktualnienia klastra zaplanowane przez wyznaczony kanał automatycznego uaktualniania. W porównaniu z konfiguracją default, można za pomocą tej konfiguracji skonfigurować bardziej precyzyjne ustawienia rytmu i powtarzania. Aby uzyskać więcej informacji na temat automatycznego uaktualniania klastra, zobacz Automatycznie uaktualnij klaster Azure Kubernetes Service.
aksManagedNodeOSUpgradeSchedule określa, kiedy należy wykonać poprawki zabezpieczeń systemu operacyjnego węzła zaplanowane przez kanał automatycznego uaktualniania systemu operacyjnego węzła. W porównaniu z konfiguracją default, można za pomocą tej konfiguracji skonfigurować bardziej precyzyjne ustawienia rytmu i powtarzania. Aby uzyskać więcej informacji na temat kanałów automatycznego uaktualniania systemu operacyjnego węzła, zobacz Automatyczne poprawianie i aktualizowanie obrazów węzłów klastra usługi AKS.

Zalecamy używanie aksManagedAutoUpgradeSchedule dla wszystkich scenariuszy aktualizacji wersji klastra Kubernetes i aksManagedNodeOSUpgradeSchedule dla wszystkich scenariuszy stosowania poprawek zabezpieczeń systemu operacyjnego węzła.

Opcja default jest przeznaczona wyłącznie dla cotygodniowych wydań usługi AKS. Użyj default polecenia, jeśli chcesz kontrolować harmonogram uaktualniania składników płaszczyzny sterowania usługi AKS (takich jak serwer API, ETCD itp.) i dodatków (takich jak CoreDNS, Serwer metryk itp.).

Wszystkie trzy typy konfiguracji mogą współistnieć.

Tworzenie okna obsługi

Uwaga

W przypadku korzystania z automatycznego uaktualniania, aby zapewnić odpowiednią funkcjonalność, użyj okna obsługi z czasem trwania co najmniej czterech godzin.

Uwaga

Od wersji interfejsu API z 2023-05-01, używaj właściwości z poniższej tabeli do konfiguracji default.

Okno aksManagedAutoUpgradeSchedule obsługi lub aksManagedNodeOSUpgradeSchedule oraz konfiguracja od wersji interfejsu API 2023-05-01 ma następujące właściwości:

Nazwa/nazwisko	opis	Domyślna wartość
`utcOffset`	Strefa czasowa konserwacji klastra.	`+00:00`
`startDate`	Data, od której okno obsługi zaczyna obowiązywać.	Bieżąca data w momencie tworzenia
`startTime`	Czas rozpoczęcia konserwacji na podstawie strefy czasowej określonej przez `utcOffset`.	Nie dotyczy
`schedule`	Częstotliwość uaktualniania. Dostępne są trzy typy: `Weekly`, `AbsoluteMonthly`i `RelativeMonthly`.	Nie dotyczy
`intervalDays`	Okres w dniach między przeglądami konserwacyjnymi. Ma zastosowanie tylko do `aksManagedNodeOSUpgradeSchedule`.	Nie dotyczy
`intervalWeeks`	Interwał w tygodniach dla przebiegów konserwacji.	Nie dotyczy
`intervalMonths`	Interwał w miesiącach dla przebiegów konserwacji.	Nie dotyczy
`dayOfWeek`	Określony dzień tygodnia na rozpoczęcie konserwacji.	Nie dotyczy
`durationHours`	Czas trwania okna konserwacyjnego.	Nie dotyczy
`notAllowedDates`	Zakres dat, w których konserwacja nie może być przeprowadzona, określony przez właściwości podrzędne `start` i `end`. Ma zastosowanie tylko wtedy, gdy tworzysz okno obsługi przy użyciu pliku konfiguracji.	Nie dotyczy

Przestarzałe właściwości

Uwaga

Jeśli tworzysz konfigurację default z następującymi przestarzałymi właściwościami, zostanie ona automatycznie zmigrowana do nowych właściwości pokazanych w poprzedniej tabeli.

[Przestarzałe] Okno default obsługi ma następujące starsze właściwości:

Nazwa/nazwisko	opis	Domyślna wartość
`timeInWeek`	W konfiguracji `default` ta właściwość zawiera wartości `day` i `hourSlots` definiujące okno obsługi.	Nie dotyczy
`timeInWeek.day`	Dzień tygodnia, w którym przeprowadzana jest konserwacja w konfiguracji `default`.	Nie dotyczy
`timeInWeek.hourSlots`	Lista godzinowych przedziałów czasu do przeprowadzania konserwacji w określonym dniu w `default` konfiguracji.	Nie dotyczy
`notAllowedTime`	Zakres dat, w których konserwacja nie może być przeprowadzona, określony przez właściwości podrzędne `start` i `end`. Ta właściwość ma zastosowanie tylko w przypadku tworzenia okna obsługi przy użyciu pliku konfiguracji.	Nie dotyczy

Typy harmonogramu

Obsługiwane są cztery typy harmonogramów: Daily, , WeeklyAbsoluteMonthlyi RelativeMonthly.

W poniższej tabeli przedstawiono typy dostępne dla każdej opcji konfiguracji konserwacji:

Typ harmonogramu	`default`	`aksManagedClusterAutoUpgradeSchedule`	`aksManagedNodeOSUpgradeSchedule`
Codziennie	Nieobsługiwane ❌	Obsługiwane ✅ (po czerwcu 2025 r.)	Obsługiwane ✅
Co tydzień	Obsługiwane ✅	Obsługiwane ✅	Obsługiwane ✅
Stały miesięczny	Nieobsługiwane ❌	Obsługiwane ✅	Obsługiwane ✅
Miesiąc relatywny	Nieobsługiwane ❌	Obsługiwane ✅	Obsługiwane ✅

Wymagane są wszystkie pola wyświetlane dla każdego typu harmonogramu.

Harmonogram Daily może wyglądać następująco: "co trzy dni":

"schedule": {
    "daily": {
        "intervalDays": 3
    }
}

Harmonogram Weekly może wyglądać następująco: "co dwa tygodnie w piątek":

"schedule": {
    "weekly": {
        "intervalWeeks": 2,
        "dayOfWeek": "Friday"
    }
}

Harmonogram AbsoluteMonthly może wyglądać następująco: "co trzy miesiące pierwszego dnia miesiąca":

"schedule": {
    "absoluteMonthly": {
        "intervalMonths": 3,
        "dayOfMonth": 1
    }
}

Harmonogram RelativeMonthly może wyglądać następująco: "co dwa miesiące w ostatni poniedziałek":

"schedule": {
    "relativeMonthly": {
        "intervalMonths": 2,
        "dayOfWeek": "Monday",
        "weekIndex": "Last"
    }
}

Prawidłowe wartości dla weekIndex obejmują First, Second, Third, Fourth i Last.

Tworzenie pliku konfiguracji narzędzia Terraform

Pliki konfiguracji narzędzia Terraform definiują infrastrukturę, którą program Terraform tworzy i zarządza.

Utwórz plik o nazwie main.tf i dodaj następujący kod, aby zdefiniować wersję programu Terraform i określić dostawcę Azure:

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

Tworzenie grupy zasobów

Dodaj następujący kod do main.tf, aby utworzyć grupę zasobów Azure. Zaktualizuj wartości location i name, aby odpowiadały Twojemu środowisku.

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

Utwórz klaster AKS

Dodaj następujący kod do main.tf, aby utworzyć klaster AKS. Zaktualizuj dowolne wartości zgodnie z potrzebami, aby pasowały do środowiska.

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

Dodaj konfigurację okna konserwacji

Dodaj konfigurację okna obsługi do klastra usługi AKS przy użyciu az aks maintenanceconfiguration add polecenia .

Pierwszy przykład dodaje nową default konfigurację, która planuje uruchomienie konserwacji od godziny 1:00 do 5:00 każdego poniedziałku w UTC strefie czasowej. Drugi przykład dodaje nową aksManagedAutoUpgradeSchedule konfigurację, która planuje uruchamianie konserwacji co trzeci piątek między 12:00 a 8:00 w UTC+5:30 strefie czasowej.

# 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

W portalu Azure przejdź do zasobu klastra AKS.
Z menu usługi w obszarze Ustawienia wybierz pozycję Uaktualnienia.
Pod Uaktualnianie>Automatyczne planowanie uaktualnień wybierz Dodaj harmonogram.
W okienku Dodawanie harmonogramu konserwacji skonfiguruj następujące ustawienia okna obsługi:
- Powtórzenia: wybierz częstotliwość okna konserwacji. Zalecamy wybranie opcji Co tydzień.
- Częstotliwość: wybierz dzień tygodnia dla okna obsługi. Zalecamy wybranie niedzieli.
- Data rozpoczęcia konserwacji: wybierz datę rozpoczęcia okna obsługi.
- Godzina rozpoczęcia konserwacji: wybierz godzinę rozpoczęcia okna obsługi.
- Przesunięcie UTC: Wybierz przesunięcie UTC dla okna konserwacji. Wartość domyślna to +00:00.
Wybierz Zapisz.

Możesz użyć pliku JSON, aby utworzyć konfigurację konserwacji zamiast używać parametrów. Korzystając z tej metody, można zapobiec konserwacji w zakresie dat, określając notAllowedDates dla parametrów default, aksManagedAutoUpgradeSchedule i konfiguracji aksManagedNodeOSUpgradeSchedule.

Utwórz plik JSON z ustawieniami okna obsługi.

Poniższy przykład tworzy default.json plik, który planuje konserwację do uruchomienia od 1:00 do 5:00 co wtorek w UTC strefie czasowej. Istnieje również wyjątek od 2021-05-26 do 2021-05-30, gdzie konserwacja nie jest dozwolona, nawet jeśli nakłada się na okno konserwacji.

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

W poniższym przykładzie tworzony jest plik autoUpgradeWindow.json, który planuje uruchamianie konserwacji co trzy miesiące pierwszego dnia miesiąca, między 9:00 rano a 13:00 po południu, w strefie czasowej UTC-08. Istnieje również wyjątek od 2023-12-23 do 2024-01-05, gdzie konserwacja nie jest dozwolona, nawet jeśli nakłada się na okno konserwacji.

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

Dodaj konfigurację okna obsługi przy użyciu az aks maintenanceconfiguration add polecenia z parametrem --config-file .

Pierwszy przykład dodaje nową default konfigurację przy użyciu default.json pliku . Drugi przykład dodaje nową aksManagedAutoUpgradeSchedule konfigurację przy użyciu autoUpgradeWindow.json pliku .

# 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

Dodaj konfigurację okna obsługi do main.tf, korzystając z zasobu azapi_resource.

Domyślna konfiguracja konserwacji

Poniższy przykład tworzy konfigurację default konserwacji, która zaplanowano uruchomienie od 2:00 nad ranem do 6:00 nad ranem w każdą sobotę w UTC-04:00 strefie czasowej.

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

Konfiguracja konserwacji automatycznego zwiększania poziomu

Poniższy przykład tworzy konfigurację harmonogramu aksManagedAutoUpgradeSchedule konserwacyjnego, planując wykonywanie prac konserwacyjnych zaplanowanych na każdą niedzielę od 1:00 do 5:00 w UTC-04:00 strefie czasowej, począwszy od 20 kwietnia 2026 r.

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

Konfiguracja konserwacji uaktualniania systemu operacyjnego Node

Poniższy przykład tworzy konfigurację aksManagedNodeOSUpgradeSchedule konserwacji, która planuje uruchamianie konserwacji w każdy poniedziałek od 3:00 do 7:00 w strefie czasowej UTC-04:00, zaczynając od 21 kwietnia 2026 roku.

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

Aktualizowanie istniejącego okna obsługi

Zaktualizuj istniejącą konfigurację konserwacji przy użyciu az aks maintenanceconfiguration update polecenia .

Poniższy przykład aktualizuje konfigurację default w celu zaplanowania konserwacji, która będzie działać od 2:00 do 6:00 każdego piątku.

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

W portalu Azure przejdź do zasobu klastra usługi AKS.
Z menu usługi w obszarze Ustawienia wybierz pozycję Uaktualnienia.
W obszarze Uaktualnianie>harmonogram automatycznego uaktualniania, wybierz pozycję Edytuj harmonogram.
W okienku Edytowanie harmonogramu konserwacji zaktualizuj ustawienia okna obsługi zgodnie z potrzebami.
Wybierz Zapisz.

Zaktualizuj plik JSON konfiguracji przy użyciu nowych ustawień okna obsługi.

Poniższy przykład aktualizuje default.json plik z poprzedniej sekcji aby zaplanować prace konserwacyjne na czas od 2:00 rano do 6:00 rano każdego poniedziałku.

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

Zaktualizuj konfigurację okna obsługi przy użyciu az aks maintenanceconfiguration update polecenia z parametrem --config-file :

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

Jeśli masz już istniejący klaster usługi AKS zarządzany przez program Terraform, możesz zaktualizować konfigurację okna obsługi, modyfikując plik konfiguracji programu Terraform i stosując zmiany za pomocą terraform apply polecenia .

Inicjowanie narzędzia Terraform

Zainicjuj Terraform w katalogu zawierającym plik main.tf przy użyciu polecenia terraform init. To polecenie pobiera dostawcę Azure wymaganego do zarządzania zasobami Azure za pomocą narzędzia Terraform.

terraform init

Tworzenie planu wykonania programu Terraform

Utwórz plan wykonywania narzędzia Terraform przy użyciu terraform plan polecenia . To polecenie pokazuje zasoby, które narzędzie Terraform utworzy lub zmodyfikuje w ramach subskrypcji Azure.

terraform plan

Stosowanie konfiguracji narzędzia Terraform

Po przejrzeniu i potwierdzeniu planu wykonania zastosuj konfigurację narzędzia Terraform przy użyciu terraform apply polecenia . To polecenie tworzy lub modyfikuje zasoby zdefiniowane w pliku main.tf w subskrypcji Azure.

terraform apply

Wyświetlanie listy wszystkich okien obsługi w istniejącym klastrze

Wyświetl listę bieżących okien konfiguracji konserwacji w klastrze usługi AKS przy użyciu az aks maintenanceconfiguration list polecenia :

az aks maintenanceconfiguration list --resource-group $RESOURCE_GROUP --cluster-name $CLUSTER_NAME

Wyświetlanie określonego okna konfiguracji konserwacji w istniejącym klastrze

Wyświetl określone okienko konfiguracji konserwacji w klastrze AKS używając polecenia az aks maintenanceconfiguration show z parametrem --name:

az aks maintenanceconfiguration show --resource-group $RESOURCE_GROUP --cluster-name $CLUSTER_NAME --name aksManagedAutoUpgradeSchedule

W poniższym przykładowym wyniku przedstawiono okno obsługi dla aksManagedAutoUpgradeSchedule:

{
  "id": "/subscriptions/<subscription>/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/managedClusters/myAKSCluster/maintenanceConfigurations/aksManagedAutoUpgradeSchedule",
  "maintenanceWindow": {
    "durationHours": 4,
    "notAllowedDates": [
      {
        "end": "2024-01-05",
        "start": "2023-12-23"
      }
    ],
    "schedule": {
      "absoluteMonthly": {
        "dayOfMonth": 1,
        "intervalMonths": 3
      },
      "daily": null,
      "relativeMonthly": null,
      "weekly": null
    },
    "startDate": "2023-01-20",
    "startTime": "09:00",
    "utcOffset": "-08:00"
  },
  "name": "aksManagedAutoUpgradeSchedule",
  "notAllowedTime": null,
  "resourceGroup": "myResourceGroup",
  "systemData": null,
  "timeInWeek": null,
  "type": null
}

Usuwanie okna konfiguracji konserwacji w istniejącym klastrze

Usuń okno konfiguracji konserwacji w klastrze usługi AKS przy użyciu az aks maintenanceconfiguration delete polecenia .

Poniższy przykład usuwa konfigurację autoUpgradeSchedule konserwacji:

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

W portalu Azure przejdź do zasobu klastra usługi AKS.
Z menu usługi w obszarze Ustawienia wybierz pozycję Konfiguracja klastra.
W obszarze Uaktualnianie>harmonogram automatycznego uaktualniania, wybierz pozycję Edytuj harmonogram.
W okienku Edytowanie harmonogramu konserwacji wybierz pozycję Usuń harmonogram.

Usuń okno konfiguracji konserwacji w klastrze usługi AKS przy użyciu az aks maintenanceconfiguration delete polecenia .

Poniższy przykład usuwa konfigurację autoUpgradeSchedule konserwacji:

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

Aby usunąć konfigurację konserwacji, usuń odpowiedni blok z konfiguracji programu Terraform i zastosuj zmiany przy użyciu terraform apply polecenia .

Najczęściej zadawane pytania (FAQ)

Jak sprawdzić istniejące konfiguracje konserwacji w klastrze?

Użyj polecenia az aks maintenanceconfiguration show.

Czy doraźna, nieplanowana konserwacja może również wystąpić w `notAllowedDates` okresach?

Tak. Usługa AKS zastrzega sobie prawo do przerwania tych ram czasowych dla nieplanowanych, reaktywnych operacji konserwacji, które są pilne lub krytyczne.

Jak sprawdzić, czy wystąpiło zdarzenie konserwacji?

Aby sprawdzić wydania, sprawdź region klastra i znajdź informacje w cotygodniowych wydaniach, aby sprawdzić, czy są zgodne z twoim harmonogramem konserwacji. Aby wyświetlić stan automatycznych uaktualnień, wyszukaj dzienniki aktywności w klastrze. Możesz również wyszukać określone zdarzenia związane z uaktualnieniem usługi AKS, jak wspomniano w temacie Uaktualnienie klastra.

Usługa AKS również emituje zdarzenia Azure Event Grid związane z aktualizacjami. Aby dowiedzieć się więcej, zobacz AKS jako źródło usługi Event Grid.

Czy można używać więcej niż jednej konfiguracji konserwacji w tym samym czasie?

Tak, można uruchomić wszystkie trzy konfiguracje jednocześnie: default, aksManagedAutoUpgradeSchedulei aksManagedNodeOSUpgradeSchedule. Jeśli okna nakładają się na siebie, AKS decyduje o kolejności uruchamiania.

Skonfigurowano okno obsługi, ale uaktualnienie nie miało miejsce. Dlaczego?

Automatyczne uaktualnianie usługi AKS wymaga pewnego czasu, zwykle nie więcej niż 15 minut, aby uwzględnić okno konserwacji. Zalecamy co najmniej 15 minut między utworzeniem lub aktualizacją konfiguracji konserwacji a zaplanowanym czasem rozpoczęcia.

Upewnij się również, że klaster jest uruchamiany po uruchomieniu planowanego okna obsługi. Jeśli klaster zostanie zatrzymany, jego płaszczyzna kontrolna zostanie zwolniona i nie da się wykonać żadnych operacji.

Dlaczego jedna z moich pul agentów została zaktualizowana poza oknem konserwacji?

Usługa AKS uruchamia operacje związane z aktualizacją tylko podczas skonfigurowanego okna konserwacji. Jeśli operacja rozpoczyna się przed zamknięciem okna, może kontynuować działanie do momentu ukończenia, nawet jeśli wykracza to poza czas zakończenia okna.

Po zamknięciu okna usługa AKS nie uruchamia żadnych nowych operacji aktualizacji. Pozostałe prace nad aktualizacją są odroczone do przyszłego dostępnego okresu.

Przykład: Jeśli okno obsługi to 08:00-12:00, a uaktualnienie klastra lub puli węzłów, które zostało uruchomione przed 12:00, nadal trwa o godzinie 12:15, usługa AKS umożliwia zakończenie pracy w locie. Jednak usługa AKS nie inicjuje nowego procesu uaktualnienia po 12:00 w południe.

Czy istnieją najlepsze praktyki dotyczące konfiguracji konserwacji?

Zalecamy ustawienie harmonogramu aktualizacji zabezpieczeń systemu operacyjnego węzła na cotygodniowy okres, jeśli używasz kanału NodeImage , ponieważ nowy obraz węzła jest dostarczany co tydzień. Możesz również wybrać SecurityPatch kanał, aby otrzymywać codzienne aktualizacje zabezpieczeń.

Harmonogram automatycznego uaktualniania można ustawić na miesięczny okres, aby zachować aktualność w zasadach pomocy technicznej platformy Kubernetes N-2.

Szczegółowe omówienie najlepszych praktyk aktualizacji i innych kwestii można znaleźć w przewodniku po poprawkach i uaktualnieniach AKS.

Czy mogę skonfigurować wszystkie klastry w jednej subskrypcji tak, aby korzystały z tej samej konfiguracji konserwacji?

Nie zalecamy używania tej samej konfiguracji utrzymania dla wielu klastrów w jednej subskrypcji, co może prowadzić do błędów ograniczania przepustowości ARM, skutkujących nieudanymi aktualizacjami klastrów. Zamiast tego zalecamy rozłożenie okien obsługi dla każdego klastra, aby uniknąć tych błędów.

Dlaczego moje pule węzłów zostały uaktualnione dwa razy w tym samym oknie obsługi?

Jeśli nowsza wersja obrazu węzła stanie się dostępna w oknie obsługi, usługa AKS wykona ponowną aktualizację, aby upewnić się, że pule węzłów działają w najnowszej wersji. To zachowanie jest normalne i nie wskazuje problemu.

Aby rozpocząć uaktualnianie klastra usługi AKS, zobacz Opcje uaktualniania klastrów usługi AKS.

Opinia

Czy ta strona była pomocna?

Last updated on 2026-04-14

Użyj planowanej konserwacji do harmonogramowania i kontrolowania uaktualnień klastra Azure Kubernetes Service

Zanim rozpoczniesz

Kwestie wymagające rozważenia

Planowanie typów konfiguracji na potrzeby planowanej konserwacji

Tworzenie okna obsługi

Przestarzałe właściwości

Typy harmonogramu

Tworzenie pliku konfiguracji narzędzia Terraform

Tworzenie grupy zasobów

Utwórz klaster AKS

Dodaj konfigurację okna konserwacji

Domyślna konfiguracja konserwacji

Konfiguracja konserwacji automatycznego zwiększania poziomu

Konfiguracja konserwacji uaktualniania systemu operacyjnego Node

Aktualizowanie istniejącego okna obsługi

Inicjowanie narzędzia Terraform

Tworzenie planu wykonania programu Terraform

Stosowanie konfiguracji narzędzia Terraform

Wyświetlanie listy wszystkich okien obsługi w istniejącym klastrze

Wyświetlanie określonego okna konfiguracji konserwacji w istniejącym klastrze

Usuwanie okna konfiguracji konserwacji w istniejącym klastrze

Najczęściej zadawane pytania (FAQ)

Jak sprawdzić istniejące konfiguracje konserwacji w klastrze?

Czy doraźna, nieplanowana konserwacja może również wystąpić w notAllowedDates okresach?

Jak sprawdzić, czy wystąpiło zdarzenie konserwacji?

Czy można używać więcej niż jednej konfiguracji konserwacji w tym samym czasie?

Skonfigurowano okno obsługi, ale uaktualnienie nie miało miejsce. Dlaczego?

Dlaczego jedna z moich pul agentów została zaktualizowana poza oknem konserwacji?

Czy istnieją najlepsze praktyki dotyczące konfiguracji konserwacji?

Czy mogę skonfigurować wszystkie klastry w jednej subskrypcji tak, aby korzystały z tej samej konfiguracji konserwacji?

Dlaczego moje pule węzłów zostały uaktualnione dwa razy w tym samym oknie obsługi?

Treści powiązane

Opinia

Dodatkowe zasoby

Czy doraźna, nieplanowana konserwacja może również wystąpić w `notAllowedDates` okresach?