Partager via

IRCTL pour Kubernetes pris en charge par le runtime d’intégration auto-hébergé

  • Article

Pour gérer votre SHIR Kubernetes Microsoft Purview localement, vous avez besoin d’un outil en ligne de commande nommé IRCTL. Vous pouvez télécharger cet outil pendant le processus de création de SHIR. IRCTL est un outil en ligne de commande qui permet de gérer votre SHIR Microsoft Purview.

Configuration requise

La configuration système requise pour IRCTL est la suivante :

  • Machine exécutant IRCTL : le système d’exploitation est Linux ou Windows prenant en charge TLS 1.2
  • La machine à exécuter IRCTL doit être en mesure de se connecter aux points de terminaison suivants :
Nom du domaine Ports sortants Description
Cloud public : *.compute.governance.azure.com
Azure Government :*.compute.governance.azure.us
Chine: *.compute.governance.azure.cn		 443 Requis pour se connecter au service Microsoft Purview. Si vous utilisez des points de terminaison privés Microsoft Purview, ce point de terminaison est couvert par un point de terminaison privé de compte.
  • Contexte Kubernetes : le contexte Kubernetes, qui contient des informations sur le cluster Kubernetes et les autorisations et informations d’identification de l’utilisateur pour ce cluster, est nécessaire pour communiquer avec votre cluster Kubernetes. Pour faciliter la configuration des autorisations de l’utilisateur pour la gestion SHIR, vous pouvez commencer par Kubernetes Administration rôle. Ce contexte est généré avec la configuration de votre cluster Kubernetes et enregistré dans un fichier de configuration. L’emplacement et la façon dont vous pouvez obtenir ce fichier dépendent de votre configuration du cluster Kubernetes.
    • Si vous utilisez kubeadm init pour configurer le cluster Kubernetes, vous trouverez le fichier de configuration sous /etc/Kubernetes/admin.conf.
    • Si vous utilisez AKS, vous pouvez suivre les instructions d’AKS pour utiliser la commande du module Az PowerShell pour obtenir les informations d’identification de ce cluster sur votre ordinateur local. Le contexte peut être fusionné dans le fichier de configuration sous $HOME/.kube/config directement.
    • Si vous utilisez d’autres outils pour configurer un cluster Kubernetes, reportez-vous à la documentation Kubernetes.
    • Comme vous avez le fichier de configuration du contexte Kubernetes, fusionnez-le avec le fichier config, qui est $HOME/.kube/config, sur l’ordinateur que vous souhaitez exécuter la commande IRCTL. Vous pouvez également définir le fichier de configuration du contexte Kubernetes dans une variable d’environnement nommée KUBECONFIG. Pour plus d’informations sur le contexte Kubernetes, consultez Configurer l’accès à plusieurs clusters.

Installer et exécuter IRCTL

Pour contrôler et gérer un runtime d’intégration auto-hébergé pris en charge par Kubernetes, les utilisateurs peuvent télécharger un outil en ligne de commande nommé IRCTL. Les utilisateurs peuvent également surveiller les status sur le portail par la ligne de commande IRCTL et kubectl. Voici les étapes de votre runtime d’intégration auto-hébergé pris en charge par Kubernetes.

Télécharger la dernière version d’IRCTL pour Windows

Version spécifique

Pour télécharger une version spécifique de l’IRCTL, modifiez le segment de version dans l’URL : https://aka.ms/purview-irctl/irctl-windows-<version>.tar.gz

Par exemple pour la version 1.0.0 : https://aka.ms/purview-irctl/irctl-windows-1.0.0.tar.gz

Les versions d’IRCTL disponibles sont disponibles dans les notes de publication d’IRCTL.

Après avoir téléchargé l’outil :

  1. Décompressez et ouvrez le dossier d’outils.

  2. Déplacez-le vers un emplacement sur votre ordinateur où vous pouvez y accéder à partir de la ligne de commande.

  3. Ouvrez la ligne de commande et accédez au dossier dans lequel l’application IRCTL est hébergée.

  4. Utilisez les commandes ci-dessous pour interagir avec IRCTL et suivez ces étapes pour installer un runtime d’intégration pris en charge par Kubernetes.

Détails de la commande IRCTL

Vous pouvez télécharger l’outil en ligne de commande IRCTL à partir de vos paramètres de runtime d’intégration dans Microsoft Purview. Sélectionnez votre runtime d’intégration et sous Paramètres , vous pouvez voir le lien Télécharger IRCTL et installer le runtime d’intégration . Sélectionnez-le pour télécharger l’outil.

Vous pouvez utiliser la ligne de commande IRCTL pour configurer ou gérer un runtime d’intégration auto-hébergé pris en charge par Kubernetes. Utilisez cette syntaxe pour exécuter des commandes IRCTL à partir de votre fenêtre de terminal :

./irctl [command][flags]...
  • La commande spécifie l’opération que vous souhaitez effectuer
  • Flags spécifie les paramètres de l’opération
Command Description
config Gère les configurations IRCTL
créer Créer une ressource SHIR
supprimer Supprimer une ressource SHIR
décrire Décrit le SHIR en cours d’exécution sur le cluster Kubernetes
Aide Fournit de l’aide sur n’importe quelle commande
stockage Gérer le stockage local réservé pour SHIR
rapport Gérer les journaux d’activité de SHIR
mise à niveau Mettre à niveau un SHIR vers la même version avec IRCTL

Configuration

Gérer les configurations IRCTL.

./irctl config [flags]
./irctl config [command]
Command Description
set Modifier une configuration SHIR.
view Affichez toutes les configurations SHIR.
Flag Type de paramètre Description
-h,--help Aide pour la configuration

Jeu de configurations

Modifier une configuration du runtime d’intégration auto-hébergé.

./irctl config set <config-name> <config-value> [flags]
Flag Type de paramètre Description
-c, --context string Nom du contexte Kubernetes à utiliser, s’il n’est pas spécifié, le contexte actuel de la configuration Kube sera utilisé.
-h,--help Aide pour la configuration

Vue de configuration

Affichez toutes les configurations SHIR.

./irctl
Flag Type de paramètre Description
-c, --context string Nom du contexte Kubernetes à utiliser, s’il n’est pas spécifié, le contexte actuel de la configuration Kube sera utilisé.
-h,--help Aide pour la configuration

Configurations SHIR autorisées

Nom de la configuration Type de configuration Valeurs admises Valeur par défaut (valeur non définie) Description Persistance via la réinstallation
autoUpdate.enabled Boolean vrai/faux true Contrôle si le SHIR actuel doit être mis à jour automatiquement. Oui

Créer

Créez une ressource SHIR.

./irctl create [flags]
Flag Type de paramètre Description
-c,--context string Nom du contexte Kubernetes à utiliser, s’il n’est pas spécifié, le contexte actuel de la configuration Kube sera utilisé
-h,--help Aide pour la création
-r,--registration-key string Clé pour inscrire SHIR
-s,--selector string Le sélecteur de nœud (requête d’étiquette) sur lequel filtrer prend en charge '='. (par exemple,--selector key1=value1,key2=value2) Sélectionnez les nœuds par étiquettes données sur lesquelles SHIR s’exécute. La valeur par défaut est vide, ce qui signifie que SHIR s’exécute sur tous les nœuds.

Exemple :

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

Mise à niveau

Mettez à niveau un SHIR vers la même version avec IRCTL.

./irctl upgrade [flags]
./irctl upgrade [command]
Command Description
status Surveille la status la dernière mise à niveau de SHIR.
Flag Type de paramètre Description
-c,--context string Nom du contexte Kubernetes à utiliser, s’il n’est pas spécifié, le contexte actuel de la configuration Kube sera utilisé
-h,--help Aide pour la mise à niveau

Supprimer

Supprimer une ressource SHIR.

./irctl delete [flags]
Flag Type de paramètre Description
-c,--context string Nom du contexte Kubernetes à utiliser, s’il n’est pas spécifié, le contexte actuel de la configuration Kube sera utilisé
-h,--help Aide à la suppression

Décrire

Décrire SHIR en cours d’exécution sur le cluster Kubernetes.

./irctl describe [flags]
Flag Type de paramètre Description
-c,--context string Nom du contexte Kubernetes à utiliser, s’il n’est pas spécifié, le contexte actuel de la configuration Kube sera utilisé
-h,--help Aide pour décrire

Stockage

Gérer les fichiers dans le stockage partagé SHIR.

./irctl storage [flags]
./irctl storage [command]
Command Description
charger Charger des fichiers dans le stockage partagé SHIR.
list Répertorier les fichiers dans le stockage partagé SHIR.
supprimer Supprimez des fichiers dans le stockage partagé SHIR.
Flag Type de paramètre Description
-h,--help Aide pour le stockage

Chargement de stockage

Charger des fichiers dans le stockage partagé SHIR.

./irctl storage upload -s <source> -d <destination> [flags]
Flag Type de paramètre Description
-c,--context string Nom du contexte Kubernetes à utiliser, s’il n’est pas spécifié, le contexte actuel de la configuration Kube sera utilisé.
-d,-- chaîne de ladestination string Chemin d’accès au fichier/dossier de stockage chargé dans le stockage partagé SHIR.
-h,--help Aide à la suppression
-s,--source string Chemin du fichier/dossier à charger.

Liste de stockage

Répertorier les fichiers dans le stockage partagé SHIR.

./irctl storage list <path> [flags]
Flag Type de paramètre Description
-c,--context string Nom du contexte Kubernetes à utiliser, s’il n’est pas spécifié, le contexte actuel de la configuration Kube sera utilisé.
-h,--help Aide pour la liste.

Suppression du stockage

Supprimez des fichiers dans le stockage partagé SHIR.

./irctl storage delete <path> [flags]
Flag Type de paramètre Description
-c,--context string Nom du contexte Kubernetes à utiliser, s’il n’est pas spécifié, le contexte actuel de la configuration Kube sera utilisé.
-h,--help Aide pour la suppression.

Log

Journaliser les opérations à partir de SHIR.

./irctl log [flags]
./irctl log [command]
Command Description
charger Chargez les journaux à partir de SHIR.
télécharger Téléchargez les journaux à partir de SHIR.
Flag Type de paramètre Description
-h,--help Aide pour le journal.

Chargement des journaux

Chargez les journaux à partir de SHIR.

./irctl log upload [flags]
./irctl log upload [command]
Command Description
Statut Surveille la status du chargement des journaux SHIR.
Flag Type de paramètre Description
-c,--context string Nom du contexte Kubernetes à utiliser, s’il n’est pas spécifié, le contexte actuel de la configuration Kube sera utilisé.
-h,--help Aide pour le chargement.
-t,--timeout int Délai d’expiration de l’opération de chargement du journal en secondes : [900, 3600]. La valeur par défaut est 900 secondes. (Par défaut, 900)

Téléchargement du journal

Chargez les journaux à partir de SHIR.

./irctl log download [flags]
Flag Type de paramètre Description
-c,--context string Nom du contexte Kubernetes à utiliser, s’il n’est pas spécifié, le contexte actuel de la configuration Kube sera utilisé.
-d,--destination string Chemin d’accès local pour stocker les journaux téléchargés à partir de SHIR.
-h,--help Aide pour le téléchargement.

Étapes suivantes