Release-opmerkingen voor de AKS-engine in Azure Stack Hub

Artikel
07/19/2022
31 minuten om te lezen

Van toepassing op versie v0.70.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. U ziet dat dit niet is bedoeld om de release-informatie voor de AKS-engine voor global Azure te documenteren.

Planning bijwerken

Met de opdracht voor het upgraden van de AKS-engine wordt het upgradeproces van uw cluster volledig geautomatiseerd. Het zorgt voor virtuele machines (VM's), netwerken, opslag, Kubernetes en indelingstaken. Voordat u de update toepast, moet u de releasenotitiegegevens controleren.

Overwegingen bij upgraden

Gebruikt u de juiste Marketplace-items, AKS Base Ubuntu 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 de 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 uw 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 met actieve workloads bijwerkt, kunt u de upgrade toepassen zonder dat dit van invloed is op de upgrade, ervan uitgaande dat het cluster onder normale belasting valt. 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 plan een aantal meer 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 opdracht voor het upgraden van de AKS-engine gebruiken, zoals beschreven in het volgende artikel 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. Bekijk de oorzaak van de onderbreking, verwerk deze en verzend opnieuw dezelfde upgradeopdracht om door te gaan met het upgradeproces. De upgradeopdracht is idempotent en moet de upgrade van het cluster hervatten zodra de opdracht opnieuw is ingediend. Normaal gesproken nemen onderbrekingen de tijd voor het voltooien van de update toe, maar mogen ze niet van invloed zijn op de voltooiing ervan.

Geschatte upgradetijd

De geschatte tijd ligt tussen 12 en 15 minuten per VM in het cluster. Het kan bijvoorbeeld ongeveer vijf (5) uur duren voordat een cluster met 20 knooppunten is bijgewerkt.

Instructies voor het gebruik van de AKS-engine 0.70.0

Microsoft heeft de Azure-cloudprovider bijgewerkt in versie 0.70.0. De Azure-cloudprovider is een kernonderdeel dat wordt gedeeld tussen AKS Azure en de AKS-engine in Azure Stack Hub.

AKS-engine 0.70.0 gebruiken:

Als u voor het eerst een nieuw Kubernetes-cluster probeert te maken:
Gebruik het voorbeeld-API-model dat is opgegeven voor versie 0.70.0 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 cloudprovider voor Azure-instructies te volgen. Als u de nieuwe instelling niet opneemt, treedt er een implementatiefout op.
Als u opslagvolumes gebruikt:
Zorg ervoor dat u het AzureDiskCSI-stuurprogramma gebruikt. Versie 0.70.0 ondersteunt alleen CSI-stuurprogramma's, niet de verouderde provider voor in-treeopslag . Volg de instructies voor het upgraden van Kubernetes v1.20 naar v1.21 om een upgrade uit te voeren.

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 van de AKS-engine voor Azure Stack Hub, is het implementeren van een Kubernetes-cluster vereist:

De binaire aks-engine (vereist)
AKS Base Ubuntu 16.04-LTS Image Distro (afgeschaft - niet meer gebruiken, wijzigen in API-model om in plaats daarvan 18.04 te gebruiken)
AKS Base Ubuntu 18.04-LTS Image Distro (vereist voor Linux-agents)
AKS Base Windows Server Image Distro (vereist voor Windows agents)

Nieuwe versies hiervan zijn beschikbaar met deze update:

Controleer de tabel AKS-engine en azure Stack-versietoewijzing voor de benodigde AKS-basisinstallatiekopieën.

Volg de instructies in het volgende artikel : De vereisten voor de AKS-engine (Azure Kubernetes Services) toevoegen aan Azure Stack Hub Marketplace
De Kubernetes-clusterbeheerder (normaal gesproken een tenantgebruiker van Azure Stack Hub) moet de nieuwe aks-engine versie 0.70.0 downloaden. Zie de instructies in het volgende artikel, Installeer de AKS-engine op Linux in Azure Stack Hub (of een equivalent Windows artikel). U kunt hetzelfde proces volgen dat u hebt gebruikt om het cluster voor het eerst 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 deze sectie Installeren in een verbonden omgeving#install-in-een-verbonden-omgeving. Hetzelfde proces is van toepassing als u zich op een Windows systeem installeert, artikel De AKS-engine installeren op Windows in Azure Stack Hub.

Kubernetes-clusters bijwerken die zijn gemaakt met de Distributie van Ubuntu 16.04

Kubernetes-clusters upgraden die zijn gemaakt met de Ubuntu 16.04-distributie vanaf AKS Engine v0.67.0, de Ubuntu 16.04-distributie is 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 van aks-ubuntu-18.04 het besturingssysteem instellen 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, 0.67.3, 0.70.0

Upgradepad voor Kubernetes-versie in AKS-engine v0.70.0

U vindt de huidige versie en de upgradeversie in de volgende tabel voor Azure Stack Hub. Gebruik de opdracht aks-engine get-versions niet, omdat de opdracht ook de versies omvat die in de globale Azure-omgeving worden ondersteund. De volgende versie en upgradetabel zijn van toepassing op het AKS-enginecluster 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	1.21.11
1.21.10	1.22.7

Geef in het JSON-bestand van het API-model de release- en versiewaarden op in de sectie orchestratorProfile, bijvoorbeeld als u van plan bent Kubernetes 1.17.17 te implementeren, de volgende twee waarden moeten worden ingesteld (zie 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)
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	Distributie van Ubuntu-basisinstallatiekopie 18.04-LTS voor AKS, 2022 Q1 (07-04-2022) Windows-basisinstallatiekopie voor AKS (17763.2565.220408)	1.21.10, 1.22.7	Voorbeelden van API-modellen (Linux, Windows)

Nieuw

Nieuwe functies omvatten:

Ondersteuning toegevoegd voor Kubernetes v1.21.10 (#4840)
Ondersteuning toegevoegd voor Kubernetes v1.22.7 (#4838)
U vindt aanvullende functies op v0.70.0.

Bekende problemen

Het parallel implementeren van meerdere Kubernetes-services binnen één cluster kan leiden tot een fout in de basisconfiguratie van de load balancer. We raden u aan om één service tegelijkertijd te implementeren.
Omdat het hulpprogramma aks-engine een opslagplaats met broncode voor delen is in Azure en Azure Stack Hub. Als u de vele releaseopmerkingen en pull-aanvragen bekijkt, zult u denken dat het hulpprogramma ondersteuning biedt voor andere versies van kubernetes en het besturingssysteemplatform buiten de bovenstaande lijst, 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. Gebruikers moeten v0.70.0 gebruiken om dit probleem op te lossen.

Referentie

Dit is de volledige set releaseopmerkingen voor Azure en Azure Stack Hub gecombineerd:

Van toepassing op versie v0.67.0 van de AKS-engine.

Planning bijwerken

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 uw 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 met actieve workloads bijwerkt, kunt u de upgrade toepassen zonder dat dit van invloed is op de upgrade, ervan uitgaande dat het cluster onder normale belasting valt. 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 plan een aantal meer 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 opdracht voor het upgraden van de AKS-engine gebruiken, zoals beschreven in het volgende artikel Een Kubernetes-cluster upgraden in Azure Stack Hub.

Upgradeonderbrekingen

Geschatte upgradetijd

De geschatte tijd ligt tussen 12 en 15 minuten per VM in het cluster. Het kan bijvoorbeeld ongeveer vijf (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 wordt uitgelegd in de AKS-engine voor Azure Stack Hub-documentatie, 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 hiervan zijn beschikbaar met deze update:

Controleer de tabel-AKS-engine en azure Stack-versietoewijzing voor de benodigde AKS-basisinstallatiekopieën.

Volg de instructies in het volgende artikel : 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 versie 0.67.0 downloaden. Zie de instructies in het volgende artikel, Installeer de AKS-engine in Linux in Azure Stack Hub (of gelijkwaardig 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 deze sectie Installeren in een verbonden omgeving. Hetzelfde proces is van toepassing als u zich op een Windows systeem installeert, artikel De AKS-engine installeren op Windows in Azure Stack Hub.

Kubernetes-clusters upgraden die zijn gemaakt met de Ubuntu 16.04-distributie

Kubernetes-clusters upgraden die zijn gemaakt met de Ubuntu 16.04-distributie vanaf AKS Engine v0.67.0, de Ubuntu 16.04-distributie is 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 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

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 sectie orchestratorProfile, bijvoorbeeld als u van plan bent Kubernetes 1.17.17 te implementeren, moeten de volgende twee waarden worden ingesteld (zie 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)

Nieuw

Als u geïnteresseerd bent in deelname aan een persoonlijke 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 binnen éé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 opslagplaats voor broncode voor delen is in Azure en Azure Stack Hub. Als u de vele releaseopmerkingen en pull-aanvragen bekijkt, zult u geloven dat het hulpprogramma ondersteuning biedt voor andere versies van Kubernetes en het besturingssysteemplatform buiten de bovenstaande lijst, ze 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:

Van toepassing op versie v0.60.1 van de AKS-engine.

Planning bijwerken

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 uw 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 met actieve workloads bijwerkt, kunt u de upgrade toepassen zonder dat dit van invloed is op de upgrade, ervan uitgaande dat het cluster onder normale belasting valt. 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 plan een aantal meer 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 opdracht voor het upgraden van de AKS-engine gebruiken, zoals beschreven in het volgende artikel Een Kubernetes-cluster upgraden in Azure Stack Hub.

Upgradeonderbrekingen

Geschatte upgradetijd

De geschatte tijd ligt tussen 12 en 15 minuten per VM in het cluster. Het kan bijvoorbeeld ongeveer vijf (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 van de AKS-engine voor Azure Stack Hub, is het implementeren van een Kubernetes-cluster vereist:

De binaire aks-engine (vereist)
AKS Base Ubuntu 16.04-LTS Image Distro (vereist)
AKS Base Ubuntu 18.04-LTS Image Distro (optioneel)
AKS Base Windows Server Image Distro (optioneel)

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)
- AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28),
- Windows-basisinstallatiekopie voor AKS (17763.1697.210129)
  
  Volg de instructies in het volgende artikel : De vereisten voor de AKS-engine (Azure Kubernetes Services) toevoegen aan Azure Stack Hub Marketplace
De Kubernetes-clusterbeheerder (normaal gesproken een tenantgebruiker van Azure Stack Hub) moet de nieuwe aks-engine versie 0.60.1 downloaden. Zie de instructies in het volgende artikel, Installeer de AKS-engine op Linux in Azure Stack Hub (of een equivalent Windows artikel). U kunt hetzelfde proces volgen dat u hebt gebruikt om het cluster voor het eerst 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 deze sectie Installeren in een verbonden omgeving. Hetzelfde proces is van toepassing als u zich op een Windows systeem installeert, artikel De AKS-engine installeren op 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

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

    -   "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

Nieuw

Als u geïnteresseerd bent in deelname aan een persoonlijke preview, kunt u preview-toegang aanvragen.

Nieuwe functies omvatten:

Algemene beschikbaarheid van Ubuntu 18.04
Openbare preview van certificaatrotatie #4214
T4 Nvidia GPU Private Preview #4259
Azure Active Directory persoonlijke preview van integratie
CSI-stuurprogramma voor Azure Blobs Private Preview #712
Openbare preview van CSI-stuurprogramma Azure Disks #712
Openbare preview van CSI-stuurprogramma NFS #712
Ondersteuning voor Kubernetes 1. 17.17 #4188 en 1.18.15 #4187

Bekende problemen

Het parallel implementeren van meerdere Kubernetes-services binnen éé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 opslagplaats voor broncode voor delen is in Azure en Azure Stack Hub. Als u de vele releaseopmerkingen en pull-aanvragen bekijkt, zult u geloven dat het hulpprogramma ondersteuning biedt voor andere versies van Kubernetes en het besturingssysteemplatform buiten de bovenstaande lijst, ze 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:

Van toepassing op versie v0.55.4 van de AKS-engine.

Planning bijwerken

Met de opdracht voor het upgraden van de AKS-engine wordt het upgradeproces van uw cluster volledig geautomatiseerd, worden virtuele machines (VM's), netwerken, opslag, Kubernetes en indelingstaken uitgevoerd. Voordat u de update toepast, moet u de informatie over de releasenotitie bekijken.

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 uw uitvoermap. Zie de deploy opdrachtparameters 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 werkbelastingen, kunt u de upgrade toepassen zonder deze te beïnvloeden, ervan uitgaande dat het cluster onder normale belasting valt. U moet echter een back-upcluster hebben voor het geval er een noodzaak is om gebruikers naar het cluster om te leiden. 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-engineopdracht upgrade gebruiken, zoals wordt beschreven in het volgende artikel Een Kubernetes-cluster upgraden in Azure Stack Hub.

Onderbrekingen van de upgrade

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, adressering en verzend opnieuw dezelfde upgradeopdracht om door te gaan met het upgradeproces. De upgradeopdracht is idempotent en moet de upgrade van het cluster hervatten zodra de opdracht opnieuw is verzonden. Normaal gesproken verhogen onderbrekingen de tijd om de update te voltooien, maar mogen ze niet van invloed zijn op de voltooiing ervan.

Geschatte upgradetijd

De geschatte tijd is tussen 12 en 15 minuten per VM in het cluster. Het kan bijvoorbeeld ongeveer vijf (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 wordt uitgelegd in de AKS-engine voor Azure Stack Hub-documentatie, vereist het implementeren van een Kubernetes-cluster twee hoofdonderdelen:

Het binaire bestand van de aks-engine
AKS Base Ubuntu 16.04-LTS Image Distro

Nieuwe versies hiervan zijn beschikbaar met deze update:

De Azure Stack Hub-operator moet een nieuwe AKS-basisinstallatiekopie voor Ubuntu downloaden naar de stempelmarktplaats:
- Naam: AKS Base Ubuntu 16.04-LTS Image Distro, september 2020 (2020.09.14)
- Versie: 2020.09.14
- Volg de instructies in het volgende artikel : de vereisten voor de AKS-engine (Azure Kubernetes Services) toevoegen aan de Azure Stack Hub Marketplace
De Kubernetes-clusterbeheerder moet de nieuwe aks-engine versie 0.51.0 downloaden. Zie de instructies in het volgende artikel, De AKS-engine installeren in Linux in Azure Stack Hub. U kunt hetzelfde proces volgen dat u 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 deze sectie Installeren in een verbonden omgeving. Hetzelfde proces is van toepassing als u zich op een Windows systeem installeert, artikel De AKS-engine installeren op 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

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, bijvoorbeeld als u van plan bent Kubernetes 1.16.14 te implementeren, moeten de volgende twee waarden worden ingesteld (zie 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
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 upgraden naar v1.7.0 #3608
Moby 19.03.x-pakketten gebruiken #3549
Oplossingen voor updatestrategie voor Azure-cni #3571

Bekende problemen

Het parallel implementeren van meerdere Kubernetes-services binnen één cluster kan leiden tot een fout in de basisconfiguratie van de load balancer. Implementeer zo mogelijk één service tegelijk.
Het uitvoeren van get-versies van aks-engine levert informatie op die van toepassing is op Azure en Azure Stack Hub. Er is echter geen expliciete manier om te onderscheiden wat overeenkomt met Azure Stack Hub. Gebruik deze opdracht niet om erachter te komen welke versies beschikbaar zijn om te upgraden. Gebruik de bovenstaande upgradereferentietabel.
Omdat het hulpprogramma aks-engine een opslagplaats met broncode voor shares is in Azure en Azure Stack Hub. Als u de vele releaseopmerkingen en pull-aanvragen bekijkt, zult u geloven dat het hulpprogramma ondersteuning biedt voor andere versies van Kubernetes en het besturingssysteemplatform buiten de bovenstaande lijst, ze 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:

Van toepassing op versie 0.48.0 of eerder van de AKS-engine.

Planning bijwerken

Met de opdracht voor het upgraden van de AKS-engine wordt het upgradeproces van uw cluster volledig geautomatiseerd, worden virtuele machines (VM's), netwerken, opslag, Kubernetes en indelingstaken uitgevoerd. Controleer de informatie in dit artikel 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 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 uw uitvoermap. Zie de opdrachtparameters Implementeren van een Kubernetes-cluster.
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 werkbelastingen, kunt u de upgrade toepassen zonder deze te beïnvloeden, ervan uitgaande dat het cluster onder normale belasting valt. U moet echter een back-upcluster hebben voor het geval er een noodzaak is om gebruikers naar het cluster om te leiden.
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 -opdracht upgraden gebruiken, zoals wordt beschreven in het volgende artikel Een Kubernetes-cluster upgraden in Azure Stack Hub.

Onderbrekingen van de upgrade

Geschatte upgradetijd

De geschatte tijd is tussen 12 en 15 minuten per VM in het cluster. Het kan bijvoorbeeld ongeveer vijf (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 wordt uitgelegd in de AKS-engine voor Azure Stack Hub-documentatie, vereist het implementeren van een Kubernetes-cluster twee hoofdonderdelen:

Het binaire bestand van de aks-engine
AKS Base Ubuntu 16.04-LTS Image Distro

Nieuwe versies hiervan zijn beschikbaar met deze update:

De Azure Stack Hub-operator moet een nieuwe AKS-basisinstallatiekopie voor Ubuntu downloaden:
- Naam: AKS Base Ubuntu 16.04-LTS Image Distro, March 2020
- Versie: 2020.03.19
- Volg de instructies in het volgende artikel : de vereisten voor de AKS-engine (Azure Kubernetes Services) toevoegen aan de Azure Stack Hub Marketplace
De Kubernetes-clusterbeheerder moet de nieuwe aks-engine versie 0.48.0 downloaden. Zie de instructies in dit artikel, De AKS-engine installeren in Linux in Azure Stack Hub. U kunt hetzelfde proces volgen dat u 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 het artikel Installeren in een verbonden omgeving. Hetzelfde proces is van toepassing als u zich op een Windows systeem installeert, artikel De AKS-engine installeren op Windows in Azure Stack Hub.

Upgradepad voor Kubernetes-versie

U vindt de huidige versie en de upgradeversie in de volgende tabel voor Azure Stack Hub. Volg de opdracht aks-engine get-versions niet, omdat de opdracht ook de versies bevat die worden ondersteund in global Azure. De volgende versie en upgradetabel zijn van toepassing op het AKS-enginecluster 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, moet u het versienummer van de release en het secundaire versienummer opgeven in het JSON-bestand (a.k.s. clusterdefinitiebestand). U vindt een voorbeeld: kubernetes-azurestack.json:
- "orchestratorRelease": "1.15,
- "orchestratorVersion": "1.15.10"
Notitie

Als de Kubernetes-versie niet expliciet is opgegeven in het JSON-bestand van het API-model, wordt de versie 1.15 gebruikt (#2932) en wordt de orchestratorVersion standaard ingesteld 1.15.11 op 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 azure Stack Hub Resource Manager drempelwaarden voor binnenkomende aanvragen. Met deze update worden de standaardinstellingen voor Azure Stack Hub gewijzigd om de belasting voor opnieuw proberen naar Azure Stack Hub te verminderen Resource Manager (#2861).
Nieuwe verificatiestap in aks-engine resulteert in het stoppen of weergeven van waarschuwingen als het JSON-bestand van het API-model 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-modelbestand en voordat u de Azure Stack Hub Resource Manager aanroept.
Met de nieuwe aks-engineoptie '--control-plane-only' in de opdracht Upgrade kan de gebruiker bewerkingen upgraden om alleen de master-Virtual Machines (#2635) te richten.
Updates naar Linux Kernel versie 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 meest recente release van februari 2020 (#2850).
Upgrade van coredns versie v1.6.6 (#2555).
Voer een upgrade etcd uit naar versie 3.3.18 (#2462).
Voer een upgrade moby uit naar versie 3.0.11 (#2887).
Met deze release vermindert de AKS-engine de afhankelijkheid van nu tot het gebruik van k8s.gcr.io de officiële Kubernetes MCR registry @ mcr.microsoft.com installatiekopieën (#2722).

Bekende problemen

Het parallel implementeren van meerdere Kubernetes-services binnen één cluster kan leiden tot een fout in de basisconfiguratie van de load balancer. Implementeer zo mogelijk één service tegelijk.
Het uitvoeren van get-versies van aks-engine levert informatie op die van toepassing is op Azure en Azure Stack Hub. Er is echter geen expliciete manier om te onderscheiden wat overeenkomt met Azure Stack Hub. Gebruik deze opdracht niet om te achterhalen welk versiegebied beschikbaar is om te upgraden. Gebruik de bovenstaande upgradereferentietabel.
Omdat het hulpprogramma aks-engine een opslagplaats met broncode voor shares is in Azure en Azure Stack Hub. Als u de vele releaseopmerkingen en pull-aanvragen bekijkt, denkt u dat het hulpprogramma ondersteuning biedt voor andere versies van Kubernetes en het besturingssysteemplatform buiten de bovenstaande lijst, negeert u deze en gebruikt u de bovenstaande versietabel als de officiële handleiding voor deze update.

Referentie

Hieronder volgt een lijst met enkele fouten die zijn opgelost, evenals de volledige set releaseopmerkingen van 0.44.0 tot 0.48.0. u ziet dat de laatste lijst Azure- en Azure Stack Hub-items bevat

Opgeloste fouten

userAssignedIdentityId in vensters azure.json ontbrekende aanhalingstekens (#2327)
Invoegtoepassingen update config zijn alleen-upgraden (#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 het instellen van IPAddressCount (#2358) corrigeren
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

Volgende stappen

Meer informatie over de AKS-engine in Azure Stack Hub