Releaseopmerkingen voor AKS-engine in Azure Stack Hub
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 correcties 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 wereldwijde Azure te documenteert.
Overwegingen voor upgraden
- 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 opdrachtparameters implementeren 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 met actieve workloads bijwerkt, kunt u de upgrade toepassen zonder dat dit van invloed is op deze, ervan uitgaande dat het cluster onder normale belasting is. 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 VM's is hetzelfde als het oorspronkelijke, maar plan een paar vm's die tijdens het proces moeten worden gemaakt.
- Er zijn 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. Onderzoek 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 zodra u de opdracht opnieuw hebt ingediend. Normaal gesproken nemen onderbrekingen de tijd voor het voltooien van de update toe, maar dit heeft geen invloed op de voltooiing ervan.
Geschatte upgradetijd
De geschatte upgradetijd is 12 tot 15 minuten per VM in het cluster. Het kan bijvoorbeeld ongeveer 5 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 Ubuntu-basisinstallatiekopie en AKS-engine van AKS.
Zoals uitgelegd in de documentatie voor de AKS-engine voor Azure Stack Hub, vereist het implementeren van een Kubernetes-cluster het volgende:
- Het binaire bestand aks-engine (vereist).
- Distributie van AKS-basisinstallatiekopie voor Ubuntu 16.04-LTS (afgeschaft - niet meer gebruiken, wijzig in API-model om in plaats daarvan 20.04 te gebruiken).
- Distributie van AKS-basisinstallatiekopie voor Ubuntu 18.04-LTS (afgeschaft- niet meer gebruiken, wijzig in HET API-model in plaats daarvan 20.04).
- Distributie van AKS-basisinstallatiekopie voor Ubuntu 20.04-LTS (vereist voor Linux-agents).
- AKS-basisinstallatiekopie van Windows Server (een van de volgende installatiekopieën is vereist voor Windows-agents):
- AKS Base Windows Server Image Containerd.
- Docker voor AKS-basisinstallatiekopieën van Windows Server.
Nieuwe versies van deze installatiekopieën zijn beschikbaar met deze update:
Controleer de AKS-engine en de azure Stack-versietoewijzingstabel voor de vereiste AKS-basisinstallatiekopieën.
Volg de instructies in 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 vergelijkbaar Windows-artikel). U kunt hetzelfde proces volgen dat u hebt gebruikt om het cluster voor de eerste keer te installeren. De update overschrijft het vorige binaire bestand. Als u bijvoorbeeld het script get-akse.sh hebt gebruikt, volgt u dezelfde stappen die worden beschreven in Installeren in een verbonden omgeving. Hetzelfde proces is van toepassing 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 niet langer een ondersteunde optie, 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. Als u kubernetes v1.24 of hoger gebruikt, overschrijft de upgrade aks-engine-azurestack automatisch de niet-ondersteunde aks-ubuntu-16.04 distributiewaarde met aks-ubuntu-20.04voor AKS Engine v0.75.3 of hoger.
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 upgrade aks-engine-azurestack automatisch de niet-ondersteunde aks-ubuntu-18.04 distributiewaarde met aks-ubuntu-20.04.
Kubernetes-clusters upgraden die zijn gemaakt met Docker Container Runtime
In Kubernetes v1.24 is het dockershim-onderdeel verwijderd uit kubelet. Als gevolg hiervan is de runtime van de Docker-container 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 upgrade aks-engine-azurestack automatisch de niet-ondersteunde dockercontainerRuntime waarde met containerd.
Voor AKS Engine-release v0.75.3 kunnen clusters met Windows-knooppunten op Kubernetes v1.23 gebruikmaken van de Windows-basisinstallatiekopieën met de Docker-runtime. Clusters met Windows-knooppunten in Kubernetes v1.24 kunnen gebruikmaken van de Windows-basisinstallatiekopieën met de containerruntime.
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* |
Notitie
*Ondersteund. Zie het ondersteuningsbeleid voor AKS-engineversies voor meer informatie.
AKS-engine en bijbehorende afbeeldingstoewijzing
In de volgende tabel vindt u de ondersteunde Kubernetes-versies voor de AKS-engine in Azure Stack Hub. Gebruik niet de opdracht aks-engine get-versions , waarmee versies worden geretourneerd die worden ondersteund in azure en in Azure Stack Hub.
Notitie
*Vanaf Kubernetes v1.21 wordt alleen cloudprovider voor Azure ondersteund op 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 Container Runtime voor meer informatie.
Updateplanning
Met de AKS-engineopdracht upgrade wordt het upgradeproces van uw cluster volledig geautomatiseerd en worden virtuele machines (VM's), netwerk-, opslag-, Kubernetes- en indelingstaken verwerkt. Voordat u de update toepast, controleert u de releasenotitiegegevens.
Wat is er nieuw in 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 in AKSe 0.75.3 en hoger?
AKS Engine-release v0.75.3 en alle toekomstige AKS Engine-releases op Azure Stack Hub komen van de nieuwe opslagplaats aks-engine-azurestack. Als zodanig moeten alle aks-engine opdrachten worden vervangen aks-engine-azurestackdoor . Opdrachten voor het ophalen van de nieuwste AKS Engine-release op Azure Stack Hub zijn ook gewijzigd. U kunt de nieuwe opdrachten zien in 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 linux-basisinstallatiekopie. 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 versie v0.75.3 kunnen clusters met Windows-knooppunten op Kubernetes v1.23 gebruikmaken van de Windows-basisinstallatiekopieën met Docker Runtime. Clusters met Windows-knooppunten in Kubernetes v1.24 kunnen gebruikmaken van de Windows-basisinstallatiekopieën 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-cloudprovider 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 api-voorbeeldmodel 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: wijzig uw API-model door de instructies voor CloudProvider voor Azure te volgen. Als u de nieuwe instelling niet opneemt, treedt er een implementatiefout op.
Als u opslagvolumes gebruikt: zorg ervoor dat u het stuurprogramma AzureDiskCSI gebruikt. Versie 0.70.0 en hoger ondersteunen alleen CSI-stuurprogramma's, niet de verouderde opslagprovider in de structuur. Als u een upgrade wilt uitvoeren, volgt u de instructies in Upgraden tijdens het gebruik van opslagvolumes.
Bekende problemen
- Het parallel implementeren van meerdere Kubernetes-services in één cluster kan leiden tot een fout in de basisconfiguratie 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 zijn dat u na het bekijken van de vele releaseopmerkingen en pull-aanvragen denkt dat het hulpprogramma andere versies van het Kubernetes- en OS-platform ondersteunt dan de eerder vermelde versies. 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ën bij het implementeren van Windows-clusters. Gebruik v0.70.0 om dit probleem op te lossen.
Referentie
De volgende lijst bevat 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
Van toepassing op versie v0.67.0 van de AKS-engine.
In dit artikel wordt de inhoud van de AKS-engine (Azure Kubernetes Service) op 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 vast te leggen.
Updateplanning
Met de opdracht van de AKS-engine upgrade wordt het upgradeproces van uw cluster volledig geautomatiseerd. Het verwerkt virtuele machines (VM's), netwerk-, opslag-, Kubernetes- en indelingstaken. Voordat u de update toepast, controleert u de releasenotitiegegevens.
Overwegingen bij upgraden
- 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 deze, ervan uitgaande dat het cluster normaal wordt belast. U moet echter een back-upcluster hebben voor het geval er gebruikers naartoe 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 VM's zou hetzelfde zijn als het origineel, maar er moeten nog enkele VM's worden gemaakt tijdens het proces.
- Er zijn 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 wordt de upgrade van het cluster onderbroken door onverwachte factoren. Er kan een onderbreking optreden wanneer de AKS-engine een fout rapporteert of er iets gebeurt met het uitvoeringsproces van de AKS-engine. Onderzoek de oorzaak van de onderbreking, los deze op en dien dezelfde upgrade opdracht opnieuw in om door te gaan met het upgradeproces. De upgrade opdracht is idempotent en moet de upgrade van het cluster hervatten zodra u de opdracht opnieuw hebt ingediend. Normaal gesproken nemen onderbrekingen de tijd voor het voltooien van de update toe, maar dit heeft geen invloed op de voltooiing ervan.
Geschatte upgradetijd
De geschatte upgradetijd is 12 tot 15 minuten per VM in het cluster. Het kan bijvoorbeeld ongeveer 5 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 voor Azure Stack Hub, is het implementeren van een Kubernetes-cluster vereist:
- Het binaire bestand aks-engine (vereist).
- Distributie van AKS-basisinstallatiekopie voor Ubuntu 16.04-LTS (afgeschaft- niet langer gebruiken, wijzig in HET API-model in plaats daarvan 18.04).
- Distributie van AKS-basisinstallatiekopie voor Ubuntu 18.04-LTS (vereist voor Linux-agents).
- Distributie van AKS-basisinstallatiekopieën van Windows Server (vereist voor Windows-agents).
Nieuwe versies van deze installatiekopieën zijn beschikbaar met deze update:
Controleer de AKS-engine en de azure Stack-versietoewijzingstabel voor de vereiste AKS-basisinstallatiekopieën.
Volg de instructies in 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 vergelijkbaar Windows-artikel). U kunt hetzelfde proces volgen dat u hebt gebruikt om het cluster voor de eerste keer 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 is van toepassing 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 niet langer een ondersteunde optie, omdat het besturingssysteem het einde van de levensduur heeft bereikt. Als u een cluster wilt upgraden, moet u de distributie aks-ubuntu-18.04 van het besturingssysteem instellen op in uw invoer-API-model, het model dat wordt gegenereerd door aks-engine deploy en als invoer wordt doorgegeven 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
In de volgende tabel vindt u de huidige versie en upgradeversie voor Azure Stack Hub. Deze tabel is van toepassing op het AKS-enginecluster in Azure Stack Hub. Gebruik niet de opdracht aks-engine get-versions , 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 op in de orchestratorProfile sectie. Als u bijvoorbeeld van plan bent om 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 | Distributie van AKS-basisinstallatiekopie voor Ubuntu 16.04-LTS, mei 2020 (2020.05.13), AKS-basisinstallatiekopie van Windows (17763.1217.200513) | 1.15.12, 1.16.8, 1.16.9 | Linux, Windows |
| v0.55.0 | Distributie van AKS-basisinstallatiekopie voor Ubuntu 16.04-LTS, augustus 2020 (2020.08.24), AKS-basisinstallatiekopie van Windows (17763.1397.200820) | 1.15.12, 1.16.14, 1.17.11 | Linux, Windows |
| v0.55.4 | Distributie van AKS-basisinstallatiekopie voor Ubuntu 16.04-LTS, september 2020 (2020.09.14), AKS-basisinstallatiekopie van Windows (17763.1397.200820) | 1.15.12, 1.16.14, 1.17.11 | Linux, Windows |
| V0.60.1 | Distributie van AKS-basisinstallatiekopie voor Ubuntu 16.04-LTS, januari 2021 (2021.01.28), Distributie van ubuntu-basisinstallatiekopie 18.04-LTS, 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 | Distributie van AKS-basisinstallatiekopie voor Ubuntu 18.04-LTS, 2021 Q2 (2021.05.24), Windows-basisinstallatiekopie voor AKS (17763.1935.210520) | 1.18.18, 1.19.10, 1.20.6 | Voorbeelden van API-modellen (Linux, Windows) |
| v0.67.0 | Distributie van ubuntu-basisinstallatiekopie 18.04-LTS, 2021 q3 (2021.09.27), Windows-basisinstallatiekopie voor AKS (17763.2213.210927) | 1.19.15, 1.20.11 | Voorbeelden van API-modellen (Linux, Windows) |
Nieuw
Als u wilt deelnemen aan een beperkte preview, kunt u preview-toegang aanvragen.
Nieuwe functies omvatten:
- 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 basisconfiguratie van de load balancer. U wordt aangeraden één service tegelijk te implementeren.
- Omdat het hulpprogramma aks-engine een gedeelde opslagplaats voor broncode is in Azure en Azure Stack Hub, kan het zijn dat u, als u de vele releaseopmerkingen en pull-aanvragen bekijkt, denkt u dat het hulpprogramma ondersteuning biedt voor andere versies van Kubernetes en het besturingssysteemplatform dan de eerder vermelde versies. U kunt deze negeren en de bovenstaande versietabel gebruiken als de officiële handleiding voor deze update.
Referentie
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 correcties 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 wereldwijde Azure te documenteert.
Updateplanning
Met de opdracht AKS-engine upgrade wordt het upgradeproces van uw cluster volledig geautomatiseerd en worden virtuele machines (VM's), netwerk-, opslag-, Kubernetes- en indelingstaken verwerkt. Controleer de releasenotitie-informatie voordat u de update toepast.
Overwegingen voor upgraden
- 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 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 opdrachtparameters implementeren 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 met actieve workloads bijwerkt, kunt u de upgrade toepassen zonder dat dit van invloed is op deze, ervan uitgaande dat het cluster onder normale belasting is. 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 VM's is hetzelfde als het oorspronkelijke, maar plan een paar vm's die tijdens het proces moeten worden gemaakt.
- Er zijn 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. Onderzoek 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 zodra u de opdracht opnieuw hebt ingediend. Normaal gesproken nemen onderbrekingen de tijd voor het voltooien van de update toe, maar dit heeft geen invloed op de voltooiing ervan.
Geschatte upgradetijd
De geschatte upgradetijd is 12 tot 15 minuten per VM in het cluster. Het kan bijvoorbeeld ongeveer 5 uur duren voordat een cluster met 20 knooppunten is bijgewerkt.
Nieuwe installatiekopieën en AKS-engine downloaden
Download de nieuwe versies van de Ubuntu-basisinstallatiekopie en AKS-engine van AKS.
Zoals uitgelegd in de documentatie voor de AKS-engine in Azure Stack Hub, vereist het implementeren van een Kubernetes-cluster het volgende:
- Het binaire bestand aks-engine (vereist).
- Distributie van AKS-basisinstallatiekopie voor Ubuntu 16.04-LTS (afgeschaft- niet meer gebruiken, wijzig in API-model om in plaats daarvan 18.04 te gebruiken).
- Distributie van AKS-basisinstallatiekopie voor Ubuntu 18.04-LTS (vereist voor Linux-agents).
- Distributie van AKS-basisinstallatiekopie van Windows Server (vereist voor Windows-agents).
Nieuwe versies hiervan zijn beschikbaar met deze update:
De Azure Stack Hub-operator moet de nieuwe AKS-basisinstallatiekopieën downloaden naar de stempelmarktplaats:
Distributie van Ubuntu-basisinstallatiekopie 16.04-LTS voor AKS, januari 2021 (28-01-2021)
Distributie van ubuntu-basisinstallatiekopie 18.04-LTS, 2021 q1 (2021.01.28),
Windows-basisinstallatiekopie voor AKS (17763.1697.210129)
Volg de instructies in 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 vergelijkbaar Windows-artikel). U kunt hetzelfde proces volgen dat u hebt gebruikt om het cluster voor de eerste keer te installeren. De update overschrijft het vorige binaire bestand. Als u bijvoorbeeld het script get-akse.sh hebt gebruikt, volgt u dezelfde stappen die worden beschreven in Installeren in een verbonden omgeving. Hetzelfde proces is van toepassing 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 niet de opdracht aks-engine get-versions , waarmee versies worden geretourneerd die worden ondersteund in 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 op in de orchestratorProfile sectie. Als u bijvoorbeeld van plan bent om 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 | Distributie van AKS-basisinstallatiekopie voor Ubuntu 16.04-LTS, mei 2020 (2020.05.13), AKS-basisinstallatiekopie van Windows (17763.1217.200513) | 1.15.12, 1.16.8, 1.16.9 | Linux, Windows |
| v0.55.0 | Distributie van AKS-basisinstallatiekopie voor Ubuntu 16.04-LTS, augustus 2020 (2020.08.24), AKS-basisinstallatiekopie van Windows (17763.1397.200820) | 1.15.12, 1.16.14, 1.17.11 | Linux, Windows |
| v0.55.4 | Distributie van AKS-basisinstallatiekopie voor Ubuntu 16.04-LTS, september 2020 (2020.09.14), AKS-basisinstallatiekopie van Windows (17763.1397.200820) | 1.15.12, 1.16.14, 1.17.11 | Linux, Windows |
| V0.60.1 | Distributie van AKS-basisinstallatiekopie voor Ubuntu 16.04-LTS, januari 2021 (2021.01.28), Distributie van ubuntu-basisinstallatiekopie 18.04-LTS, 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 |
Nieuw
Als u wilt deelnemen aan een beperkte preview, kunt u preview-toegang aanvragen.
Nieuwe functies omvatten:
- Algemene beschikbaarheid van Ubuntu 18.04.
- Certificaatrotatie openbare preview #4214.
- T4 Nvidia GPU Private Preview #4259.
- Beperkte preview van Azure Active Directory-integratie.
- CSI-stuurprogramma voor Azure Blobs Private Preview #712.
- Openbare preview van CSI-stuurprogramma voor Azure Disks #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 basisconfiguratie van de load balancer. U wordt aangeraden één service tegelijk te implementeren.
- Omdat het hulpprogramma aks-engine een gedeelde opslagplaats voor broncode is in Azure en Azure Stack Hub, kan het zijn dat u, als u de vele releaseopmerkingen en pull-aanvragen bekijkt, denkt u dat het hulpprogramma ondersteuning biedt voor andere versies van Kubernetes en het besturingssysteemplatform dan de eerder vermelde versies. U kunt deze negeren en de bovenstaande versietabel gebruiken als de officiële handleiding voor deze update.
Referentie
De volgende lijst is de volledige set releaseopmerkingen voor Azure en Azure Stack Hub gecombineerd:
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 correcties 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 wereldwijde Azure te documenteert.
Updateplanning
Met de opdracht AKS-engine upgrade wordt het upgradeproces van uw cluster volledig geautomatiseerd en worden virtuele machines (VM's), netwerk-, opslag-, Kubernetes- en indelingstaken verwerkt. Controleer de releasenotitie-informatie voordat u de update toepast.
Overwegingen voor upgraden
- 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 opdrachtparameters implementeren 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 met actieve workloads bijwerkt, kunt u de upgrade toepassen zonder dat dit van invloed is op deze, ervan uitgaande dat het cluster onder normale belasting is. 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 VM's zou hetzelfde zijn als het origineel, maar er moeten nog enkele VM's worden gemaakt tijdens het proces.
- Er zijn 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 wordt de upgrade van het cluster onderbroken door onverwachte factoren. Er kan een onderbreking optreden wanneer de AKS-engine een fout rapporteert of er iets gebeurt met het uitvoeringsproces van de AKS-engine. Onderzoek de oorzaak van de onderbreking, los deze op en dien dezelfde upgrade opdracht opnieuw in om door te gaan met het upgradeproces. De upgrade opdracht is idempotent en moet de upgrade van het cluster hervatten zodra u de opdracht opnieuw hebt ingediend. Normaal gesproken nemen onderbrekingen de tijd voor het voltooien van de update toe, maar dit heeft geen invloed op de voltooiing ervan.
Geschatte upgradetijd
De geschatte upgradetijd is 12 tot 15 minuten per VM in het cluster. Het kan bijvoorbeeld ongeveer 5 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 en AKS-engine.
Zoals uitgelegd in de documentatie voor de AKS-engine in Azure Stack Hub, vereist het implementeren van een Kubernetes-cluster twee hoofdonderdelen:
- Het binaire bestand aks-engine (vereist).
- Distributie van AKS-basisinstallatiekopie voor Ubuntu 16.04-LTS
Nieuwe versies van deze installatiekopieën zijn beschikbaar met deze update:
De Azure Stack Hub-operator moet een nieuwe Ubuntu-basisinstallatiekopie van AKS downloaden naar de stempelmarktplaats:
Naam: Distributie van AKS-basisinstallatiekopie voor Ubuntu 16.04-LTS, september 2020 (2020.09.14)
Versie: 2020.09.14
Volg de instructies in 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 vergelijkbaar Windows-artikel). U kunt hetzelfde proces volgen dat u hebt gebruikt om het cluster voor de eerste keer 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 is van toepassing 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
In de volgende tabel vindt u de huidige versie en upgradeversie voor Azure Stack Hub. Deze tabel is van toepassing op het AKS-enginecluster in Azure Stack Hub. Gebruik niet de opdracht aks-engine get-versions , 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 op in de orchestratorProfile sectie. Als u bijvoorbeeld van plan bent om 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 | Notities |
|---|---|
| 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) |
Nieuw
- De Linux-VHD van Azure Stack bijwerken naar 2020.09.14 #3828
- Hiermee wordt ondersteuning toegevoegd voor K8s v1.17.11 op Azure Stack #3702
- Hiermee wordt ondersteuning toegevoegd voor K8s v1.16.14 op Azure Stack #3704
- Linux VHD-update naar 2020.09.14 #3750
- Windows VHD-update naar augustus #3730
- Upgradet Kubernetes Metrics-server naar v0.3.7 #3669
- Upgrade docker-versie om het probleem met logboekrotatie op te lossen #3693
- Werkt CoreDNS bij 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 basisconfiguratie 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 beschikbaar zijn om te upgraden. Gebruik de upgradereferentietabel die in de vorige sectie wordt beschreven. - Omdat het hulpprogramma aks-engine een gedeelde broncodeopslagplaats is in Azure en Azure Stack Hub, kan het zijn dat u na het bekijken van de vele releaseopmerkingen en pull-aanvragen denkt dat het hulpprogramma andere versies van het Kubernetes- en OS-platform ondersteunt dan de eerder vermelde versies. U kunt deze negeren en de bovenstaande versietabel gebruiken als de officiële handleiding voor deze update.
Referentie
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
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) op 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 vast te leggen.
Updateplanning
Met de AKS-engineopdracht upgrade wordt het upgradeproces van uw cluster volledig geautomatiseerd en worden virtuele machines (VM's), netwerk-, opslag-, Kubernetes- en indelingstaken verwerkt. Voordat u de update toepast, controleert u de releasenotitiegegevens.
Overwegingen bij upgraden
- 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 De nieuwe AKS-basisinstallatiekopie en AKS-engineversies 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 deze, ervan uitgaande dat het cluster normaal wordt belast. U moet echter een back-upcluster hebben voor het geval er gebruikers naartoe 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 VM's zou hetzelfde zijn als het origineel, maar er moeten nog enkele VM's worden gemaakt tijdens het proces.
- Er zijn 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 wordt de upgrade van het cluster onderbroken door onverwachte factoren. Er kan een onderbreking optreden wanneer de AKS-engine een fout rapporteert of er iets gebeurt met het uitvoeringsproces van de AKS-engine. Onderzoek de oorzaak van de onderbreking, los deze op en dien dezelfde upgrade opdracht opnieuw in om door te gaan met het upgradeproces. De upgrade opdracht is idempotent en moet de upgrade van het cluster hervatten zodra u de opdracht opnieuw hebt ingediend. Normaal gesproken nemen onderbrekingen de tijd voor het voltooien van de update toe, maar dit heeft geen invloed op de voltooiing ervan.
Geschatte upgradetijd
De geschatte upgradetijd is 12 tot 15 minuten per VM in het cluster. Het kan bijvoorbeeld ongeveer 5 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 en AKS-engine.
Zoals uitgelegd in de documentatie voor de AKS-engine in Azure Stack Hub, vereist het implementeren van een Kubernetes-cluster twee hoofdonderdelen:
- Het binaire bestand aks-engine (vereist).
- Distributie van AKS-basisinstallatiekopie voor Ubuntu 16.04-LTS.
Nieuwe versies hiervan zijn beschikbaar met deze update:
De Azure Stack Hub-operator moet de nieuwe AKS-basisinstallatiekopieën downloaden naar de marketplace voor stempels:
Naam:
AKS Base Ubuntu 16.04-LTS Image Distro, March 2020Versie:
2020.03.19Volg de instructies in 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 vergelijkbaar Windows-artikel). U kunt hetzelfde proces volgen dat u hebt gebruikt om het cluster voor de eerste keer 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 is van toepassing als u installeert op een Windows-systeem: Installeer de AKS-engine in Windows in Azure Stack Hub.
Upgradepad voor Kubernetes-versie
In de volgende tabel vindt u de huidige versie en upgradeversie voor Azure Stack Hub. Deze tabel is van toepassing op het AKS-enginecluster in Azure Stack Hub. Gebruik niet de opdracht aks-engine get-versions , 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 |
Nieuw
Ondersteuning voor Kubernetes versie 1.15.10 (#2834). Wanneer u een nieuw cluster implementeert, geeft u in uw API-model .json-bestand (ook wel bekend als het clusterdefinitiebestand) zowel het versienummer van de release als het secundaire versienummer op in de volgende indeling. 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 en andere taken uit te voeren niet goed met Azure Stack Hub Resource Manager drempelwaarden voor binnenkomende aanvragen. Deze update wijzigt de standaardinstellingen voor Azure Stack Hub om de belasting voor opnieuw proberen naar Azure Stack Hub te verminderen Resource Manager (#2861).
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 verificatiecontrole 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 de Azure Stack Hub-Resource Manager wordt aangeroepen.
Met de nieuwe aks-engineoptie '--control-plane-only' in de
upgradeopdracht kan de gebruiker bewerkingen upgraden om alleen de master-Virtual Machines (#2635) te bereiken.Updates 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 Besturingsvlakknooppunten van het Kubernetes-cluster. U kunt het met SSH uitvoeren in een master.
Updates voor de Azure Container Monitor-invoegtoepassing met de laatste release van februari 2020 (#2850).
Upgrade van
corednsnaar versie v1.6.6 (#2555).Upgrade
etcdnaar versie 3.3.18 (#2462).Upgrade naar
mobyversie 3.0.11 (#2887).Met deze release vermindert de AKS-engine de afhankelijkheid van
k8s.gcr.ioom nu de officiëleKubernetes MCR registry @ mcr.microsoft.comte gebruiken 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 basisconfiguratie van de load balancer. We raden u aan om één service tegelijk te implementeren.
- Het uitvoeren van een 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 beschikbaar zijn om te upgraden. Gebruik de upgradereferentietabel die in de vorige sectie wordt beschreven. - Omdat het hulpprogramma aks-engine een gedeelde broncodeopslagplaats is in Azure en Azure Stack Hub, kan het zijn dat u na het bekijken van de vele releaseopmerkingen en pull-aanvragen denkt dat het hulpprogramma andere versies van het Kubernetes- en OS-platform ondersteunt dan de eerder vermelde versies. U kunt deze negeren en de bovenstaande versietabel gebruiken als de officiële handleiding voor deze update.
Referentie
Hier volgt een lijst met enkele van de opgeloste fouten en de volledige set releaseopmerkingen van versie 0.44.0 tot versie 0.48.0. De releaseopmerkingen bevatten zowel Azure als Azure Stack Hub.
Opgeloste fouten
userAssignedIdentityIdin Windows azure.json ontbrekende aanhalingstekens (#2327)Invoegtoepassingen
update configzijn alleen upgraden (#2282)Time-out voor het ophalen van beheer-IP op Windows-knooppunten (#2284)
1.0.28 Azure CNI .zip-bestand toevoegen aan Windows VHD (#2268)
De standaardvolgorde voor de instelling
IPAddressCountcorrigeren (#2358)Bijwerken om één omsagent yaml te gebruiken voor alle K8s-versies om handmatige fouten en onderhoudbaarheid te voorkomen (#2692)
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 de AKS-engine in Azure Stack Hub
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor