Viktig information om AKS-motorn på Azure Stack Hub

Gäller för version v0.70.0 av AKS-motorn.

I den här artikeln beskrivs innehållet i aks-motorn (Azure Kubernetes Service) i Azure Stack Hub-uppdateringen. Uppdateringen innehåller förbättringar och korrigeringar för den senaste versionen av AKS-motorn som är riktad till Azure Stack Hub-plattformen. Observera att detta inte är avsett att dokumentera versionsinformationen för AKS-motorn för globala Azure.

Uppdateringsplanering

AKS-motorns uppgraderingskommando automatiserar fullständigt uppgraderingsprocessen för klustret, det tar hand om virtuella datorer (VM), nätverk, lagring, Kubernetes och orkestreringsuppgifter. Innan du tillämpar uppdateringen bör du granska viktig information.

Uppgraderingsöverväganden

  • Använder du rätt marketplace-objekt, AKS Base Ubuntu 18.04 Image Distro eller AKS Base Windows Server för din version av AKS-motorn? Du hittar versionerna i avsnittet Ladda ned nya avbildningar och AKS-motorn.
  • Använder du rätt klusterspecifikation (apimodel.json) och resursgrupp för målklustret? När du ursprungligen distribuerade klustret genererades den här filen i utdatakatalogen. Se distribuera kommandoparametrar Distribuera ett Kubernetes-kluster.
  • Använder du en tillförlitlig dator för att köra AKS-motorn och från vilken du utför uppgraderingsåtgärder?
  • Om du uppdaterar ett driftkluster med aktiva arbetsbelastningar kan du använda uppgraderingen utan att påverka dem, förutsatt att klustret är under normal belastning. Du bör dock ha ett säkerhetskopieringskluster om det finns ett behov av att omdirigera användare till det. Ett säkerhetskopieringskluster rekommenderas starkt.
  • Om möjligt kör du kommandot från en virtuell dator i Azure Stack Hub-miljön för att minska nätverkshoppen och potentiella anslutningsfel.
  • Kontrollera att din prenumeration har tillräckligt med kvot för hela processen. Processen allokerar nya virtuella datorer under processen. Det resulterande antalet virtuella datorer skulle vara detsamma som det ursprungliga, men planera för ett par virtuella datorer som ska skapas under processen.
  • Inga systemuppdateringar eller schemalagda aktiviteter planeras.
  • Konfigurera en stegvis uppgradering på ett kluster som har konfigurerats med samma värden som produktionsklustret och testa uppgraderingen där innan du gör det i ditt produktionskluster.

Använd uppgraderingskommandot

Du måste använda AKS-motorns uppgraderingskommando enligt beskrivningen i följande artikel Uppgradera ett Kubernetes-kluster på Azure Stack Hub.

Uppgraderingsavbrott

Ibland avbryter oväntade faktorer uppgraderingen av klustret. Ett avbrott kan inträffa när AKS-motorn rapporterar ett fel eller om något händer med AKS-motorns körningsprocess. Granska orsaken till avbrottet, åtgärda det och skicka samma uppgraderingskommando igen för att fortsätta uppgraderingsprocessen. Uppgraderingskommandot är idempotent och bör återuppta uppgraderingen av klustret när kommandot har skickats på nytt. Normalt ökar avbrott tiden för att slutföra uppdateringen, men bör inte påverka slutförandet av den.

Uppskattad uppgraderingstid

Den uppskattade tiden är mellan 12 och 15 minuter per virtuell dator i klustret. Till exempel kan det ta ungefär fem (5) timmar att uppgradera ett kluster med 20 noder.

Instruktioner för att använda AKS-motorn 0.70.0

Microsoft uppgraderade Azure Cloud Provider i version 0.70.0. Azure Cloud Provider är en kärnkomponent som delas mellan AKS Azure- och AKS-motorn på Azure Stack Hub.

Så här använder du AKS-motorn 0.70.0:

  • Om du försöker skapa ett nytt Kubernetes-kluster för första gången:
    Använd exempel-API-modellen för version 0.70.0 i AKS-motorn och motsvarande bildmappningstabell .

  • Om du skapar ett nytt kluster, men vill använda din befintliga API-modell:
    Ändra DIN API-modell genom att följa anvisningarna i Cloud Provider for Azure . Om den nya inställningen inte tas med resulterar det i ett distributionsfel.

  • Om du använder lagringsvolymer:
    Kontrollera att du använder AzureDiskCSI-drivrutinen. Version 0.70.0 stöder endast CSI-drivrutiner, inte den äldre lagringsprovidern i träd . Om du vill uppgradera följer du anvisningarna för att uppgradera från Kubernetes v1.20 till v1.21.

Ladda ned ny avbildning och AKS-motor

Ladda ned de nya versionerna av AKS-basmotorn Ubuntu Image och AKS.

Som förklaras i AKS-motorn för Azure Stack Hub-dokumentationen kräver distribution av ett Kubernetes-kluster:

  • Aks-motorns binärfil (krävs)
  • AKS Base Ubuntu 16.04-LTS Image Distro (inaktuell – använd inte längre, ändra i API-modellen så att 18.04 används i stället)
  • AKS Base Ubuntu 18.04-LTS Image Distro (krävs för Linux-agenter)
  • AKS Base Windows Server Image Distro (krävs för Windows agenter)

Nya versioner av dessa är tillgängliga med den här uppdateringen:

Uppgradera Kubernetes-kluster som skapats med Ubuntu 16.04-distributionen

Uppgradering av Kubernetes-kluster som skapats med Ubuntu 16.04-distributionen Från och med AKS Engine v0.67.0 är Ubuntu 16.04-distributionen inte längre ett alternativ som stöds när operativsystemet har nått sin slutpunkt. För att uppgradera ett kluster måste du ange os-distributionen till aks-ubuntu-18.04 i din indata-API-modell, den som genereras av aks-engine deploy och skickas som indata till aks-engine upgrade.

    "masterProfile": {
        "distro": "aks-ubuntu-18.04"
    },

    "agentPoolProfiles": [{
        "distro": "aks-ubuntu-18.04"
    }]

AKS-motor och Azure Stack-versionsmappning

Azure Stack Hub-version Version av AKS-motorn
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

Uppgraderingssökväg för Kubernetes-version i AKS-motorn v0.70.0

Du hittar den aktuella versionen och uppgraderingsversionen i följande tabell för Azure Stack Hub. Använd inte kommandot aks-engine get-versions eftersom det även hämtar de versioner som stöds i globala Azure. Följande version och uppgraderingstabell gäller AKS-motorklustret i Azure Stack Hub.

Aktuell version Uppgradering tillgänglig
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

Ange versions- och versionsvärdena i avsnittet orchestratorProfile, till exempel om du planerar att distribuera Kubernetes 1.17.17, följande två värden måste anges (se exempel på kubernetes-azurestack.json):

    -   "orchestratorRelease": "1.17",
    -   "orchestratorVersion": "1.17.17"

AKS-motor och motsvarande bildmappning

AKS-motor AKS-basavbildning Kubernetes-versioner API-modellexempel
v0.43.1 AKS Base Ubuntu 16.04-LTS Image Distro, oktober 2019 (2019.10.24) 1.15.5, 1.15.4, 1.14.8, 1.14.7
v0.48.0 AKS Base Ubuntu 16.04-LTS Image Distro, mars 2020 (2020.03.19) 1.15.10, 1.14.7
v0.51.0 AKS Base Ubuntu 16.04-LTS Image Distro, maj 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, augusti 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),
AKS Base Windows Image (17763.1697.210129)
1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows
v0.63.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q2 (2021.05.24), AKS Base Windows Image (17763.1935.210520) 1.18.18, 1.19.10, 1.20.6 API-modellexempel (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 API-modellexempel (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 API-modellexempel (Linux, Windows)
v0.70.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2022 Q1 (2022.04.07)
AKS Base Windows Image (17763.2565.220408)
1.21.10, 1.22.7 API-modellexempel (Linux, Windows)

Nyheter

Nya funktioner som ingår:

  • Stöd har lagts till för Kubernetes v1.21.10 (#4840)
  • Stöd har lagts till för Kubernetes v1.22.7 (#4838)
  • Du hittar ytterligare funktioner på v0.70.0.

Kända problem

  • Om du distribuerar flera Kubernetes-tjänster parallellt i ett enda kluster kan det leda till ett fel i den grundläggande lastbalanserarens konfiguration. Vi rekommenderar att du distribuerar en tjänst i taget.
  • Eftersom aks-engine-verktyget är en resurskällkodslagringsplats i Azure och Azure Stack Hub. Om du undersöker många viktig information och pull-begäranden kommer du att tro att verktyget stöder andra versioner av Kubernetes och OS-plattformen utöver ovanstående, ignorerar dem och använder versionstabellen ovan som officiell guide för den här uppdateringen.
  • AKS Engine v0.67.0 använder fel Windows Image när de distribuerar Windows kluster, användare bör använda v0.70.0 för att lösa problemet.

Referens

Det här är den fullständiga uppsättningen viktig information för Azure och Azure Stack Hub tillsammans:

Gäller för version v0.67.0 av AKS-motorn.

I den här artikeln beskrivs innehållet i aks-motorn (Azure Kubernetes Service) i Azure Stack Hub-uppdateringen. Uppdateringen innehåller förbättringar och korrigeringar för den senaste versionen av AKS-motorn som är riktad till Azure Stack Hub-plattformen. Observera att detta inte är avsett att dokumentera versionsinformationen för AKS-motorn för globala Azure.

Uppdateringsplanering

AKS-motorns uppgraderingskommando automatiserar fullständigt uppgraderingsprocessen för klustret, det tar hand om virtuella datorer (VM), nätverk, lagring, Kubernetes och orkestreringsuppgifter. Innan du tillämpar uppdateringen bör du granska viktig information.

Uppgraderingsöverväganden

  • Använder du rätt marketplace-objekt, AKS Base Ubuntu 16.04-LTS eller 18.04 Image Distro eller AKS Base Windows Server för din version av AKS-motorn? Du hittar versionerna i avsnittet "Ladda ned nya avbildningar och AKS-motor".
  • Använder du rätt klusterspecifikation (apimodel.json) och resursgrupp för målklustret? När du ursprungligen distribuerade klustret genererades den här filen i utdatakatalogen. Se distribuera kommandoparametrar Distribuera ett Kubernetes-kluster.
  • Använder du en tillförlitlig dator för att köra AKS-motorn och från vilken du utför uppgraderingsåtgärder?
  • Om du uppdaterar ett driftkluster med aktiva arbetsbelastningar kan du använda uppgraderingen utan att påverka dem, förutsatt att klustret är under normal belastning. Du bör dock ha ett säkerhetskopieringskluster om det finns ett behov av att omdirigera användare till det. Ett säkerhetskopieringskluster rekommenderas starkt.
  • Om möjligt kör du kommandot från en virtuell dator i Azure Stack Hub-miljön för att minska nätverkshoppen och potentiella anslutningsfel.
  • Kontrollera att din prenumeration har tillräckligt med kvot för hela processen. Processen allokerar nya virtuella datorer under processen. Det resulterande antalet virtuella datorer skulle vara detsamma som det ursprungliga, men planera för ett par virtuella datorer som ska skapas under processen.
  • Inga systemuppdateringar eller schemalagda aktiviteter planeras.
  • Konfigurera en stegvis uppgradering på ett kluster som har konfigurerats med samma värden som produktionsklustret och testa uppgraderingen där innan du gör det i ditt produktionskluster.

Använd uppgraderingskommandot

Du måste använda AKS-motorns uppgraderingskommando enligt beskrivningen i följande artikel Uppgradera ett Kubernetes-kluster på Azure Stack Hub.

Uppgraderingsavbrott

Ibland avbryter oväntade faktorer uppgraderingen av klustret. Ett avbrott kan inträffa när AKS-motorn rapporterar ett fel eller om något händer med AKS-motorns körningsprocess. Granska orsaken till avbrottet, åtgärda det och skicka samma uppgraderingskommando igen för att fortsätta uppgraderingsprocessen. Uppgraderingskommandot är idempotent och bör återuppta uppgraderingen av klustret när kommandot har skickats på nytt. Normalt ökar avbrott tiden för att slutföra uppdateringen, men bör inte påverka slutförandet av den.

Uppskattad uppgraderingstid

Den uppskattade tiden är mellan 12 och 15 minuter per virtuell dator i klustret. Till exempel kan det ta ungefär fem (5) timmar att uppgradera ett kluster med 20 noder.

Ladda ned ny avbildning och AKS-motor

Ladda ned de nya versionerna av AKS-basmotorn Ubuntu Image och AKS.

Som förklaras i AKS-motorn för Azure Stack Hub-dokumentationen kräver distribution av ett Kubernetes-kluster:

  • Aks-motorns binärfil (krävs)
  • AKS Base Ubuntu 16.04-LTS Image Distro (inaktuell – använd inte längre, ändra i API-modellen så att 18.04 används i stället)
  • AKS Base Ubuntu 18.04-LTS Image Distro (krävs för Linux-agenter)
  • AKS Base Windows Server Image Distro (krävs för Windows agenter)

Nya versioner av dessa är tillgängliga med den här uppdateringen:

Uppgradera Kubernetes-kluster som skapats med Ubuntu 16.04-distributionen

Uppgradering av Kubernetes-kluster som skapats med Ubuntu 16.04-distributionen Från och med AKS Engine v0.67.0 är Ubuntu 16.04-distributionen inte längre ett alternativ som stöds när operativsystemet har nått sin slutpunkt. För att uppgradera ett kluster måste du ange os-distributionen till aks-ubuntu-18.04 i din indata-API-modell, den som genereras av aks-engine deploy och skickas som indata till aks-engine upgrade.

    "masterProfile": {
        "distro": "aks-ubuntu-18.04"
    },

    "agentPoolProfiles": [{
        "distro": "aks-ubuntu-18.04"
    }]

AKS-motor och Azure Stack-versionsmappning

Azure Stack Hub-version Version av AKS-motorn
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

Uppgraderingssökväg för Kubernetes-version i AKS-motorn v0.67.0

Du hittar den aktuella versionen och uppgraderingsversionen i följande tabell för Azure Stack Hub. Använd inte kommandot aks-engine get-versions eftersom det även hämtar de versioner som stöds i globala Azure. Följande version och uppgraderingstabell gäller AKS-motorklustret i Azure Stack Hub.

Aktuell version Uppgradering tillgänglig
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

Ange versions- och versionsvärdena i avsnittet orchestratorProfile, till exempel om du planerar att distribuera Kubernetes 1.17.17, följande två värden måste anges (se exempel på kubernetes-azurestack.json):

    -   "orchestratorRelease": "1.17",
    -   "orchestratorVersion": "1.17.17"

AKS-motor och motsvarande bildmappning

AKS-motor AKS-basavbildning Kubernetes-versioner API-modellexempel
v0.43.1 AKS Base Ubuntu 16.04-LTS Image Distro, oktober 2019 (2019.10.24) 1.15.5, 1.15.4, 1.14.8, 1.14.7
v0.48.0 AKS Base Ubuntu 16.04-LTS Image Distro, mars 2020 (2020.03.19) 1.15.10, 1.14.7
v0.51.0 AKS Base Ubuntu 16.04-LTS Image Distro, maj 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, augusti 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),
AKS Base Windows Image (17763.1697.210129)
1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows
v0.63.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q2 (2021.05.24), AKS Base Windows Image (17763.1935.210520) 1.18.18, 1.19.10, 1.20.6 API-modellexempel (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 API-modellexempel (Linux, Windows)

Nyheter

Om du är intresserad av att delta i en privat förhandsversion kan du begära förhandsversionsåtkomst.

Nya funktioner som ingår:

  • Stöd för Kubernetes 1.19.15 och 1.20.11

Kända problem

  • Om du distribuerar flera Kubernetes-tjänster parallellt i ett enda kluster kan det leda till ett fel i den grundläggande lastbalanserarens konfiguration. Vi rekommenderar att du distribuerar en tjänst i taget.
  • Eftersom aks-engine-verktyget är en resurskällkodslagringsplats i Azure och Azure Stack Hub. Om du undersöker många viktig information och pull-begäranden kommer du att tro att verktyget stöder andra versioner av Kubernetes och OS-plattformen utöver ovanstående, ignorerar dem och använder versionstabellen ovan som officiell guide för den här uppdateringen.

Referens

Det här är den fullständiga uppsättningen viktig information för Azure och Azure Stack Hub tillsammans:

Gäller för version v0.60.1 av AKS-motorn.

I den här artikeln beskrivs innehållet i aks-motorn (Azure Kubernetes Service) i Azure Stack Hub-uppdateringen. Uppdateringen innehåller förbättringar och korrigeringar för den senaste versionen av AKS-motorn som är riktad till Azure Stack Hub-plattformen. Observera att detta inte är avsett att dokumentera versionsinformationen för AKS-motorn för globala Azure.

Uppdateringsplanering

AKS-motorns uppgraderingskommando automatiserar fullständigt uppgraderingsprocessen för klustret, det tar hand om virtuella datorer (VM), nätverk, lagring, Kubernetes och orkestreringsuppgifter. Innan du tillämpar uppdateringen bör du granska viktig information.

Uppgraderingsöverväganden

  • Använder du rätt marketplace-objekt, AKS Base Ubuntu 16.04-LTS eller 18.04 Image Distro eller AKS Base Windows Server för din version av AKS-motorn? Du hittar versionerna i avsnittet "Ladda ned nya avbildningar och AKS-motor".
  • Använder du rätt klusterspecifikation (apimodel.json) och resursgrupp för målklustret? När du ursprungligen distribuerade klustret genererades den här filen i utdatakatalogen. Se distribuera kommandoparametrar Distribuera ett Kubernetes-kluster.
  • Använder du en tillförlitlig dator för att köra AKS-motorn och från vilken du utför uppgraderingsåtgärder?
  • Om du uppdaterar ett driftkluster med aktiva arbetsbelastningar kan du använda uppgraderingen utan att påverka dem, förutsatt att klustret är under normal belastning. Du bör dock ha ett säkerhetskopieringskluster om det finns ett behov av att omdirigera användare till det. Ett säkerhetskopieringskluster rekommenderas starkt.
  • Om möjligt kör du kommandot från en virtuell dator i Azure Stack Hub-miljön för att minska nätverkshoppen och potentiella anslutningsfel.
  • Kontrollera att din prenumeration har tillräckligt med kvot för hela processen. Processen allokerar nya virtuella datorer under processen. Det resulterande antalet virtuella datorer skulle vara detsamma som det ursprungliga, men planera för ett par virtuella datorer som ska skapas under processen.
  • Inga systemuppdateringar eller schemalagda aktiviteter planeras.
  • Konfigurera en stegvis uppgradering på ett kluster som har konfigurerats med samma värden som produktionsklustret och testa uppgraderingen där innan du gör det i ditt produktionskluster.

Använd uppgraderingskommandot

Du måste använda AKS-motorns uppgraderingskommando enligt beskrivningen i följande artikel Uppgradera ett Kubernetes-kluster på Azure Stack Hub.

Uppgraderingsavbrott

Ibland avbryter oväntade faktorer uppgraderingen av klustret. Ett avbrott kan inträffa när AKS-motorn rapporterar ett fel eller om något händer med AKS-motorns körningsprocess. Granska orsaken till avbrottet, åtgärda det och skicka samma uppgraderingskommando igen för att fortsätta uppgraderingsprocessen. Uppgraderingskommandot är idempotent och bör återuppta uppgraderingen av klustret när kommandot har skickats på nytt. Normalt ökar avbrott tiden för att slutföra uppdateringen, men bör inte påverka slutförandet av den.

Uppskattad uppgraderingstid

Den uppskattade tiden är mellan 12 och 15 minuter per virtuell dator i klustret. Till exempel kan det ta ungefär fem (5) timmar att uppgradera ett kluster med 20 noder.

Ladda ned ny avbildning och AKS-motor

Ladda ned de nya versionerna av AKS-basmotorn Ubuntu Image och AKS.

Som förklaras i AKS-motorn för Azure Stack Hub-dokumentationen kräver distribution av ett Kubernetes-kluster:

  • Aks-motorns binärfil (krävs)
  • AKS Base Ubuntu 16.04-LTS Image Distro (krävs)
  • AKS Base Ubuntu 18.04-LTS Image Distro (valfritt)
  • AKS Base Windows Server Image Distro (valfritt)

Nya versioner av dessa är tillgängliga med den här uppdateringen:

AKS-motor och Azure Stack-versionsmappning

Azure Stack Hub-version Version av AKS-motorn
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

Uppgraderingssökväg för Kubernetes-version i AKS-motorn v0.60.1

Du hittar den aktuella versionen och uppgraderingsversionen i följande tabell för Azure Stack Hub. Använd inte kommandot aks-engine get-versions eftersom det även hämtar de versioner som stöds i globala Azure. Följande version och uppgraderingstabell gäller AKS-motorklustret i Azure Stack Hub.

Aktuell version Uppgradering tillgänglig
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

Ange versions- och versionsvärdena i avsnittet orchestratorProfile, till exempel om du planerar att distribuera Kubernetes 1.17.17, följande två värden måste anges (se exempel på kubernetes-azurestack.json):

    -   "orchestratorRelease": "1.17",
    -   "orchestratorVersion": "1.17.17"

AKS-motor och motsvarande bildmappning

AKS-motor AKS-basavbildning Kubernetes-versioner API-modellexempel
v0.43.1 AKS Base Ubuntu 16.04-LTS Image Distro, oktober 2019 (2019.10.24) 1.15.5, 1.15.4, 1.14.8, 1.14.7
v0.48.0 AKS Base Ubuntu 16.04-LTS Image Distro, mars 2020 (2020.03.19) 1.15.10, 1.14.7
v0.51.0 AKS Base Ubuntu 16.04-LTS Image Distro, maj 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, augusti 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),
AKS Base Windows Image (17763.1697.210129)
1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows

Nyheter

Om du är intresserad av att delta i en privat förhandsversion kan du begära förhandsversionsåtkomst.

Nya funktioner som ingår:

  • Allmän tillgänglighet för Ubuntu 18.04
  • Offentlig förhandsversion av certifikatrotation #4214
  • T4 Nvidia GPU Private Preview #4259
  • privat förhandsversion av Azure Active Directory integration
  • CSI-drivrutin för privat förhandsversion av Azure Blobs #712
  • Offentlig förhandsversion av CSI Driver Azure Disks #712
  • CSI Driver NFS Public Preview #712
  • Stöd för Kubernetes 1. 17.17 #4188 och 1.18.15 #4187

Kända problem

  • Om du distribuerar flera Kubernetes-tjänster parallellt i ett enda kluster kan det leda till ett fel i den grundläggande lastbalanserarens konfiguration. Vi rekommenderar att du distribuerar en tjänst i taget.
  • Eftersom aks-engine-verktyget är en resurskällkodslagringsplats i Azure och Azure Stack Hub. Om du undersöker många viktig information och pull-begäranden kommer du att tro att verktyget stöder andra versioner av Kubernetes och OS-plattformen utöver ovanstående, ignorerar dem och använder versionstabellen ovan som officiell guide för den här uppdateringen.

Referens

Det här är den fullständiga uppsättningen viktig information för Azure och Azure Stack Hub tillsammans:

Gäller för version v0.55.4 av AKS-motorn.

I den här artikeln beskrivs innehållet i aks-motorn (Azure Kubernetes Service) i Azure Stack Hub-uppdateringen. Uppdateringen innehåller förbättringar och korrigeringar för den senaste versionen av AKS-motorn som är riktad till Azure Stack Hub-plattformen. Observera att detta inte är avsett att dokumentera versionsinformationen för AKS-motorn för globala Azure.

Uppdateringsplanering

AKS-motorns uppgraderingskommando automatiserar fullständigt uppgraderingsprocessen för klustret, det tar hand om virtuella datorer (VM), nätverk, lagring, Kubernetes och orkestreringsuppgifter. Innan du tillämpar uppdateringen bör du granska viktig information.

Uppgraderingsöverväganden

  • Använder du rätt marketplace-objekt, AKS Base Ubuntu 16.04-LTS Image Distro för din version av AKS-motorn? Du hittar versionerna i avsnittet "Ladda ned ny avbildning och AKS-motor".

  • Använder du rätt klusterspecifikation (apimodel.json) och resursgrupp för målklustret? När du ursprungligen distribuerade klustret genererades den här filen i utdatakatalogen. deploy Se kommandoparametrarna Distribuera ett Kubernetes-kluster.

  • Använder du en tillförlitlig dator för att köra AKS-motorn och från vilken du utför uppgraderingsåtgärder?

  • Om du uppdaterar ett driftkluster med aktiva arbetsbelastningar kan du tillämpa uppgraderingen utan att påverka dem, förutsatt att klustret är under normal belastning. Du bör dock ha ett säkerhetskopieringskluster om det finns ett behov av att omdirigera användare till det. Ett säkerhetskopieringskluster rekommenderas starkt.

  • Om möjligt kör du kommandot från en virtuell dator i Azure Stack Hub-miljön för att minska nätverkshoppen och potentiella anslutningsfel.

  • Kontrollera att din prenumeration har tillräckligt med kvot för hela processen. Processen allokerar nya virtuella datorer under processen. Det resulterande antalet virtuella datorer skulle vara detsamma som det ursprungliga, men planera för ett par virtuella datorer som ska skapas under processen.

  • Inga systemuppdateringar eller schemalagda aktiviteter planeras.

  • Konfigurera en stegvis uppgradering på ett kluster som har konfigurerats med samma värden som produktionsklustret och testa uppgraderingen där innan du gör det i ditt produktionskluster.

Använd uppgraderingskommandot

Du måste använda AKS-motorkommandot upgrade enligt beskrivningen i följande artikel Uppgradera ett Kubernetes-kluster på Azure Stack Hub.

Uppgraderingsavbrott

Ibland avbryter oväntade faktorer uppgraderingen av klustret. Ett avbrott kan inträffa när AKS-motorn rapporterar ett fel eller om något händer med AKS-motorns körningsprocess. Granska orsaken till avbrottet, åtgärda det och skicka samma uppgraderingskommando igen för att fortsätta uppgraderingsprocessen. Uppgraderingskommandot är idempotent och bör återuppta uppgraderingen av klustret när kommandot har skickats på nytt. Normalt ökar avbrott tiden för att slutföra uppdateringen, men bör inte påverka slutförandet av den.

Uppskattad uppgraderingstid

Den uppskattade tiden är mellan 12 och 15 minuter per virtuell dator i klustret. Till exempel kan det ta ungefär fem (5) timmar att uppgradera ett kluster med 20 noder.

Ladda ned ny avbildning och AKS-motor

Ladda ned de nya versionerna av AKS-basmotorn Ubuntu Image och AKS.

Som förklaras i AKS-motorn för Azure Stack Hub-dokumentationen kräver distribution av ett Kubernetes-kluster två huvudkomponenter:

  • Aks-motorns binära

  • AKS Base Ubuntu 16.04-LTS Image Distro

Nya versioner av dessa är tillgängliga med den här uppdateringen:

AKS-motor och Azure Stack-versionsmappning

Azure Stack Hub-version Version av AKS-motorn
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

Uppgraderingssökväg för Kubernetes-version i AKS-motorn v0.55.4

Du hittar den aktuella versionen och uppgraderingsversionen i följande tabell för Azure Stack Hub. Använd inte kommandot aks-engine get-versions eftersom det även hämtar de versioner som stöds i globala Azure. Följande version och uppgraderingstabell gäller AKS-motorklustret i Azure Stack Hub.

Aktuell version Uppgradering tillgänglig
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

I Json-filen för API-modellen anger du versions- och versionsvärdena under orchestratorProfile avsnittet, till exempel om du planerar att distribuera Kubernetes 1.16.14 måste följande två värden anges(se exempel på kubernetes-azurestack.json):

    -   "orchestratorRelease": "1.16",
    -   "orchestratorVersion": "1.16.14"

AKS-motor och motsvarande bildmappning

Kubernetes-versioner Kommentarer
1.15.5, 1.15.4, 1.14.8, 1.14.7
1.15.10, 1.14.7
1.15.12, 1.16.8, 1.16.9 API-modellexempel (Linux, Windows)
1.15.12, 1.16.14, 1.17.11 API-modellexempel (Linux, Windows)
1.15.12, 1.16.14, 1.17.11 API-modellexempel (Linux, Windows)

Nyheter

  • Uppdatera Azure Stacks virtuella Linux-hårddisk till 2020.09.14 #3828
  • Lägger till stöd för K8s v1.17.11 på Azure Stack #3702
  • Lägger till stöd för K8s v1.16.14 på Azure Stack #3704
  • Linux VHD-uppdatering till 2020.09.14 #3750
  • Windows VHD-uppdatering till augusti #3730
  • Uppgraderar Kubernetes metrics-server till v0.3.7 #3669
  • Uppgraderar Docker-versionen för att åtgärda loggrotationsproblem #3693
  • Uppgraderar CoreDNS till v1.7.0 #3608
  • Använda moby 19.03.x-paket #3549
  • Korrigeringar av uppdateringsstrategin för azure-cni #3571

Kända problem

  • Att distribuera flera Kubernetes-tjänster parallellt i ett enda kluster kan leda till ett fel i den grundläggande lastbalanseringskonfigurationen. Distribuera en tjänst vid den tidpunkten om det är möjligt.
  • Om du kör aks-engine get-versions skapas information som är tillämplig för Azure och Azure Stack Hub, men det finns inte uttryckliga sätt att urskilja vad som motsvarar Azure Stack Hub. Använd inte det här kommandot för att ta reda på vilka versioner som är tillgängliga för uppgradering. Använd uppgraderingsreferenstabellen som beskrivs ovan.
  • Eftersom verktyget aks-engine är en resurslagringsplats för källkod i Azure och Azure Stack Hub. Om du undersöker många viktig information och pull-begäranden kommer du att tro att verktyget stöder andra versioner av Kubernetes och OS-plattformen utöver ovanstående, ignorerar dem och använder versionstabellen ovan som officiell guide för den här uppdateringen.

Referens

Det här är den fullständiga uppsättningen viktig information för Azure och Azure Stack Hub tillsammans:

Gäller för version 0.48.0 eller tidigare av AKS-motorn.

I den här artikeln beskrivs innehållet i aks-motorn (Azure Kubernetes Service) i Azure Stack Hub-uppdateringen. Uppdateringen innehåller förbättringar och korrigeringar för den senaste versionen av AKS-motorn som är riktad mot Azure Stack Hub-plattformen. Observera att detta inte är avsett att dokumentera versionsinformationen för AKS-motorn för globala Azure.

Uppdateringsplanering

Uppgraderingskommandot för AKS-motorn automatiserar fullständigt uppgraderingsprocessen för klustret, det tar hand om virtuella datorer (VM), nätverk, lagring, Kubernetes och orkestreringsuppgifter. Se till att granska informationen i den här artikeln innan du tillämpar uppdateringen.

Uppgraderingsöverväganden

  • Använder du rätt Marketplace-objekt, AKS Base Ubuntu 16.04-LTS Image Distro för din version av AKS-motorn? Du hittar versionerna i avsnittet Ladda ned de nya versionerna av AKS-bas-Ubuntu Image och AKS-motorn.

  • Använder du rätt klusterspecifikation (apimodel.json) och resursgrupp för målklustret? När du ursprungligen distribuerade klustret genererades den här filen i utdatakatalogen. Se kommandoparametrarna "distribuera" Distribuera ett Kubernetes-kluster.

  • Använder du en tillförlitlig dator för att köra AKS-motorn och från vilken du utför uppgraderingsåtgärder?

  • Om du uppdaterar ett driftkluster med aktiva arbetsbelastningar kan du tillämpa uppgraderingen utan att påverka dem, förutsatt att klustret är under normal belastning. Du bör dock ha ett säkerhetskopieringskluster om det finns ett behov av att omdirigera användare till det.

  • Om möjligt kör du kommandot från en virtuell dator i Azure Stack Hub-miljön för att minska nätverkshoppen och potentiella anslutningsfel.

  • Kontrollera att din prenumeration har tillräckligt med kvot för hela processen. Processen allokerar nya virtuella datorer under processen. Det resulterande antalet virtuella datorer skulle vara samma som det ursprungliga, men planera för ett par fler virtuella datorer som ska skapas under processen.

  • Inga systemuppdateringar eller schemalagda aktiviteter planeras.

  • Konfigurera en mellanlagrad uppgradering på ett kluster som har konfigurerats med samma värden som produktionsklustret och testa uppgraderingen där innan du gör det i produktionsklustret.

Använd uppgraderingskommandot

Du måste använda kommandot "upgrade" för AKS-motorn enligt beskrivningen i följande artikel Uppgradera ett Kubernetes-kluster på Azure Stack Hub.

Uppgraderingsavbrott

Ibland avbryter oväntade faktorer uppgraderingen av klustret. Ett avbrott kan inträffa när AKS-motorn rapporterar ett fel eller om något händer med AKS-motorns körningsprocess. Granska orsaken till avbrottet, åtgärda det och skicka samma uppgraderingskommando igen för att fortsätta uppgraderingsprocessen. Uppgraderingskommandot är idempotent och bör återuppta uppgraderingen av klustret när kommandot har skickats på nytt. Normalt ökar avbrott tiden för att slutföra uppdateringen, men bör inte påverka slutförandet av den.

Uppskattad uppgraderingstid

Den uppskattade tiden är mellan 12 och 15 minuter per virtuell dator i klustret. Till exempel kan det ta ungefär fem (5) timmar att uppgradera ett kluster med 20 noder.

Ladda ned ny avbildning och AKS-motor

Ladda ned de nya versionerna av AKS-basmotorn Ubuntu Image och AKS.

Som förklaras i dokumentationen om AKS-motorn för Azure Stack Hub kräver distribution av ett Kubernetes-kluster två huvudkomponenter:

  • Aks-motorns binärfil
  • AKS Base Ubuntu 16.04-LTS Image Distro

Nya versioner av dessa är tillgängliga med den här uppdateringen:

Uppgraderingssökväg för Kubernetes-version

Du hittar den aktuella versionen och uppgraderingsversionen i följande tabell för Azure Stack Hub. Följ inte kommandot aks-engine get-versions eftersom kommandot ett även innehåller de versioner som stöds i globala Azure. Följande version och uppgraderingstabell gäller AKS-motorklustret i Azure Stack Hub.

Aktuell version Uppgradering tillgänglig
1.14.7 1.15.10
1.14.8 1.15.10
1.15.4 1.15.10
1.15.5 1.15.10

Nyheter

  • Stöd för Kubernetes version 1.15.10 (#2834). När du distribuerar ett nytt kluster måste du ange versionsnumret och delversionsnumret i api-modellens json-fil (även kallat klusterdefinitionsfil). Du hittar ett exempel: kubernetes-azurestack.json:

    • "orchestratorRelease": "1.15,

    • "orchestratorVersion": "1.15.10"

    Anteckning

    Om Kubernetes-versionen inte uttryckligen anges i API-modellens json-fil används versionen 1.15 (#2932) och orchestratorVersion används som standard 1.15.11, vilket resulterar i ett fel under distributionen av klustret.

  • Med aks-engine v0.43.1 fungerar inte standardfrekvensinställningarna för molnleverantören för att utföra sin kontrollloop och andra uppgifter bra med Azure Stack Hub Resource Manager tröskelvärden för inkommande begäranden. Den här uppdateringen ändrar standardinställningarna för Azure Stack Hub för att minska återförsöksbelastningen till Azure Stack Hub Resource Manager (#2861).

  • Det nya verifieringssteget i aks-engine resulterar antingen i att körningen stoppas eller att varningar visas om api-modellens json-fil innehåller egenskaper som inte stöds av Azure Stack Hub (#2717).

  • Med en ny verifieringskontroll verifierar aks-motorn tillgängligheten för den version av AKS-basavbildningen som krävs för den version av aks-engine som körs (#2342). Detta inträffar efter parsning av API-modellfilen och innan du anropar Azure Stack Hub-Resource Manager.

  • Med det nya aks-engine-alternativet "--control-plane-only" i kommandot "upgrade" kan användaren uppgradera åtgärder för att endast rikta in sig på huvud-Virtual Machines (#2635).

  • Uppdateringar till Linux Kernel version 4.15.0-1071-azure för Ubuntu 16.04-LTS. Mer information finns i "Package: linux-image-4.15.0-1071-azure (4.15.0-1071.76) [security]".

  • Nya hyperkube-uppdateringar för att stödja Kubernetes-versionerna 1.14.8 och 1.15.10.

  • Uppdatera kubectl så att det matchar kubernetes-versionen för klustret. Den här komponenten är tillgänglig i Kubernetes-klusterkontrollplanets noder. Du kan köra den via SSH till en huvudserver.

  • Uppdateringar för Azure Container Monitor-tillägget med den senaste versionen från februari 2020 (#2850).

  • Uppgradering av coredns till version v1.6.6 (#2555).

  • Uppgradera etcd till version 3.3.18 (#2462).

  • Uppgradera moby till version 3.0.11 (#2887).

  • Med den här versionen av AKS Engine minskar beroendet från k8s.gcr.io att nu använda den officiella Kubernetes MCR registry @ mcr.microsoft.com när du skapar dess avbildningar (#2722).

Kända problem

  • Att distribuera flera Kubernetes-tjänster parallellt i ett enda kluster kan leda till ett fel i den grundläggande lastbalanseringskonfigurationen. Distribuera en tjänst vid den tidpunkten om det är möjligt.

  • Om du kör aks-engine get-versions skapas information som är tillämplig för Azure och Azure Stack Hub, men det finns inte uttryckliga sätt att urskilja vad som motsvarar Azure Stack Hub. Använd inte det här kommandot för att ta reda på vilket versionsområde som är tillgängligt för uppgradering. Använd uppgraderingsreferenstabellen som beskrivs ovan.

  • Eftersom verktyget aks-engine är en resurslagringsplats för källkod i Azure och Azure Stack Hub. Om du undersöker många viktig information och pull-begäranden kommer du att tro att verktyget stöder andra versioner av Kubernetes och OS-plattformen utöver ovanstående. Ignorera dem och använd versionstabellen ovan som officiell guide för den här uppdateringen.

Referens

Följande är en lista över några av de buggar som har åtgärdats samt en fullständig uppsättning viktig information från 0.44.0 till 0.48.0. Observera att den senare listan innehåller Azure- och Azure Stack Hub-objekt

Felkorrigeringar

  • userAssignedIdentityId citattecken saknas i Windows azure.json (#2327)

  • Tillägg är update config endast uppgradering (#2282)

  • Överskriden tidsgräns för att hämta hanterings-IP på Windows-noder (#2284)

  • Lägg till zip-filen 1.0.28 Azure CNI i windows VHD (#2268)

  • Korrigera standardordningen för att ange IPAddressCount (#2358)

  • Uppdatera för att använda yaml med en enskild omsagent för alla k8s-versioner för att undvika manuella fel och enkel underhållbarhet (#2692)

Viktig information

Det här är den fullständiga uppsättningen viktig information för Azure och Azure Stack Hub tillsammans

Nästa steg