Versionshinweise für das AKS-Modul im Azure Stack Hub
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:
Überprüfen Sie die AKS-Modul- und Azure Stack-Versionszuordnungstabelle für die erforderlichen AKS-Basisimages.
Befolgen Sie die Anweisungen unter Hinzufügen der Voraussetzungen des Azure Kubernetes Services (AKS)-Moduls zum Azure Stack Hub Marketplace.
Der Kubernetes-Clusteradministrator (normalerweise ein Mandantbenutzer von Azure Stack Hub) muss das neue Aks-Modul herunterladen. Lesen Sie die Anweisungen unter Installieren des AKS-Moduls unter Linux im Azure Stack Hub (oder einem entsprechenden Windows-Artikel). Sie können den gleichen Prozess wie bei der ersten Installation des Clusters verwenden. Das Update überschreibt die vorherige Binärdatei. Wenn Sie z. B. das skript get-akse.sh verwendet haben, führen Sie die gleichen Schritte aus, die in der Installation in einer verbundenen Umgebung beschrieben sind. Derselbe Vorgang gilt, wenn Sie auf einem Windows-System installieren: Installieren Sie das AKS-Modul unter Windows im Azure Stack Hub.
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* |
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.
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:
- https://github.com/Azure/aks-engine/releases/tag/v0.64.0
- https://github.com/Azure/aks-engine/releases/tag/v0.65.0
- https://github.com/Azure/aks-engine/releases/tag/v0.65.1
- https://github.com/Azure/aks-engine/releases/tag/v0.66.0
- https://github.com/Azure/aks-engine/releases/tag/v0.66.1
- https://github.com/Azure/aks-engine/releases/tag/v0.67.0
- https://github.com/Azure/aks-engine/releases/tag/v0.70.0
- https://github.com/Azure/aks-engine/releases/tag/v0.71.0
- https://github.com/Azure/aks-engine/releases/tag/v0.73.0
- https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.75.3
- https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.76.0
- https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.77.0
- https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.78.0
- https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.79.0
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:
Überprüfen Sie die AKS-Modul- und Azure Stack-Versionszuordnungstabelle für die erforderlichen AKS-Basisimages.
Befolgen Sie die Anweisungen unter Hinzufügen der Voraussetzungen des Azure Kubernetes Services (AKS)-Moduls zum Azure Stack Hub Marketplace.
Der Kubernetes-Clusteradministrator (normalerweise ein Mandantbenutzer von Azure Stack Hub) muss das neue Aks-Modul herunterladen. Lesen Sie die Anweisungen unter Installieren des AKS-Moduls unter Linux im Azure Stack Hub (oder einem entsprechenden Windows-Artikel). Sie können den gleichen Prozess wie bei der ersten Installation des Clusters verwenden. Das Update überschreibt die vorherige Binärdatei. Wenn Sie z. B. das skript get-akse.sh verwendet haben, führen Sie die gleichen Schritte aus, die in der Installation in einer verbundenen Umgebung beschrieben sind. Derselbe Vorgang gilt, wenn Sie auf einem Windows-System installieren: Installieren Sie das AKS-Modul unter Windows im Azure Stack Hub.
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) |
Neuerungen
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:
- https://github.com/Azure/aks-engine/releases/tag/v0.64.0
- https://github.com/Azure/aks-engine/releases/tag/v0.65.0
- https://github.com/Azure/aks-engine/releases/tag/v0.65.1
- https://github.com/Azure/aks-engine/releases/tag/v0.66.0
- https://github.com/Azure/aks-engine/releases/tag/v0.66.1
- https://github.com/Azure/aks-engine/releases/tag/v0.67.0
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:
Der Azure Stack Hub-Operator muss die neuen AKS-Basisimages auf den Stamp Marketplace herunterladen:
AKS Base Ubuntu 16.04-LTS-Imagedistribution, Januar 2021 (2021.01.28)
AKS Base Ubuntu 18.04-LTS-Imagedistribution, 2021 Q1 (2021.01.28)
AKS Base Windows-Image (17763.1697.210129)
Befolgen Sie die Anweisungen unter Hinzufügen der Voraussetzungen des Azure Kubernetes Services (AKS)-Moduls zum Azure Stack Hub Marketplace.
Der Kubernetes-Clusteradministrator (normalerweise ein Mandantbenutzer von Azure Stack Hub) muss das neue Aks-Modul herunterladen. Lesen Sie die Anweisungen unter Installieren des AKS-Moduls unter Linux im Azure Stack Hub (oder einem entsprechenden Windows-Artikel). Sie können den gleichen Prozess wie bei der ersten Installation des Clusters verwenden. Das Update überschreibt die vorherige Binärdatei. Wenn Sie z. B. das skript get-akse.sh verwendet haben, führen Sie die gleichen Schritte aus, die in der Installation in einer verbundenen Umgebung beschrieben sind. Derselbe Vorgang gilt, wenn Sie auf einem Windows-System installieren: Installieren Sie das AKS-Modul unter Windows im Azure Stack Hub.
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 |
Neuerungen
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:
Der Azure Stack Hub-Operator muss ein neues AKS-Basis-Ubuntu-Image auf den Stamp Marketplace herunterladen:
Name: AKS Base Ubuntu 16.04-LTS Image Distro, September 2020 (2020.09.14)
Version: 2020.09.14
Befolgen Sie die Anweisungen unter Hinzufügen der Voraussetzungen des Azure Kubernetes Services (AKS)-Moduls zum Azure Stack Hub Marketplace.
Der Kubernetes-Clusteradministrator (normalerweise ein Mandantbenutzer von Azure Stack Hub) muss das neue Aks-Modul herunterladen. Lesen Sie die Anweisungen unter Installieren des AKS-Moduls unter Linux im Azure Stack Hub (oder einem entsprechenden Windows-Artikel). Sie können den gleichen Prozess wie bei der ersten Installation des Clusters verwenden. Das Update überschreibt die vorherige Binärdatei. Wenn Sie z. B. das skript get-akse.sh verwendet haben, führen Sie die gleichen Schritte aus, die in der Installation in einer verbundenen Umgebung beschrieben sind. Derselbe Vorgang gilt, wenn Sie auf einem Windows-System installieren: Installieren Sie das AKS-Modul unter Windows im Azure Stack Hub.
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) |
Neuerungen
- 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:
- https://github.com/Azure/aks-engine/releases/tag/v0.51.1
- https://github.com/Azure/aks-engine/releases/tag/v0.52.1
- https://github.com/Azure/aks-engine/releases/tag/v0.53.1
- https://github.com/Azure/aks-engine/releases/tag/v0.54.1
- https://github.com/Azure/aks-engine/releases/tag/v0.55.0
- https://github.com/Azure/aks-engine/releases/tag/v0.55.4
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:
Der Azure Stack Hub-Operator muss die neuen AKS-Basisimages auf den Stamp Marketplace herunterladen:
Name:
AKS Base Ubuntu 16.04-LTS Image Distro, March 2020Version:
2020.03.19Befolgen Sie die Anweisungen unter Hinzufügen der Voraussetzungen des Azure Kubernetes Services (AKS)-Moduls zum Azure Stack Hub Marketplace.
Der Kubernetes-Clusteradministrator (normalerweise ein Mandantbenutzer von Azure Stack Hub) muss das neue Aks-Modul herunterladen. Lesen Sie die Anweisungen unter Installieren des AKS-Moduls unter Linux im Azure Stack Hub (oder einem entsprechenden Windows-Artikel). Sie können den gleichen Prozess wie bei der ersten Installation des Clusters verwenden. Das Update überschreibt die vorherige Binärdatei. Wenn Sie z. B. das skript get-akse.sh verwendet haben, führen Sie die gleichen Schritte aus, die in der Installation in einer verbundenen Umgebung beschrieben sind. Derselbe Vorgang gilt, wenn Sie auf einem Windows-System installieren: Installieren Sie das AKS-Modul unter Windows im Azure Stack Hub.
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 |
Neuerungen
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
upgradeBefehl 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
corednsauf Version 1.6.6 (#2555).Upgrade von
etcdauf Version 3.3.18 (#2462).Upgrade von
mobyauf Version 3.0.11 (#2887).Mit diesem Release der AKS-Engine wird die Abhängigkeit von
k8s.gcr.iobeendet und beim Erstellen von Images nun die offizielle Vorgehensweise mitKubernetes MCR registry @ mcr.microsoft.comverwendet (#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-versionserzeugt 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
userAssignedIdentityIdin Windows azure.json fehlende Anführungszeichen (#2327)Add-Ins
update configsind 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:
- https://github.com/Azure/aks-engine/releases/tag/v0.44.0
- https://github.com/Azure/aks-engine/releases/tag/v0.44.1
- https://github.com/Azure/aks-engine/releases/tag/v0.44.2
- https://github.com/Azure/aks-engine/releases/tag/v0.45.0
- https://github.com/Azure/aks-engine/releases/tag/v0.46.0
- https://github.com/Azure/aks-engine/releases/tag/v0.46.1
- https://github.com/Azure/aks-engine/releases/tag/v0.46.2
- https://github.com/Azure/aks-engine/releases/tag/v0.46.3
- https://github.com/Azure/aks-engine/releases/tag/v0.47.0
- https://github.com/Azure/aks-engine/releases/tag/v0.48.0
Nächste Schritte
- Informationen zum AKS-Modul im Azure Stack Hub
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für