Mettre à niveau un connecteur Active Directory

Article
10/16/2024

Cet article explique comment mettre à niveau le connecteur Active Directory.

Prérequis

Avant de pouvoir effectuer les tâches de cet article, vous devez :

Vous connecter et vous authentifier auprès d’un cluster Kubernetes
Avoir sélectionné un contexte Kubernetes existant
Contrôleur de données Azure Arc déployé, en mode direct ou indirect
Connecteur Active Directory déployé

Installer des outils

Pour mettre à niveau le connecteur Active Directory (adc), vous devez avoir installé les outils Kubernetes comme kubectl.

Les exemples de cet article utilisent kubectl, mais des approches similaires peuvent être utilisées avec d’autres outils Kubernetes tels que le tableau de bord Kubernetes, ocou helm si vous êtes familiarisé avec ces outils et Kubernetes yaml/json.

Installer l’outil kubectl

Limites

La mise à niveau automatique du connecteur Active Directory est applicable à partir d’imageTag v1.12.0_2022-10-11 et versions ultérieures, et le contrôleur de données Arc doit avoir au moins la version v1.11.0_2022-09-13.

Le connecteur Active Directory (adc) doit avoir la même version que le contrôleur de données avant la mise à niveau d’un contrôleur de données.

Aucun processus de mise à niveau par lots n’est disponible pour l’instant.

Mettre à niveau un connecteur Active Directory pour les versions précédentes

Pour les versions ImageTag v1.11.0_2022-09-13 ou antérieures, le connecteur Active Directory doit être mis à niveau manuellement comme indiqué ci-dessous :

Utilisez une commande kubectl pour afficher les spécifications existantes dans YAML.

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

Exécutez le patch kubectl pour mettre à jour la version souhaitée.

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

Monitor

Vous pouvez monitorer la progression de la mise à niveau avec kubectl de la façon suivante :

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

Sortie

La sortie de la commande affiche les informations sur les ressources. Les informations de mise à niveau seront dans État.

Pendant la mise à niveau, State affiche Updating et Running Version correspond à la version actuelle :

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

Une fois la mise à niveau terminée, State affiche Ready et Running Version correspond à la nouvelle version :

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

Dépannage

Lorsque la version souhaitée est définie sur une version spécifique, le travail de démarrage tente de procéder à la mise à niveau vers cette version jusqu’à ce qu’elle réussisse. Si la mise à niveau réussit, la propriété RunningVersion de la spécification est mise à jour vers la nouvelle version. Les mises à niveau peuvent échouer dans des scénarios comme une balise d’image incorrecte, l’impossibilité de se connecter au registre ou au référentiel, une quantité de processeur ou de mémoire insuffisante allouée aux conteneurs ou un stockage insuffisant.

Exécutez la commande ci-dessous pour voir si l’un des pods présente un statut Error ou présente un nombre élevé de redémarrages :
```
kubectl get pods --namespace <namespace>
```
Pour examiner les événements pour voir s’il existe une erreur, exécutez
```
kubectl describe pod <pod name> --namespace <namespace>
```

Pour obtenir la liste des conteneurs dans les pods, exécutez

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

Pour obtenir les journaux d’un conteneur, exécutez

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

Pour afficher les erreurs courantes et la façon de les résoudre, accédez aux Ressources de dépannage.

Partager via