Partager via


Configurer l’outil DIRCTL pour le runtime d’intégration auto-hébergé (préversion)

La ligne de commande du runtime d’intégration de données (DIRCTL) est un . Outil d’interface de ligne de commande (CLI) basé sur NET qui automatise la gestion du runtime d’intégration des données dans les clusters Kubernetes. Il simplifie les opérations Kubernetes complexes avec des commandes simples et garantit une communication sécurisée avec Microsoft Purview pour l’inscription et la gestion du cycle de vie des jetons.

Pour gérer votre runtime d’intégration de données auto-hébergé Microsoft Purview Kubernetes localement, vous avez besoin de l’outil en ligne de commande DIRCTL. Vous pouvez télécharger cet outil pendant le processus de création du runtime d’intégration des données. Consultez les instructions d’installation ci-dessous pour les systèmes d’exploitation Windows et Linux.

Configuration de Windows pour l’interface CLI DIRCTL

  1. Téléchargez et installez l’outil CLI Kubectl.
  2. Placez le fichier de configuration kube généré dans le dossier spécifique à l’utilisateur en suivant ce chemin d’accès : C:/Users/<user-folder>/.kube/. Copiez le fichier et nommez-le config.

    Remarque

    Ce fichier de configuration est requis pour l’authentification DIRCTL sur les clusters Kubernetes.

  3. Téléchargez le package CLI DIRCTL .zip pour Windows.
  4. Extrayez le contenu dans un répertoire préféré sur votre ordinateur local.
  5. Ouvrez un terminal sur Windows.
  6. Accédez au répertoire DIRCTL extrait.
  7. Utilisez la commande <path-to-dirctl> cd pour accéder au dossier.
  8. Exécutez des commandes à l’aide ./de DIRCTL '''.

configuration Linux pour l’interface CLI DIRCTL

  1. Téléchargez et installez l’interface CLI kubectl pour votre distribution Linux.
  2. Placez le fichier kubeconfig, pour l’authentification auprès de Kubernetes, dans le dossier kube par défaut : ~/.kube/.
  3. Copiez votre fichier kubeconfig généré dans le répertoire spécifique à l’utilisateur. Vérifiez que le fichier est nommé config : mkdir -p ~/.kube cp /path/to/your/kubeconfig ~/.kube/config

    Remarque

    Ce fichier de configuration est requis pour l’authentification DIRCTL sur les clusters Kubernetes.

  4. Téléchargez le package CLI DIRCTL pour Windows ou Linux.
  5. Ouvrez un terminal et accédez au répertoire DIRCTL : cd /your/target/directory/DIRCTL
  6. Exécutez des commandes à l’aide de : ./DIRCTL .

Commandes DIRCTL

  1. Aide de DIRCTL : la commande Aide fournit une vue d’ensemble complète de toutes les commandes et fonctionnalités disponibles dans l’outil DIRCTL. Il garantit que vous pouvez utiliser l’outil efficacement en fournissant des conseils et un contexte pour vos tâches d’intégration de données.

  2. Réinscrire DIRCTL : ./DIRCTL re-register –registration-key <re-registration-key-value> utilisez la commande Réinscrire pour réinscrire une ressource de runtime d’intégration de données existante, si elle est inactive pendant une longue période, à l’aide d’une nouvelle clé d’inscription.

  3. DIRCTL Delete : ./DIRCTL delete lorsque vous souhaitez désinscrire un runtime d’intégration de données du système et libérer tous les pods Kubernetes d’application associés, la commande Delete fournit une solution simplifiée. Cette commande supprime complètement le DIR du SQL Server Data Quality Services (DQS), en veillant à ce qu’il ne reste aucun reste du runtime ou de ses pods d’application. La commande gère également l’arrêt de tous les pods Kubernetes en cours d’exécution associés à l’application DIR, ce qui libère des ressources au sein du système.

  4. Mise à niveau DIRCTL : ./DIRCTL upgrade –v <image version> la commande Mettre à niveau vous permet de mettre à niveau en toute transparence la version d’un runtime d’intégration de données vers la dernière version disponible spécifiée par l’utilisateur. Ce processus garantit que le runtime d’intégration de données fonctionne avec les fonctionnalités, améliorations et correctifs de sécurité les plus à jour, tout en conservant sa compatibilité et son efficacité au sein du système.

  5. DIRCTL Décrire : ./DIRCTL describe La commande Describe fournit des informations détaillées sur la status et les performances des applications DIR et DIRCTL en cours d’exécution. Il vérifie l’intégrité des pods d’application, en s’assurant que les problèmes ou anomalies sont rapidement identifiés. En offrant une visibilité sur l’environnement d’exécution, cette fonctionnalité prend en charge la résolution des problèmes et la maintenance proactive du système.

  6. Journal DIRCTL : ./DIRCTL log download –d <relative-destination-folder-path> utilisez la commande Log pour télécharger les journaux de tous les pods d’application du runtime d’intégration de données actifs dans un chemin d’accès de dossier de destination spécifié. Cette fonctionnalité est particulièrement essentielle pour le débogage, l’analyse des performances ou les activités d’audit, car elle vous garantit l’accès à des enregistrements d’exécution détaillés. En conservant des journaux complets, vous pouvez identifier efficacement les modèles, les anomalies et les problèmes potentiels, ce qui en fait un outil clé dans la maintenance et l’optimisation du système.

  7. Configuration DIRCTL : ./DIRCTL config auto-update-enable <true/false> Mettez à jour la configuration de l’activation automatique de la mise à jour sur false ou true.