Kubernetes-agents met Azure Arc upgraden

  • Artikel

Kubernetes met Azure Arc biedt zowel automatische als handmatige upgrademogelijkheden voor de agents , zodat agents worden bijgewerkt naar de nieuwste versie. Als u automatische upgrade uitschakelt en in plaats daarvan afhankelijk bent van handmatige upgrade, is een versieondersteuningsbeleid van toepassing op Arc-agents en de onderliggende Kubernetes-clusters.

Automatische upgrade in- of uitschakelen bij het verbinden van een cluster met Azure Arc

Kubernetes met Azure Arc biedt de agents out-of-the-box automatische upgrademogelijkheden. Wanneer automatische upgrade is ingeschakeld, controleert de agent azure elk uur om te controleren op een nieuwere versie. Wanneer een nieuwere versie beschikbaar komt, wordt er een Helm-grafiekupgrade geactiveerd voor de Azure Arc-agents.

Wanneer u een cluster verbindt met Azure Arc, is de standaardinstelling om automatische upgrade in te schakelen.

Met de volgende opdracht wordt een cluster verbonden met Azure Arc waarvoor automatische upgrade is ingeschakeld:

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

Belangrijk

Zorg ervoor dat u connectiviteit met alle vereiste eindpunten toestaat. Er is met name verbinding met dl.k8s.io vereist voor automatische upgrades.

Als u zich wilt afmelden voor automatische upgrade, geeft u de --disable-auto-upgrade parameter op tijdens het verbinden van het cluster met Azure Arc.

Met de volgende opdracht wordt een cluster verbonden met Azure Arc met automatische upgrade uitgeschakeld:

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

Tip

Als u automatische upgrade wilt uitschakelen, moet u rekening houden met het versieondersteuningsbeleid voor Kubernetes met Azure Arc.

Automatische upgrade in- of uitschakelen na het verbinden van een cluster met Azure Arc

Nadat u een cluster hebt verbonden met Azure Arc, kunt u de selectie voor automatische upgrades wijzigen met behulp van de az connectedk8s update opdracht en instelling --auto-upgrade op waar of onwaar.

Met de volgende opdracht wordt automatische upgrade uitgeschakeld voor een verbonden cluster:

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

Agents handmatig upgraden

Als u automatische upgrade hebt uitgeschakeld, kunt u handmatig upgrades voor de agents initiëren met behulp van de az connectedk8s upgrade opdracht. Als u dit doet, moet u de versie opgeven waarnaar u een upgrade wilt uitvoeren.

Kubernetes met Azure Arc volgt het standaard semantische versiebeheerschema voor versiebeheer van MAJOR.MINOR.PATCH de agents. Elk nummer in de versie geeft algemene compatibiliteit met de vorige versie aan:

  • Primaire versies veranderen wanneer er incompatibele API-updates zijn of compatibiliteit met eerdere versies kan worden verbroken.
  • Secundaire versies veranderen wanneer functionaliteitswijzigingen compatibel zijn met andere secundaire versies.
  • Patchversies veranderen wanneer achterwaarts compatibele foutoplossingen worden aangebracht.

Hoewel het schema kan variëren, wordt er ongeveer één keer per maand een nieuwe secundaire versie van Kubernetes-agents met Azure Arc uitgebracht.

Met de volgende opdracht worden de agents handmatig bijgewerkt naar versie 1.8.14:

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

Agentversie controleren

Gebruik de volgende opdracht om verbonden clusters en gerapporteerde agentversie weer te geven:

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

Controleren of automatische upgrade is ingeschakeld op een cluster

Voer de volgende kubectl-opdracht uit om te controleren of een cluster is ingeschakeld voor automatische upgrade. Houd er rekening mee dat de automatische upgradeconfiguratie niet beschikbaar is in de openbare API voor Kubernetes met Azure Arc.

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

Versieondersteuningsbeleid

Wanneer u ondersteuningsaanvragen voor Kubernetes met Azure Arc maakt, is het volgende versieondersteuningsbeleid van toepassing:

  • Kubernetes-agents met Azure Arc hebben een ondersteuningsvenster van 'N-2', waarbij N de meest recente secundaire versie van agents is.

    • Als Kubernetes met Azure Arc bijvoorbeeld 0.28.a introduceert, worden versies 0.28.a, 0.28.b, 0.27.c, 0.27.d, 0.26.e en 0.26.f ondersteund.

  • Kubernetes-clusters die verbinding maken met Azure Arc hebben een ondersteuningsvenster van 'N-2', waarbij 'N' de meest recente stabiele secundaire versie van upstream Kubernetes is.

    • Als Kubernetes bijvoorbeeld vandaag 1.20.a introduceert, worden versies 1.20.a, 1.20.b, 1.19.c, 1.19.d, 1.18.e en 1.18.f ondersteund.

Als u een ondersteuningsaanvraag maakt en een versie gebruikt die zich buiten het ondersteuningsbeleid bevindt (ouder dan de ondersteunde N-2-versies van agents en upstream Kubernetes-clusters), wordt u gevraagd om de clusters en agents te upgraden naar een ondersteunde versie.

Volgende stappen