Condividi tramite

Aggiornare un controller dei dati di Azure Arc connesso direttamente tramite l'interfaccia della riga di comando

  • Articolo

Questo articolo che come aggiornare un controller dei dati abilitato per Azure Arc connesso direttamente tramite l'interfaccia della riga di comando di Azure (az).

Durante un aggiornamento di un controller dei dati, è possibile aggiornare parti del piano di controllo dei dati, ad esempio le definizioni di risorse personalizzate e i contenitori. Un aggiornamento del controller dei dati non causerà tempi di inattività per i servizi dati (Istanza gestita di SQL o server PostgreSQL).

Prerequisiti

È necessario un controller dei dati connesso direttamente con imageTag v1.0.0_2021-07-30 o versione successiva.

Per controllare la versione, eseguire:

kubectl get datacontrollers -n <namespace> -o custom-columns=BUILD:.spec.docker.imageTag

Installare gli strumenti

Prima di procedere con le attività descritte in questo articolo, è necessario installare:

Gli esempi in questo articolo usano parentesi angolari < ... > per identificare i valori che è necessario sostituire prima di eseguire lo script. Sostituire le parentesi quadre e i valori all'interno delle parentesi quadre.

La versione dell'estensione arcdata e la versione dell'immagine sono correlate. Nel log delle versioni verificare che la versione dell'estensione arcdata sia corretta e corrisponda alla versione dell'immagine a cui si vuole eseguire l'aggiornamento.

Visualizzare le immagini disponibili e scegliere una versione

Eseguire il pull dell'elenco delle immagini disponibili per il controller dei dati con il comando seguente:

az arcdata dc list-upgrades --k8s-namespace <namespace>

Il comando precedente restituisce un output simile all'esempio seguente:

Found 2 valid versions.  The current datacontroller version is v1.0.0_2021-07-30.
v1.1.0_2021-11-02
v1.0.0_2021-07-30

Aggiornare il controller dei dati

Questa sezione spiega come aggiornare un controller dei dati connesso direttamente.

Nota

Alcuni dei livelli e delle modalità dei servizi dati sono disponibili a livello generale e alcuni in anteprima. Se si installano servizi con disponibilità generale e in anteprima nello stesso controller dei dati, non è possibile eseguire l'aggiornamento sul posto. Per eseguire l'aggiornamento, eliminare tutte le istanze di database non con disponibilità generale. È possibile trovare l'elenco dei servizi con disponibilità generale e in anteprima nelle note sulla versione.

Per i percorsi di aggiornamento supportati, vedere Aggiornare i servizi dati abilitati per Azure Arc.

Autentica

È necessario connettersi ed eseguire l'autenticazione a un cluster Kubernetes e disporre di un contesto Kubernetes esistente selezionato prima di iniziare l'aggiornamento del controller dei dati di Azure Arc.

kubectl config use-context <Kubernetes cluster name>

Aggiornare il controller dei dati

È prima possibile eseguire una prova. L'esecuzione di prova convalida l'esistenza del registro, dello schema delle versioni e del token di autorizzazione del repository privato (se usato). Per eseguire un'esecuzione di prova, usare il parametro --dry-run nel comando az arcdata dc upgrade. Ad esempio:

az arcdata dc upgrade --resource-group <resource group> --name <data controller name> --desired-version <version> --dry-run [--no-wait]

L'output del comando precedente è:

Preparing to upgrade dc arcdc in namespace arc to version <version-tag>.
****Dry Run****
Arcdata Control Plane would be upgraded to: <version-tag>

Dopo aver aggiornato l'estensione del controller dei dati di Azure Arc, eseguire il comando az arcdata dc upgrade specificando il tag immagine con --desired-version.

az arcdata dc upgrade --resource-group <resource group> --name <data controller name> --desired-version <version> [--no-wait]

Esempio:

az arcdata dc upgrade --resource-group rg-arcds --name dc01 --desired-version v1.7.0_2022-05-24 [--no-wait]

Monitorare lo stato dell'aggiornamento

È possibile monitorare lo stato di avanzamento dell'aggiornamento con l'interfaccia della riga di comando.

CLI

 az arcdata dc status show --resource-group <resource group>

L'aggiornamento è un processo articolato in due parti. Il controller viene aggiornato per primo e quindi viene aggiornato lo stack di monitoraggio. Al termine dell'aggiornamento, l'output sarà:

Ready

Risoluzione dei problemi

Quando la versione desiderata è impostata su una versione specifica, il processo del caricatore di bootstrap tenterà di eseguire l'aggiornamento a tale versione fino a quando l'operazione non ha esito positivo. Se l'aggiornamento ha esito positivo, la proprietà RunningVersion della specifica viene aggiornata in base alla nuova versione. Gli aggiornamenti potrebbero non riuscire in scenari in cui i tag immagine non sono corretti, risulta impossibile connettersi al registro o al repository, la CPU o la memoria allocata ai contenitori non è sufficiente oppure le risorse di archiviazione sono insufficienti.

  1. Eseguire il comando seguente per verificare se uno dei pod è associato allo stato Error o ha un numero elevato di riavvii:

    kubectl get pods --namespace <namespace>

  2. Per esaminare gli eventi e verificare l'eventuale presenza di un errore, eseguire:

    kubectl describe pod <pod name> --namespace <namespace>

  3. Per ottenere l'elenco dei contenitori nei pod, eseguire:

    kubectl get pods <pod name> --namespace <namespace> -o jsonpath='{.spec.containers[*].name}*'

  4. Per ottenere i log per un contenitore, eseguire:

    kubectl logs <pod name> <container name> --namespace <namespace>

Per visualizzare gli errori comuni e come risolverli, consultare Risorse per la risoluzione dei problemi.