Uppgradera Azure Arc-aktiverade Kubernetes-agenter

Azure Arc-aktiverade Kubernetes tillhandahåller både automatiska och manuella uppgraderingsfunktioner för sina agenter så att agenterna uppgraderas till den senaste versionen. Om du inaktiverar automatisk uppgradering och i stället förlitar dig på manuell uppgradering gäller en princip för versionsstöd för Arc-agenter och underliggande Kubernetes-kluster.

Aktivera eller inaktivera automatisk uppgradering när du ansluter ett kluster till Azure Arc

Azure Arc-aktiverade Kubernetes ger sina agenter färdiga funktioner för automatisk uppgradering. När automatisk uppgradering är aktiverad avsöker agenten Azure varje timme för att söka efter en nyare version. När en nyare version blir tillgänglig utlöser den en Helm-diagramuppgradering för Azure Arc-agenterna.

När du ansluter ett kluster till Azure Arc är standardinställningen att aktivera automatisk uppgradering.

Följande kommando ansluter ett kluster till Azure Arc med automatisk uppgradering aktiverad:

az connectedk8s connect --name AzureArcTest1 --resource-group AzureArcTest

Viktigt!

Se till att du tillåter anslutning till alla nödvändiga slutpunkter. I synnerhet krävs anslutning till dl.k8s.io för automatiska uppgraderingar.

Om du vill avanmäla dig från automatisk uppgradering anger du parametern --disable-auto-upgrade när du ansluter klustret till Azure Arc.

Följande kommando ansluter ett kluster till Azure Arc med automatisk uppgradering inaktiverat:

az connectedk8s connect --name AzureArcTest1 --resource-group AzureArcTest --disable-auto-upgrade

Dricks

Om du planerar att inaktivera automatisk uppgradering bör du vara medveten om versionssupportprincipen för Azure Arc-aktiverade Kubernetes.

Aktivera eller inaktivera automatisk uppgradering när du har anslutit ett kluster till Azure Arc

När du har anslutit ett kluster till Azure Arc kan du ändra det automatiska uppgraderingsvalet med hjälp az connectedk8s update av kommandot och inställningen --auto-upgrade till antingen sant eller falskt.

Följande kommando inaktiverar automatisk uppgradering för ett anslutet kluster:

az connectedk8s update --name AzureArcTest1 --resource-group AzureArcTest --auto-upgrade false

Uppgradera agenter manuellt

Om du har inaktiverat automatisk uppgradering kan du initiera uppgraderingar för agenterna manuellt med hjälp az connectedk8s upgrade av kommandot . När du gör det måste du ange den version som du vill uppgradera till.

Azure Arc-aktiverade Kubernetes följer standardsystemet för semantisk versionshantering för versionshantering av MAJOR.MINOR.PATCH dess agenter. Varje tal i versionen anger allmän kompatibilitet med den tidigare versionen:

  • Större versioner ändras när det finns inkompatibla API-uppdateringar eller bakåtkompatibilitet kan brytas.
  • Mindre versioner ändras när funktionsändringar är bakåtkompatibla med andra mindre versioner.
  • Korrigeringsversioner ändras när bakåtkompatibla felkorrigeringar görs.

Schemat kan variera, men en ny delversion av Azure Arc-aktiverade Kubernetes-agenter släpps ungefär en gång per månad.

Följande kommando uppgraderar agenterna manuellt till version 1.8.14:

az connectedk8s upgrade -g AzureArcTest1 -n AzureArcTest --agent-version 1.8.14

Kontrollera agentversionen

Om du vill visa en lista över anslutna kluster och en rapporterad agentversion använder du följande kommando:

az connectedk8s list --query '[].{name:name,rg:resourceGroup,id:id,version:agentVersion}'

Kontrollera om automatisk uppgradering är aktiverad i ett kluster

Kör följande kubectl-kommando för att kontrollera om ett kluster är aktiverat för automatisk uppgradering. Observera att konfigurationen för automatisk uppgradering inte är tillgänglig i det offentliga API:et för Azure Arc-aktiverade Kubernetes.

kubectl -n azure-arc get cm azure-clusterconfig -o jsonpath="{.data['AZURE_ARC_AUTOUPDATE']}"

Princip för versionsstöd

När du skapar supportbegäranden för Azure Arc-aktiverade Kubernetes gäller följande princip för versionsstöd:

  • Azure Arc-aktiverade Kubernetes-agenter har ett supportfönster med "N-2", där "N" är den senaste mindre versionen av agenter.

    • Om Till exempel Azure Arc-aktiverade Kubernetes introducerar 0.28.a idag, versionerna 0.28.a, 0.28.b, 0.27.c, 0.27.d, 0.26.e och 0.26.f stöds.
  • Kubernetes-kluster som ansluter till Azure Arc har ett supportfönster med "N-2", där "N" är den senaste stabila mindre versionen av uppströms Kubernetes.

    • Om Kubernetes till exempel introducerar 1.20.a idag stöds version 1.20.a, 1.20.b, 1.19.c, 1.19.d, 1.18.e och 1.18.f.

Om du skapar en supportbegäran och använder en version som ligger utanför supportprincipen (äldre än de versioner av agenter som stöds av N-2 och överordnade Kubernetes-kluster) uppmanas du att uppgradera klustren och agenterna till en version som stöds.

Nästa steg