Freigeben über

IRCTL für Kubernetes unterstützte selbstgehostete Integration Runtime

  • Artikel

Um Ihre Microsoft Purview Kubernetes SHIR lokal zu verwalten, benötigen Sie ein Befehlszeilentool namens IRCTL. Sie können dieses Tool während des SHIR-Erstellungsprozesses herunterladen. IRCTL ist ein Befehlszeilentool zum Verwalten Ihrer Microsoft Purview SHIR.

Voraussetzungen

Die Systemanforderungen für IRCTL sind:

  • Computer, auf dem IRCTL ausgeführt wird : Das Betriebssystem ist Linux oder Windows, das TLS 1.2 unterstützt
  • Der Computer zum Ausführen von IRCTL sollte in der Lage sein, eine Verbindung mit den folgenden Endpunkten herzustellen:
Domänenname Ausgehende Ports Beschreibung
Öffentliche Cloud: *.compute.governance.azure.com
Azure Government:*.compute.governance.azure.us
China: *.compute.governance.azure.cn		 443 Erforderlich, um eine Verbindung mit dem Microsoft Purview-Dienst herzustellen. Wenn Sie private Microsoft Purview-Endpunkte verwenden, wird dieser Endpunkt vom privaten Endpunkt des Kontos abgedeckt.
  • Kubernetes-Kontext: Kubernetes-Kontext, der Kubernetes-Clusterinformationen sowie Berechtigungen und Anmeldeinformationen des Benutzers für diesen Cluster enthält, ist für die Kommunikation mit Ihrem Kubernetes-Cluster erforderlich. Um die Konfiguration der Benutzerberechtigungen für die SHIR-Verwaltung zu vereinfachen, können Sie mit Kubernetes Admin Rolle beginnen. Dieser Kontext wird beim Einrichten Ihres Kubernetes-Clusters generiert und in einer Konfigurationsdatei gespeichert. Wo und wie Sie diese Datei abrufen können, hängt von Ihrer Einrichtung des Kubernetes-Clusters ab.
    • Wenn Sie zum Einrichten des Kubernetes-Clusters verwenden kubeadm init , finden Sie die Konfigurationsdatei unter /etc/Kubernetes/admin.conf.
    • Wenn Sie AKS verwenden, können Sie die Anleitung von AKS befolgen, um den Az PowerShell-Modulbefehl zu verwenden, um Anmeldeinformationen für diesen Cluster auf Ihrem lokalen Computer abzurufen. Der Kontext kann direkt mit der Konfigurationsdatei unter $HOME/.kube/config zusammengeführt werden.
    • Wenn Sie andere Tools zum Einrichten eines Kubernetes-Clusters verwenden, lesen Sie die Kubernetes-Dokumentation.
    • Da Sie über die Konfigurationsdatei des Kubernetes-Kontexts verfügen, führen Sie sie mit der Konfigurationsdatei auf dem Computer zusammen, $HOME/.kube/configauf dem Sie den IRCTL-Befehl ausführen möchten. Alternativ können Sie die Konfigurationsdatei des Kubernetes-Kontexts auch in einer Umgebungsvariablen namens KUBECONFIG festlegen. Weitere Informationen zum Kubernetes-Kontext finden Sie unter Konfigurieren des Zugriffs auf mehrere Cluster.

Installieren und Ausführen von IRCTL

Um eine von Kubernetes unterstützte selbstgehostete Integration Runtime zu steuern und zu verwalten, können Benutzer ein Befehlszeilentool namens IRCTL herunterladen. Benutzer können die status auch über IRCTL und kubectl-Befehlszeile im Portal überwachen. Im Folgenden finden Sie die Schritte zur von Kubernetes unterstützten selbstgehosteten Integration Runtime.

Herunterladen der neuesten IRCTL für Windows

Bestimmte Version

Um eine bestimmte Version der IRCTL herunterzuladen, ändern Sie das Versionssegment in der URL: https://aka.ms/purview-irctl/irctl-windows-<version>.tar.gz

Beispiel für Version 1.0.0: https://aka.ms/purview-irctl/irctl-windows-1.0.0.tar.gz

Verfügbare IRCTL-Versionen finden Sie in den IRCTL-Versionshinweisen.

Nachdem Sie das Tool heruntergeladen haben:

  1. Entzippen Sie den Toolordner, und öffnen Sie diesen.

  2. Verschieben Sie sie an einen Speicherort auf Ihrem Computer, an dem Sie über die Befehlszeile darauf zugreifen können.

  3. Öffnen Sie die Befehlszeile, und navigieren Sie zu dem Ordner, in dem sich die IRCTL-Anwendung befindet.

  4. Verwenden Sie die folgenden Befehle, um mit IRCTL zu interagieren, und führen Sie die folgenden Schritte aus, um eine von Kubernetes unterstützte Integration Runtime zu installieren.

IRCTL-Befehlsdetails

Sie können das IRCTL-Befehlszeilentool aus Ihren Integration Runtime-Einstellungen in Microsoft Purview herunterladen. Wählen Sie Ihre Integration Runtime aus, und unter Einstellungen wird der Link IRCTL herunterladen und Integration Runtime installieren angezeigt. Wählen Sie es aus, um das Tool herunterzuladen.

Sie können die IRCTL-Befehlszeile verwenden, um eine von Kubernetes unterstützte selbstgehostete Integration Runtime einzurichten oder zu verwalten. Verwenden Sie diese Syntax, um IRCTL-Befehle aus Ihrem Terminalfenster auszuführen:

./irctl [command][flags]...
  • Der Befehl gibt den Vorgang an, den Sie ausführen möchten.
  • Flags gibt Parameter für den Vorgang an.
Befehl Beschreibung
config Verwaltet IRCTL-Konfigurationen
create Erstellen einer neuen SHIR-Ressource
löschen Löschen einer SHIR-Ressource
beschreiben Beschreibt die SHIR, die im Kubernetes-Cluster ausgeführt wird.
Hilfe Enthält Hilfe zu beliebigen Befehlen.
Lagerung Verwalten des für SHIR reservierten lokalen Speichers
Log Verwalten von Protokollen von SHIR
upgrade Aktualisieren einer SHIR auf dieselbe Version mit IRCTL

Konfiguration

Verwalten von IRCTL-Konfigurationen

./irctl config [flags]
./irctl config [command]
Befehl Beschreibung
set Ändern Sie eine SHIR-Konfiguration.
Ansicht Zeigen Sie alle SHIR-Konfigurationen an.
Flag Parametertyp Beschreibung
-h,--help Hilfe zur Konfiguration

Konfigurationssatz

Ändern Sie eine Konfiguration der selbstgehosteten Integration Runtime.

./irctl config set <config-name> <config-value> [flags]
Flag Parametertyp Beschreibung
-c, --context string Name des Kubernetes-Kontexts, der verwendet werden soll, wenn er nicht angegeben wird, wird der aktuelle Kontext der Kube-Konfiguration verwendet.
-h,--help Hilfe zur Konfiguration

Konfigurationsansicht

Zeigen Sie alle SHIR-Konfigurationen an.

./irctl
Flag Parametertyp Beschreibung
-c, --context string Name des Kubernetes-Kontexts, der verwendet werden soll, wenn er nicht angegeben wird, wird der aktuelle Kontext der Kube-Konfiguration verwendet.
-h,--help Hilfe zur Konfiguration

Zulässige SHIR-Konfigurationen

Konfigurationsname Konfigurationstyp Gültige Werte Standardwert (Wert nicht festgelegt) Beschreibung Wird durch Neuinstallation beibehalten.
autoUpdate.enabled Boolesch true/false true Steuert, ob die aktuelle SHIR automatisch aktualisiert werden soll. Ja

Erstellen

Erstellen Sie eine neue SHIR-Ressource.

./irctl create [flags]
Flag Parametertyp Beschreibung
-c,--context string Name des Kubernetes-Kontexts, der verwendet werden soll. Wenn nicht angegeben, wird der aktuelle Kontext der Kube-Konfiguration verwendet.
-h,--help Hilfe zum Erstellen
-r,--registration-key string Schlüssel zum Registrieren von SHIR
-s,--selector string Knotenauswahl (Bezeichnungsabfrage), nach der gefiltert werden soll, unterstützt "=". (beispiel,--selector key1=value1,key2=value2) Wählen Sie Knoten nach bestimmten Bezeichnungen aus, auf denen SHIR ausgeführt werden soll. Der Standardwert ist leer, was bedeutet, dass SHIR auf allen Knoten ausgeführt wird.

Beispiel:

./irctl create --registration-key 1234@keyvalue

Upgraden

Aktualisieren Sie eine SHIR mit IRCTL auf die gleiche Version.

./irctl upgrade [flags]
./irctl upgrade [command]
Befehl Beschreibung
status Überwacht die status das neueste SHIR-Upgrade.
Flag Parametertyp Beschreibung
-c,--context string Name des Kubernetes-Kontexts, der verwendet werden soll. Wenn nicht angegeben, wird der aktuelle Kontext der Kube-Konfiguration verwendet.
-h,--help Hilfe zum Upgrade

Löschen

Löschen sie eine SHIR-Ressource.

./irctl delete [flags]
Flag Parametertyp Beschreibung
-c,--context string Name des Kubernetes-Kontexts, der verwendet werden soll. Wenn nicht angegeben, wird der aktuelle Kontext der Kube-Konfiguration verwendet.
-h,--help Hilfe zum Löschen

Beschreiben

Beschreiben der SHIR-Ausführung im Kubernetes-Cluster

./irctl describe [flags]
Flag Parametertyp Beschreibung
-c,--context string Name des Kubernetes-Kontexts, der verwendet werden soll. Wenn nicht angegeben, wird der aktuelle Kontext der Kube-Konfiguration verwendet.
-h,--help Hilfe zum Beschreiben

Speicher

Verwalten von Dateien im freigegebenen SHIR-Speicher.

./irctl storage [flags]
./irctl storage [command]
Befehl Beschreibung
Hochladen Laden Sie Dateien in den freigegebenen SHIR-Speicher hoch.
list Auflisten von Dateien im freigegebenen SHIR-Speicher.
löschen Löschen Sie Dateien im freigegebenen SHIR-Speicher.
Flag Parametertyp Beschreibung
-h,--help Hilfe zum Speicher

Speicherupload

Laden Sie Dateien in den freigegebenen SHIR-Speicher hoch.

./irctl storage upload -s <source> -d <destination> [flags]
Flag Parametertyp Beschreibung
-c,--context string Name des Kubernetes-Kontexts, der verwendet werden soll, wenn er nicht angegeben wird, wird der aktuelle Kontext der Kube-Konfiguration verwendet.
-d,--destination string string Pfad zum Speichern der Datei/des Ordners, die in den freigegebenen SHIR-Speicher hochgeladen wurde.
-h,--help Hilfe zum Löschen
-s,--source string Pfad zu der Datei/dem Ordner, die hochgeladen werden soll.

Speicherliste

Auflisten von Dateien im freigegebenen SHIR-Speicher.

./irctl storage list <path> [flags]
Flag Parametertyp Beschreibung
-c,--context string Name des Kubernetes-Kontexts, der verwendet werden soll, wenn er nicht angegeben wird, wird der aktuelle Kontext der Kube-Konfiguration verwendet.
-h,--help Hilfe zur Liste.

Speicherlöschung

Löschen Sie Dateien im freigegebenen SHIR-Speicher.

./irctl storage delete <path> [flags]
Flag Parametertyp Beschreibung
-c,--context string Name des Kubernetes-Kontexts, der verwendet werden soll, wenn er nicht angegeben wird, wird der aktuelle Kontext der Kube-Konfiguration verwendet.
-h,--help Hilfe zum Löschen.

Protokoll

Protokollvorgänge aus SHIR.

./irctl log [flags]
./irctl log [command]
Befehl Beschreibung
Hochladen Laden Sie Protokolle aus SHIR hoch.
herunterladen Laden Sie Protokolle von SHIR herunter.
Flag Parametertyp Beschreibung
-h,--help Hilfe zum Protokoll.

Protokollupload

Laden Sie Protokolle aus SHIR hoch.

./irctl log upload [flags]
./irctl log upload [command]
Befehl Beschreibung
Status Überwacht die status des SHIR-Protokolluploads.
Flag Parametertyp Beschreibung
-c,--context string Name des Kubernetes-Kontexts, der verwendet werden soll, wenn er nicht angegeben wird, wird der aktuelle Kontext der Kube-Konfiguration verwendet.
-h,--help Hilfe zum Hochladen.
-t,--timeout int Timeout für den Protokolluploadvorgang in Sekunden: [900, 3600]. Der Standardwert ist 900 Sekunden. (Standardwert 900)

Protokolldownload

Laden Sie Protokolle aus SHIR hoch.

./irctl log download [flags]
Flag Parametertyp Beschreibung
-c,--context string Name des Kubernetes-Kontexts, der verwendet werden soll, wenn er nicht angegeben wird, wird der aktuelle Kontext der Kube-Konfiguration verwendet.
-d,--destination string Lokaler Pfad zum Speichern von Protokollen, die von SHIR heruntergeladen wurden.
-h,--help Hilfe zum Download.

Nächste Schritte