Plánování a řízení upgradů clusteru Azure Kubernetes Service pomocí plánované údržby

Článek
05/02/2024

V tomto článku se dozvíte, jak pomocí plánované údržby naplánovat a řídit upgrady imagí clusteru a uzlů ve službě Azure Kubernetes Service (AKS).

V clusteru AKS se provádí pravidelná údržba automaticky. Existují dva typy operací údržby:

Údržba iniciovaná službou AKS zahrnuje týdenní vydání, které AKS provádí, aby byl cluster aktuální s nejnovějšími funkcemi a opravami.
Údržba iniciovaná uživatelem zahrnuje automatické upgrady clusteru a automatické aktualizace zabezpečení operačního systému uzlu.

Pokud používáte funkci plánované údržby v AKS, můžete spustit oba typy údržby ve zvoleném tempu, abyste minimalizovali dopad úloh. Plánovanou údržbu můžete použít k naplánování načasování automatických upgradů, ale povolení nebo zakázání plánované údržby nepovolí nebo zakáže automatické upgrady.

Než začnete

Tento článek předpokládá, že máte existující cluster AKS. Pokud cluster AKS nemáte, přečtěte si téma Vytvoření clusteru AKS.
Pokud používáte Azure CLI, pomocí příkazu upgradujte na nejnovější verzi az upgrade .

Důležité informace

Při použití plánované údržby platí následující aspekty:

AKS si vyhrazuje právo přerušit časové intervaly plánované údržby pro neplánované, reaktivní operace údržby, které jsou naléhavé nebo kritické. Tyto operace údržby můžou běžet i během notAllowedTime období notAllowedDates definovaných v konfiguraci.
Operace údržby se považují pouze za nejlepší úsilí a nejsou zaručeny, že se v zadaném okně objeví.

Plánování typů konfigurace pro plánovanou údržbu

Pro plánovanou údržbu jsou k dispozici tři typy konfigurace plánu:

default je základní konfigurace pro řízení verzí AKS. Uvedení verzí do všech oblastí v počátečním čase expedice může trvat až dva týdny, a to z důvodu postupů bezpečného nasazení Azure.

Zvolte default , že chcete tyto aktualizace naplánovat způsobem, který je pro vás nejméně rušivý. Stav probíhající verze AKS můžete monitorovat podle oblastí pomocí týdenního sledování vydaných verzí.
aksManagedAutoUpgradeSchedule určuje, kdy provést upgrady clusteru naplánované určeným kanálem automatického upgradu. Pomocí této konfigurace můžete v porovnání default s konfigurací nakonfigurovat jemněji řízená nastavení četnosti a opakování. Další informace o automatickém upgradu clusteru najdete v tématu Automatické upgrade clusteru Azure Kubernetes Service.
aksManagedNodeOSUpgradeSchedule určuje, kdy provést opravy zabezpečení operačního systému uzlu naplánované kanálem automatického upgradu operačního systému uzlu. Pomocí této konfigurace můžete v porovnání default s konfigurací nakonfigurovat jemněji řízená nastavení četnosti a opakování. Další informace o kanálech automatického upgradu operačního systému uzlu najdete v tématu Automatické opravy a aktualizace imagí uzlů clusteru AKS.

Doporučujeme použít aksManagedAutoUpgradeSchedule pro všechny scénáře upgradu clusteru a aksManagedNodeOSUpgradeSchedule pro všechny scénáře oprav zabezpečení operačního systému uzlu.

Tato default možnost je určená výhradně pro týdenní verze AKS. Konfiguraci můžete přepnout default na aksManagedAutoUpgradeSchedule konfiguraci pomocí aksManagedNodeOSUpgradeScheduleaz aks maintenanceconfiguration update příkazu.

Vytvoření časového období údržby

Poznámka:

Pokud používáte automatický upgrade, abyste zajistili správné funkce, použijte časové období údržby s dobou trvání čtyř hodin nebo více.

Časové intervaly plánované údržby jsou uvedeny ve standardu UTC (Coordinated Universal Time).

Časové default období údržby má následující vlastnosti:

Název	Popis	Default value
`timeInWeek`	`default` V konfiguraci tato vlastnost obsahuje `day` hodnoty`hourSlots`, které definují časové období údržby.	Nelze použít
`timeInWeek.day`	Den v týdnu, kdy se má provést údržba v `default` konfiguraci.	Nelze použít
`timeInWeek.hourSlots`	Seznam hodinových časových úseků pro provádění údržby v konkrétní den v `default` konfiguraci.	Nelze použít
`notAllowedTime`	Rozsah dat, která údržba nemůže spustit, určená vlastnostmi a `end` podřízenými vlastnostmi`start`. Tato vlastnost se vztahuje pouze při vytváření časového období údržby pomocí konfiguračního souboru.	Nelze použít

Časové aksManagedAutoUpgradeSchedule období údržby aksManagedNodeOSUpgradeSchedule má následující vlastnosti:

Název	Popis	Default value
`utcOffset`	Časové pásmo pro údržbu clusteru.	`+00:00`
`startDate`	Datum, kdy se časové období údržby začne projevit.	Aktuální datum v době vytvoření
`startTime`	Čas zahájení údržby na základě časového pásma určeného `utcOffset`.	Nelze použít
`schedule`	Frekvence upgradu. K dispozici jsou tři typy: `Weekly`, `AbsoluteMonthly`a `RelativeMonthly`.	Nelze použít
`intervalDays`	Interval ve dnech spuštění údržby. Platí pouze pro `aksManagedNodeOSUpgradeSchedule`.	Nelze použít
`intervalWeeks`	Interval v týdnech pro běhy údržby.	Nelze použít
`intervalMonths`	Interval v měsících pro běhy údržby.	Nelze použít
`dayOfWeek`	Zadaný den v týdnu pro zahájení údržby.	Nelze použít
`durationHours`	Doba trvání časového období pro spuštění údržby.	Nelze použít
`notAllowedDates`	Rozsah dat, která údržba nemůže spustit, určená vlastnostmi a `end` podřízenými vlastnostmi`start`. Dá se použít jenom v případě, že vytváříte časové období údržby pomocí konfiguračního souboru.	Nelze použít

Typy plánů

K dispozici jsou čtyři dostupné typy plánů: Daily, Weekly, AbsoluteMonthlya RelativeMonthly.

Weekly, AbsoluteMonthlya RelativeMonthly typy plánů se vztahují pouze na aksManagedClusterAutoUpgradeSchedule a aksManagedNodeOSUpgradeSchedule konfigurace. Daily plány se vztahují pouze na aksManagedNodeOSUpgradeSchedule konfigurace.

Všechna pole zobrazená pro každý typ plánu jsou povinná.

Plán Daily může vypadat takto: "každých tři dny":

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

Plán Weekly může vypadat jako "každý dva týdny v pátek":

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

Plán AbsoluteMonthly může vypadat takto: "každý tři měsíce v prvním dni v měsíci":

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

Plán RelativeMonthly může vypadat takto: "Každý dva měsíce v posledním pondělí":

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

Platné hodnoty pro weekIndex zahrnutí First, , ThirdSecond, Fourth, a Last.

Přidání konfigurace časového období údržby

Přidejte konfiguraci časového období údržby do clusteru AKS pomocí az aks maintenanceconfiguration add příkazu.

První příklad přidá novou default konfiguraci, která plánuje spuštění údržby od 1:00 do 2:00 do každou pondělí. Druhý příklad přidá novou aksManagedAutoUpgradeSchedule konfiguraci, která plánuje spuštění údržby každý třetí pátek od 12:00 do 8:00 v časovém pásmu UTC+5:30 .

# Add a new default configuration
az aks maintenanceconfiguration add --resource-group myResourceGroup --cluster-name myAKSCluster --name default --weekday Monday --start-hour 1

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

Poznámka:

Pokud používáte default typ konfigurace, můžete parametr vynechat --start-time , aby umožňoval údržbu kdykoli během dne.

Soubor JSON můžete použít k vytvoření konfigurace údržby místo použití parametrů. Pokud použijete tuto metodu, můžete zabránit údržbě během řady kalendářních dat zadáním notAllowedTimes konfigurace default a notAllowedDatesaksManagedAutoUpgradeSchedule konfigurací.

Vytvořte soubor JSON s nastavením časového období údržby.

Následující příklad vytvoří default.json soubor, který naplánuje spuštění údržby od 1:00 do 3:00 do 3:00 každé úterý a středu v časovém pásmu UTC . Existuje také výjimka z toho, že 2021-05-26T03:00:00Z2021-05-30T12:00:00Z údržba není povolená, i když se překrývá s časovým obdobím údržby.

{
  "timeInWeek": [
    {
      "day": "Tuesday",
      "hour_slots": [
        1,
        2
      ]
    },
    {
      "day": "Wednesday",
      "hour_slots": [
        1,
        6
      ]
    }
  ],
  "notAllowedTime": [
    {
      "start": "2021-05-26T03:00:00Z",
      "end": "2021-05-30T12:00:00Z"
    }
  ]
}

Následující příklad vytvoří autoUpgradeWindow.json soubor, který naplánuje spuštění údržby každé tři měsíce v prvním měsíci od 9:00 do 13:00 v časovém pásmu UTC-08 . Existuje také výjimka z toho, že 2023-12-232024-01-05 údržba není povolená, i když se překrývá s časovým obdobím údržby.

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

Přidejte konfiguraci časového období údržby pomocí az aks maintenanceconfiguration add příkazu s parametrem --config-file .

První příklad přidá novou default konfiguraci pomocí default.json souboru. Druhý příklad přidá novou aksManagedAutoUpgradeSchedule konfiguraci pomocí autoUpgradeWindow.json souboru.

# Add a new default configuration
az aks maintenanceconfiguration add -g myResourceGroup --cluster-name myAKSCluster --name default --config-file ./default.json

# Add a new aksManagedAutoUpgradeSchedule configuration
az aks maintenanceconfiguration add -g myResourceGroup --cluster-name myAKSCluster --name aksManagedAutoUpgradeSchedule --config-file ./autoUpgradeWindow.json

Aktualizace existujícího časového období údržby

Pomocí příkazu aktualizujte existující konfiguraci údržby az aks maintenanceconfiguration update .

Následující příklad aktualizuje default konfiguraci tak, aby plánoval údržbu tak, aby se spustila od 2:00 do 3:00 do každou pondělí:

az aks maintenanceconfiguration update --resource-group myResourceGroup --cluster-name myAKSCluster --name default --weekday Monday --start-hour 2

Aktualizujte konfigurační soubor JSON pomocí nového nastavení časového období údržby.

Následující příklad aktualizuje default.json soubor z předchozí části tak, aby plánoval údržbu tak, aby běžel od 2:00 do 3:00 do 3:00 každé pondělí:
```
{
  "timeInWeek": [
    {
      "day": "Monday",
      "hour_slots": [
        2,
        3
      ]
    }
  ],
  "notAllowedTime": [
    {
      "start": "2021-05-26T03:00:00Z",
      "end": "2021-05-30T12:00:00Z"
    }
  ]
}
```

Aktualizujte konfiguraci časového období údržby az aks maintenanceconfiguration update pomocí příkazu s parametrem --config-file :

az aks maintenanceconfiguration update --resource-group myResourceGroup --cluster-name myAKSCluster --name default --config-file ./default.json

Výpis všech časových období údržby v existujícím clusteru

Pomocí příkazu zobrazte seznam aktuálních časových intervalů konfigurace údržby v clusteru az aks maintenanceconfiguration list AKS:

az aks maintenanceconfiguration list --resource-group myResourceGroup --cluster-name myAKSCluster

Zobrazení určitého časového období konfigurace údržby v existujícím clusteru

Pomocí příkazu s --name parametrem az aks maintenanceconfiguration show zobrazte v clusteru AKS konkrétní okno konfigurace údržby:

az aks maintenanceconfiguration show --resource-group myResourceGroup --cluster-name myAKSCluster --name aksManagedAutoUpgradeSchedule

Následující příklad výstupu ukazuje časové období údržby pro 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
}

Odstranění časového období konfigurace údržby v existujícím clusteru

Pomocí příkazu odstraňte okno konfigurace údržby v clusteru az aks maintenanceconfiguration delete AKS.

Následující příklad odstraní konfiguraci údržby autoUpgradeSchedule :

az aks maintenanceconfiguration delete --resource-group myResourceGroup --cluster-name myAKSCluster --name autoUpgradeSchedule