Aggiornare Active Directory Connector

Articolo
09/26/2024

Questo articolo descrive come aggiornare Active Directory Connector.

Prerequisiti

Prima di procedere con le attività descritte in questo articolo, è necessario disporre degli elementi seguenti:

Connessione e autenticazione con un cluster Kubernetes
Contesto Kubernetes esistente selezionato
Controller dei dati di Azure Arc distribuito, in modalità direct o indirect
Active Directory Connector distribuito

Installare gli strumenti

Per aggiornare Active Directory Connector (ADC), è necessario disporre degli strumenti Kubernetes, ad esempio kubectl, installati.

Gli esempi riportati in questo articolo useranno kubectl, tuttavia è possibile usare approcci simili con altri strumenti Kubernetes, ad esempio il dashboard di Kubernetes, oc o Helm, se si ha familiarità con questi strumenti e con i file yaml/json di Kubernetes.

Installare lo strumento kubectl

Limiti

L'aggiornamento automatico di Active Directory Connector è applicabile da imageTag v1.12.0_2022-10-11 e versioni successive e il controller dei dati di Azure Arc deve essere almeno della versione v1.11.0_2022-09-13.

Active Directory Connector (ADC) deve avere la stessa versione del controller dei dati prima che un controller dei dati possa essere aggiornato.

Al momento non è disponibile alcun processo di aggiornamento batch.

Aggiornare Active Directory Connector per le versioni precedenti

Per imageTag v1.11.0_2022-09-13 o versioni precedenti, Active Directory Connector deve essere aggiornato manualmente come indicato di seguito:

Usare un comando kubectl per visualizzare la specifica esistente in yaml.

kubectl get adc <adc-name> --namespace <namespace> --output yaml

Eseguire la patch kubectl per aggiornare la versione desiderata.

kubectl patch adc <adc-name> --namespace <namespace> --type merge --patch '{"spec": {"update": {"desiredVersion": "v1.11.0_2022-09-13"}}}'

Monitoraggio

È possibile monitorare lo stato di avanzamento dell'aggiornamento con kubectl nel modo seguente:

kubectl describe adc <adc-name> --namespace <namespace>

Output

L'output del comando mostrerà le informazioni sulla risorsa. Le informazioni sull'aggiornamento saranno incluse nello stato.

Durante l'aggiornamento, State indicherà Updating e Running Version sarà la versione corrente:

Status:
  Last Update Time:     2022-09-20T16:01:48.449512Z
  Observed Generation:  1
  Running Version:      v1.10.0_2022-08-09
  State:                Updating

Al termine dell'aggiornamento, State indicherà Ready e Running Version sarà la nuova versione:

Status:
  Last Update Time:     2022-09-20T16:01:54.279612Z
  Observed Generation:  2
  Running Version:      v1.11.0_2022-09-13
  State:                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.

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>
```
Per esaminare gli eventi e verificare l'eventuale presenza di un errore, eseguire:
```
kubectl describe pod <pod name> --namespace <namespace>
```

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

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

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.

Condividi tramite