Aktualisieren eines Active Directory-Connectors

Artikel
10/16/2024

In diesem Artikel wird beschrieben, wie Sie den Active Directory-Connector aktualisieren.

Voraussetzungen

Um die Aufgaben in diesem Artikel ausführen zu können, ist zunächst Folgendes erforderlich:

Herstellen einer Verbindung mit einem Kubernetes-Cluster und Durchführen der Authentifizierung
Auswählen eines vorhandenen Kubernetes-Kontexts
Bereitgestellter Azure Arc-Datencontroller im Modus direct oder indirect
Bereitgestellter Active Directory-Connector

Installieren von Tools

Zum Aktualisieren des Active Directory-Connectors (adc) müssen die Kubernetes-Tools (etwa kubectl) installiert sein.

In den Beispielen in diesem Artikel wird kubectl verwendet, aber es können auch ähnliche Ansätze mit anderen Kubernetes-Tools verfolgt werden, z. B. mit dem Kubernetes-Dashboard, oc oder Helm, wenn Sie mit diesen Tools und Kubernetes-YAML/JSON-Dateien vertraut sind.

Installieren des kubectl-Tools

Begrenzungen

Das automatische Upgrade eines Active Directory-Connectors gilt ab imageTag v1.12.0_2022-10-11, und der Arc-Datencontroller muss mindestens Version v1.11.0_2022-09-13 aufweisen.

Der aktive Active Directory-Controller (adc) muss dieselbe Version wie der Datencontroller aufweisen, damit der Datencontroller aktualisiert werden kann.

Zurzeit ist kein Prozess für ein Batchupgrade verfügbar.

Aktualisieren des Active Directory-Connectors für frühere Versionen

Für imageTag-Versionen v1.11.0_2022-09-13 oder niedriger muss der Active Directory-Connector wie folgt manuell aktualisiert werden:

Verwenden Sie einen kubectl-Befehl, um die vorhandene Spezifikation in YAML anzuzeigen.

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

Führen Sie „kubectl patch“ aus, um die gewünschte Version zu aktualisieren.

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

Monitor

Sie können den Fortschritt des Upgrades mit kubectl wie folgt überwachen:

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

Output

Die Ausgabe für den Befehl zeigt die Ressourceninformationen an. Die Upgradeinformationen werden unter Status angezeigt.

Während des Upgrades zeigt State Updating an und Running Version ist die aktuelle Version:

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

Nach Abschluss des Upgrades zeigt State Ready an und Running Version ist die neue Version:

Status:
  Last Update Time:     2022-09-20T16:01:54.279612Z
  Observed Generation:  2
  Running Version:      v1.11.0_2022-09-13
  State:                Ready

Problembehandlung

Wenn die gewünschte Version auf eine bestimmte Version festgelegt ist, versucht der Bootstrapperauftrag solange ein Upgrade darauf durchzuführen, bis er erfolgreich ist. Wenn das Upgrade erfolgreich ist, wird die Eigenschaft RunningVersion der Spezifikation auf die neue Version aktualisiert. Bei Upgrades können Fehler auftreten, wenn z. B. das Imagetag falsch ist, keine Verbindung mit der Registrierung oder dem Repository hergestellt werden kann, den Containern nicht genügend CPU oder Arbeitsspeicher zugewiesen ist oder der Speicherplatz nicht ausreicht.

Führen Sie den folgenden Befehl aus, um festzustellen, ob einer der Pods den Status Error anzeigt oder eine hohe Anzahl von Neustarts aufweist:
```
kubectl get pods --namespace <namespace>
```
Um sich Ereignisse anzusehen, um zu sehen, ob ein Fehler vorliegt, führen Sie Folgendes aus
```
kubectl describe pod <pod name> --namespace <namespace>
```

Führen Sie zum Abrufen einer Liste der Container in den Pods aus

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

Um die Protokolle für einen Container zu erhalten, führen Sie Folgendes aus
```
kubectl logs <pod name> <container name> --namespace <namespace>
```

Um häufige Fehler zu sehen und zu erfahren, wie Sie diese beheben können, gehen Sie zu Ressourcen zur Problembehandlung.

Freigeben über