Aggiornare l'host del servizio Azure Kubernetes abilitato da Arc tramite PowerShell

  • Articolo

Si applica a: servizio Azure Kubernetes in Azure Stack HCI 22H2, servizio Azure Kubernetes in Windows Server

Questo articolo descrive come aggiornare l'host servizio Azure Kubernetes nel servizio Azure Kubernetes abilitato da Azure Arc.

Panoramica degli aggiornamenti dell'host del servizio Azure Kubernetes

Aggiornamenti all'host del servizio Azure Kubernetes includono sempre la versione più recente disponibile. Anche se è possibile aggiornare l'host indipendentemente dagli aggiornamenti del cluster del carico di lavoro, è necessario aggiornare sempre l'host prima di aggiornare un cluster del carico di lavoro.

Per evitare interruzioni e perdita della disponibilità del servizio Azure Kubernetes, vengono eseguiti aggiornamenti in sequenza. Quando si inserisce un nuovo nodo con una build più recente nel cluster, le risorse passano dal nodo precedente al nuovo nodo. Quando le risorse vengono rimosse correttamente, il nodo precedente viene rimosso e rimosso dal cluster.

Nota

Microsoft consiglia di aggiornare i cluster del servizio Azure Kubernetes entro 30 giorni da una nuova versione. Se non si esegue l'aggiornamento all'interno di questa finestra, sono trascorsi fino a 90 giorni dall'ultimo aggiornamento prima della scadenza dei certificati e dei token interni. Una volta scaduti i certificati e i token, il cluster è ancora funzionante; Tuttavia, è necessario chiamare supporto tecnico Microsoft per eseguire l'aggiornamento. Quando si riavvia il cluster dopo il periodo di 90 giorni, rimane in uno stato non funzionale. Per altre informazioni sui certificati e i token interni, vedere la panoramica della gestione dei certificati.

Aggiornare l'host del servizio Azure Kubernetes

Il primo passaggio in qualsiasi flusso di aggiornamento consiste nell'eseguire il comando Update-AksHci per aggiornare l'host del servizio Azure Kubernetes. Update-AksHci non accetta argomenti e aggiorna sempre il cluster di gestione alla versione più recente. È necessario avviare questo passaggio prima di eseguire Update-AksHciCluster per aggiornare il cluster Kubernetes a una nuova versione.

Importante

Il comando update funziona solo se è stata installata la versione disponibile a livello generale o versione successiva. Non funziona per le versioni precedenti. Questo comando di aggiornamento aggiorna l'host del servizio Azure Kubernetes e la piattaforma cloud gestita da Microsoft locale. Questo comando non aggiorna i cluster del carico di lavoro del servizio Azure Kubernetes esistenti. I nuovi cluster del carico di lavoro del servizio Azure Kubernetes creati dopo l'aggiornamento dell'host del servizio Azure Kubernetes potrebbero differire dai cluster del carico di lavoro del servizio Azure Kubernetes esistenti nella versione del sistema operativo e in Kubernetes.

È consigliabile aggiornare i cluster del carico di lavoro del servizio Azure Kubernetes immediatamente dopo l'aggiornamento dell'host del servizio Azure Kubernetes per ottenere le versioni più recenti del sistema operativo e le correzioni recenti. Se un cluster del carico di lavoro si trova in una versione Kubernetes non supportata nella versione successiva di Arc del servizio Azure Kubernetes, l'aggiornamento ha esito negativo.

Flusso di esempio per l'aggiornamento di un host del servizio Azure Kubernetes

Aggiornare i moduli di PowerShell

Assicurarsi di avere sempre installato i moduli di PowerShell più recenti nei nodi del servizio Azure Kubernetes eseguendo il comando seguente in tutti i nodi fisici nella distribuzione del servizio Azure Kubernetes.

Importante

È necessario chiudere tutte le finestre di PowerShell aperte e quindi aprire una nuova sessione per eseguire il comando di aggiornamento. Se non si chiude tutte le finestre di PowerShell, potrebbero essere presenti moduli in uso e che non possono essere aggiornati.

Update-Module -Name AksHci -Force -AcceptLicense

Ottenere la versione corrente del servizio Azure Kubernetes Arc

Get-AksHciVersion                    

1.0.0.10517

Ottenere gli aggiornamenti di Azure Kubernetes Arc disponibili

Get-AksHciUpdates

L'output mostra le versioni disponibili a cui è possibile aggiornare questo host del servizio Azure Kubernetes:

1.0.2.10723

Controllo delle versioni

Usando la versione 1.0.2.10723 come esempio, la tabella seguente illustra come vengono costruiti i numeri di versione per le versioni di Arc del servizio Azure Kubernetes.

Valore Significato
1 Versione principale: +1 per ogni versione con una modifica di rilievo di grandi dimensioni.
0 Versione secondaria: +1 per ogni versione dopo la versione principale più recente con una modifica delle funzionalità principali.
2 Funzionalità & aggiornamenti delle patch: +1 per ogni versione regolare (in genere mensile) dopo la versione principale più recente.
1 Tipo di compilazione: sempre 1 per le build pubbliche.
0723 Data di creazione della compilazione: data di creazione della compilazione in formato mmdd.

Avviare l'aggiornamento di Arc del servizio Azure Kubernetes

Update-AksHci

Verificare che l'host del servizio Azure Kubernetes sia stato aggiornato

Get-AksHciVersion

L'output mostra la versione aggiornata del servizio Azure Kubernetes nell'host del servizio Azure Kubernetes:

1.0.2.10723

Passaggi successivi