Einrichten des DIRCTL-Tools für die selbstgehostete Integration Runtime (Vorschau)

Die Data Integration Runtime-Befehlszeile (DIRCTL) ist ein . NET-basiertes Befehlszeilenschnittstellentool (CLI), das die Verwaltung der Datenintegrationslaufzeit in Kubernetes-Clustern automatisiert. Es vereinfacht komplexe Kubernetes-Vorgänge mit einfachen Befehlen und stellt eine sichere Kommunikation mit Microsoft Purview für die Registrierung und Tokenlebenszyklusverwaltung sicher.

Um Ihre selbstgehostete Microsoft Purview Kubernetes-Datenintegrationslaufzeit lokal zu verwalten, benötigen Sie das DIRCTL-Befehlszeilentool. Sie können dieses Tool während des Erstellungsprozesses der Datenintegration Runtime herunterladen. Weitere Informationen finden Sie in den nachstehenden Setupanweisungen für Windows und Linux Betriebssysteme.

Windows-Setup für DIRCTL CLI

  1. Laden Sie das Kubectl CLI-Tool herunter, und installieren Sie es.
  2. Platzieren Sie die generierte kube-Konfigurationsdatei im benutzerspezifischen Ordner gemäß diesem Pfad: C:/Users/<user-folder>/.kube/. Kopieren Sie die Datei, und nennen Sie sie config.

    Hinweis

    Diese Konfigurationsdatei ist für die DIRCTL-Authentifizierung in Kubernetes-Clustern erforderlich.

  3. Laden Sie das DIRCTL CLI-Paket .zip für Windows herunter.
  4. Extrahieren Sie den Inhalt in ein bevorzugtes Verzeichnis auf Ihrem lokalen Computer.
  5. Öffnen Sie ein Terminal unter Windows.
  6. Navigieren Sie zum extrahierten DIRCTL-Verzeichnis.
  7. Verwenden Sie den Befehl <path-to-dirctl> cd, um in den Ordner zu wechseln.
  8. Führen Sie Befehle mit ./DIRCTL''' aus.

Linux setup for DIRCTL CLI

  1. Laden Sie die kubectl CLI für Ihre Linux-Distribution herunter, und installieren Sie sie.
  2. Platzieren Sie die kubeconfig-Datei für die Authentifizierung bei Kubernetes im Kube-Standardordner: ~/.kube/.
  3. Kopieren Sie die generierte kubeconfig-Datei in das benutzerspezifische Verzeichnis. Stellen Sie sicher, dass die Datei config heißt: mkdir -p ~/.kube cp /path/to/your/kubeconfig ~/.kube/config

    Hinweis

    Diese Konfigurationsdatei ist für die DIRCTL-Authentifizierung in Kubernetes-Clustern erforderlich.

  4. Laden Sie das DIRCTL CLI-Paket für Windows oder Linux herunter.
  5. Öffnen Sie ein Terminal, und navigieren Sie zum VERZEICHNIS DIRCTL: cd /your/target/directory/DIRCTL
  6. Führen Sie Befehle mit aus: ./DIRCTL .

DIRCTL-Befehle

  1. DIRCTL-Hilfe: Der Befehl Hilfe bietet eine umfassende Übersicht über alle verfügbaren Befehle und Funktionen im DIRCTL-Tool. Es stellt sicher, dass Sie das Tool effektiv verwenden können, indem Sie Anleitungen und Kontext für Ihre Datenintegrationsaufgaben bereitstellen.

  2. DIRCTL Neu registrieren: ./DIRCTL re-register –registration-key <re-registration-key-value> Verwenden Sie den Befehl Neu registrieren, um eine vorhandene Datenintegrationslaufzeitressource erneut zu registrieren, wenn sie für längere Zeit inaktiv ist, indem Sie einen neuen Registrierungsschlüssel verwenden.

  3. DIRCTL Delete: ./DIRCTL delete Wenn Sie die Registrierung einer Datenintegrationslaufzeit im System aufheben und alle zugehörigen Kubernetes-Anwendungspods freigeben möchten, bietet der Befehl Löschen eine optimierte Lösung. Dieser Befehl entfernt den DIR vollständig aus dem SQL Server Data Quality Services (DQS), wodurch sichergestellt wird, dass keine Reste der Runtime oder der zugehörigen Anwendungspods verbleiben. Der Befehl verarbeitet auch die Beendigung aller ausgeführten Kubernetes-Pods, die der DIR-Anwendung zugeordnet sind, und gibt Ressourcen innerhalb des Systems frei.

  4. DIRCTL-Upgrade: ./DIRCTL upgrade –v <image version> Mit dem Befehl Upgrade können Sie die Version einer Datenintegrationslaufzeit nahtlos auf die neueste verfügbare Version aktualisieren, die vom Benutzer angegeben wurde. Dieser Prozess stellt sicher, dass die Datenintegrationslaufzeit mit den aktuellsten Features, Verbesserungen und Sicherheitspatches arbeitet und die Kompatibilität und Effizienz innerhalb des Systems aufrechterhalten bleibt.

  5. DIRCTL Beschreiben: ./DIRCTL describe Der Befehl Describe bietet detaillierte Einblicke in die status und die Leistung der ausgeführten DIR- und DIRCTL-Anwendungen. Es überprüft die Integrität von Anwendungspods und stellt sicher, dass Probleme oder Anomalien sofort identifiziert werden. Durch die Bereitstellung von Einblicken in die Laufzeitumgebung unterstützt diese Funktion die Problembehandlung und proaktive Systemwartung.

  6. DIRCTL-Protokoll: ./DIRCTL log download –d <relative-destination-folder-path> Verwenden Sie den Befehl Protokoll, um Protokolle aller aktiven Datenintegration Runtime-Anwendungspods in einen angegebenen Zielordnerpfad herunterzuladen. Diese Funktionalität ist besonders wichtig für Das Debuggen, die Leistungsüberwachung oder Überwachungsaktivitäten, da sie sicherstellt, dass Sie Zugriff auf detaillierte Laufzeitdatensätze haben. Durch die Aufbewahrung umfassender Protokolle können Sie Muster, Anomalien und potenzielle Probleme effektiv identifizieren und zu einem wichtigen Tool für die Systemwartung und -optimierung machen.

  7. DIRCTL-Konfiguration: ./DIRCTL config auto-update-enable <true/false> Aktualisieren Sie die Konfiguration für auto-update-enable auf false oder true.

  • Last updated on