Freigeben über

Versionshinweise für das AKS-Modul im Azure Stack Hub

  • Artikel

Gilt für Version v0.80.2 des AKS-Moduls.

In diesem Artikel wird der Inhalt des Updates für die AKS-Engine (Azure Kubernetes Service) in Azure Stack Hub beschrieben. Das Update umfasst Verbesserungen und Fehlerbehebungen für das aktuelle Release der AKS-Engine für die Azure Stack Hub-Plattform. Dieser Artikel soll die Versionsinformationen für das AKS-Modul für globale Azure nicht dokumentieren.

Üpgradeüberlegungen

  • Verwenden Sie die richtigen Marketplace-Elemente, AKS Base Ubuntu 20.04 Image Distro oder AKS Base Windows Server für Ihre Version des AKS-Moduls? Informationen zu den Versionen finden Sie im Abschnitt Herunterladen neuer Images und der AKS-Engine.
  • Verwenden Sie die richtige Clusterspezifikation (apimodel.json) und Ressourcengruppe für den Zielcluster? Als Sie für den Cluster die ursprüngliche Bereitstellung durchgeführt haben, wurde diese Datei in Ihrem Ausgabeverzeichnis generiert. Informationen zu den Parametern des „deploy“-Befehls finden Sie unter Bereitstellen eines Kubernetes-Clusters.
  • Verwenden Sie einen zuverlässigen Computer, auf dem die AKS-Engine ausgeführt wird und über den Sie Upgradevorgänge ausführen?
  • Beim Aktualisieren eines betriebsbereiten Clusters mit aktiven Workloads können Sie das Upgrade anwenden, ohne dass diese beeinträchtigt werden (sofern der Cluster normal ausgelastet ist). Sie sollten aber über einen zusätzlichen Cluster als Reserve verfügen, damit Benutzer unter Umständen an diesen Cluster umgeleitet werden können. Ein Sicherungscluster wird dringend empfohlen.
  • Führen Sie den Befehl wenn möglich von einem virtuellen Computer in der Azure Stack Hub-Umgebung aus, um die Anzahl der Netzwerkhops und potenzielle Verbindungsfehler zu verringern.
  • Stellen Sie sicher, dass das Kontingent Ihres Abonnements ausreicht, um den gesamten Prozess auszuführen. Während des Prozesses werden neue virtuelle Computer zugeordnet. Die resultierende Anzahl von virtuellen Computern wäre identisch mit dem Original, aber planen Sie einige weitere virtuelle Computer, die während des Prozesses erstellt werden sollen.
  • Systemupdates oder geplante Tasks sind nicht vorgesehen.
  • Richten Sie ein gestaffeltes Upgrade in einem Cluster ein, für den die gleichen Werte wie für den Produktionscluster konfiguriert sind, und testen Sie das Upgrade dort, bevor Sie es im Produktionscluster ausführen.

Verwenden des „upgrade“-Befehls

Sie müssen den aks-engine upgrade Befehl wie unter Upgrade eines Kubernetes-Clusters auf Azure Stack Hub beschrieben verwenden.

Unterbrechungen des Upgrades

Es kann auch vorkommen, dass das Upgrade des Clusters aufgrund von unerwarteten Faktoren unterbrochen wird. Eine Unterbrechung kann auftreten, wenn das AKS-Modul einen Fehler meldet oder etwas mit dem Ausführungsprozess des AKS-Moduls geschieht. Untersuchen Sie die Ursache der Unterbrechung, beheben Sie sie, und übermitteln Sie denselben upgrade Befehl erneut, um den Upgradevorgang fortzusetzen. Der upgrade Befehl ist idempotent und sollte das Upgrade des Clusters fortsetzen, sobald Sie den Befehl erneut übermitteln. Normalerweise erhöhen Unterbrechungen die Zeit zum Abschließen des Updates, sollten sich jedoch nicht auf den Abschluss auswirken.

Geschätzte Upgradedauer

Die geschätzte Upgradezeit beträgt 12 bis 15 Minuten pro VM im Cluster. Ein 20-Knoten-Cluster kann z. B. etwa 5 Stunden dauern, bis ein Upgrade durchgeführt wird.

Anweisungen zur Verwendung des AKS-Moduls 0.70.0 und höher

Herunterladen eines neuen Images und der AKS-Engine

Laden Sie die neuen Versionen des AKS-Basis-Ubuntu-Images und des AKS-Moduls herunter.

Wie in der Dokumentation für das AKS-Modul für Azure Stack Hub erläutert, erfordert die Bereitstellung eines Kubernetes-Clusters Folgendes:

  • Die Binärdatei des Aks-Moduls (erforderlich).
  • AKS Base Ubuntu 16.04-LTS Image Distro (veraltet - nicht mehr verwendet, im API-Modell ändern, stattdessen 20.04 verwenden).
  • AKS Base Ubuntu 18.04-LTS Image Distro (veraltet - nicht mehr verwendet, im API-Modell ändern, stattdessen 20.04 verwenden).
  • AKS Base Ubuntu 20.04-LTS Image Distro (erforderlich für Linux-Agents).
  • AKS Base Windows Server Image (eines der folgenden Images ist für Windows-Agents erforderlich):
    • AKS Base Windows Server Image Containerd.
    • AKS-Basis-Windows Server-Image Docker.

Neue Versionen dieser Images sind mit diesem Update verfügbar:

Upgrade von Kubernetes-Clustern, die mit der Ubuntu-Distribution 16.04 erstellt wurden

Ab AKS Engine v0.63.0 ist die Ubuntu 16.04-Distro nicht mehr eine unterstützte Option, da das Betriebssystem das Ende der Lebensdauer erreicht hat. Bei AKS Engine v0.67.0 oder höheren Versionen überschreibt das Aks-Engine-Upgrade automatisch den nicht unterstützten aks-ubuntu-16.04 Distro-Wert mit .aks-ubuntu-18.04 Wenn Sie Kubernetes v1.24 oder höher verwenden, überschreibt das aks-engine-azurestack-Upgrade automatisch den nicht unterstützten aks-ubuntu-16.04 Distro-Wert mit aks-ubuntu-20.04.

Upgrade von Kubernetes-Clustern, die mit der Ubuntu 18.04-Distro

Ab AKS Engine v0.75.3 ist die Ubuntu 18.04-Distro nicht mehr eine unterstützte Option, da das Betriebssystem das Ende der Lebensdauer erreicht hat. Bei AKS Engine v0.75.3 oder neueren Versionen überschreibt das aks-engine-azurestack-Upgrade automatisch den nicht unterstützten aks-ubuntu-18.04 Distro-Wert mit aks-ubuntu-20.04.

Upgrade von Kubernetes-Clustern, die mit Docker-Containerlaufzeit erstellt wurden

In Kubernetes v1.24 wurde die Dockershim-Komponente aus Kubelet entfernt. Daher ist die Docker-Containerlaufzeit keine unterstützte Option mehr. Weitere Informationen finden Sie in den Versionshinweisen zu Kubernetes v1.24. Für AKS Engine v0.75.3 oder höhere Versionen überschreibt das aks-engine-azurestack-Upgrade automatisch den nicht unterstützten docker containerRuntime Wert mit containerd.

Für AKS Engine Release v0.75.3 können Cluster mit Windows-Knoten auf Kubernetes v1.23 das Windows-Basisimage mit der Docker-Runtime verwenden. Cluster mit Windows-Knoten auf Kubernetes v1.24 können das Windows-Basisimage mit der Containerd-Runtime verwenden.

Versionszuordnung für AKS-Engine und Azure Stack

Azure Stack Hub-Version AKS-Engine-Version
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4
2008 0.55.4, 0.60.1
2102 0.60.1, 0.63.0, 0.67.0, 0.67.3
2108 0.63.0, 0.67.0, 0.67.3, 0.70.0, 0.71.0, 0.73.0, 0.75.3, 0.76.0
2206 0.70.0, 0.71.0, 0.73.0, 0.75.3, 0.76.0, 0.77.0
2301 0.75.3, 0.76.0, 0.77.0, 0.78.0, 0.79.0
2306 0.78.0, 0.79.0, 0.80.2
2311 0.80.2*
2406 0.80.2*, 0.81.1*
2408 0.80.2*, 0.81.1*

Hinweis

Unterstützt.* Weitere Informationen finden Sie in der AKS-Modulversionsunterstützungsrichtlinie .

AKS-Engine und entsprechende Imagezuordnungen

Die unterstützten Kubernetes-Versionen für das AKS-Modul auf Azure Stack Hub finden Sie in der folgenden Tabelle. Verwenden Sie nicht den Befehl "Aks-Engine get-versions ", der Versionen zurückgibt, die in globalen Azure sowie in Azure Stack Hub unterstützt werden.

AKS-Engine AKS-Basisimage Kubernetes-Versionen Beispiele für das API-Modell
v0.43.1 AKS Base Ubuntu 16.04-LTS, Imagedistribution, Oktober 2019 (2019.10.24) 1.15.5, 1.15.4, 1.14.8, 1.14.7
v0.48.0 AKS Base Ubuntu 16.04-LTS, Imagedistribution, März 2020 (2020.03.19) 1.15.10, 1.14.7
v0.51.0 AKS Base Ubuntu 16.04-LTS-Imagedistribution, Mai 2020 (2020.05.13), AKS Base Windows-Image (17763.1217.200513) 1.15.12, 1.16.8, 1.16.9 Linux, Windows
v0.55.0 AKS Base Ubuntu 16.04-LTS-Imagedistribution, August 2020 (2020.08.24), AKS Base Windows-Image (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
v0.55.4 AKS Base Ubuntu 16.04-LTS-Imagedistribution, September 2020 (2020.09.14), AKS Base Windows-Image (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
V0.60.1 AKS Base Ubuntu 16.04-LTS Image Distro, Januar 2021 (2021.01.28),
AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28),
AKS Base Windows-Image (17763.1697.210129)		 1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows
v0.63.0 AKS Base Ubuntu 18.04-LTS-Imagedistribution, 2021 Q2 (2021.05.24), AKS Base Windows-Image (17763.1935.210520) 1.18.18, 1.19.10, 1.20.6 API-Modellbeispiele (Linux, Windows)
v0.67.0 AKS Base Ubuntu 18.04-LTS-Imagedistribution, 2021 Q3 (2021.09.27), AKS Windows-Basisimage (17763.2213.210927) 1.19.15, 1.20.11 API-Modellbeispiele (Linux, Windows)
v0.67.3 AKS Base Ubuntu 18.04-LTS-Imagedistribution, 2021 Q3 (2021.09.27), AKS Windows-Basisimage (17763.2213.210927) 1.19.15, 1.20.11 API-Modellbeispiele (Linux, Windows)
v0.70.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2022 Q2 (2022.04.07), AKS Base Windows Image (17763.2565.220408) 1.21.10*, 1.22.7* API-Modellbeispiele (Linux, Windows)
v0.71.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2022 Q3 (2022.08.12), AKS Base Windows Image (17763.3232.220805) 1.22.7*, 1.23.6* API-Modellbeispiele (Linux, Windows)
v0.73.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2022 Q4 (2022.11.02), AKS Base Windows Image (17763.3532.221102) 1.22.15*, 1.23.13* API-Modellbeispiele (Linux, Windows)
v0.75.3 AKS Base Ubuntu 20.04-LTS Image Distro (2023.032.2), AKS Base Windows Server 2019 Image Docker (17763.3887.20230332), AKS Base Windows Server 2019 Image Containerd (17763.3887.20230332) 1.23.15*, 1.24.9** API-Modellbeispiele (Linux, Windows)
v0.76.0 AKS Base Ubuntu 20.04-LTS Image Distro (2023.116.3), AKS Base Windows Server 2019 Image Containerd (17763.4252.20231163) 1.24.11**, 1.25.7** API-Modellbeispiele (Linux, Windows)
v0.77.0 AKS Base Ubuntu 20.04-LTS Image Distro (2023.206.1), AKS Base Windows Server 2019 Image Containerd (17763.4645.20232061) 1.25.7**, 1.26.6** API-Modellbeispiele (Linux, Windows)
v0.78.0 AKS Base Ubuntu 20.04-LTS Image Distro (2023.242.3), AKS Base Windows Server 2019 Image Containerd (17763.4737.20232423) 1.25.13**, 1.26.8** API-Modellbeispiele (Linux, Windows)
v0.79.0 AKS Base Ubuntu 20.04-LTS Image Distro (2023.296.1), AKS Base Windows Server 2019 Image Containerd (17763.4974.20232961) 1.26.9**, 1.27.6** API-Modellbeispiele (Linux, Windows)
v0.80.2 AKS Base Ubuntu 20.04-LTS Image Distro (2024.032.1), AKS Base Windows Server 2019 Image Containerd (17763.5329.20240321) 1.27.10**, 1.28.6** API-Modellbeispiele (Linux, Windows)
v0.81.1 AKS Base Ubuntu 20.04-LTS Image Distro (2024.311.1), AKS Base Windows Server 2019 Image Containerd (17763.6414.20243111) 1.28.15**, 1.29.10** API-Modellbeispiele (Linux, Windows)

Hinweis

*Ab Kubernetes v1.21 wird nur der Cloudanbieter für Azure auf Azure Stack Hub unterstützt.

Hinweis

** Ab Kubernetes v1.24 wird nur die containerd Containerlaufzeit unterstützt. Weitere Informationen finden Sie im Abschnitt Upgrade von Kubernetes-Clustern, die mit docker container runtime erstellt wurden.

Updateplanung

Der AKS-Modulbefehl upgrade automatisiert den Upgradeprozess Ihres Clusters vollständig und behandelt virtuelle Computer (VMs), Netzwerk-, Speicher-, Kubernetes- und Orchestrierungsaufgaben. Stellen Sie vor dem Anwenden des Updates sicher, dass Sie die Informationen in diesen Versionshinweisen überprüfen:

Neuerungen mit AKSe 0.76.0

  • Unterstützung für Kubernetes v1.24.11 und v1.25.7 hinzugefügt.
  • Weitere Features finden Sie auf der GitHub-Seite v0.76.0.

Neuerungen mit AKSe 0.75.3 und höher

Die AKS Engine-Version v0.75.3 und alle zukünftigen AKS Engine-Versionen auf Azure Stack Hub stammen aus dem neuen aks-engine-azurestack-Repository. Daher sollten alle aks-engine Befehle durch aks-engine-azurestackersetzt werden. Befehle zum Abrufen der neuesten AKS Engine-Version auf Azure Stack Hub wurden ebenfalls geändert. Sie können die neuen Befehle unter "Linux-Client erstellen" und "Windows-Client erstellen" anzeigen. Erstellen Sie ein Problem im neuen Repository , wenn Probleme auftreten.

AKS Engine Release v0.75.3 auf Azure Stack Hub bietet Ubuntu 20.04 LTS als Linux-Basisimage an. Ab dieser Version wird Ubuntu 18.04 nicht mehr unterstützt. Weitere Informationen finden Sie unter Aktualisieren von Kubernetes-Clustern, die mit ubuntu 18.04 Distro erstellt wurden.

Ab Kubernetes v1.24 wird nur die containerd Laufzeit unterstützt. Weitere Informationen finden Sie unter Aktualisieren von Kubernetes-Clustern, die mit Docker-Runtime erstellt wurden. Für AKS Engine Release v0.75.3 können Cluster mit Windows-Knoten auf Kubernetes v1.23 das Windows-Basisimage mit Docker-Runtime verwenden. Cluster mit Windows-Knoten auf Kubernetes v1.24 können das Windows-Basisimage mit containerierter Laufzeit verwenden.

Weitere Features finden Sie auf der GitHub-Seite v0.75.3.

Anweisungen zur Verwendung des AKS-Moduls 0.70.0 und höher

Microsoft hat den Azure-Cloudanbieter in Version 0.70.0 aktualisiert. Der Azure-Cloudanbieter ist eine Kernkomponente, die zwischen AKS Azure und der AKS-Engine in Azure Stack Hub freigegeben wird.

So verwenden Sie das AKS-Modul 0.70.0 und höher:

  • Wenn Sie zum ersten Mal versuchen, einen neuen Kubernetes-Cluster zu erstellen: Verwenden Sie das Beispiel-API-Modell, das für die entsprechende Version im AKS-Modul und die entsprechende Bildzuordnungstabelle bereitgestellt wird.

  • Wenn Sie einen neuen Cluster erstellen, aber Ihr vorhandenes API-Modell verwenden möchten: Ändern Sie Ihr API-Modell, indem Sie den Cloudanbieter für Azure-Anweisungen befolgen. Wenn die neue Einstellung nicht eingeschlossen wird, tritt ein Bereitstellungsfehler auf.

  • Wenn Sie Speichervolumes verwenden: Stellen Sie sicher, dass Sie den AzureDiskCSI-Treiber verwenden. Version 0.70.0 und höher unterstützen nur CSI-Treiber, nicht den älteren In-Tree-Speicheranbieter. Folgen Sie zum Upgrade den Anweisungen im Upgrade bei Verwendung von Speichervolumes.

Bekannte Probleme

  • Die parallele Bereitstellung mehrerer Kubernetes-Dienste in einem Cluster kann zu einem Fehler in der grundlegenden Konfiguration für den Lastenausgleich führen. Es wird empfohlen, jeweils einen Dienst bereitzustellen.
  • Da das Aks-Engine-Tool ein freigegebenes Quellcode-Repository in Azure und Azure Stack Hub ist, können Sie die vielen Versionshinweise und Pullanforderungen untersuchen, um zu glauben, dass das Tool andere Versionen von Kubernetes und Betriebssystemplattform unterstützt, die über die zuvor aufgeführten hinausgehen. Sie können sie ignorieren und die obige Versionstabelle als offizielle Anleitung für dieses Update verwenden.
  • AKS Engine v0.67.0 verwendet beim Bereitstellen von Windows-Clustern das falsche Windows-Image. Verwenden Sie v0.70.0, um dieses Problem zu beheben.

Verweis

Die folgende Liste ist der vollständige Satz von Versionshinweisen für Azure und Azure Stack Hub kombiniert:

Gilt für Version v0.67.0 des AKS-Moduls.

In diesem Artikel wird der Inhalt des Updates für die AKS-Engine (Azure Kubernetes Service) in Azure Stack Hub beschrieben. Das Update umfasst Verbesserungen und Fehlerbehebungen für das aktuelle Release der AKS-Engine für die Azure Stack Hub-Plattform. Dieser Artikel soll die Versionsinformationen für das AKS-Modul für globale Azure nicht dokumentieren.

Updateplanung

Der AKS-Modulbefehl upgrade automatisiert den Upgradeprozess Ihres Clusters vollständig. Es behandelt virtuelle Computer (VMs), Netzwerke, Speicher, Kubernetes und Orchestrierungsaufgaben. Stellen Sie vor dem Anwenden des Updates sicher, dass Sie die Informationen in diesen Versionshinweisen überprüfen:

Üpgradeüberlegungen

  • Verwenden Sie die richtigen Marketplace-Elemente, AKS Base Ubuntu 16.04-LTS oder 18.04 Image Distro oder AKS Base Windows Server für Ihre Version des AKS-Moduls? Informationen zu den Versionen finden Sie im Abschnitt „Herunterladen neuer Images und der AKS-Engine“.
  • Verwenden Sie die richtige Clusterspezifikation (apimodel.json) und Ressourcengruppe für den Zielcluster? Als Sie für den Cluster die ursprüngliche Bereitstellung durchgeführt haben, wurde diese Datei in Ihrem Ausgabeverzeichnis generiert. Informationen zu den Parametern des „deploy“-Befehls finden Sie unter Bereitstellen eines Kubernetes-Clusters.
  • Verwenden Sie einen zuverlässigen Computer zum Ausführen des AKS-Moduls und von dem aus Sie Upgradevorgänge ausführen?
  • Beim Aktualisieren eines betriebsbereiten Clusters mit aktiven Workloads können Sie das Upgrade anwenden, ohne dass diese beeinträchtigt werden (sofern der Cluster normal ausgelastet ist). Sie sollten aber über einen zusätzlichen Cluster als Reserve verfügen, damit Benutzer unter Umständen an diesen Cluster umgeleitet werden können. Ein Sicherungscluster wird dringend empfohlen.
  • Führen Sie den Befehl wenn möglich von einem virtuellen Computer in der Azure Stack Hub-Umgebung aus, um die Anzahl der Netzwerkhops und potenzielle Verbindungsfehler zu verringern.
  • Stellen Sie sicher, dass das Kontingent Ihres Abonnements ausreicht, um den gesamten Prozess auszuführen. Während des Prozesses werden neue virtuelle Computer zugeordnet. Die resultierende Anzahl von virtuellen Computern wäre identisch mit dem Original, aber planen Sie einige weitere virtuelle Computer, die während des Prozesses erstellt werden sollen.
  • Systemupdates oder geplante Tasks sind nicht vorgesehen.
  • Richten Sie ein gestaffeltes Upgrade in einem Cluster ein, für den die gleichen Werte wie für den Produktionscluster konfiguriert sind, und testen Sie das Upgrade dort, bevor Sie es im Produktionscluster ausführen.

Verwenden des „upgrade“-Befehls

Sie müssen den aks-engine upgrade Befehl wie unter Upgrade eines Kubernetes-Clusters auf Azure Stack Hub beschrieben verwenden.

Unterbrechungen des Upgrades

Es kann auch vorkommen, dass das Upgrade des Clusters aufgrund von unerwarteten Faktoren unterbrochen wird. Eine Unterbrechung kann auftreten, wenn das AKS-Modul einen Fehler meldet oder etwas mit dem Ausführungsprozess des AKS-Moduls geschieht. Untersuchen Sie die Ursache der Unterbrechung, beheben Sie sie, und übermitteln Sie denselben upgrade Befehl erneut, um den Upgradevorgang fortzusetzen. Der upgrade Befehl ist idempotent und sollte das Upgrade des Clusters fortsetzen, sobald Sie den Befehl erneut übermitteln. Normalerweise erhöhen Unterbrechungen die Zeit zum Abschließen des Updates, sollten sich jedoch nicht auf den Abschluss auswirken.

Geschätzte Upgradedauer

Die geschätzte Upgradezeit beträgt 12 bis 15 Minuten pro VM im Cluster. Ein 20-Knoten-Cluster kann z. B. etwa 5 Stunden dauern, bis ein Upgrade durchgeführt wird.

Herunterladen eines neuen Images und der AKS-Engine

Laden Sie die neuen Versionen des AKS-Basis-Ubuntu-Images und des AKS-Moduls herunter.

Wie in der Dokumentation für das AKS-Modul für Azure Stack Hub erläutert, erfordert die Bereitstellung eines Kubernetes-Clusters Folgendes:

  • Die Binärdatei des Aks-Moduls (erforderlich).
  • AKS Base Ubuntu 16.04-LTS Image Distro (veraltet - nicht mehr verwendet, im API-Modell ändern, stattdessen 18.04 verwenden).
  • AKS Base Ubuntu 18.04-LTS Image Distro (erforderlich für Linux-Agents).
  • AKS Base Windows Server Image Distro (erforderlich für Windows-Agents).

Neue Versionen dieser Images sind mit diesem Update verfügbar:

Upgrade von Kubernetes-Clustern, die mit der Ubuntu-Distribution 16.04 erstellt wurden

Ab AKS Engine v0.67.0 ist die Ubuntu 16.04-Distro nicht mehr eine unterstützte Option, da das Betriebssystem das Ende der Lebensdauer erreicht hat. Um ein Cluster zu aktualisieren, stellen Sie sicher, dass die Betriebssystem-Distribution aks-ubuntu-18.04 in Ihrem Eingabe-API-Modell festgelegt wird, das von aks-engine deploy dem generierten und als Eingabe übergeben wird:aks-engine upgrade

"masterProfile": {
    "distro": "aks-ubuntu-18.04"
},

"agentPoolProfiles": [{
    "distro": "aks-ubuntu-18.04"
}]

Versionszuordnung für AKS-Engine und Azure Stack

Azure Stack Hub-Version AKS-Engine-Version
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4
2008 0.55.4, 0.60.1
2102 0.60.1, 0.63.0, 0.67.0
2108 0.63.0, 0.67.0

Upgradepfad für Kubernetes-Version in AKS-Engine v0.67.0

Die aktuelle Version und Upgradeversion für Azure Stack Hub finden Sie in der folgenden Tabelle. Diese Tabelle gilt für den AKS-Modulcluster im Azure Stack Hub. Verwenden Sie nicht den Befehl "Aks-Engine get-versions ", der Versionen zurückgibt, die in globalen Azure sowie in Azure Stack Hub unterstützt werden.

Aktuelle Version Upgrade verfügbar
1.15.12 1.16.14, 1.16.15
1.16.14 1.16.15, 1.17.17
1.17.11, 1.17.17 1.18.18
1.18.15, 1.18.18 1.19.10
1.19.10 1.19.15, 1.20.11
1.20.6 1.20.11

Geben Sie in der JSON-Datei des API-Modells die Versions- und Versionswerte unter dem orchestratorProfile Abschnitt an. Wenn Sie beispielsweise planen, Kubernetes 1.17.17.17 bereitzustellen, müssen die folgenden beiden Werte festgelegt werden (siehe beispiel kubernetes-azurestack.json):

-   "orchestratorRelease": "1.17",
-   "orchestratorVersion": "1.17.17"

AKS-Engine und entsprechende Imagezuordnungen

AKS-Engine AKS-Basisimage Kubernetes-Versionen Beispiele für das API-Modell
v0.43.1 AKS Base Ubuntu 16.04-LTS, Imagedistribution, Oktober 2019 (2019.10.24) 1.15.5, 1.15.4, 1.14.8, 1.14.7
v0.48.0 AKS Base Ubuntu 16.04-LTS, Imagedistribution, März 2020 (2020.03.19) 1.15.10, 1.14.7
v0.51.0 AKS Base Ubuntu 16.04-LTS-Imagedistribution, Mai 2020 (2020.05.13), AKS Base Windows-Image (17763.1217.200513) 1.15.12, 1.16.8, 1.16.9 Linux, Windows
v0.55.0 AKS Base Ubuntu 16.04-LTS-Imagedistribution, August 2020 (2020.08.24), AKS Base Windows-Image (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
v0.55.4 AKS Base Ubuntu 16.04-LTS-Imagedistribution, September 2020 (2020.09.14), AKS Base Windows-Image (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
V0.60.1 AKS Base Ubuntu 16.04-LTS Image Distro, Januar 2021 (2021.01.28),
AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28),
AKS Base Windows-Image (17763.1697.210129)		 1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows
v0.63.0 AKS Base Ubuntu 18.04-LTS-Imagedistribution, 2021 Q2 (2021.05.24), AKS Base Windows-Image (17763.1935.210520) 1.18.18, 1.19.10, 1.20.6 API-Modellbeispiele (Linux, Windows)
v0.67.0 AKS Base Ubuntu 18.04-LTS-Imagedistribution, 2021 Q3 (2021.09.27), AKS Windows-Basisimage (17763.2213.210927) 1.19.15, 1.20.11 API-Modellbeispiele (Linux, Windows)

Neues

Wenn Sie an einer privaten Vorschau teilnehmen möchten, können Sie den Zugriff auf die Vorschauversion anfordern.

Neue Features:

  • Unterstützung für Kubernetes 1.19.15 und 1.20.11

Bekannte Probleme

  • Die parallele Bereitstellung mehrerer Kubernetes-Dienste in einem Cluster kann zu einem Fehler in der grundlegenden Konfiguration für den Lastenausgleich führen. Es wird empfohlen, jeweils einen Dienst bereitzustellen.
  • Da das Aks-Engine-Tool ein freigegebenes Quellcode-Repository in Azure und Azure Stack Hub ist, können Sie die vielen Versionshinweise und Pullanforderungen untersuchen, um zu glauben, dass das Tool andere Versionen von Kubernetes und Betriebssystemplattform unterstützt, die über die zuvor aufgeführten hinausgehen. Sie können sie ignorieren und die obige Versionstabelle als offizielle Anleitung für dieses Update verwenden.

Verweis

Die folgende Liste ist der vollständige Satz von Versionshinweisen für Azure und Azure Stack Hub kombiniert:

Gilt für Version v0.60.1 des AKS-Moduls.

In diesem Artikel wird der Inhalt des Updates für die AKS-Engine (Azure Kubernetes Service) in Azure Stack Hub beschrieben. Das Update umfasst Verbesserungen und Fehlerbehebungen für das aktuelle Release der AKS-Engine für die Azure Stack Hub-Plattform. Dieser Artikel soll die Versionsinformationen für das AKS-Modul für globale Azure nicht dokumentieren.

Updateplanung

Der AKS-Modulbefehl upgrade automatisiert den Upgradeprozess Ihres Clusters vollständig und behandelt virtuelle Computer (VMs), Netzwerk-, Speicher-, Kubernetes- und Orchestrierungsaufgaben. Stellen Sie vor dem Anwenden des Updates sicher, dass Sie die Informationen in diesen Versionshinweisen überprüfen:

Üpgradeüberlegungen

  • Verwenden Sie die richtigen Marketplace-Elemente, AKS Base Ubuntu 16.04-LTS oder 18.04 Image Distro oder AKS Base Windows Server für Ihre Version des AKS-Moduls? Informationen zu den Versionen finden Sie im Abschnitt „Herunterladen neuer Images und der AKS-Engine“.
  • Verwenden Sie die richtige Clusterspezifikation (apimodel.json) und Ressourcengruppe für den Zielcluster? Als Sie für den Cluster die ursprüngliche Bereitstellung durchgeführt haben, wurde diese Datei in Ihrem Ausgabeverzeichnis generiert. Informationen zu den Parametern des „deploy“-Befehls finden Sie unter Bereitstellen eines Kubernetes-Clusters.
  • Verwenden Sie einen zuverlässigen Computer zum Ausführen des AKS-Moduls und von dem aus Sie Upgradevorgänge ausführen?
  • Beim Aktualisieren eines betriebsbereiten Clusters mit aktiven Workloads können Sie das Upgrade anwenden, ohne dass diese beeinträchtigt werden (sofern der Cluster normal ausgelastet ist). Sie sollten aber über einen zusätzlichen Cluster als Reserve verfügen, damit Benutzer unter Umständen an diesen Cluster umgeleitet werden können. Ein Sicherungscluster wird dringend empfohlen.
  • Führen Sie den Befehl wenn möglich von einem virtuellen Computer in der Azure Stack Hub-Umgebung aus, um die Anzahl der Netzwerkhops und potenzielle Verbindungsfehler zu verringern.
  • Stellen Sie sicher, dass das Kontingent Ihres Abonnements ausreicht, um den gesamten Prozess auszuführen. Während des Prozesses werden neue virtuelle Computer zugeordnet. Die resultierende Anzahl von virtuellen Computern wäre identisch mit dem Original, aber planen Sie einige weitere virtuelle Computer, die während des Prozesses erstellt werden sollen.
  • Systemupdates oder geplante Tasks sind nicht vorgesehen.
  • Richten Sie ein gestaffeltes Upgrade in einem Cluster ein, für den die gleichen Werte wie für den Produktionscluster konfiguriert sind, und testen Sie das Upgrade dort, bevor Sie es im Produktionscluster ausführen.

Verwenden des „upgrade“-Befehls

Sie müssen den aks-engine upgrade Befehl wie unter Upgrade eines Kubernetes-Clusters auf Azure Stack Hub beschrieben verwenden.

Unterbrechungen des Upgrades

Es kann auch vorkommen, dass das Upgrade des Clusters aufgrund von unerwarteten Faktoren unterbrochen wird. Eine Unterbrechung kann auftreten, wenn das AKS-Modul einen Fehler meldet oder etwas mit dem Ausführungsprozess des AKS-Moduls geschieht. Untersuchen Sie die Ursache der Unterbrechung, beheben Sie sie, und übermitteln Sie denselben upgrade Befehl erneut, um den Upgradevorgang fortzusetzen. Der upgrade Befehl ist idempotent und sollte das Upgrade des Clusters fortsetzen, sobald Sie den Befehl erneut übermitteln. Normalerweise erhöhen Unterbrechungen die Zeit zum Abschließen des Updates, sollten sich jedoch nicht auf den Abschluss auswirken.

Geschätzte Upgradedauer

Die geschätzte Upgradezeit beträgt 12 bis 15 Minuten pro VM im Cluster. Ein 20-Knoten-Cluster kann z. B. etwa 5 Stunden dauern, bis ein Upgrade durchgeführt wird.

Herunterladen eines neuen Images und der AKS-Engine

Laden Sie die neuen Versionen des AKS-Basis-Ubuntu-Images und des AKS-Moduls herunter.

Wie in der Dokumentation für das AKS-Modul auf Azure Stack Hub erläutert, erfordert die Bereitstellung eines Kubernetes-Clusters Folgendes:

  • Die Binärdatei des Aks-Moduls (erforderlich).
  • AKS Base Ubuntu 16.04-LTS Image Distro (veraltet - nicht mehr verwendet, im API-Modell ändern, stattdessen 18.04 verwenden).
  • AKS Base Ubuntu 18.04-LTS Image Distro (erforderlich für Linux-Agents).
  • AKS Base Windows Server Image Distro (erforderlich für Windows-Agents).

Neue Versionen hierfür sind unter diesem Update verfügbar:

Versionszuordnung für AKS-Engine und Azure Stack

Azure Stack Hub-Version AKS-Engine-Version
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4
2008 0.55.4, 0.60.1

Upgradepfad für Kubernetes-Version in AKS-Engine v0.60.1

Die aktuelle Version und Upgradeversion für Azure Stack Hub finden Sie in der folgenden Tabelle. Diese Tabelle gilt für den AKS-Modulcluster im Azure Stack Hub. Verwenden Sie nicht den Befehl "Aks-Engine get-versions ", der Versionen zurückgibt, die in globalen Azure sowie in Azure Stack Hub unterstützt werden.

Aktuelle Version Upgrade verfügbar
1.15.12 1.16.14, 1.16.15
1.16.14 1.16.15, 1.17.17
1.17.11 1.17.17, 1.18.15
1.17.17 1.18.15

Geben Sie in der JSON-Datei des API-Modells die Versions- und Versionswerte unter dem orchestratorProfile Abschnitt an. Wenn Sie beispielsweise planen, Kubernetes 1.17.17.17 bereitzustellen, müssen die folgenden beiden Werte festgelegt werden (siehe beispiel kubernetes-azurestack.json):

-   "orchestratorRelease": "1.17",
-   "orchestratorVersion": "1.17.17"

AKS-Engine und entsprechende Imagezuordnungen

AKS-Engine AKS-Basisimage Kubernetes-Versionen Beispiele für das API-Modell
v0.43.1 AKS Base Ubuntu 16.04-LTS, Imagedistribution, Oktober 2019 (2019.10.24) 1.15.5, 1.15.4, 1.14.8, 1.14.7
v0.48.0 AKS Base Ubuntu 16.04-LTS, Imagedistribution, März 2020 (2020.03.19) 1.15.10, 1.14.7
v0.51.0 AKS Base Ubuntu 16.04-LTS-Imagedistribution, Mai 2020 (2020.05.13), AKS Base Windows-Image (17763.1217.200513) 1.15.12, 1.16.8, 1.16.9 Linux, Windows
v0.55.0 AKS Base Ubuntu 16.04-LTS-Imagedistribution, August 2020 (2020.08.24), AKS Base Windows-Image (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
v0.55.4 AKS Base Ubuntu 16.04-LTS-Imagedistribution, September 2020 (2020.09.14), AKS Base Windows-Image (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
V0.60.1 AKS Base Ubuntu 16.04-LTS Image Distro, Januar 2021 (2021.01.28),
AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28),
AKS Base Windows-Image (17763.1697.210129)		 1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows

Neues

Wenn Sie an einer privaten Vorschau teilnehmen möchten, können Sie den Zugriff auf die Vorschauversion anfordern.

Neue Features:

  • Allgemeine Verfügbarkeit von Ubuntu 18.04.
  • Öffentliche Zertifikatdrehung Nr. 4214.
  • T4 Nvidia GPU Private Vorschau Nr. 4259.
  • Azure Active Directory integriert die private Vorschau.
  • CSI-Treiber für Azure Blobs Private Preview Nr. 712.
  • CSI-Treiber Azure Disks Public Preview #712.
  • CSI-Treiber NFS Public Preview #712.
  • Unterstützung für Kubernetes 1. 17.17 #4188 und 1.18.15 #4187.

Bekannte Probleme

  • Die parallele Bereitstellung mehrerer Kubernetes-Dienste in einem Cluster kann zu einem Fehler in der grundlegenden Konfiguration für den Lastenausgleich führen. Es wird empfohlen, jeweils einen Dienst bereitzustellen.
  • Da das Aks-Engine-Tool ein freigegebenes Quellcode-Repository in Azure und Azure Stack Hub ist, können Sie die vielen Versionshinweise und Pullanforderungen untersuchen, um zu glauben, dass das Tool andere Versionen von Kubernetes und Betriebssystemplattform unterstützt, die über die zuvor aufgeführten hinausgehen. Sie können sie ignorieren und die obige Versionstabelle als offizielle Anleitung für dieses Update verwenden.

Verweis

Die folgende Liste ist der vollständige Satz von Versionshinweisen für Azure und Azure Stack Hub kombiniert:

Gilt für Version v0.55.4 des AKS-Moduls.

In diesem Artikel wird der Inhalt des Updates für die AKS-Engine (Azure Kubernetes Service) in Azure Stack Hub beschrieben. Das Update umfasst Verbesserungen und Fehlerbehebungen für das aktuelle Release der AKS-Engine für die Azure Stack Hub-Plattform. Dieser Artikel soll die Versionsinformationen für das AKS-Modul für globale Azure nicht dokumentieren.

Updateplanung

Der AKS-Modulbefehl upgrade automatisiert den Upgradeprozess Ihres Clusters vollständig und behandelt virtuelle Computer (VMs), Netzwerk-, Speicher-, Kubernetes- und Orchestrierungsaufgaben. Stellen Sie vor dem Anwenden des Updates sicher, dass Sie die Informationen in diesen Versionshinweisen überprüfen:

Üpgradeüberlegungen

  • Verwenden Sie das richtige Marketplace-Element, AKS Base Ubuntu 16.04-LTS Image Distro für Ihre Version des AKS-Moduls? Die Versionen finden Sie im Abschnitt "Neues Image und AKS-Modul herunterladen".
  • Verwenden Sie die richtige Clusterspezifikation (apimodel.json) und Ressourcengruppe für den Zielcluster? Als Sie für den Cluster die ursprüngliche Bereitstellung durchgeführt haben, wurde diese Datei in Ihrem Ausgabeverzeichnis generiert. Informationen zu den Parametern des „deploy“-Befehls finden Sie unter Bereitstellen eines Kubernetes-Clusters.
  • Verwenden Sie einen zuverlässigen Computer, auf dem die AKS-Engine ausgeführt wird und über den Sie Upgradevorgänge ausführen?
  • Beim Aktualisieren eines betriebsbereiten Clusters mit aktiven Workloads können Sie das Upgrade anwenden, ohne dass diese beeinträchtigt werden (sofern der Cluster normal ausgelastet ist). Sie sollten aber über einen zusätzlichen Cluster als Reserve verfügen, damit Benutzer unter Umständen an diesen Cluster umgeleitet werden können. Ein Sicherungscluster wird dringend empfohlen.
  • Führen Sie den Befehl wenn möglich von einem virtuellen Computer in der Azure Stack Hub-Umgebung aus, um die Anzahl der Netzwerkhops und potenzielle Verbindungsfehler zu verringern.
  • Stellen Sie sicher, dass das Kontingent Ihres Abonnements ausreicht, um den gesamten Prozess auszuführen. Während des Prozesses werden neue virtuelle Computer zugeordnet. Die resultierende Anzahl von virtuellen Computern wäre identisch mit dem Original, aber planen Sie einige weitere virtuelle Computer, die während des Prozesses erstellt werden sollen.
  • Systemupdates oder geplante Tasks sind nicht vorgesehen.
  • Richten Sie ein gestaffeltes Upgrade in einem Cluster ein, für den die gleichen Werte wie für den Produktionscluster konfiguriert sind, und testen Sie das Upgrade dort, bevor Sie es im Produktionscluster ausführen.

Verwenden des „upgrade“-Befehls

Sie müssen den aks-engine upgrade Befehl wie unter Upgrade eines Kubernetes-Clusters auf Azure Stack Hub beschrieben verwenden.

Unterbrechungen des Upgrades

Es kann auch vorkommen, dass das Upgrade des Clusters aufgrund von unerwarteten Faktoren unterbrochen wird. Eine Unterbrechung kann auftreten, wenn das AKS-Modul einen Fehler meldet oder etwas mit dem Ausführungsprozess des AKS-Moduls geschieht. Untersuchen Sie die Ursache der Unterbrechung, beheben Sie sie, und übermitteln Sie denselben upgrade Befehl erneut, um den Upgradevorgang fortzusetzen. Der upgrade Befehl ist idempotent und sollte das Upgrade des Clusters fortsetzen, sobald Sie den Befehl erneut übermitteln. Normalerweise erhöhen Unterbrechungen die Zeit zum Abschließen des Updates, sollten sich jedoch nicht auf den Abschluss auswirken.

Geschätzte Upgradedauer

Die geschätzte Upgradezeit beträgt 12 bis 15 Minuten pro VM im Cluster. Ein 20-Knoten-Cluster kann z. B. etwa 5 Stunden dauern, bis ein Upgrade durchgeführt wird.

Herunterladen eines neuen Images und der AKS-Engine

Laden Sie die neuen Versionen des AKS Base Ubuntu-Images und der AKS-Engine herunter.

Wie in der Dokumentation für das AKS-Modul auf Azure Stack Hub erläutert, erfordert die Bereitstellung eines Kubernetes-Clusters zwei Hauptkomponenten:

  • Die Binärdatei des Aks-Moduls (erforderlich).
  • AKS Base Ubuntu 16.04-LTS Image Distro

Neue Versionen dieser Images sind mit diesem Update verfügbar:

Versionszuordnung für AKS-Engine und Azure Stack

Azure Stack Hub-Version AKS-Engine-Version
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4

Upgradepfad für Kubernetes-Version in AKS-Engine v0.55.4

Die aktuelle Version und Upgradeversion für Azure Stack Hub finden Sie in der folgenden Tabelle. Diese Tabelle gilt für den AKS-Modulcluster im Azure Stack Hub. Verwenden Sie nicht den Befehl "Aks-Engine get-versions ", der Versionen zurückgibt, die in globalen Azure sowie in Azure Stack Hub unterstützt werden.

Aktuelle Version Upgrade verfügbar
1.15.10 1.15.12
1.15.12, 1.16.8, 1.16.9 1.16.14
1.16.8, 1.16.9, 1.16.14 1.17.11

Geben Sie in der JSON-Datei des API-Modells die Versions- und Versionswerte unter dem orchestratorProfile Abschnitt an. Wenn Sie beispielsweise planen, Kubernetes 1.17.17.17 bereitzustellen, müssen die folgenden beiden Werte festgelegt werden (siehe beispiel kubernetes-azurestack.json):

    -   "orchestratorRelease": "1.16",
    -   "orchestratorVersion": "1.16.14"

AKS-Engine und entsprechende Imagezuordnungen

Kubernetes-Versionen Hinweise
1.15.5, 1.15.4, 1.14.8, 1.14.7
1.15.10, 1.14.7
1.15.12, 1.16.8, 1.16.9 API-Modellbeispiele (Linux, Windows)
1.15.12, 1.16.14, 1.17.11 API-Modellbeispiele (Linux, Windows)
1.15.12, 1.16.14, 1.17.11 API-Modellbeispiele (Linux, Windows)

Neues

  • Aktualisieren der Azure Stack-Linux-VHD auf 2020.09.14 #3828
  • Fügt Unterstützung für K8s v1.17.11 in Azure Stack hinzu #3702
  • Fügt Unterstützung für K8s v1.16.14 in Azure Stack hinzu #3704
  • Linux-VHD-Update auf 2020.09.14 #3750
  • Windows-VHD-Update auf August #3730
  • Kubernetes-Metrikserver auf v0.3.7 aktualisiert #3669
  • Docker-Version aktualisiert, um das Protokollrotationsproblem zu beheben #3693
  • CoreDNS auf v1.7.0 aktualisiert #3608
  • Die Moby-Pakete 19.03.x werden verwendet #3549
  • Fehlerbehebungen für Azure CNI-Updatestrategie #3571

Bekannte Probleme

  • Die parallele Bereitstellung mehrerer Kubernetes-Dienste in einem Cluster kann zu einem Fehler in der grundlegenden Konfiguration für den Lastenausgleich führen. Es wird empfohlen, jeweils einen Dienst bereitzustellen.
  • Wenn Sie einKs-Modul get-versionsausführen, erzeugt die Ausgabe Informationen, die für Azure und Azure Stack Hub gelten. Es gibt jedoch keine explizite Möglichkeit, zu erkennen, was Azure Stack Hub entspricht. Verwenden Sie diesen Befehl nicht, um zu bestimmen, welche Versionen für das Upgrade verfügbar sind. Verwenden Sie die im vorherigen Abschnitt beschriebene Upgradereferenztabelle.
  • Da das Aks-Engine-Tool ein freigegebenes Quellcode-Repository in Azure und Azure Stack Hub ist, können Sie die vielen Versionshinweise und Pullanforderungen untersuchen, um zu glauben, dass das Tool andere Versionen von Kubernetes und Betriebssystemplattform unterstützt, die über die zuvor aufgeführten hinausgehen. Sie können sie ignorieren und die obige Versionstabelle als offizielle Anleitung für dieses Update verwenden.

Verweis

Dies sind alle Versionshinweise, die für Azure und Azure Stack Hub gemeinsam gelten:

Gilt für Version 0.48.0 oder eine frühere Version des AKS-Moduls.

In diesem Artikel wird der Inhalt des Updates für die AKS-Engine (Azure Kubernetes Service) in Azure Stack Hub beschrieben. Das Update umfasst Verbesserungen und Fehlerbehebungen für das aktuelle Release der AKS-Engine für die Azure Stack Hub-Plattform. Dieser Artikel soll die Versionsinformationen für das AKS-Modul für globale Azure nicht dokumentieren.

Updateplanung

Der AKS-Modulbefehl upgrade automatisiert den Upgradeprozess Ihres Clusters vollständig und behandelt virtuelle Computer (VMs), Netzwerk-, Speicher-, Kubernetes- und Orchestrierungsaufgaben. Stellen Sie vor dem Anwenden des Updates sicher, dass Sie die Informationen in diesen Versionshinweisen überprüfen:

Üpgradeüberlegungen

  • Verwenden Sie das richtige Marketplace-Element, AKS Base Ubuntu 16.04-LTS Image Distro für Ihre Version des AKS-Moduls? Informationen zu den Versionen finden Sie im Abschnitt Herunterladen des neuen AKS Base Ubuntu-Images und der AKS-Engine-Versionen.
  • Verwenden Sie die richtige Clusterspezifikation (apimodel.json) und Ressourcengruppe für den Zielcluster? Als Sie für den Cluster die ursprüngliche Bereitstellung durchgeführt haben, wurde diese Datei in Ihrem Ausgabeverzeichnis generiert. Informationen zu den Parametern des „deploy“-Befehls finden Sie unter Bereitstellen eines Kubernetes-Clusters.
  • Verwenden Sie einen zuverlässigen Computer zum Ausführen des AKS-Moduls und von dem aus Sie Upgradevorgänge ausführen?
  • Beim Aktualisieren eines betriebsbereiten Clusters mit aktiven Workloads können Sie das Upgrade anwenden, ohne dass diese beeinträchtigt werden (sofern der Cluster normal ausgelastet ist). Sie sollten aber über einen zusätzlichen Cluster als Reserve verfügen, damit Benutzer unter Umständen an diesen Cluster umgeleitet werden können. Ein Sicherungscluster wird dringend empfohlen.
  • Führen Sie den Befehl wenn möglich von einem virtuellen Computer in der Azure Stack Hub-Umgebung aus, um die Anzahl der Netzwerkhops und potenzielle Verbindungsfehler zu verringern.
  • Stellen Sie sicher, dass das Kontingent Ihres Abonnements ausreicht, um den gesamten Prozess auszuführen. Während des Prozesses werden neue virtuelle Computer zugeordnet. Die resultierende Anzahl von virtuellen Computern wäre identisch mit dem Original, aber planen Sie einige weitere virtuelle Computer, die während des Prozesses erstellt werden sollen.
  • Systemupdates oder geplante Tasks sind nicht vorgesehen.
  • Richten Sie ein gestaffeltes Upgrade in einem Cluster ein, für den die gleichen Werte wie für den Produktionscluster konfiguriert sind, und testen Sie das Upgrade dort, bevor Sie es im Produktionscluster ausführen.

Verwenden des „upgrade“-Befehls

Sie müssen den aks-engine upgrade Befehl wie unter Upgrade eines Kubernetes-Clusters auf Azure Stack Hub beschrieben verwenden.

Unterbrechungen des Upgrades

Es kann auch vorkommen, dass das Upgrade des Clusters aufgrund von unerwarteten Faktoren unterbrochen wird. Eine Unterbrechung kann auftreten, wenn das AKS-Modul einen Fehler meldet oder etwas mit dem Ausführungsprozess des AKS-Moduls geschieht. Untersuchen Sie die Ursache der Unterbrechung, beheben Sie sie, und übermitteln Sie denselben upgrade Befehl erneut, um den Upgradevorgang fortzusetzen. Der upgrade Befehl ist idempotent und sollte das Upgrade des Clusters fortsetzen, sobald Sie den Befehl erneut übermitteln. Normalerweise erhöhen Unterbrechungen die Zeit zum Abschließen des Updates, sollten sich jedoch nicht auf den Abschluss auswirken.

Geschätzte Upgradedauer

Die geschätzte Upgradezeit beträgt 12 bis 15 Minuten pro VM im Cluster. Ein 20-Knoten-Cluster kann z. B. etwa 5 Stunden dauern, bis ein Upgrade durchgeführt wird.

Herunterladen eines neuen Images und der AKS-Engine

Laden Sie die neuen Versionen des AKS Base Ubuntu-Images und der AKS-Engine herunter.

Wie in der Dokumentation für das AKS-Modul auf Azure Stack Hub erläutert, erfordert die Bereitstellung eines Kubernetes-Clusters zwei Hauptkomponenten:

  • Die Binärdatei des Aks-Moduls (erforderlich).
  • AKS Base Ubuntu 16.04-LTS Image Distro.

Neue Versionen hierfür sind unter diesem Update verfügbar:

Upgradepfad für Kubernetes-Version

Die aktuelle Version und Upgradeversion für Azure Stack Hub finden Sie in der folgenden Tabelle. Diese Tabelle gilt für den AKS-Modulcluster im Azure Stack Hub. Verwenden Sie nicht den Befehl "Aks-Engine get-versions ", der Versionen zurückgibt, die in globalen Azure sowie in Azure Stack Hub unterstützt werden.

Aktuelle Version Upgrade verfügbar
1.14.7 1.15.10
1.14.8 1.15.10
1.15.4 1.15.10
1.15.5 1.15.10

Neues

  • Unterstützung für Kubernetes-Version 1.15.10 (#2834). Wenn Sie einen neuen Cluster bereitstellen, geben Sie in Ihrem API-Modell .json Datei (auch als Clusterdefinitionsdatei bezeichnet) sowohl die Versionsnummer als auch die Nebenversionsnummer im folgenden Format an. Ein Beispiel für eine Clusterdefinitionsdatei finden Sie unter kubernetes-azurestack.json.

    • "orchestratorRelease": "1.15,

    • "orchestratorVersion": "1.15.10"

    Hinweis

    Wenn die Kubernetes-Version nicht explizit im API-Modell .json Datei bereitgestellt wird, wird Version 1.15 (#2932) verwendet, und die OrchestratorVersion wird standardmäßig auf 1.15.11 festgelegt, was zu einem Fehler während der Bereitstellung des Clusters führt.

  • Bei Version 0.43.1 der AKS-Engine passen die Standardeinstellungen für die Häufigkeit, mit der der Cloudanbieter die Steuerungsschleife und andere Aufgaben durchführt, nicht gut zu den Schwellenwerten für eingehende Anforderungen, die von Azure Stack Hub Resource Manager verwendet werden. Bei diesem Update werden die Standardeinstellungen für Azure Stack Hub geändert, um die Wiederholungslast für Azure Stack Hub Resource Manager zu reduzieren (#2861).

  • Der neue Überprüfungsschritt in aks-Engine führt entweder zum Beenden der Ausführung oder zum Anzeigen von Warnungen, wenn das API-Modell .json Datei Eigenschaften enthält, die von Azure Stack Hub (#2717) nicht unterstützt werden.

  • Mit einer neuen Verifizierungsmethode überprüft die AKS-Engine die Verfügbarkeit der Version des AKS-Basisimages, das für die ausgeführte Version der AKS-Engine benötigt wird (#2342). Dies geschieht nach der Analyse des API-Modells .json Datei und vor dem Aufrufen des Azure Stack Hub Resource Manager.

  • Neue Aks-Engine-Option "--control-plane-only" im upgrade Befehl ermöglicht es dem Benutzer, Vorgänge nur auf die Master virtual Machines (#2635) zu aktualisieren.

  • Es wird ein Update auf Linux-Kernel-Version 4.15.0-1071-azure für Ubuntu 16.04-LTS durchgeführt. Weitere Informationen finden Sie unter Package: linux-image-4.15.0-1071-azure (4.15.0-1071.76) [security].

  • Neue Hyperkube-Updates zur Unterstützung der Kubernetes-Versionen 1.14.8 und 1.15.10.

  • Aktualisieren Sie kubectl so, dass sie der Version von Kubernetes für den Cluster entspricht. Diese Komponente ist auf den Steuerungsebenenknoten des Kubernetes-Clusters verfügbar. Sie können sie ausführen, indem Sie per SSH auf einen Master zugreifen.

  • Updates für das Azure Container Monitor-Add-In mit der neuesten Version vom Februar 2020 (#2850).

  • Upgrade von coredns auf Version 1.6.6 (#2555).

  • Upgrade von etcd auf Version 3.3.18 (#2462).

  • Upgrade von moby auf Version 3.0.11 (#2887).

  • Mit diesem Release der AKS-Engine wird die Abhängigkeit von k8s.gcr.io beendet und beim Erstellen von Images nun die offizielle Vorgehensweise mit Kubernetes MCR registry @ mcr.microsoft.com verwendet (#2722).

Bekannte Probleme

  • Die parallele Bereitstellung mehrerer Kubernetes-Dienste in einem Cluster kann zu einem Fehler in der grundlegenden Konfiguration für den Lastenausgleich führen. Es wird empfohlen, jeweils einen Dienst bereitzustellen.
  • Das Ausführen einesKs-Moduls get-versions erzeugt Informationen, die für Azure und Azure Stack Hub gelten. Es gibt jedoch keine explizite Möglichkeit zu erkennen, was Azure Stack Hub entspricht. Verwenden Sie diesen Befehl nicht, um zu bestimmen, welche Versionen für das Upgrade verfügbar sind. Verwenden Sie die im vorherigen Abschnitt beschriebene Upgradereferenztabelle.
  • Da das Aks-Engine-Tool ein freigegebenes Quellcode-Repository in Azure und Azure Stack Hub ist, können Sie die vielen Versionshinweise und Pullanforderungen untersuchen, um zu glauben, dass das Tool andere Versionen von Kubernetes und Betriebssystemplattform unterstützt, die über die zuvor aufgeführten hinausgehen. Sie können sie ignorieren und die obige Versionstabelle als offizielle Anleitung für dieses Update verwenden.

Verweis

Es folgt eine Liste einiger der behobenen Fehler und der vollständige Satz von Version 0.44.0 auf Version 0.48.0. Die Versionshinweise enthalten sowohl Azure als auch Azure Stack Hub.

Fehlerkorrekturen

  • userAssignedIdentityId in Windows azure.json fehlende Anführungszeichen (#2327)

  • Add-Ins update config sind nur upgraden (#2282)

  • Timeout für das Abrufen der Verwaltungs-IP auf Windows-Knoten (#2284)

  • Hinzufügen der Datei 1.0.28 Azure CNI .zip zu Windows VHD (#2268)

  • Richtige Standardreihenfolge für die Einstellung IPAddressCount (#2358)

  • Aktualisieren, um einzelne omsagent yaml für alle K8s-Versionen zu verwenden, um manuelle Fehler und einfache Wartung zu vermeiden (#2692)

Versionshinweise

Dies sind alle Versionshinweise, die für Azure und Azure Stack Hub gemeinsam gelten:

Nächste Schritte