Verwenden Sie geplante Wartung, um Upgrades für Mitglieder des Azure Kubernetes Application Network zu planen (Vorschau).

Von Bedeutung

AKS-Vorschaufunktionen sind auf Selbstbedienungsbasis und freiwillig verfügbar. Vorschauversionen werden „im Istzustand“ und „wie verfügbar“ bereitgestellt und sind von den Service Level Agreements und der eingeschränkten Garantie ausgeschlossen. AKS-Vorschauversionen werden teilweise vom Kundensupport auf Grundlage der bestmöglichen Leistung abgedeckt. Daher sind diese Funktionen nicht für die Verwendung in der Produktion vorgesehen. Weitere Informationen finden Sie in den folgenden Supportartikeln:

In diesem Artikel erfahren Sie, wie Sie die geplante Wartung verwenden, um Komponentenupgrades für Azure Kubernetes-Anwendungsnetzwerkmitglieder zu planen.

Übersicht über die geplante Wartung des Anwendungsnetzwerks

Wartungsvorgänge beziehen sich auf das Upgrade von Komponenten in Clusterdatenebenen und Komponenten der Anwendungsnetzwerksteuerungsebene, die außerhalb des Clusters ausgeführt werden, z. B. Istiod.

Zwei der wichtigsten In-Cluster-Komponenten sind die Ztunnel-Knoten-Proxys und Istio CNI-Knoten-Agents. Diese Ressourcen sind daemonSets pro Knoten, sodass sich ihre Upgrades auf einen gesamten Knoten gleichzeitig auswirken und zu Unterbrechungen von langlebigen TCP-Verbindungen führen können. Um Störungen auf Knotenebene innerhalb eines gemeinsamen Zeitfensters zu isolieren, verwendet das Anwendungsnetzwerk denselben aksManagedNodeOSUpgradeSchedule Wartungszeitplan wie automatische Upgrades des Betriebssystems von Azure Kubernetes Service (AKS)-Knoten, sofern konfiguriert.

Beachten Sie, dass während das Wartungsfenster identisch ist, Upgrades von Anwendungsnetzwerk-Membern und Knotenbetriebssystemupgrades unabhängige Ereignisse innerhalb des Fensters sind, die je nach Verfügbarkeit von Upgrades für eine oder beide Komponenten auftreten. Keines der Upgrades beeinflusst den Zeitpunkt oder den Prozess des anderen. Wenn beide Komponenten innerhalb desselben Fensters aktualisiert werden, gibt es möglicherweise separate Verbindungsunterbrechungen für jedes Upgrade innerhalb dieses Fensters.

Hinweis

Es ist nicht erforderlich, automatische Betriebssystemupgrades für Knoten zu aktivieren, um die geplante Wartung für das Anwendungsnetzwerk zu verwenden. Durch das Erstellen eines aksManagedNodeOSUpgradeSchedule werden die automatischen Upgrades des Node-OS weder aktiviert noch deaktiviert.

Voraussetzungen

  • Ein vorhandener AKS-Cluster, der als Mitglied einer Anwendungsnetzwerkressource integriert ist. Wenn Sie noch keine Anwendungsnetzwerkressource haben oder Ihren Cluster noch nicht integriert haben, lesen Sie "Erste Schritte mit Dem Azure Kubernetes-Anwendungsnetzwerk".
  • Azure CLI-Version ist 2.84.0 oder höher. Überprüfen Sie Ihre Version mit dem Befehl az --version. Informationen zum Installieren oder Aktualisieren finden Sie unter Installieren der Azure CLI.
  • Es wird empfohlen, die Dokumentation zum Wartungsfenster zu überprüfen, um die Konfigurationsfelder und die Funktionsweise von Wartungsfenstern in AKS zu verstehen.

Überlegungen

Beachten Sie die folgenden Überlegungen bei der Verwendung der geplanten Wartung zum Planen von Anwendungsnetzwerkupgrades:

  • Das Anwendungsnetzwerk behält sich das Recht vor, geplante Wartungsfenster für ungeplante, reaktive Wartungsvorgänge zu unterbrechen, die dringend oder kritisch sind. Diese Wartungsvorgänge können sogar während der in Ihrer Konfiguration definierten notAllowedTime- oder notAllowedDates-Zeiträume ausgeführt werden.
  • Wartungsarbeiten werden nur nach bestem Wissen und Gewissen durchgeführt und es wird nicht garantiert, dass sie innerhalb eines bestimmten Zeitraums stattfinden.
  • Wenn ein versuchtes Upgrade bis zum Ende des Zeitfensters nicht abgeschlossen ist, wird weiterhin versucht, den Abgleich vorzunehmen, bis es abgeschlossen ist.

Modusspezifisches Verhalten

Sie können die geplante Wartung verwenden, um den Zeitpunkt der vollständig verwalteten Upgrades und selbstverwalteten Upgrades zu planen, die Aktivierung oder Deaktivierung der geplanten Wartung wirkt sich jedoch nicht auf den Upgrademodus selbst aus. Wartungsfenster steuern verschiedene Arten von Aktualisierungen abhängig vom Upgrade-Modus Ihres Clusters.

  • Vollverwalteter Modus: Wartungsfenster steuern sowohl geringfügige als auch Patch-Upgrades. Wenn Sie jedoch eine Änderung des Veröffentlichungskanals initiieren, wird die zugehörige Versionsänderung sofort wirksam.
  • Selbstverwalteter Modus: Wartungsfenster gelten nur für Patchupgrades. Wenn Sie eine Nebenversionsänderung initiieren, wird sie sofort wirksam.

Hinzufügen eines Wartungsfensters

  • Fügen Sie mithilfe des aksManagedNodeOSUpgradeSchedule Befehls eine az aks maintenanceconfiguration add Wartungsfensterkonfiguration zu einem AKS-Cluster hinzu. Im folgenden Beispiel wird eine neue aksManagedNodeOSUpgradeSchedule Konfiguration hinzugefügt, mit der die Wartung jeden dritten Freitag zwischen 12:00 und 8:00 Uhr in der UTC+5:30 Zeitzone geplant wird:

    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
    

Aktualisieren eines vorhandenen Wartungsfensters

  • Aktualisieren Sie eine vorhandene Wartungskonfiguration mithilfe des az aks maintenanceconfiguration update Befehls. Im folgenden Beispiel wird die Konfiguration aktualisiert, um die aksManagedNodeOSUpgradeSchedule Wartung für jeden Freitag von 2:00 bis 6:00 Uhr zu planen:

    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
    

Anzeigen der Wartungskonfiguration für einen Cluster

  • Zeigen Sie ein bestimmtes Wartungskonfigurationsfenster in Ihrem AKS-Cluster mithilfe des az aks maintenanceconfiguration show Befehls mit dem --name Parameter an.

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

    Die folgende Beispielausgabe zeigt das Wartungsfenster für 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
    }
    

Löschen einer Wartungskonfiguration für einen Cluster

  • Löschen Sie mithilfe des az aks maintenanceconfiguration delete Befehls ein Wartungskonfigurationsfenster in Ihrem AKS-Cluster.

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

Weitere Informationen zum Azure Kubernetes-Anwendungsnetzwerk finden Sie in den folgenden Artikeln: