Aggiornare gli agenti Kubernetes abilitati per Azure Arc

  • Articolo

Per i relativi agenti, Kubernetes abilitato per Azure Arc offre funzionalità di aggiornamento automatico e manuale alla versione più recente. Se si disabilita l'aggiornamento automatico e si sceglie invece l'aggiornamento manuale, vengono applicati i criteri di supporto della versione per gli agenti Azure Arc e i cluster Kubernetes sottostanti.

Attivare o disattivare l'aggiornamento automatico in fase di connessione di un cluster ad Azure Arc

Kubernetes abilitato per Azure Arc offre agli agenti funzionalità di aggiornamento automatico predefinite. Quando l'aggiornamento automatico è abilitato, l'agente esegue ogni ora il polling in Azure per verificare la disponibilità di una versione più recente. Quando una versione più recente diventa disponibile, viene attivato un aggiornamento del grafico Helm per gli agenti Azure Arc.

Quando un cluster viene connesso ad Azure Arc, l'impostazione predefinita prevede l'abilitazione dell'aggiornamento automatico.

Il comando seguente connette un cluster ad Azure Arc con l'aggiornamento automatico abilitato:

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

Importante

Assicurarsi di consentire la connettività a tutti gli endpoint necessari. In particolare, la connettività a dl.k8s.io è necessaria per gli aggiornamenti automatici.

Per rifiutare esplicitamente l'aggiornamento automatico, specificare il parametro --disable-auto-upgrade in fase di connessione del cluster ad Azure Arc.

Il comando seguente connette un cluster ad Azure Arc con l'aggiornamento automatico disabilitato:

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

Suggerimento

Se si prevede di disabilitare l'aggiornamento automatico, considerare i criteri di supporto della versione per Kubernetes abilitato per Azure Arc.

Attivare o disattivare l'aggiornamento automatico dopo la connessione di un cluster ad Azure Arc

Dopo aver connesso un cluster ad Azure Arc, è possibile modificare la selezione dell'aggiornamento automatico usando il comando az connectedk8s update e impostando --auto-upgrade su true o false.

Il comando seguente disattiva l'aggiornamento automatico per un cluster connesso:

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

Aggiornare manualmente gli agenti

Se l'aggiornamento automatico è stato disabilitato, è possibile avviare manualmente gli aggiornamenti degli agenti usando il comando az connectedk8s upgrade. In questo caso, è necessario specificare la versione in base alla quale si vuole eseguire l'aggiornamento.

Kubernetes abilitato per Azure Arc segue lo schema Versionamento Semantico standard di MAJOR.MINOR.PATCH per il controllo delle versioni degli agenti. Ogni numero nella versione indica la compatibilità generale con la versione precedente:

  • Le versioni principali cambiano in caso di aggiornamenti incompatibili dell'API o quando potrebbe essere interrotta la compatibilità con le versioni precedenti.
  • Le versioni secondarie cambiano se gli aggiornamenti delle funzionalità non sono compatibili con le versioni precedenti delle altre versioni secondarie.
  • Le versioni patch cambiano quando vengono apportate correzioni di bug compatibili con le versioni precedenti.

Anche se la pianificazione può variare, viene rilasciata una nuova versione secondaria degli agenti Kubernetes abilitati per Azure Arc circa una volta al mese.

Il comando seguente aggiorna manualmente gli agenti alla versione 1.8.14:

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

Controllare la versione degli agenti

Per elencare i cluster connessi e la versione dell'agente segnalata, usare il comando seguente:

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

Controllare se l'aggiornamento automatico è abilitato in un cluster

Per verificare se un cluster è abilitato per l'aggiornamento automatico, eseguire il comando kubectl seguente. Si noti che la configurazione dell'aggiornamento automatico non è disponibile nell'API pubblica per Kubernetes abilitato per Azure Arc.

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

Criteri di supporto delle versioni

Quando si creano richieste di supporto per Kubernetes abilitato per Azure Arc, si applicano i criteri di supporto della versione seguenti:

  • Gli agenti Kubernetes abilitati per Azure Arc hanno una finestra di supporto "N-2", dove "N" è la versione secondaria più recente degli agenti.

    • Ad esempio, se Kubernetes abilitato per Azure Arc introduce la versione 0.28.a, saranno supportate le versioni 0.28.a, 0.28.b, 0.27.c, 0.27.d, 0.26.e e 0.26.f.

  • I cluster Kubernetes che si connettono ad Azure Arc hanno una finestra di supporto "N-2", dove "N" è la versione secondaria stabile più recente di Upstream Kubernetes.

    • Ad esempio, se Kubernetes introduce la versione 1.20.a, saranno supportate le versioni 1.20.a, 1.20.b, 1.19.c, 1.19.d, 1.18.e e 1.18.f.

Se si crea una richiesta di supporto e si usa una versione non conforme ai criteri di supporto (precedenti alle versioni "N-2" supportate degli agenti e dei cluster Upstream Kubernetes), verrà chiesto di aggiornare i cluster e gli agenti a una versione supportata.

Passaggi successivi