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

In dit artikel leest u hoe u gepland onderhoud kunt gebruiken om upgrades van cluster- en knooppuntinstallatiekopieën te plannen en beheren in Azure Kubernetes Service (AKS).

Regelmatig onderhoud wordt automatisch uitgevoerd op uw AKS-cluster. Er zijn twee soorten onderhoudsbewerkingen:

• AKS-geïnitieerd onderhoud omvat de wekelijkse releases die AKS uitvoert om uw cluster up-to-date te houden met de nieuwste functies en oplossingen.
• Door de gebruiker geïnitieerd onderhoud omvat automatische upgrades van clusters en knooppuntbesturingssysteem (OS) automatische beveiligingsupdates.

Wanneer u de functie van gepland onderhoud in AKS gebruikt, kunt u beide typen onderhoud uitvoeren in een frequentie van uw keuze om de impact van de werkbelasting te minimaliseren.

Voordat u begint

• In dit artikel wordt ervan uitgegaan dat u een bestaand AKS-cluster hebt. Zie Een AKS-cluster maken als u geen AKS-cluster hebt.
• Als u de Azure CLI gebruikt, voert u een upgrade uit naar de nieuwste versie met behulp van de az upgrade opdracht.

Overwegingen

Wanneer u gepland onderhoud gebruikt, zijn de volgende overwegingen van toepassing:

• AKS behoudt zich het recht voor om geplande onderhoudsvensters te breken voor ongeplande, reactieve onderhoudsbewerkingen die dringend of kritiek zijn. Deze onderhoudsbewerkingen kunnen zelfs worden uitgevoerd tijdens de notAllowedTime of notAllowedDates perioden die zijn gedefinieerd in uw configuratie.
• Onderhoudsbewerkingen worden alleen beschouwd als best effort en worden niet gegarandeerd binnen een opgegeven venster uitgevoerd.

Configuratietypen plannen voor gepland onderhoud

Er zijn drie planningsconfiguratietypen beschikbaar voor gepland onderhoud:

• default is een basisconfiguratie voor het beheren van AKS-releases, die betrekking hebben op onderdelen van het besturingsvlak en de upgrade van systeeminvoegtoepassingen. Het kan tot twee weken duren voordat de releases vanaf de eerste verzending naar alle regio's worden geïmplementeerd, vanwege de veilige implementatieprocedures van Azure.

  Kies ervoor default om deze updates te plannen op een manier die het minst storend voor u is. U kunt de status van een doorlopende AKS-release per regio bewaken met de wekelijkse releasetracker.

• aksManagedAutoUpgradeSchedule bepaalt wanneer u clusterupgrades wilt uitvoeren die zijn gepland door het aangewezen kanaal voor automatische upgrade. U kunt nauwkeuriger beheerde frequentie- en terugkeerinstellingen configureren met deze configuratie in vergelijking met de default configuratie. Zie Een Azure Kubernetes Service-cluster automatisch upgraden voor meer informatie over automatische upgrade van clusters.

• aksManagedNodeOSUpgradeSchedule bepaalt wanneer u de beveiligingspatch voor het knooppuntbesturingssysteem moet uitvoeren die is gepland door het kanaal voor automatische upgrade van het knooppuntbesturingssysteem. U kunt nauwkeuriger beheerde frequentie- en terugkeerinstellingen configureren met deze configuratie in vergelijking met de default configuratie. Zie AKS-clusterknooppuntinstallatiekopieën automatisch patchen en bijwerken voor meer informatie over kanalen voor automatische upgrade van knooppunten van knooppunten van het besturingssysteem.

We raden u aan aksManagedAutoUpgradeSchedule voor alle upgradescenario's voor Kubernetes-clusterversies en aksManagedNodeOSUpgradeSchedule voor alle patchscenario's voor knooppuntbesturingssysteembeveiliging.

De default optie is uitsluitend bedoeld voor wekelijkse AKS-releases. Gebruik default deze optie als u het upgradeschema voor onderdelen van het AKS-besturingsvlak (zoals API Server, ETCD, enzovoort) en invoegtoepassingen (zoals CoreDNS, Metrics Server, enzovoort) wilt beheren.

Alle drie de typen configuraties kunnen naast elkaar bestaan.

Een onderhoudsvenster maken

Een aksManagedAutoUpgradeSchedule of aksManagedNodeOSUpgradeSchedule onderhoudsvenster en default configuratie vanaf 2023-05-01 API-versie hebben de volgende eigenschappen:

Afgeschafte eigenschappen

[Afgeschaft] Een default onderhoudsvenster heeft de volgende verouderde eigenschappen:

Planningstypen

Vier schematypen worden ondersteund: Daily, Weekly, AbsoluteMonthlyen RelativeMonthly.

In de volgende tabel ziet u welke typen beschikbaar zijn voor elke optie voor onderhoudsconfiguratie:

Alle velden die voor elk schematype worden weergegeven, zijn vereist.

Een Daily planning kan er als volgt uitzien: 'elke drie dagen':

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

Een Weekly planning kan er als volgt uitzien: 'elke twee weken op vrijdag':

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

Een AbsoluteMonthly planning kan er als volgt uitzien: 'elke drie maanden op de eerste dag van de maand':

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

Een RelativeMonthly planning kan er als volgt uitzien: 'elke twee maanden op de afgelopen maandag':

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

Geldige waarden voor weekIndex include First, Second, Third, , Fourthen Last.

Een configuratie van een onderhoudsvenster toevoegen

# 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

Een bestaand onderhoudsvenster bijwerken

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

Alle onderhoudsvensters in een bestaand cluster weergeven

Geef de huidige onderhoudsconfiguratievensters in uw AKS-cluster weer met behulp van de az aks maintenanceconfiguration list opdracht:

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

Een specifiek onderhoudsconfiguratievenster in een bestaand cluster weergeven

Bekijk een specifiek onderhoudsconfiguratievenster in uw AKS-cluster met behulp van de az aks maintenanceconfiguration show opdracht met de --name parameter:

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

In de volgende voorbeelduitvoer ziet u het onderhoudsvenster voor 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
}

Een onderhoudsconfiguratievenster in een bestaand cluster verwijderen

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

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

Veelgestelde vragen (FAQ)

Hoe kan ik de bestaande onderhoudsconfiguraties in mijn cluster controleren?

Gebruik de opdracht az aks maintenanceconfiguration show.

Kan reactief, ongepland onderhoud ook plaatsvinden tijdens de notAllowedDates perioden?

Ja. AKS behoudt zich het recht voor om deze vensters te breken voor ongeplande, reactieve onderhoudsbewerkingen die dringend of kritiek zijn.

Hoe kan ik zien of er een onderhoudsgebeurtenis is opgetreden?

Voor releases controleert u de regio van uw cluster en zoekt u informatie op in wekelijkse releases om te zien of deze overeenkomt met uw onderhoudsschema. Als u de status van uw automatische upgrades wilt bekijken, zoekt u activiteitenlogboeken op in uw cluster. U kunt ook specifieke upgradegebeurtenissen opzoeken, zoals vermeld in Een AKS-cluster upgraden.

AKS verzendt ook upgradegerelateerde Azure Event Grid-gebeurtenissen. Zie AKS als een Event Grid-bron voor meer informatie.

Kan ik meer dan één onderhoudsconfiguratie tegelijk gebruiken?

Ja, u kunt alle drie de configuraties tegelijk uitvoeren: default, aksManagedAutoUpgradeSchedule, en aksManagedNodeOSUpgradeSchedule. Als de vensters elkaar overlappen, bepaalt AKS de uitvoeringsvolgorde.

Ik heb een onderhoudsvenster geconfigureerd, maar de upgrade is niet uitgevoerd. Waarom?

Automatische upgrade van AKS heeft een bepaalde tijd nodig, meestal niet meer dan 15 minuten, om rekening te houden met het onderhoudsvenster. We raden ten minste 15 minuten aan tussen het maken of bijwerken van een onderhoudsconfiguratie en de geplande begintijd.

Zorg er ook voor dat uw cluster wordt gestart wanneer het geplande onderhoudsvenster wordt gestart. Als het cluster is gestopt, wordt de toewijzing van het besturingsvlak ongedaan gemaakt en kunnen er geen bewerkingen worden uitgevoerd.

Waarom is een van mijn agentpools bijgewerkt buiten het onderhoudsvenster?

Als een agentgroep niet wordt bijgewerkt (bijvoorbeeld omdat budgetten voor podonderbreking dit verhinderden), kan deze later, buiten het onderhoudsvenster, worden bijgewerkt. Dit scenario wordt een inhaalupgrade genoemd. Het voorkomt dat agentpools worden bijgewerkt met een andere versie dan het AKS-besturingsvlak.

Een andere reden waarom een agentgroep onverwacht kan worden bijgewerkt, is wanneer er geen gedefinieerde onderhoudsconfiguratie is of als deze is verwijderd. In dat geval wordt een cluster met automatische upgrade , maar zonder een onderhoudsconfiguratie op willekeurige momenten bijgewerkt (terugvalschema), wat een ongewenst tijdsbestek kan zijn.

Zijn er best practices voor de onderhoudsconfiguraties?

Het is raadzaam om het beveiligingsupdatesschema voor het knooppuntbesturingssysteem in te stellen op een wekelijkse frequentie als u het NodeImage kanaal gebruikt, omdat er elke week een nieuwe knooppuntinstallatiekopie wordt verzonden. U kunt ook kiezen voor het SecurityPatch kanaal om dagelijkse beveiligingsupdates te ontvangen.

U kunt het schema voor automatische upgrade instellen op een maandelijkse frequentie om op de hoogte te blijven van het Ondersteuningsbeleid voor Kubernetes N-2.

Zie AKS-patch- en upgraderichtlijnen voor een gedetailleerde bespreking van best practices en andere overwegingen voor upgrades.

Kan ik al mijn clusters in één abonnement configureren om dezelfde onderhoudsconfiguratie te gebruiken?

We raden u niet aan dezelfde onderhoudsconfiguratie te gebruiken voor meerdere clusters in één abonnement, omdat dit kan leiden tot ARM-beperkingsfouten waardoor clusterupgrades mislukken. In plaats daarvan raden we u aan de onderhoudsvensters voor elk cluster te verdelen om deze fouten te voorkomen.

Waarom zijn mijn knooppuntgroepen tweemaal geüpgraded tijdens hetzelfde onderhoudsvenster?

Als er een nieuwere versie van de knooppuntinstallatiekopie beschikbaar komt tijdens het onderhoudsvenster, voert AKS een tweede upgrade uit om ervoor te zorgen dat uw knooppuntgroepen de nieuwste versie uitvoeren. Dit gedrag is normaal en geeft geen probleem aan.

Verwante inhoud

Zie Upgradeopties voor AKS-clusters om aan de slag te gaan met het upgraden van uw AKS-cluster.