Versionshinweise für die AKS-Engine in Azure Stack Hub
Gilt für Version v0.80.2 der AKS-Engine.
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 dient nicht dazu, die Releaseinformationen für die AKS-Engine für das globale Azure zu dokumentieren.
Überlegungen zur Aktualisierung
- Verwenden Sie die richtigen Marketplace-Elemente, AKS Base Ubuntu 20.04 Image Distribution oder AKS Base Windows Server für Ihre Version der AKS-Engine? 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 VMs entspricht der ursprünglichen, aber planen Sie, dass während des Prozesses einige weitere VMs erstellt werden.
- 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 verwenden, wie unter Aktualisieren eines Kubernetes-Clusters in Azure Stack Hub beschrieben.
Unterbrechungen des Upgrades
Es kann auch vorkommen, dass das Upgrade des Clusters aufgrund von unerwarteten Faktoren unterbrochen wird. Eine Unterbrechung kann auftreten, wenn die AKS-Engine einen Fehler meldet oder beim Ausführungsprozess der AKS-Engine etwas passiert. 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 dessen Abschluss auswirken.
Geschätzte Upgradedauer
Die geschätzte Upgradezeit beträgt 12 bis 15 Minuten pro VM im Cluster. Beispielsweise kann das Upgrade eines Clusters mit 20 Knoten etwa 5 Stunden dauern.
Anweisungen zur Verwendung der AKS-Engine 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 der AKS-Engine herunter.
Wie in der Dokumentation zur AKS-Engine für Azure Stack Hub erläutert, erfordert die Bereitstellung eines Kubernetes-Clusters Folgendes:
- Die aks-engine-Binärdatei (erforderlich).
- AKS Base Ubuntu 16.04-LTS Image Distro (veraltet – nicht mehr verwenden, ändern Sie im API-Modell stattdessen 20.04).
- AKS Base Ubuntu 18.04-LTS Image Distro (veraltet – nicht mehr verwenden, ändern Sie im API-Modell stattdessen 20.04).
- AKS Base Ubuntu 20.04-LTS Image Distribution (erforderlich für Linux-Agents).
- AKS-Basis-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.
Mit diesem Update sind neue Versionen dieser Images verfügbar:
Überprüfen Sie die AKS-Engine und die Azure Stack-Versionszuordnungstabelle auf die erforderlichen AKS-Basisimages.
Befolgen Sie die Anweisungen unter Hinzufügen der Voraussetzungen für die Azure Kubernetes Services-Engine (AKS) zum Azure Stack Hub Marketplace.
Der Kubernetes-Clusteradministrator (normalerweise ein Mandantenbenutzer von Azure Stack Hub) muss die neue aks-Engine herunterladen. Weitere Informationen finden Sie unter Installieren der AKS-Engine unter Linux in Azure Stack Hub (oder in 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 beispielsweise das skript get-akse.sh verwendet haben, führen Sie die gleichen Schritte aus, die unter Installieren in einer verbundenen Umgebung beschrieben sind. Der gleiche Prozess gilt, wenn Sie auf einem Windows-System installieren: Installieren Sie die AKS-Engine unter Windows in Azure Stack Hub.
Upgrade von Kubernetes-Clustern, die mit der Ubuntu-Distribution 16.04 erstellt wurden
Ab AKS Engine v0.63.0 wird die Ubuntu 16.04-Distribution nicht mehr unterstützt, da das Betriebssystem sein Ende der Lebensdauer erreicht hat. Für AKS Engine v0.67.0 oder höhere Versionen überschreibt das Upgrade der aks-Engine automatisch den nicht unterstützten aks-ubuntu-16.04
Distributionswert mit aks-ubuntu-18.04
mit . Wenn Sie Kubernetes v1.24 oder höher verwenden, überschreibt das aks-engine-azurestack-Upgrade automatisch den nicht unterstützten aks-ubuntu-16.04
Distributionswert mit aks-ubuntu-20.04
.
Aktualisieren von Kubernetes-Clustern, die mit der Ubuntu 18.04-Distribution erstellt wurden
Ab AKS Engine v0.75.3 wird die Ubuntu 18.04-Distribution nicht mehr unterstützt, da das Betriebssystem sein Ende der Lebensdauer erreicht hat. Bei AKS Engine v0.75.3 oder höheren Versionen überschreibt das aks-engine-azurestack-Upgrade automatisch den nicht unterstützten aks-ubuntu-18.04
Distributionswert mit aks-ubuntu-20.04
.
Aktualisieren von Kubernetes-Clustern, die mit docker container runtime erstellt wurden
In Kubernetes v1.24 wurde die Dockershim-Komponente aus kubelet entfernt. Daher wird die Docker-Containerruntime nicht mehr unterstützt. Weitere Informationen finden Sie in den Versionshinweisen zu Kubernetes v1.24 . Bei AKS Engine v0.75.3 oder höheren Versionen überschreibt das aks-engine-azurestack-Upgrade automatisch den nicht unterstützten docker
containerRuntime
Wert mit containerd
.
Für das AKS-Engine-Release v0.75.3 können Cluster mit Windows-Knoten unter Kubernetes v1.23 das Windows-Basisimage mit der Docker-Runtime verwenden. Cluster mit Windows-Knoten in 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 Richtlinie zur Unterstützung von Versionen der AKS-Engine .
AKS-Engine und entsprechende Imagezuordnungen
Die unterstützten Kubernetes-Versionen für die AKS-Engine in Azure Stack Hub finden Sie in der folgenden Tabelle. Verwenden Sie nicht den Befehl aks-engine get-versions
, der versionen zurückgibt, die sowohl im globalen Azure als auch in Azure Stack Hub unterstützt werden.
Hinweis
*Ab Kubernetes v1.21 wird in Azure Stack Hub nur der Cloudanbieter für Azure unterstützt.
Hinweis
** Ab Kubernetes v1.24 wird nur die containerd
Containerruntime unterstützt. Weitere Informationen finden Sie im Abschnitt Upgraden von Kubernetes-Clustern, die mit docker container runtime erstellt wurden .
Updateplanung
Der AKS-Engine-Befehl upgrade
automatisiert den Upgradeprozess Ihres Clusters vollständig und verarbeitet 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:
Neuerungen in 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
Das AKS-Engine-Release v0.75.3 und alle zukünftigen AKS-Engine-Releases in Azure Stack Hub stammen aus dem neuen Repository aks-engine-azurestack. Daher sollten alle aks-engine
Befehle durch aks-engine-azurestack
ersetzt werden. Die Befehle zum Abrufen der neuesten Version der AKS-Engine in Azure Stack Hub wurden ebenfalls geändert. Die neuen Befehle finden Sie unter Erstellen eines Linux-Clients und Erstellen eines Windows-Clients. Erstellen Sie ein Problem im neuen Repository , wenn Sie Probleme finden.
Das AKS-Engine-Release v0.75.3 in Azure Stack Hub bietet Ubuntu 20.04 LTS als Linux-Basisimage. Ab diesem Release wird Ubuntu 18.04 nicht mehr unterstützt. Weitere Informationen finden Sie unter Aktualisieren von Kubernetes-Clustern, die mit der Ubuntu 18.04-Distribution erstellt wurden .
Ab Kubernetes v1.24 wird nur die containerd
Runtime unterstützt. Weitere Informationen finden Sie unter Upgraden von Kubernetes-Clustern, die mit der Docker-Runtime erstellt wurden . Für das AKS-Engine-Release v0.75.3 können Cluster mit Windows-Knoten unter Kubernetes v1.23 das Windows-Basisimage mit Docker-Runtime verwenden. Cluster mit Windows-Knoten in Kubernetes v1.24 können das Windows-Basisimage mit Containerd Runtime verwenden.
Weitere Features finden Sie auf der GitHub-Seite v0.75.3.
Anweisungen zur Verwendung der AKS-Engine 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 die AKS-Engine 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 in der AKS-Engine und der entsprechenden Imagezuordnungstabelle bereitgestellt wurde.
Wenn Sie einen neuen Cluster erstellen, aber Ihr vorhandenes API-Modell verwenden möchten: Ändern Sie Ihr API-Modell, indem Sie die Anweisungen des Cloudanbieters für Azure befolgen. Fehler beim Einschließen der neuen Einstellung führt zu einem Bereitstellungsfehler.
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. Befolgen Sie zum Upgrade die Anweisungen unter Upgrade, während Sie Speichervolumes verwenden.
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, einen Dienst gleichzeitig bereitzustellen.
- Da das aks-engine-Tool ein gemeinsam genutztes Quellcoderepository in Azure und Azure Stack Hub ist, können Sie die vielen Versionshinweise und Pull Requests 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.
Referenz
Die folgende Liste enthält den vollständigen 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 der AKS-Engine.
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 dient nicht dazu, die Releaseinformationen für die AKS-Engine für die globale Azure-Instanz zu dokumentieren.
Updateplanung
Der Befehl der AKS-Engine upgrade
automatisiert den Upgradeprozess Ihres Clusters vollständig. Er verarbeitet 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:
Überlegungen zur Aktualisierung
- 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 der AKS-Engine? 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 der AKS-Engine, 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 VMs entspricht der ursprünglichen, aber planen Sie, dass während des Prozesses einige weitere VMs erstellt werden.
- 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 verwenden, wie unter Aktualisieren eines Kubernetes-Clusters in Azure Stack Hub beschrieben.
Unterbrechungen des Upgrades
Es kann auch vorkommen, dass das Upgrade des Clusters aufgrund von unerwarteten Faktoren unterbrochen wird. Eine Unterbrechung kann auftreten, wenn die AKS-Engine einen Fehler meldet oder beim Ausführungsprozess der AKS-Engine etwas passiert. 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 dessen Abschluss auswirken.
Geschätzte Upgradedauer
Die geschätzte Upgradezeit beträgt 12 bis 15 Minuten pro VM im Cluster. Beispielsweise kann das Upgrade für einen Cluster mit 20 Knoten etwa 5 Stunden dauern.
Herunterladen eines neuen Images und der AKS-Engine
Laden Sie die neuen Versionen des AKS-Basis-Ubuntu-Images und der AKS-Engine herunter.
Wie in der Dokumentation für die AKS-Engine für Azure Stack Hub erläutert, erfordert die Bereitstellung eines Kubernetes-Clusters Folgendes:
- Die aks-Engine-Binärdatei (erforderlich).
- AKS Base Ubuntu 16.04-LTS Image Distro (veraltet – nicht mehr verwenden, ändern Sie im API-Modell stattdessen 18.04).
- AKS Base Ubuntu 18.04-LTS Image Distro (erforderlich für Linux-Agents).
- AKS-Basis-Windows Server-Image-Distribution (erforderlich für Windows-Agents).
Mit diesem Update sind neue Versionen dieser Images verfügbar:
Überprüfen Sie die AKS-Engine und die Azure Stack-Versionszuordnungstabelle auf die erforderlichen AKS-Basisimages.
Befolgen Sie die Anweisungen unter Hinzufügen der Voraussetzungen der Azure Kubernetes Services-Engine (AKS) zum Azure Stack Hub Marketplace.
Der Kubernetes-Clusteradministrator (normalerweise ein Mandantenbenutzer von Azure Stack Hub) muss die neue aks-Engine herunterladen. Weitere Informationen finden Sie in den Anweisungen unter Installieren der AKS-Engine unter Linux in Azure Stack Hub (oder in 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 beispielsweise das skript get-akse.sh verwendet haben, führen Sie die gleichen Schritte aus, die unter Installieren in einer verbundenen Umgebung beschrieben sind. Der gleiche Prozess gilt, wenn Sie die Installation auf einem Windows-System ausführen: Installieren Sie die AKS-Engine unter Windows in Azure Stack Hub.
Upgrade von Kubernetes-Clustern, die mit der Ubuntu-Distribution 16.04 erstellt wurden
Ab AKS Engine v0.67.0 wird die Ubuntu 16.04-Distribution nicht mehr unterstützt, da das Betriebssystem sein Lebenszyklusende erreicht hat. Um einen Cluster zu aktualisieren, stellen Sie sicher, dass Sie die Betriebssystem-Distribution in Ihrem Eingabe-API-Modell auf aks-ubuntu-18.04
festlegen, die von aks-engine deploy
generiert und als Eingabe an aks-engine upgrade
übergeben wird:
"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-Engine-Cluster in Azure Stack Hub. Verwenden Sie nicht den Befehl aks-engine get-versions
, der Versionen zurückgibt, die sowohl im globalen Azure als auch 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 im orchestratorProfile
Abschnitt an. Wenn Sie beispielsweise kubernetes 1.17.17 bereitstellen möchten, 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-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) |
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 verfügbare Funktionen:
- 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, einen Dienst gleichzeitig bereitzustellen.
- Da das aks-engine-Tool ein gemeinsam genutztes Quellcoderepository in Azure und Azure Stack Hub ist, können Sie die vielen Versionshinweise und Pull Requests 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.
Referenz
Die folgende Liste enthält den vollständigen 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 der AKS-Engine.
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 dient nicht dazu, die Releaseinformationen für die AKS-Engine für die globale Azure-Instanz zu dokumentieren.
Updateplanung
Der Befehl der AKS-Engine upgrade
automatisiert den Upgradeprozess Ihres Clusters vollständig und verarbeitet 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:
Überlegungen zur Aktualisierung
- 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 der AKS-Engine? 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 der AKS-Engine, 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 VMs entspricht der ursprünglichen, aber planen Sie, dass während des Prozesses einige weitere VMs erstellt werden.
- 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 verwenden, wie unter Aktualisieren eines Kubernetes-Clusters in Azure Stack Hub beschrieben.
Unterbrechungen des Upgrades
Es kann auch vorkommen, dass das Upgrade des Clusters aufgrund von unerwarteten Faktoren unterbrochen wird. Eine Unterbrechung kann auftreten, wenn die AKS-Engine einen Fehler meldet oder beim Ausführungsprozess der AKS-Engine etwas passiert. 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 dessen Abschluss auswirken.
Geschätzte Upgradedauer
Die geschätzte Upgradezeit beträgt 12 bis 15 Minuten pro VM im Cluster. Das Upgrade eines Clusters mit 20 Knoten kann beispielsweise etwa 5 Stunden dauern.
Herunterladen eines neuen Images und der AKS-Engine
Laden Sie die neuen Versionen des AKS-Basis-Ubuntu-Images und der AKS-Engine herunter.
Wie in der Dokumentation für die AKS-Engine in Azure Stack Hub erläutert, erfordert die Bereitstellung eines Kubernetes-Clusters Folgendes:
- Die aks-Engine-Binärdatei (erforderlich).
- AKS Base Ubuntu 16.04-LTS Image Distro (veraltet – nicht mehr verwenden, ändern Sie im API-Modell stattdessen 18.04).
- AKS Base Ubuntu 18.04-LTS Image Distro (erforderlich für Linux-Agents).
- AKS-Basis-Windows Server-Image-Distribution (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 in den Stempel-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 für die Azure Kubernetes Services-Engine (AKS) zum Azure Stack Hub Marketplace.
Der Kubernetes-Clusteradministrator (normalerweise ein Mandantenbenutzer von Azure Stack Hub) muss die neue aks-Engine herunterladen. Weitere Informationen finden Sie unter Installieren der AKS-Engine unter Linux in Azure Stack Hub (oder in 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 beispielsweise das skript get-akse.sh verwendet haben, führen Sie die gleichen Schritte aus, die unter Installieren in einer verbundenen Umgebung beschrieben sind. Der gleiche Prozess gilt, wenn Sie auf einem Windows-System installieren: Installieren Sie die AKS-Engine unter Windows in 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 die Upgradeversion für Azure Stack Hub finden Sie in der folgenden Tabelle. Diese Tabelle gilt für den AKS-Engine-Cluster in Azure Stack Hub. Verwenden Sie nicht den Befehl aks-engine get-versions
, der versionen zurückgibt, die sowohl im globalen Azure als auch 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 Werte für Release und Version im Abschnitt an orchestratorProfile
. Wenn Sie beispielsweise die Bereitstellung von Kubernetes 1.17.17 planen, 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-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) |
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 verfügbare Funktionen:
- Allgemeine Verfügbarkeit von Ubuntu 18.04.
- Zertifikatrotation Public Preview #4214.
- T4 Nvidia GPU Private Preview #4259.
- Azure Active Directory integriert die private Vorschau.
- CSI-Treiber für Azure Blobs Private Preview #712.
- CSI Driver 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 gemeinsam genutztes Quellcoderepository in Azure und Azure Stack Hub ist, kann das Untersuchen der vielen Versionshinweise und Pull Requests zu der Annahme führen, dass das Tool andere Versionen von Kubernetes und der 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.
Referenz
Die folgende Liste enthält die vollständigen Versionshinweise für Azure und Azure Stack Hub kombiniert:
Gilt für Version v0.55.4 der AKS-Engine.
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 dient nicht dazu, die Releaseinformationen für die AKS-Engine für das globale Azure zu dokumentieren.
Updateplanung
Der AKS-Engine-Befehl upgrade
automatisiert den Upgradeprozess Ihres Clusters vollständig und verarbeitet 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:
Überlegungen zur Aktualisierung
- Verwenden Sie das richtige Marketplace-Element, AKS Base Ubuntu 16.04-LTS Image Distribution für Ihre Version der AKS-Engine? Sie finden die Versionen im Abschnitt "Neues Image und AKS-Engine 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 VMs entspricht der ursprünglichen, aber planen Sie, dass während des Prozesses einige weitere VMs erstellt werden.
- 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 verwenden, wie unter Aktualisieren eines Kubernetes-Clusters in Azure Stack Hub beschrieben.
Unterbrechungen des Upgrades
Es kann auch vorkommen, dass das Upgrade des Clusters aufgrund von unerwarteten Faktoren unterbrochen wird. Eine Unterbrechung kann auftreten, wenn die AKS-Engine einen Fehler meldet oder beim Ausführungsprozess der AKS-Engine etwas passiert. 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 dessen Abschluss auswirken.
Geschätzte Upgradedauer
Die geschätzte Upgradezeit beträgt 12 bis 15 Minuten pro VM im Cluster. Beispielsweise kann das Upgrade eines Clusters mit 20 Knoten etwa 5 Stunden dauern.
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 die AKS-Engine in Azure Stack Hub erläutert, erfordert die Bereitstellung eines Kubernetes-Clusters zwei Standard Komponenten:
- Die aks-engine-Binärdatei (erforderlich).
- AKS Base Ubuntu 16.04-LTS Image Distro
Mit diesem Update sind neue Versionen dieser Images verfügbar:
Der Azure Stack Hub-Operator muss ein neues AKS-Basis-Ubuntu-Image in 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 für die Azure Kubernetes Services-Engine (AKS) zum Azure Stack Hub Marketplace.
Der Kubernetes-Clusteradministrator (normalerweise ein Mandantenbenutzer von Azure Stack Hub) muss die neue aks-Engine herunterladen. Weitere Informationen finden Sie unter Installieren der AKS-Engine unter Linux in Azure Stack Hub (oder in 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 beispielsweise das skript get-akse.sh verwendet haben, führen Sie die gleichen Schritte aus, die unter Installieren in einer verbundenen Umgebung beschrieben sind. Der gleiche Prozess gilt, wenn Sie auf einem Windows-System installieren: Installieren Sie die AKS-Engine unter Windows in 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 die Upgradeversion für Azure Stack Hub finden Sie in der folgenden Tabelle. Diese Tabelle gilt für den AKS-Engine-Cluster in Azure Stack Hub. Verwenden Sie nicht den Befehl aks-engine get-versions
, der versionen zurückgibt, die sowohl im globalen Azure als auch 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 Werte für Release und Version im Abschnitt an orchestratorProfile
. Wenn Sie beispielsweise die Bereitstellung von Kubernetes 1.17.17 planen, 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 aks-engine
get-versions
ausfü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 gemeinsam genutztes Quellcoderepository in Azure und Azure Stack Hub ist, kann das Untersuchen der vielen Versionshinweise und Pull Requests zu der Annahme führen, dass das Tool andere Versionen von Kubernetes und der 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 früher der AKS-Engine.
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 dient nicht dazu, die Releaseinformationen für die AKS-Engine für das globale Azure zu dokumentieren.
Updateplanung
Der AKS-Engine-Befehl upgrade
automatisiert den Upgradeprozess Ihres Clusters vollständig und verarbeitet 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:
Überlegungen zur Aktualisierung
- Verwenden Sie das richtige Marketplace-Element, AKS Base Ubuntu 16.04-LTS Image Distribution für Ihre Version der AKS-Engine? 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 der AKS-Engine 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 VMs entspricht der ursprünglichen, aber planen Sie, dass während des Prozesses einige weitere VMs erstellt werden.
- 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 verwenden, wie unter Aktualisieren eines Kubernetes-Clusters in Azure Stack Hub beschrieben.
Unterbrechungen des Upgrades
Es kann auch vorkommen, dass das Upgrade des Clusters aufgrund von unerwarteten Faktoren unterbrochen wird. Eine Unterbrechung kann auftreten, wenn die AKS-Engine einen Fehler meldet oder beim Ausführungsprozess der AKS-Engine etwas passiert. 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 dessen Abschluss auswirken.
Geschätzte Upgradedauer
Die geschätzte Upgradezeit beträgt 12 bis 15 Minuten pro VM im Cluster. Beispielsweise kann das Upgrade eines Clusters mit 20 Knoten etwa 5 Stunden dauern.
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 die AKS-Engine in Azure Stack Hub erläutert, erfordert die Bereitstellung eines Kubernetes-Clusters zwei Standard Komponenten:
- Die aks-engine-Binärdatei (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 in den Stamp Marketplace herunterladen:
Name:
AKS Base Ubuntu 16.04-LTS Image Distro, March 2020
Version:
2020.03.19
Befolgen Sie die Anweisungen unter Hinzufügen der Voraussetzungen für die Azure Kubernetes Services-Engine (AKS) zum Azure Stack Hub Marketplace.
Der Kubernetes-Clusteradministrator (normalerweise ein Mandantenbenutzer von Azure Stack Hub) muss die neue aks-Engine herunterladen. Weitere Informationen finden Sie unter Installieren der AKS-Engine unter Linux in Azure Stack Hub (oder in 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 beispielsweise das skript get-akse.sh verwendet haben, führen Sie die gleichen Schritte aus, die unter Installieren in einer verbundenen Umgebung beschrieben sind. Der gleiche Prozess gilt, wenn Sie auf einem Windows-System installieren: Installieren Sie die AKS-Engine unter Windows in Azure Stack Hub.
Upgradepfad für Kubernetes-Version
Die aktuelle Version und die Upgradeversion für Azure Stack Hub finden Sie in der folgenden Tabelle. Diese Tabelle gilt für den AKS-Engine-Cluster in Azure Stack Hub. Verwenden Sie nicht den Befehl aks-engine get-versions
, der versionen zurückgibt, die sowohl im globalen Azure als auch 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 bekannt als Clusterdefinitionsdatei) sowohl die Versionsnummer des Releases als auch die Nebenversionsnummer im folgenden Format an. Eine Beispieldatei für eine Clusterdefinition 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 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).
Ein neuer Überprüfungsschritt in aks-engine führt entweder dazu, dass die Ausführung beendet oder Warnungen angezeigt werden, wenn das API-Modell .json Datei Eigenschaften enthält, die von Azure Stack Hub nicht unterstützt werden (#2717).
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 Aufruf des Azure Stack Hub-Resource Manager.
Die neue aks-engine-Option "--control-plane-only" im
upgrade
Befehl ermöglicht es dem Benutzer, Vorgänge zu aktualisieren, um nur die master Virtual Machines (#2635) zu verwenden.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 es der Kubernetes-Version 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 von 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 mitKubernetes 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.
- Die Ausführung der aks-Engine
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 gemeinsam genutztes Quellcoderepository in Azure und Azure Stack Hub ist, kann das Untersuchen der vielen Versionshinweise und Pull Requests zu der Annahme führen, dass das Tool andere Versionen von Kubernetes und der 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.
Referenz
Im Folgenden finden Sie eine Liste einiger der behobenen Fehler und die vollständigen Versionshinweise von Version 0.44.0 bis Version 0.48.0. Die Versionshinweise enthalten sowohl Azure als auch Azure Stack Hub.
Behebung von Programmfehlern
userAssignedIdentityId
in Windows azure.json fehlende Anführungszeichen (#2327)Add-Ins
update config
sind nur upgraden (#2282)Timeout beim Abrufen der Verwaltungs-IP auf Windows-Knoten erhöhen (#2284)
Hinzufügen der Datei 1.0.28 Azure CNI .zip zur Windows-VHD (#2268)
Korrigieren der Standardreihenfolge für die Einstellung
IPAddressCount
(#2358)Update zur Verwendung eines einzelnen omsagent yaml für alle K8s-Versionen, um manuelle Fehler und einfache Wartbarkeit 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 zur AKS-Engine in Azure Stack Hub
Feedback
https://aka.ms/ContentUserFeedback.
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 unterFeedback senden und anzeigen für