Releaseopmerkingen voor AKS-engine in Azure Stack Hub
Is van toepassing op versie v0.80.2 van de AKS-engine.
In dit artikel wordt de inhoud van de AKS-engine (Azure Kubernetes Service) in Azure Stack Hub-update beschreven. De update bevat verbeteringen en oplossingen voor de nieuwste versie van de AKS-engine die is gericht op het Azure Stack Hub-platform. Dit artikel is niet bedoeld om de release-informatie voor de AKS-engine voor globale Azure te documenteren.
Overwegingen bij upgrades
- Gebruikt u de juiste Marketplace-items, AKS Base Ubuntu 20.04 Image Distro of AKS Base Windows Server voor uw versie van de AKS-engine? U vindt de versies in de sectie Nieuwe installatiekopieën en AKS-engine downloaden.
- Gebruikt u de juiste clusterspecificatie (apimodel.json) en resourcegroep voor het doelcluster? Toen u het cluster oorspronkelijk hebt geïmplementeerd, is dit bestand gegenereerd in de uitvoermap. Zie de implementatieopdrachtparameters Een Kubernetes-cluster implementeren.
- Gebruikt u een betrouwbare computer om de AKS-engine uit te voeren en van waaruit u upgradebewerkingen uitvoert?
- Als u een operationeel cluster bijwerkt met actieve workloads, kunt u de upgrade toepassen zonder dat dit van invloed is op de upgrade, ervan uitgaande dat het cluster normaal wordt belast. U moet echter een back-upcluster hebben voor het geval er gebruikers naar moeten worden omgeleid. Een back-upcluster wordt ten zeerste aanbevolen.
- Voer indien mogelijk de opdracht uit vanaf een VIRTUELE machine in de Azure Stack Hub-omgeving om de netwerkhops en mogelijke verbindingsfouten te verminderen.
- Zorg ervoor dat uw abonnement voldoende quotum heeft voor het hele proces. Tijdens het proces worden nieuwe VM's toegewezen. Het resulterende aantal virtuele machines is hetzelfde als het origineel, maar plan een paar meer VM's die tijdens het proces moeten worden gemaakt.
- Er worden geen systeemupdates of geplande taken gepland.
- Stel een gefaseerde upgrade in op een cluster dat is geconfigureerd met dezelfde waarden als het productiecluster en test de upgrade daar voordat u dit doet in uw productiecluster.
De upgradeopdracht gebruiken
U moet de aks-engine upgrade opdracht gebruiken zoals beschreven in Een Kubernetes-cluster upgraden in Azure Stack Hub.
Upgradeonderbrekingen
Soms onderbreken onverwachte factoren de upgrade van het cluster. Er kan een onderbreking optreden wanneer de AKS-engine een fout rapporteert of er iets gebeurt met het uitvoeringsproces van de AKS-engine. Bekijk de oorzaak van de onderbreking, los deze op en verzend dezelfde upgrade opdracht opnieuw om door te gaan met het upgradeproces. De upgrade opdracht is idempotent en moet de upgrade van het cluster hervatten nadat u de opdracht opnieuw hebt ingediend. Normaal gesproken verhogen onderbrekingen de tijd om de update te voltooien, maar moeten ze niet van invloed zijn op de voltooiing ervan.
Geschatte upgradetijd
De geschatte upgradetijd is 12 tot 15 minuten per VM in het cluster. Het kan bijvoorbeeld ongeveer vijf uur duren voordat een cluster met 20 knooppunten is bijgewerkt.
Instructies voor het gebruik van AKS-engine 0.70.0 en hoger
Nieuwe installatiekopieën en AKS-engine downloaden
Download de nieuwe versies van de AKS-basisinstallatiekopie voor Ubuntu en de AKS-engine.
Zoals uitgelegd in de documentatie voor de AKS-engine voor Azure Stack Hub, is het implementeren van een Kubernetes-cluster vereist:
- Het binaire bestand van de aks-engine (vereist).
- AKS Base Ubuntu 16.04-LTS Image Distro (afgeschaft - niet meer gebruiken, wijzigen in API-model in plaats daarvan 20.04).
- AKS Base Ubuntu 18.04-LTS Image Distro (afgeschaft - niet meer gebruiken, wijzigen in API-model in plaats daarvan 20.04).
- AKS Base Ubuntu 20.04-LTS Image Distro (vereist voor Linux-agents).
- AKS Base Windows Server Image (een van de volgende installatiekopieën is vereist voor Windows-agents):
- AKS Base Windows Server Image Containerd.
- Docker voor AKS Base Windows Server-installatiekopieën.
Nieuwe versies van deze installatiekopieën zijn beschikbaar met deze update:
Controleer de AKS-engine en azure Stack-versietoewijzingstabel voor de vereiste AKS-basisinstallatiekopieën.
Volg de instructies in De vereisten voor de AKS-engine (Azure Kubernetes Services) toevoegen aan de Azure Stack Hub Marketplace.
De Kubernetes-clusterbeheerder (normaal gesproken een tenantgebruiker van Azure Stack Hub) moet de nieuwe aks-engine downloaden. Zie de instructies in De AKS-engine installeren in Linux in Azure Stack Hub (of een gelijkwaardig Windows-artikel). U kunt hetzelfde proces volgen dat u voor het eerst hebt gebruikt om het cluster te installeren. De update overschrijft het vorige binaire bestand. Als u bijvoorbeeld het get-akse.sh-script hebt gebruikt, volgt u dezelfde stappen die worden beschreven in Installeren in een verbonden omgeving. Hetzelfde proces geldt als u installeert op een Windows-systeem: installeer de AKS-engine in Windows in Azure Stack Hub.
Kubernetes-clusters upgraden die zijn gemaakt met de Ubuntu 16.04-distributie
Vanaf AKS Engine v0.63.0 is de Ubuntu 16.04-distributie geen ondersteunde optie meer, omdat het besturingssysteem het einde van de levensduur heeft bereikt. Voor AKS Engine v0.67.0 of latere versies overschrijft de upgrade van de aks-engine automatisch de niet-ondersteunde aks-ubuntu-16.04 distributiewaarde met aks-ubuntu-18.04. Voor AKS Engine v0.75.3 of hoger, als u Kubernetes v1.24 of hoger gebruikt, overschrijft de upgrade van aks-engine-azurestack automatisch de niet-ondersteunde aks-ubuntu-16.04 distributiewaarde met aks-ubuntu-20.04.
Kubernetes-clusters upgraden die zijn gemaakt met de Ubuntu 18.04-distributie
Vanaf AKS Engine v0.75.3 is de Ubuntu 18.04-distributie niet langer een ondersteunde optie, omdat het besturingssysteem het einde van de levensduur heeft bereikt. Voor AKS Engine v0.75.3 of latere versies overschrijft de aks-engine-azurestack-upgrade automatisch de niet-ondersteunde aks-ubuntu-18.04 distributiewaarde met aks-ubuntu-20.04.
Kubernetes-clusters upgraden die zijn gemaakt met docker-containerruntime
In Kubernetes v1.24 is het dockershim-onderdeel verwijderd uit kubelet. Als gevolg hiervan is de docker-containerruntime niet langer een ondersteunde optie. Zie de opmerkingen bij de release van Kubernetes v1.24 voor meer informatie. Voor AKS Engine v0.75.3 of latere versies overschrijft de aks-engine-azurestack-upgrade automatisch de niet-ondersteunde docker containerRuntime waarde met containerd.
Voor AKS Engine-release v0.75.3 kunnen clusters met Windows-knooppunten op Kubernetes v1.23 de Windows-basisinstallatiekopie gebruiken met de Docker-runtime. Clusters met Windows-knooppunten in Kubernetes v1.24 kunnen de Windows-basisinstallatiekopie gebruiken met de Containerd Runtime.
Toewijzing van AKS-engine en Azure Stack-versie
| Versie van Azure Stack Hub | Versie van AKS-engine |
|---|---|
| 1910 | 0.43.0, 0.43.1 |
| 2002 | 0.48.0, 0.51.0 |
| 2005 | 0.48.0, 0.51.0, 0.55.0, 0.55.4 |
| 2008 | 0.55.4, 0.60.1 |
| 2102 | 0.60.1, 0.63.0, 0.67.0, 0.67.3 |
| 2108 | 0.63.0, 0.67.0, 0.67.3, 0.70.0, 0.71.0, 0.73.0, 0.75.3, 0.76.0 |
| 2206 | 0.70.0, 0.71.0, 0.73.0, 0.75.3, 0.76.0, 0.77.0 |
| 2301 | 0.75.3, 0.76.0, 0.77.0, 0.78.0, 0.79.0 |
| 2306 | 0.78.0, 0.79.0*, 0.80.2* |
| 2311 | 0.80.2* |
| 2406 | 0.80.2* |
Notitie
*Ondersteund. Zie het ondersteuningsbeleid voor AKS Engine-versies voor meer informatie.
AKS-engine en bijbehorende afbeeldingstoewijzing
U vindt de ondersteunde Kubernetes-versies voor AKS Engine in Azure Stack Hub in de volgende tabel. Gebruik de opdracht aks-engine get-versions niet, die versies retourneert die worden ondersteund in globale Azure en in Azure Stack Hub.
| AKS-engine | AKS-basisinstallatiekopie | Kubernetes-versies | Voorbeelden van API-modellen |
|---|---|---|---|
| v0.43.1 | Distributie van Ubuntu-basisinstallatiekopie 16.04-LTS voor AKS, oktober 2019 (24-10-2019) | 1.15.5, 1.15.4, 1.14.8, 1.14.7 | |
| v0.48.0 | Distributie van Ubuntu-basisinstallatiekopie 16.04-LTS voor AKS, maart 2020 (19-03-2020) | 1.15.10, 1.14.7 | |
| v0.51.0 | AKS Base Ubuntu 16.04-LTS Image Distro, mei 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 Image Distro, augustus 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 Image Distro, 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, januari 2021 (2021.01.28), AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28), Windows-basisinstallatiekopie voor AKS (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 Image Distro, 2021 Q2 (2021.05.24), AKS Base Windows Image (17763.1935.210520) | 1.18.18, 1.19.10, 1.20.6 | Voorbeelden van API-modellen (Linux, Windows) |
| v0.67.0 | AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q3 (2021.09.27), AKS Base Windows Image (17763.2213.210927) | 1.19.15, 1.20.11 | Voorbeelden van API-modellen (Linux, Windows) |
| v0.67.3 | AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q3 (2021.09.27), AKS Base Windows Image (17763.2213.210927) | 1.19.15, 1.20.11 | Voorbeelden van API-modellen (Linux, Windows) |
| v0.70.0 | AKS Base Ubuntu 18.04-LTS Image Distro, 2022 Q2 (2022.04.07), AKS Base Windows Image (17763.2565.220408) | 1.21.10*, 1.22.7* | Voorbeelden van API-modellen (Linux, Windows) |
| v0.71.0 | AKS Base Ubuntu 18.04-LTS Image Distro, 2022 Q3 (2022.08.12), AKS Base Windows Image (17763.3232.220805) | 1.22.7*, 1.23.6* | Voorbeelden van API-modellen (Linux, Windows) |
| v0.73.0 | AKS Base Ubuntu 18.04-LTS Image Distro, 2022 Q4 (2022.11.02), AKS Base Windows Image (17763.3532.221102) | 1.22.15*, 1.23.13* | Voorbeelden van API-modellen (Linux, Windows) |
| v0.75.3 | AKS Base Ubuntu 20.04-LTS Image Distro (2023.032.2), AKS Base Windows Server 2019 Image Docker (17763.3887.20230332), AKS Base Windows Server 2019 Image Containerd (17763.3887.20230332) | 1.23.15*, 1.24.9** | Voorbeelden van API-modellen (Linux, Windows) |
| v0.76.0 | AKS Base Ubuntu 20.04-LTS Image Distro (2023.116.3), AKS Base Windows Server 2019 Image Containerd (17763.4252.20231163) | 1.24.11**, 1.25.7** | Voorbeelden van API-modellen (Linux, Windows) |
| v0.77.0 | AKS Base Ubuntu 20.04-LTS Image Distro (2023.206.1), AKS Base Windows Server 2019 Image Containerd (17763.4645.20232061) | 1.25.7**, 1.26.6** | Voorbeelden van API-modellen (Linux, Windows) |
| v0.78.0 | AKS Base Ubuntu 20.04-LTS Image Distro (2023.242.3), AKS Base Windows Server 2019 Image Containerd (17763.4737.20232423) | 1.25.13**, 1.26.8** | Voorbeelden van API-modellen (Linux, Windows) |
| v0.79.0 | AKS Base Ubuntu 20.04-LTS Image Distro (2023.296.1), AKS Base Windows Server 2019 Image Containerd (17763.4974.20232961) | 1.26.9**, 1.27.6** | Voorbeelden van API-modellen (Linux, Windows) |
| v0.80.2 | AKS Base Ubuntu 20.04-LTS Image Distro (2024.032.1), AKS Base Windows Server 2019 Image Containerd (17763.5329.20240321) | 1.27.10**, 1.28.6** | Voorbeelden van API-modellen (Linux, Windows) |
Notitie
*Vanaf Kubernetes v1.21 wordt alleen de cloudprovider voor Azure ondersteund in Azure Stack Hub.
Notitie
** Vanaf Kubernetes v1.24 wordt alleen de containerd containerruntime ondersteund. Zie de sectie Kubernetes-clusters upgraden die zijn gemaakt met docker-containerruntime voor meer informatie.
Planning bijwerken
De AKS-engineopdracht upgrade automatiseert het upgradeproces van uw cluster volledig en verwerkt virtuele machines (VM's), netwerken, opslag, Kubernetes en indelingstaken. Voordat u de update toepast, moet u de informatie over de releasenotitie controleren.
Wat is er nieuw met AKSe 0.76.0
- Ondersteuning toegevoegd voor Kubernetes v1.24.11 en v1.25.7.
- U vindt andere functies op de GitHub-pagina v0.76.0.
Wat is er nieuw met AKSe 0.75.3 en hoger
AKS Engine-release v0.75.3 en alle toekomstige AKS Engine-releases in Azure Stack Hub zijn afkomstig van de nieuwe aks-engine-azurestack-opslagplaats. Als zodanig moeten alle aks-engine opdrachten worden vervangen door aks-engine-azurestack. Opdrachten voor het ophalen van de nieuwste versie van de AKS Engine in Azure Stack Hub zijn ook gewijzigd. U kunt de nieuwe opdrachten zien in De Linux-client maken en Windows-client maken. Maak een probleem in de nieuwe opslagplaats als u problemen ondervindt.
AKS Engine release v0.75.3 op Azure Stack Hub biedt Ubuntu 20.04 LTS als basisinstallatiekopie voor Linux. Vanaf deze release wordt Ubuntu 18.04 niet meer ondersteund. Zie Kubernetes-clusters upgraden die zijn gemaakt met de Ubuntu 18.04-distributie voor meer informatie.
Vanaf Kubernetes v1.24 wordt alleen de containerd runtime ondersteund. Zie Kubernetes-clusters upgraden die zijn gemaakt met Docker Runtime voor meer informatie. Voor AKS Engine release v0.75.3 kunnen clusters met Windows-knooppunten op Kubernetes v1.23 de Windows-basisinstallatiekopie gebruiken met Docker Runtime. Clusters met Windows-knooppunten in Kubernetes v1.24 kunnen de Windows-basisinstallatiekopie gebruiken met Containerd Runtime.
Meer functies vindt u op de GitHub-pagina v0.75.3.
Instructies voor het gebruik van AKS-engine 0.70.0 en hoger
Microsoft heeft de Azure Cloud Provider bijgewerkt in versie 0.70.0. De Azure Cloud Provider is een kernonderdeel dat wordt gedeeld tussen AKS Azure en AKS-engine in Azure Stack Hub.
AKS-engine 0.70.0 en hoger gebruiken:
Als u voor het eerst een nieuw Kubernetes-cluster probeert te maken: gebruik het voorbeeld-API-model dat is opgegeven voor de juiste versie in de AKS-engine en de bijbehorende tabel voor afbeeldingstoewijzing .
Als u een nieuw cluster maakt, maar uw bestaande API-model wilt gebruiken: pas uw API-model aan door de cloudprovider voor Azure-instructies te volgen. Als u de nieuwe instelling niet opneemt, resulteert dit in een implementatiefout.
Als u opslagvolumes gebruikt: zorg ervoor dat u het AzureDiskCSI-stuurprogramma gebruikt. Versie 0.70.0 en hoger ondersteunen alleen CSI-stuurprogramma's, niet de verouderde in-tree-opslagprovider. Als u een upgrade wilt uitvoeren, volgt u de instructies in de upgrade tijdens het gebruik van opslagvolumes.
Bekende problemen
- Het parallel implementeren van meerdere Kubernetes-services in één cluster kan leiden tot een fout in de standaardconfiguratie van de load balancer. We raden u aan om één service tegelijk te implementeren.
- Omdat het hulpprogramma aks-engine een gedeelde broncodeopslagplaats is in Azure en Azure Stack Hub, kan het onderzoeken van de vele opmerkingen bij de release en pull-aanvragen ertoe leiden dat het hulpprogramma ondersteuning biedt voor andere versies van kubernetes en het besturingssysteemplatform dan eerder vermeld. U kunt deze negeren en de bovenstaande versietabel gebruiken als de officiële handleiding voor deze update.
- AKS Engine v0.67.0 gebruikt de verkeerde Windows-installatiekopie bij het implementeren van Windows-clusters. Gebruik v0.70.0 om dit probleem op te lossen.
Verwijzing
De volgende lijst is de volledige set releaseopmerkingen voor Azure en Azure Stack Hub gecombineerd:
- 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
Is van toepassing op versie v0.67.0 van de AKS-engine.
In dit artikel wordt de inhoud van de AKS-engine (Azure Kubernetes Service) in Azure Stack Hub-update beschreven. De update bevat verbeteringen en oplossingen voor de nieuwste versie van de AKS-engine die is gericht op het Azure Stack Hub-platform. Dit artikel is niet bedoeld om de release-informatie voor de AKS-engine voor globale Azure te documenteren.
Planning bijwerken
Met de AKS-engineopdracht upgrade wordt het upgradeproces van uw cluster volledig geautomatiseerd. Het verwerkt taken voor virtuele machines (VM's), netwerken, opslag, Kubernetes en indeling. Voordat u de update toepast, moet u de informatie over de releasenotitie controleren.
Overwegingen bij upgrades
- Gebruikt u de juiste Marketplace-items, AKS Base Ubuntu 16.04-LTS of 18.04 Image Distro of AKS Base Windows Server voor uw versie van de AKS-engine? U vindt de versies in de sectie 'Nieuwe installatiekopieën en AKS-engine downloaden'.
- Gebruikt u de juiste clusterspecificatie (apimodel.json) en resourcegroep voor het doelcluster? Toen u het cluster oorspronkelijk hebt geïmplementeerd, is dit bestand gegenereerd in de uitvoermap. Zie de implementatieopdrachtparameters Een Kubernetes-cluster implementeren.
- Gebruikt u een betrouwbare machine om de AKS-engine uit te voeren en van waaruit u upgradebewerkingen uitvoert?
- Als u een operationeel cluster bijwerkt met actieve workloads, kunt u de upgrade toepassen zonder dat dit van invloed is op de upgrade, ervan uitgaande dat het cluster normaal wordt belast. U moet echter een back-upcluster hebben voor het geval er gebruikers naar moeten worden omgeleid. Een back-upcluster wordt ten zeerste aanbevolen.
- Voer indien mogelijk de opdracht uit vanaf een VIRTUELE machine in de Azure Stack Hub-omgeving om de netwerkhops en mogelijke verbindingsfouten te verminderen.
- Zorg ervoor dat uw abonnement voldoende quotum heeft voor het hele proces. Tijdens het proces worden nieuwe VM's toegewezen. Het resulterende aantal virtuele machines is hetzelfde als het origineel, maar plan een paar meer VM's die tijdens het proces moeten worden gemaakt.
- Er worden geen systeemupdates of geplande taken gepland.
- Stel een gefaseerde upgrade in op een cluster dat is geconfigureerd met dezelfde waarden als het productiecluster en test de upgrade daar voordat u dit doet in uw productiecluster.
De upgradeopdracht gebruiken
U moet de aks-engine upgrade opdracht gebruiken zoals beschreven in Een Kubernetes-cluster upgraden in Azure Stack Hub.
Upgradeonderbrekingen
Soms onderbreken onverwachte factoren de upgrade van het cluster. Er kan een onderbreking optreden wanneer de AKS-engine een fout rapporteert of er iets gebeurt met het uitvoeringsproces van de AKS-engine. Bekijk de oorzaak van de onderbreking, los deze op en verzend dezelfde upgrade opdracht opnieuw om door te gaan met het upgradeproces. De upgrade opdracht is idempotent en moet de upgrade van het cluster hervatten nadat u de opdracht opnieuw hebt ingediend. Normaal gesproken verhogen onderbrekingen de tijd om de update te voltooien, maar moeten ze niet van invloed zijn op de voltooiing ervan.
Geschatte upgradetijd
De geschatte upgradetijd is 12 tot 15 minuten per VM in het cluster. Het kan bijvoorbeeld ongeveer vijf uur duren voordat een cluster met 20 knooppunten is bijgewerkt.
Nieuwe installatiekopieën en AKS-engine downloaden
Download de nieuwe versies van de AKS-basisinstallatiekopie voor Ubuntu en de AKS-engine.
Zoals uitgelegd in de documentatie voor de AKS-engine voor Azure Stack Hub, is het implementeren van een Kubernetes-cluster vereist:
- Het binaire bestand van de aks-engine (vereist).
- AKS Base Ubuntu 16.04-LTS Image Distro (afgeschaft - niet meer gebruiken, wijzigen in API-model in plaats daarvan 18.04).
- AKS Base Ubuntu 18.04-LTS Image Distro (vereist voor Linux-agents).
- AKS Base Windows Server Image Distro (vereist voor Windows-agents).
Nieuwe versies van deze installatiekopieën zijn beschikbaar met deze update:
Controleer de AKS-engine en azure Stack-versietoewijzingstabel voor de vereiste AKS-basisinstallatiekopieën.
Volg de instructies in De vereisten voor de AKS-engine (Azure Kubernetes Services) toevoegen aan de Azure Stack Hub Marketplace.
De Kubernetes-clusterbeheerder (normaal gesproken een tenantgebruiker van Azure Stack Hub) moet de nieuwe aks-engine downloaden. Zie de instructies in De AKS-engine installeren in Linux in Azure Stack Hub (of een gelijkwaardig Windows-artikel). U kunt hetzelfde proces volgen dat u voor het eerst hebt gebruikt om het cluster te installeren. De update overschrijft het vorige binaire bestand. Als u bijvoorbeeld het get-akse.sh-script hebt gebruikt, volgt u dezelfde stappen die worden beschreven in Installeren in een verbonden omgeving. Hetzelfde proces geldt als u installeert op een Windows-systeem: installeer de AKS-engine in Windows in Azure Stack Hub.
Kubernetes-clusters upgraden die zijn gemaakt met de Ubuntu 16.04-distributie
Vanaf AKS Engine v0.67.0 is de Ubuntu 16.04-distributie geen ondersteunde optie meer, omdat het besturingssysteem het einde van de levensduur heeft bereikt. Als u een cluster wilt upgraden, moet u ervoor zorgen dat u de distributie van het besturingssysteem aks-ubuntu-18.04 instelt in uw invoer-API-model, het model dat wordt gegenereerd door aks-engine deploy en doorgegeven als invoer aan aks-engine upgrade:
"masterProfile": {
"distro": "aks-ubuntu-18.04"
},
"agentPoolProfiles": [{
"distro": "aks-ubuntu-18.04"
}]
Toewijzing van AKS-engine en Azure Stack-versie
| Versie van Azure Stack Hub | Versie van AKS-engine |
|---|---|
| 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 |
Upgradepad voor Kubernetes-versie in AKS-engine v0.67.0
U vindt de huidige versie en upgradeversie voor Azure Stack Hub in de volgende tabel. Deze tabel is van toepassing op het AKS-enginecluster in Azure Stack Hub. Gebruik de opdracht aks-engine get-versions niet, die versies retourneert die worden ondersteund in globale Azure en in Azure Stack Hub.
| Huidige versie | Upgrade beschikbaar |
|---|---|
| 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 |
Geef in het JSON-bestand van het API-model de release- en versiewaarden onder de orchestratorProfile sectie op. Als u bijvoorbeeld van plan bent Kubernetes 1.17.17 te implementeren, moeten de volgende twee waarden worden ingesteld (zie het voorbeeld kubernetes-azurestack.json):
- "orchestratorRelease": "1.17",
- "orchestratorVersion": "1.17.17"
AKS-engine en bijbehorende afbeeldingstoewijzing
| AKS-engine | AKS-basisinstallatiekopie | Kubernetes-versies | Voorbeelden van API-modellen |
|---|---|---|---|
| v0.43.1 | Distributie van Ubuntu-basisinstallatiekopie 16.04-LTS voor AKS, oktober 2019 (24-10-2019) | 1.15.5, 1.15.4, 1.14.8, 1.14.7 | |
| v0.48.0 | Distributie van Ubuntu-basisinstallatiekopie 16.04-LTS voor AKS, maart 2020 (19-03-2020) | 1.15.10, 1.14.7 | |
| v0.51.0 | AKS Base Ubuntu 16.04-LTS Image Distro, mei 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 Image Distro, augustus 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 Image Distro, 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, januari 2021 (2021.01.28), AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28), Windows-basisinstallatiekopie voor AKS (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 Image Distro, 2021 Q2 (2021.05.24), AKS Base Windows Image (17763.1935.210520) | 1.18.18, 1.19.10, 1.20.6 | Voorbeelden van API-modellen (Linux, Windows) |
| v0.67.0 | AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q3 (2021.09.27), AKS Base Windows Image (17763.2213.210927) | 1.19.15, 1.20.11 | Voorbeelden van API-modellen (Linux, Windows) |
Nieuwe functies
Als u geïnteresseerd bent in een persoonlijke preview, kunt u preview-toegang aanvragen.
Dit zijn enkele nieuwe functies:
- Ondersteuning voor Kubernetes 1.19.15 en 1.20.11
Bekende problemen
- Het parallel implementeren van meerdere Kubernetes-services in één cluster kan leiden tot een fout in de standaardconfiguratie van de load balancer. We raden u aan om één service tegelijk te implementeren.
- Omdat het hulpprogramma aks-engine een gedeelde broncodeopslagplaats is in Azure en Azure Stack Hub, kan het onderzoeken van de vele opmerkingen bij de release en pull-aanvragen ertoe leiden dat het hulpprogramma ondersteuning biedt voor andere versies van kubernetes en het besturingssysteemplatform dan eerder vermeld. U kunt deze negeren en de bovenstaande versietabel gebruiken als de officiële handleiding voor deze update.
Verwijzing
De volgende lijst is de volledige set releaseopmerkingen voor Azure en Azure Stack Hub gecombineerd:
- 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
Van toepassing op versie v0.60.1 van de AKS-engine.
In dit artikel wordt de inhoud van de AKS-engine (Azure Kubernetes Service) in Azure Stack Hub-update beschreven. De update bevat verbeteringen en oplossingen voor de nieuwste versie van de AKS-engine die is gericht op het Azure Stack Hub-platform. Dit artikel is niet bedoeld om de release-informatie voor de AKS-engine voor globale Azure te documenteren.
Planning bijwerken
De AKS-engineopdracht upgrade automatiseert het upgradeproces van uw cluster volledig en verwerkt virtuele machines (VM's), netwerken, opslag, Kubernetes en indelingstaken. Voordat u de update toepast, moet u de informatie over de releasenotitie controleren.
Overwegingen bij upgrades
- Gebruikt u de juiste Marketplace-items, AKS Base Ubuntu 16.04-LTS of 18.04 Image Distro of AKS Base Windows Server voor uw versie van de AKS-engine? U vindt de versies in de sectie 'Nieuwe installatiekopieën en AKS-engine downloaden'.
- Gebruikt u de juiste clusterspecificatie (apimodel.json) en resourcegroep voor het doelcluster? Toen u het cluster oorspronkelijk hebt geïmplementeerd, is dit bestand gegenereerd in de uitvoermap. Zie de implementatieopdrachtparameters Een Kubernetes-cluster implementeren.
- Gebruikt u een betrouwbare machine om de AKS-engine uit te voeren en van waaruit u upgradebewerkingen uitvoert?
- Als u een operationeel cluster bijwerkt met actieve workloads, kunt u de upgrade toepassen zonder dat dit van invloed is op de upgrade, ervan uitgaande dat het cluster normaal wordt belast. U moet echter een back-upcluster hebben voor het geval er gebruikers naar moeten worden omgeleid. Een back-upcluster wordt ten zeerste aanbevolen.
- Voer indien mogelijk de opdracht uit vanaf een VIRTUELE machine in de Azure Stack Hub-omgeving om de netwerkhops en mogelijke verbindingsfouten te verminderen.
- Zorg ervoor dat uw abonnement voldoende quotum heeft voor het hele proces. Tijdens het proces worden nieuwe VM's toegewezen. Het resulterende aantal virtuele machines is hetzelfde als het origineel, maar plan een paar meer VM's die tijdens het proces moeten worden gemaakt.
- Er worden geen systeemupdates of geplande taken gepland.
- Stel een gefaseerde upgrade in op een cluster dat is geconfigureerd met dezelfde waarden als het productiecluster en test de upgrade daar voordat u dit doet in uw productiecluster.
De upgradeopdracht gebruiken
U moet de aks-engine upgrade opdracht gebruiken zoals beschreven in Een Kubernetes-cluster upgraden in Azure Stack Hub.
Upgradeonderbrekingen
Soms onderbreken onverwachte factoren de upgrade van het cluster. Er kan een onderbreking optreden wanneer de AKS-engine een fout rapporteert of er iets gebeurt met het uitvoeringsproces van de AKS-engine. Bekijk de oorzaak van de onderbreking, los deze op en verzend dezelfde upgrade opdracht opnieuw om door te gaan met het upgradeproces. De upgrade opdracht is idempotent en moet de upgrade van het cluster hervatten nadat u de opdracht opnieuw hebt ingediend. Normaal gesproken verhogen onderbrekingen de tijd om de update te voltooien, maar moeten ze niet van invloed zijn op de voltooiing ervan.
Geschatte upgradetijd
De geschatte upgradetijd is 12 tot 15 minuten per VM in het cluster. Het kan bijvoorbeeld ongeveer vijf uur duren voordat een cluster met 20 knooppunten is bijgewerkt.
Nieuwe installatiekopieën en AKS-engine downloaden
Download de nieuwe versies van de AKS-basisinstallatiekopie voor Ubuntu en de AKS-engine.
Zoals uitgelegd in de documentatie voor de AKS-engine in Azure Stack Hub, is het implementeren van een Kubernetes-cluster vereist:
- Het binaire bestand van de aks-engine (vereist).
- AKS Base Ubuntu 16.04-LTS Image Distro (afgeschaft - niet meer gebruiken, wijzigen in API-model in plaats daarvan 18.04).
- AKS Base Ubuntu 18.04-LTS Image Distro (vereist voor Linux-agents).
- AKS Base Windows Server Image Distro (vereist voor Windows-agents).
Er zijn nieuwe versies van deze versies beschikbaar met deze update:
De Azure Stack Hub-operator moet de nieuwe AKS Base-installatiekopieën downloaden naar de stempelmarktplaats:
Distributie van Ubuntu-basisinstallatiekopie 16.04-LTS voor AKS, januari 2021 (28-01-2021)
AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28),
Windows-basisinstallatiekopie voor AKS (17763.1697.210129)
Volg de instructies in De vereisten voor de AKS-engine (Azure Kubernetes Services) toevoegen aan de Azure Stack Hub Marketplace.
De Kubernetes-clusterbeheerder (normaal gesproken een tenantgebruiker van Azure Stack Hub) moet de nieuwe aks-engine downloaden. Zie de instructies in De AKS-engine installeren in Linux in Azure Stack Hub (of een gelijkwaardig Windows-artikel). U kunt hetzelfde proces volgen dat u voor het eerst hebt gebruikt om het cluster te installeren. De update overschrijft het vorige binaire bestand. Als u bijvoorbeeld het get-akse.sh-script hebt gebruikt, volgt u dezelfde stappen die worden beschreven in Installeren in een verbonden omgeving. Hetzelfde proces geldt als u installeert op een Windows-systeem: installeer de AKS-engine in Windows in Azure Stack Hub.
Toewijzing van AKS-engine en Azure Stack-versie
| Versie van Azure Stack Hub | Versie van AKS-engine |
|---|---|
| 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 |
Upgradepad voor Kubernetes-versie in AKS-engine v0.60.1
U vindt de huidige versie en upgradeversie voor Azure Stack Hub in de volgende tabel. Deze tabel is van toepassing op het AKS-enginecluster in Azure Stack Hub. Gebruik de opdracht aks-engine get-versions niet, die versies retourneert die worden ondersteund in globale Azure en in Azure Stack Hub.
| Huidige versie | Upgrade beschikbaar |
|---|---|
| 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 |
Geef in het JSON-bestand van het API-model de release- en versiewaarden onder de orchestratorProfile sectie op. Als u bijvoorbeeld van plan bent Kubernetes 1.17.17 te implementeren, moeten de volgende twee waarden worden ingesteld (zie het voorbeeld kubernetes-azurestack.json):
- "orchestratorRelease": "1.17",
- "orchestratorVersion": "1.17.17"
AKS-engine en bijbehorende afbeeldingstoewijzing
| AKS-engine | AKS-basisinstallatiekopie | Kubernetes-versies | Voorbeelden van API-modellen |
|---|---|---|---|
| v0.43.1 | Distributie van Ubuntu-basisinstallatiekopie 16.04-LTS voor AKS, oktober 2019 (24-10-2019) | 1.15.5, 1.15.4, 1.14.8, 1.14.7 | |
| v0.48.0 | Distributie van Ubuntu-basisinstallatiekopie 16.04-LTS voor AKS, maart 2020 (19-03-2020) | 1.15.10, 1.14.7 | |
| v0.51.0 | AKS Base Ubuntu 16.04-LTS Image Distro, mei 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 Image Distro, augustus 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 Image Distro, 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, januari 2021 (2021.01.28), AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28), Windows-basisinstallatiekopie voor AKS (17763.1697.210129) |
1.16.14, 1.16.15, 1.17.17, 1.18.15 | Linux, Windows |
Nieuwe functies
Als u geïnteresseerd bent in een persoonlijke preview, kunt u preview-toegang aanvragen.
Dit zijn enkele nieuwe functies:
- Algemene beschikbaarheid van Ubuntu 18.04.
- Openbare preview van certificaatrotatie #4214.
- T4 Nvidia GPU Private Preview #4259.
- Privévoorbeeld van Azure Active Directory-integratie.
- CSI-stuurprogramma voor Azure Blobs Private Preview #712.
- CSI-stuurprogramma Azure Disks Public Preview #712.
- CSI Driver NFS Public Preview #712.
- Ondersteuning voor Kubernetes 1. 17.17 #4188 en 1.18.15 #4187.
Bekende problemen
- Het parallel implementeren van meerdere Kubernetes-services in één cluster kan leiden tot een fout in de standaardconfiguratie van de load balancer. We raden u aan om één service tegelijk te implementeren.
- Omdat het hulpprogramma aks-engine een gedeelde broncodeopslagplaats is in Azure en Azure Stack Hub, kan het onderzoeken van de vele opmerkingen bij de release en pull-aanvragen ertoe leiden dat het hulpprogramma ondersteuning biedt voor andere versies van kubernetes en het besturingssysteemplatform dan eerder vermeld. U kunt deze negeren en de bovenstaande versietabel gebruiken als de officiële handleiding voor deze update.
Verwijzing
De volgende lijst is de volledige set releaseopmerkingen voor Azure en Azure Stack Hub gecombineerd:
Is van toepassing op versie v0.55.4 van de AKS-engine.
In dit artikel wordt de inhoud van de AKS-engine (Azure Kubernetes Service) in Azure Stack Hub-update beschreven. De update bevat verbeteringen en oplossingen voor de nieuwste versie van de AKS-engine die is gericht op het Azure Stack Hub-platform. Dit artikel is niet bedoeld om de release-informatie voor de AKS-engine voor globale Azure te documenteren.
Planning bijwerken
De AKS-engineopdracht upgrade automatiseert het upgradeproces van uw cluster volledig en verwerkt virtuele machines (VM's), netwerken, opslag, Kubernetes en indelingstaken. Voordat u de update toepast, moet u de informatie over de releasenotitie controleren.
Overwegingen bij upgrades
- Gebruikt u het juiste Marketplace-item, AKS Base Ubuntu 16.04-LTS Image Distro voor uw versie van de AKS-engine? U vindt de versies in de sectie 'Nieuwe installatiekopieën en AKS-engine downloaden'.
- Gebruikt u de juiste clusterspecificatie (apimodel.json) en resourcegroep voor het doelcluster? Toen u het cluster oorspronkelijk hebt geïmplementeerd, is dit bestand gegenereerd in de uitvoermap. Zie de implementatieopdrachtparameters Een Kubernetes-cluster implementeren.
- Gebruikt u een betrouwbare computer om de AKS-engine uit te voeren en van waaruit u upgradebewerkingen uitvoert?
- Als u een operationeel cluster bijwerkt met actieve workloads, kunt u de upgrade toepassen zonder dat dit van invloed is op de upgrade, ervan uitgaande dat het cluster normaal wordt belast. U moet echter een back-upcluster hebben voor het geval er gebruikers naar moeten worden omgeleid. Een back-upcluster wordt ten zeerste aanbevolen.
- Voer indien mogelijk de opdracht uit vanaf een VIRTUELE machine in de Azure Stack Hub-omgeving om de netwerkhops en mogelijke verbindingsfouten te verminderen.
- Zorg ervoor dat uw abonnement voldoende quotum heeft voor het hele proces. Tijdens het proces worden nieuwe VM's toegewezen. Het resulterende aantal virtuele machines is hetzelfde als het origineel, maar plan een paar meer VM's die tijdens het proces moeten worden gemaakt.
- Er worden geen systeemupdates of geplande taken gepland.
- Stel een gefaseerde upgrade in op een cluster dat is geconfigureerd met dezelfde waarden als het productiecluster en test de upgrade daar voordat u dit doet in uw productiecluster.
De upgradeopdracht gebruiken
U moet de aks-engine upgrade opdracht gebruiken zoals beschreven in Een Kubernetes-cluster upgraden in Azure Stack Hub.
Upgradeonderbrekingen
Soms onderbreken onverwachte factoren de upgrade van het cluster. Er kan een onderbreking optreden wanneer de AKS-engine een fout rapporteert of er iets gebeurt met het uitvoeringsproces van de AKS-engine. Bekijk de oorzaak van de onderbreking, los deze op en verzend dezelfde upgrade opdracht opnieuw om door te gaan met het upgradeproces. De upgrade opdracht is idempotent en moet de upgrade van het cluster hervatten nadat u de opdracht opnieuw hebt ingediend. Normaal gesproken verhogen onderbrekingen de tijd om de update te voltooien, maar moeten ze niet van invloed zijn op de voltooiing ervan.
Geschatte upgradetijd
De geschatte upgradetijd is 12 tot 15 minuten per VM in het cluster. Het kan bijvoorbeeld ongeveer vijf uur duren voordat een cluster met 20 knooppunten is bijgewerkt.
Nieuwe installatiekopieën en AKS-engine downloaden
Download de nieuwe versies van de AKS-basisinstallatiekopie van Ubuntu en de AKS-engine.
Zoals uitgelegd in de documentatie voor de AKS-engine in Azure Stack Hub, zijn voor het implementeren van een Kubernetes-cluster twee hoofdonderdelen vereist:
- Het binaire bestand van de aks-engine (vereist).
- AKS Base Ubuntu 16.04-LTS Image Distro
Nieuwe versies van deze installatiekopieën zijn beschikbaar met deze update:
De Azure Stack Hub-operator moet een nieuwe AKS-basisinstallatiekopie voor Ubuntu downloaden naar de zegelmarktplaats:
Naam: AKS Base Ubuntu 16.04-LTS Image Distro, september 2020 (2020.09.14)
Versie: 2020.09.14
Volg de instructies in De vereisten voor de AKS-engine (Azure Kubernetes Services) toevoegen aan de Azure Stack Hub Marketplace.
De Kubernetes-clusterbeheerder (normaal gesproken een tenantgebruiker van Azure Stack Hub) moet de nieuwe aks-engine downloaden. Zie de instructies in De AKS-engine installeren in Linux in Azure Stack Hub (of een gelijkwaardig Windows-artikel). U kunt hetzelfde proces volgen dat u voor het eerst hebt gebruikt om het cluster te installeren. De update overschrijft het vorige binaire bestand. Als u bijvoorbeeld het get-akse.sh-script hebt gebruikt, volgt u dezelfde stappen die worden beschreven in Installeren in een verbonden omgeving. Hetzelfde proces geldt als u installeert op een Windows-systeem: installeer de AKS-engine in Windows in Azure Stack Hub.
Toewijzing van AKS-engine en Azure Stack-versie
| Versie van Azure Stack Hub | Versie van AKS-engine |
|---|---|
| 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 |
Upgradepad voor Kubernetes-versie in AKS-engine v0.55.4
U vindt de huidige versie en upgradeversie voor Azure Stack Hub in de volgende tabel. Deze tabel is van toepassing op het AKS-enginecluster in Azure Stack Hub. Gebruik de opdracht aks-engine get-versions niet, die versies retourneert die worden ondersteund in globale Azure en in Azure Stack Hub.
| Huidige versie | Upgrade beschikbaar |
|---|---|
| 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 |
Geef in het JSON-bestand van het API-model de release- en versiewaarden onder de orchestratorProfile sectie op. Als u bijvoorbeeld van plan bent Kubernetes 1.17.17 te implementeren, moeten de volgende twee waarden worden ingesteld (zie het voorbeeld kubernetes-azurestack.json):
- "orchestratorRelease": "1.16",
- "orchestratorVersion": "1.16.14"
AKS-engine en bijbehorende afbeeldingstoewijzing
| Kubernetes-versies | Opmerkingen |
|---|---|
| 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 | Voorbeelden van API-modellen (Linux, Windows) |
| 1.15.12, 1.16.14, 1.17.11 | Voorbeelden van API-modellen (Linux, Windows) |
| 1.15.12, 1.16.14, 1.17.11 | Voorbeelden van API-modellen (Linux, Windows) |
Nieuwe functies
- De Linux-VHD van Azure Stack bijwerken naar 2020.09.14 #3828
- Voegt ondersteuning toe voor K8s v1.17.11 op Azure Stack #3702
- Voegt ondersteuning toe voor K8s v1.16.14 op Azure Stack #3704
- Linux-VHD-update naar 2020.09.14 #3750
- Windows VHD-update naar augustus 3730
- Kubernetes metrics-server upgradet naar v0.3.7 #3669
- Docker-versie upgraden om probleem met logboekrotatie #3693 op te lossen
- CoreDNS upgradet naar v1.7.0 #3608
- Moby 19.03.x-pakketten #3549 gebruiken
- Oplossingen voor azure-cni-updatestrategie #3571
Bekende problemen
- Het parallel implementeren van meerdere Kubernetes-services in één cluster kan leiden tot een fout in de standaardconfiguratie van de load balancer. We raden u aan om één service tegelijk te implementeren.
- Wanneer u aks-engine
get-versionsuitvoert, produceert de uitvoer informatie die van toepassing is op Azure en Azure Stack Hub. Er is echter geen expliciete manier om te bepalen wat overeenkomt met Azure Stack Hub. Gebruik deze opdracht niet om te bepalen welke versies er beschikbaar zijn om een upgrade uit te voeren. Gebruik de naslagtabel voor de upgrade die in de vorige sectie is beschreven. - Omdat het hulpprogramma aks-engine een gedeelde broncodeopslagplaats is in Azure en Azure Stack Hub, kan het onderzoeken van de vele opmerkingen bij de release en pull-aanvragen ertoe leiden dat het hulpprogramma ondersteuning biedt voor andere versies van kubernetes en het besturingssysteemplatform dan eerder vermeld. U kunt deze negeren en de bovenstaande versietabel gebruiken als de officiële handleiding voor deze update.
Verwijzing
Dit is de volledige set releaseopmerkingen voor Azure en Azure Stack Hub gecombineerd:
- 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
Is van toepassing op versie 0.48.0 of eerder van de AKS-engine.
In dit artikel wordt de inhoud van de AKS-engine (Azure Kubernetes Service) in Azure Stack Hub-update beschreven. De update bevat verbeteringen en oplossingen voor de nieuwste versie van de AKS-engine die is gericht op het Azure Stack Hub-platform. Dit artikel is niet bedoeld om de release-informatie voor de AKS-engine voor globale Azure te documenteren.
Planning bijwerken
De AKS-engineopdracht upgrade automatiseert het upgradeproces van uw cluster volledig en verwerkt virtuele machines (VM's), netwerken, opslag, Kubernetes en indelingstaken. Voordat u de update toepast, moet u de informatie over de releasenotitie controleren.
Overwegingen bij upgrades
- Gebruikt u het juiste Marketplace-item, AKS Base Ubuntu 16.04-LTS Image Distro voor uw versie van de AKS-engine? U vindt de versies in de sectie Download the new AKS base Ubuntu Image and AKS engine versions.
- Gebruikt u de juiste clusterspecificatie (apimodel.json) en resourcegroep voor het doelcluster? Toen u het cluster oorspronkelijk hebt geïmplementeerd, is dit bestand gegenereerd in de uitvoermap. Zie de implementatieopdrachtparameters Een Kubernetes-cluster implementeren.
- Gebruikt u een betrouwbare machine om de AKS-engine uit te voeren en van waaruit u upgradebewerkingen uitvoert?
- Als u een operationeel cluster bijwerkt met actieve workloads, kunt u de upgrade toepassen zonder dat dit van invloed is op de upgrade, ervan uitgaande dat het cluster normaal wordt belast. U moet echter een back-upcluster hebben voor het geval er gebruikers naar moeten worden omgeleid. Een back-upcluster wordt ten zeerste aanbevolen.
- Voer indien mogelijk de opdracht uit vanaf een VIRTUELE machine in de Azure Stack Hub-omgeving om de netwerkhops en mogelijke verbindingsfouten te verminderen.
- Zorg ervoor dat uw abonnement voldoende quotum heeft voor het hele proces. Tijdens het proces worden nieuwe VM's toegewezen. Het resulterende aantal virtuele machines is hetzelfde als het origineel, maar plan een paar meer VM's die tijdens het proces moeten worden gemaakt.
- Er worden geen systeemupdates of geplande taken gepland.
- Stel een gefaseerde upgrade in op een cluster dat is geconfigureerd met dezelfde waarden als het productiecluster en test de upgrade daar voordat u dit doet in uw productiecluster.
De upgradeopdracht gebruiken
U moet de aks-engine upgrade opdracht gebruiken zoals beschreven in Een Kubernetes-cluster upgraden in Azure Stack Hub.
Upgradeonderbrekingen
Soms onderbreken onverwachte factoren de upgrade van het cluster. Er kan een onderbreking optreden wanneer de AKS-engine een fout rapporteert of er iets gebeurt met het uitvoeringsproces van de AKS-engine. Bekijk de oorzaak van de onderbreking, los deze op en verzend dezelfde upgrade opdracht opnieuw om door te gaan met het upgradeproces. De upgrade opdracht is idempotent en moet de upgrade van het cluster hervatten nadat u de opdracht opnieuw hebt ingediend. Normaal gesproken verhogen onderbrekingen de tijd om de update te voltooien, maar moeten ze niet van invloed zijn op de voltooiing ervan.
Geschatte upgradetijd
De geschatte upgradetijd is 12 tot 15 minuten per VM in het cluster. Het kan bijvoorbeeld ongeveer vijf uur duren voordat een cluster met 20 knooppunten is bijgewerkt.
Nieuwe installatiekopieën en AKS-engine downloaden
Download de nieuwe versies van de AKS-basisinstallatiekopie van Ubuntu en de AKS-engine.
Zoals uitgelegd in de documentatie voor de AKS-engine in Azure Stack Hub, zijn voor het implementeren van een Kubernetes-cluster twee hoofdonderdelen vereist:
- Het binaire bestand van de aks-engine (vereist).
- AKS Base Ubuntu 16.04-LTS Image Distro.
Er zijn nieuwe versies van deze versies beschikbaar met deze update:
De Azure Stack Hub-operator moet de nieuwe AKS Base-installatiekopieën downloaden naar de stempelmarktplaats:
Naam:
AKS Base Ubuntu 16.04-LTS Image Distro, March 2020Versie:
2020.03.19Volg de instructies in De vereisten voor de AKS-engine (Azure Kubernetes Services) toevoegen aan de Azure Stack Hub Marketplace.
De Kubernetes-clusterbeheerder (normaal gesproken een tenantgebruiker van Azure Stack Hub) moet de nieuwe aks-engine downloaden. Zie de instructies in De AKS-engine installeren in Linux in Azure Stack Hub (of een gelijkwaardig Windows-artikel). U kunt hetzelfde proces volgen dat u voor het eerst hebt gebruikt om het cluster te installeren. De update overschrijft het vorige binaire bestand. Als u bijvoorbeeld het get-akse.sh-script hebt gebruikt, volgt u dezelfde stappen die worden beschreven in Installeren in een verbonden omgeving. Hetzelfde proces geldt als u installeert op een Windows-systeem: installeer de AKS-engine in Windows in Azure Stack Hub.
Upgradepad voor Kubernetes-versie
U vindt de huidige versie en upgradeversie voor Azure Stack Hub in de volgende tabel. Deze tabel is van toepassing op het AKS-enginecluster in Azure Stack Hub. Gebruik de opdracht aks-engine get-versions niet, die versies retourneert die worden ondersteund in globale Azure en in Azure Stack Hub.
| Huidige versie | Upgrade beschikbaar |
|---|---|
| 1.14.7 | 1.15.10 |
| 1.14.8 | 1.15.10 |
| 1.15.4 | 1.15.10 |
| 1.15.5 | 1.15.10 |
Nieuwe functies
Ondersteuning voor Kubernetes versie 1.15.10 (#2834). Wanneer u een nieuw cluster implementeert, geeft u in uw API-model .json bestand (ook wel het clusterdefinitiebestand genoemd), zowel het versienummer van de release als het secundaire versienummer in de volgende indeling op. Zie kubernetes-azurestack.json voor een voorbeeld van een clusterdefinitiebestand.
"orchestratorRelease": "1.15,"orchestratorVersion": "1.15.10"
Notitie
Als de Kubernetes-versie niet expliciet is opgegeven in het API-model .json bestand, wordt versie 1.15 gebruikt (#2932) en wordt orchestratorVersion standaard ingesteld op 1.15.11, wat resulteert in een fout tijdens de implementatie van het cluster.
Met aks-engine v0.43.1 werken de standaardfrequentie-instellingen voor de cloudprovider om de besturingslus uit te voeren en andere taken niet goed met de drempelwaarden van Azure Stack Hub Resource Manager voor binnenkomende aanvragen. Met deze update worden de standaardinstellingen voor Azure Stack Hub gewijzigd om de belasting van opnieuw proberen naar Azure Stack Hub Resource Manager (#2861) te verminderen.
Nieuwe verificatiestap in aks-engine resulteert in het stoppen van de uitvoering of het weergeven van waarschuwingen als het API-model .json bestand eigenschappen bevat die niet worden ondersteund door Azure Stack Hub (#2717).
Met een nieuwe controlecontrole valideert de aks-engine de beschikbaarheid van de versie van de AKS-basisinstallatiekopie die nodig is voor de versie van de aks-engine die wordt uitgevoerd (#2342). Dit gebeurt na het parseren van het API-model .json bestand en voordat u Azure Stack Hub Resource Manager aanroept.
Met de nieuwe aks-engineoptie '--control-plane-only' in de
upgradeopdracht kan de gebruiker bewerkingen upgraden om alleen de hoofd-VM's (#2635) te targeten.Updates voor Linux-kernelversie 4.15.0-1071-azure voor Ubuntu 16.04-LTS. Zie 'Package: linux-image-4.15.0-1071-azure (4.15.0-1071.76) [security]' voor meer informatie.
Nieuwe hyperkube-updates ter ondersteuning van Kubernetes-versies 1.14.8 en 1.15.10.
Werk kubectl bij zodat deze overeenkomt met de versie van Kubernetes voor het cluster. Dit onderdeel is beschikbaar in de Kubernetes-clusterbesturingsvlakknooppunten. U kunt dit door SSH uitvoeren in een master.
Updates voor de Azure Container Monitor-invoegtoepassing met de nieuwste release van februari 2020 (#2850).
Upgrade van
corednsversie v1.6.6 (#2555).Voer een upgrade
etcduit naar versie 3.3.18 (#2462).Voer een upgrade
mobyuit naar versie 3.0.11 (#2887).Met deze release knipt de AKS-engine de afhankelijkheid van nu naar het gebruik van
k8s.gcr.iode officiëleKubernetes MCR registry @ mcr.microsoft.comversie bij het bouwen van de installatiekopieën (#2722).
Bekende problemen
- Het parallel implementeren van meerdere Kubernetes-services in één cluster kan leiden tot een fout in de standaardconfiguratie van de load balancer. We raden u aan om één service tegelijk te implementeren.
- Het uitvoeren van aks-engine
get-versionsproduceert informatie die van toepassing is op Azure en Azure Stack Hub. Er is echter geen expliciete manier om te bepalen wat overeenkomt met Azure Stack Hub. Gebruik deze opdracht niet om te bepalen welke versies er beschikbaar zijn om een upgrade uit te voeren. Gebruik de naslagtabel voor de upgrade die in de vorige sectie is beschreven. - Omdat het hulpprogramma aks-engine een gedeelde broncodeopslagplaats is in Azure en Azure Stack Hub, kan het onderzoeken van de vele opmerkingen bij de release en pull-aanvragen ertoe leiden dat het hulpprogramma ondersteuning biedt voor andere versies van kubernetes en het besturingssysteemplatform dan eerder vermeld. U kunt deze negeren en de bovenstaande versietabel gebruiken als de officiële handleiding voor deze update.
Verwijzing
Hier volgt een lijst met enkele bugs die zijn opgelost en de volledige set releaseopmerkingen van versie 0.44.0 naar versie 0.48.0. De releaseopmerkingen omvatten zowel Azure als Azure Stack Hub.
Bugfixes
userAssignedIdentityIdin Windows azure.json ontbrekende aanhalingstekens (#2327)Invoegtoepassingen
update confighebben alleen een upgrade (#2282)Time-out voor het verkrijgen van beheer-IP op Windows-knooppunten (#2284)
1.0.28 Azure CNI .zip bestand toevoegen aan Windows VHD (#2268)
De standaardvolgorde voor instelling
IPAddressCountcorrigeren (#2358)Update voor het gebruik van één omsagent-yaml voor alle K8s-versies om handmatige fouten en eenvoudige onderhoudbaarheid (#2692) te voorkomen
Opmerkingen bij de release
Dit is de volledige set releaseopmerkingen voor Azure en Azure Stack Hub gecombineerd:
- 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
Volgende stappen
- Meer informatie over AKS-engine in Azure Stack Hub