Gepland onderhoud gebruiken om upgrades te plannen voor leden van Azure Kubernetes Application Network (preview)

Belangrijk

AKS preview-functies zijn beschikbaar op selfservice, opt-in basis. Previews worden geleverd 'zoals het is' en 'voor zover beschikbaar' en zijn uitgesloten van de serviceovereenkomsten en beperkte garantie. AKS-previews worden gedeeltelijk gedekt door klantondersteuning naar best vermogen. Zodoende zijn deze functies niet bedoeld voor productiegebruik. Zie de volgende ondersteuningsartikelen voor meer informatie:

In dit artikel wordt beschreven hoe u gepland onderhoud kunt gebruiken om onderdeelupgrades te plannen voor leden van Azure Kubernetes Application Network.

Overzicht van gepland onderhoud voor toepassingsnetwerk

Onderhoudsbewerkingen verwijzen naar de upgrade van onderdelen van het gegevensvlak in het cluster en onderdelen van het toepassingsnetwerkbesturingsvlak die buiten het cluster worden uitgevoerd, zoals Istiod.

Twee van de belangrijkste onderdelen in het cluster zijn de ztunnel-knooppuntproxy's en Istio CNI-knooppuntagents. Deze resources zijn daemonSets per knooppunt, dus hun upgrades zijn van invloed op een volledig knooppunt tegelijk en kunnen onderbrekingen van langdurige TCP-verbindingen veroorzaken. Om onderbrekingen op knooppuntniveau in een gemeenschappelijk venster te isoleren, gebruikt Application Network hetzelfde aksManagedNodeOSUpgradeSchedule onderhoudsschema als de automatische upgrades van het AKS-knooppunt (Azure Kubernetes Service) als dit is geconfigureerd.

Houd er rekening mee dat het onderhoudsvenster hetzelfde is, dat lidupgrades van het toepassingsnetwerk en upgrades van knooppuntbesturingssystemen onafhankelijke gebeurtenissen zijn binnen het venster dat voor een of beide onderdelen plaatsvindt, afhankelijk van de beschikbaarheid van upgrades. Geen van beide upgrades heeft invloed op de timing of het proces van de ander. Als beide onderdelen in hetzelfde venster worden bijgewerkt, zijn er mogelijk afzonderlijke verbindingsonderbrekingen voor elke upgrade in dat venster.

Opmerking

Het is niet nodig om automatische upgrades van het besturingssysteem van knooppunten uit te voeren om gepland onderhoud voor Application Network te gebruiken. Wanneer u een aksManagedNodeOSUpgradeSchedule maakt, worden automatische updates van het knooppunt-OS niet ingeschakeld of uitgeschakeld.

Vereiste voorwaarden

  • Een bestaand AKS-cluster dat is toegevoegd als lid van een Application Network-resource. Zie Aan de slag met Azure Kubernetes Application Network als u nog geen toepassingsnetwerkresource hebt of als u nog geen onboarding van uw cluster hebt uitgevoerd.
  • Azure CLI-versie is 2.84.0 of hoger. Controleer uw versie met behulp van de az --version opdracht. Als u Azure CLI wilt installeren of bijwerken, raadpleegt u Azure CLI installeren.
  • We raden u aan de documentatie over onderhoudsvensters te raadplegen om inzicht te hebben in de configuratievelden en hoe onderhoudsvensters in AKS werken.

Overwegingen

Houd rekening met de volgende overwegingen bij het gebruik van gepland onderhoud om upgrades van het toepassingsnetwerk te plannen:

  • Application Network behoudt zich het recht voor om geplande onderhoudsvensters te verbreken 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.
  • Als een poging tot upgrade niet is voltooid wanneer het venster sluit, gaat het door met pogingen tot afstemming totdat het is voltooid.

Modusspecifiek gedrag

U kunt gepland onderhoud gebruiken om de timing van volledig beheerde upgrades en zelfbeheerde upgrades te plannen, maar het in- of uitschakelen van gepland onderhoud heeft geen invloed op de upgrademodus zelf. Onderhoudsvensters reguleren verschillende soorten upgrades, afhankelijk van de upgrademodus van uw cluster.

  • Volledig beheerde modus: Onderhoudsvensters beheersen zowel kleine updates als patches. Als u echter een wijziging in een releasekanaal start, wordt de bijbehorende versiewijziging onmiddellijk van kracht.
  • Zelfbeheerde modus: Onderhoudsvensters zijn alleen van toepassing op patchupgrades. Als u een kleine versiewijziging start, wordt deze onmiddellijk van kracht.

Een onderhoudsvenster toevoegen

  • Voeg een aksManagedNodeOSUpgradeSchedule onderhoudsvensterconfiguratie toe aan een AKS-cluster met behulp van de az aks maintenanceconfiguration add opdracht. In het volgende voorbeeld wordt een nieuwe aksManagedNodeOSUpgradeSchedule configuratie toegevoegd waarmee het onderhoud elke derde vrijdag tussen 12:00 en 8:00 uur wordt uitgevoerd in de UTC+5:30 tijdzone:

    az aks maintenanceconfiguration add --resource-group $RESOURCE_GROUP --cluster-name $CLUSTER_NAME --name aksManagedNodeOSUpgradeSchedule --schedule-type Weekly --day-of-week Friday --interval-weeks 3 --duration 8 --utc-offset +05:30 --start-time 00:00
    

Een bestaand onderhoudsvenster bijwerken

  • Werk een bestaande onderhoudsconfiguratie bij met behulp van de az aks maintenanceconfiguration update opdracht. In het volgende voorbeeld wordt de configuratie bijgewerkt voor het aksManagedNodeOSUpgradeSchedule plannen van onderhoud om elke vrijdag van 2:00 tot 16:00 uur uit te voeren:

    az aks maintenanceconfiguration update --resource-group $RESOURCE_GROUP --cluster-name $CLUSTER_NAME --name aksManagedNodeOSUpgradeSchedule --schedule-type Weekly --day-of-week Friday --interval-weeks 1 --duration 4 --utc-offset +00:00 --start-time 02:00
    

De onderhoudsconfiguratie voor een cluster weergeven

  • Bekijk een specifiek venster voor onderhoudsconfiguratie in uw AKS-cluster met de az aks maintenanceconfiguration show opdracht en de --name parameter.

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

    In de volgende voorbeelduitvoer ziet u het onderhoudsvenster voor aksManagedNodeOSUpgradeSchedule:

    {
      "id": "/subscriptions/<subscription>/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/managedClusters/myAKSCluster/maintenanceConfigurations/aksManagedNodeOSUpgradeSchedule",
      "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": "aksManagedNodeOSUpgradeSchedule",
      "notAllowedTime": null,
      "resourceGroup": "myResourceGroup",
      "systemData": null,
      "timeInWeek": null,
      "type": null
    }
    

Een onderhoudsconfiguratie voor een cluster verwijderen

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

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

Zie de volgende artikelen voor meer informatie over Azure Kubernetes Application Network: