Aggiornare gli agenti Kubernetes abilitati per Azure Arc

  • Articolo

Kubernetes abilitato per Azure Arc offre funzionalità di aggiornamento automatico e manuale per i relativi agenti in modo che gli agenti vengano aggiornati alla versione più recente. Se si disabilita l'aggiornamento automatico e si fa invece affidamento sull'aggiornamento manuale, vengono applicati criteri di supporto della versione per gli agenti Arc e i cluster Kubernetes sottostanti.

Attivare o disattivare l'aggiornamento automatico durante la 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 il polling orario di Azure per verificare la disponibilità di una versione più recente. Quando una versione più recente diventa disponibile, attiva un aggiornamento del grafico Helm per gli agenti di Azure Arc.

Quando si connette un cluster ad Azure Arc, l'impostazione predefinita consiste nell'abilitare l'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 durante la --disable-auto-upgrade 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, tenere presente i criteri di supporto della versione per Kubernetes abilitati 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 az connectedk8s update comando 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 per gli agenti usando il az connectedk8s upgrade comando . In questo caso, è necessario specificare la versione a cui si vuole eseguire l'aggiornamento.

Kubernetes abilitato per Azure Arc segue lo schema di controllo delle versioni 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 quando sono presenti aggiornamenti dell'API incompatibili o la compatibilità con le versioni precedenti potrebbe essere interrotta.
  • Le versioni secondarie cambiano quando le modifiche alle funzionalità sono compatibili con le versioni precedenti di altre versioni secondarie.
  • Le versioni delle 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 dell'agente

Per elencare i cluster connessi e la versione dell'agente segnalato, 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 con abilitazione di 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 attualmente la versione 0.28.a, le versioni 0.28.a, 0.28.b, 0.27.c, 0.27.d, 0.26.e e 0.26.f sono supportate.

  • 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 Kubernetes upstream.

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

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

Passaggi successivi