Runtime di integrazione self-hosted supportato da IRCTL per Kubernetes

Per gestire microsoft Purview Kubernetes SHIR in locale, è necessario uno strumento da riga di comando denominato IRCTL. È possibile scaricare questo strumento durante il processo di creazione di SHIR. IRCTL è uno strumento da riga di comando per gestire microsoft Purview SHIR.

Prerequisiti

I requisiti di sistema per IRCTL sono:

• Computer che esegue IRCTL : il sistema operativo è Linux o Windows che supporta TLS 1.2
• Il computer per l'esecuzione di IRCTL deve essere in grado di connettersi agli endpoint seguenti:

Nome di dominio	Porte in uscita	Descrizione
Cloud pubblico: *.compute.governance.azure.com Azure per enti pubblici:*.compute.governance.azure.us Cina: *.compute.governance.azure.cn	443	Necessario per connettersi al servizio Microsoft Purview. Se si usano gli endpoint privati di Microsoft Purview, questo endpoint è coperto dall'endpoint privato dell'account.

• Contesto Kubernetes: il contesto Kubernetes, che contiene le informazioni sul cluster Kubernetes e le autorizzazioni e le credenziali dell'utente per questo cluster, è necessario per comunicare con il cluster Kubernetes. Per semplificare la configurazione per le autorizzazioni dell'utente per la gestione SHIR, è possibile iniziare con Kubernetes Amministrazione ruolo. Questo contesto viene generato con l'installazione del cluster Kubernetes e salvato in un file di configurazione. Dove e come è possibile ottenere questo file dipende dalla configurazione del cluster Kubernetes.
  • Se si usa kubeadm init per configurare il cluster Kubernetes, è possibile trovare il file di configurazione in /etc/Kubernetes/admin.conf.
  • Se si usa il servizio Azure Kubernetes, è possibile seguire le indicazioni del servizio Azure Kubernetes per usare il comando del modulo Az PowerShell per ottenere le credenziali di questo cluster nel computer locale. Il contesto può essere unito direttamente al file di configurazione in $HOME/.kube/config .
  • Se si usano altri strumenti per configurare un cluster Kubernetes, vedere la documentazione di Kubernetes.
  • Poiché si dispone del file di configurazione del contesto Kubernetes, unirlo al file di configurazione, ovvero $HOME/.kube/config, nel computer in cui si vuole eseguire il comando IRCTL. In alternativa, è possibile impostare il file di configurazione del contesto Kubernetes anche in una variabile di ambiente denominata KUBECONFIG. Per altre informazioni sul contesto Kubernetes, vedere Configurare l'accesso a più cluster.

Installare ed eseguire IRCTL

Per controllare e gestire un runtime di integrazione self-hosted supportato da Kubernetes, gli utenti possono scaricare uno strumento da riga di comando denominato IRCTL. Gli utenti possono anche monitorare lo stato nel portale tramite la riga di comando IRCTL e kubectl. Di seguito sono riportati i passaggi per il runtime di integrazione self-hosted supportato da Kubernetes.

Windows

Scaricare la versione più recente di IRCTL per Windows

Versione specifica

Per scaricare una versione specifica di IRCTL, modificare il segmento di versione nell'URL: https://aka.ms/purview-irctl/irctl-windows-<version>.tar.gz

Ad esempio, per la versione 1.0.0: https://aka.ms/purview-irctl/irctl-windows-1.0.0.tar.gz

Le versioni IRCTL disponibili sono disponibili nelle note sulla versione di IRCTL.

Linux

wget https://aka.ms/purview-irctl/irctl-linux.tar.gz

Versione specifica

Per scaricare una versione specifica di IRCTL, modificare il segmento di versione nell'URL: https://aka.ms/purview-irctl/irctl-linux-<version>.tar.gz

Ad esempio, per la versione 1.0.0: https://aka.ms/purview-irctl/irctl-linux-1.0.0.tar.gz

Le versioni IRCTL disponibili sono disponibili nelle note sulla versione di IRCTL.

Dopo aver scaricato lo strumento:

1. Decomprimere e aprire la cartella degli strumenti.

2. Spostarlo in una posizione nel computer in cui è possibile accedervi dalla riga di comando.

3. Aprire la riga di comando e passare alla cartella in cui è ospitata l'applicazione IRCTL.

4. Usare i comandi seguenti per interagire con IRCTL e seguire questa procedura per installare un runtime di integrazione supportato da Kubernetes.

Dettagli del comando IRCTL

È possibile scaricare lo strumento da riga di comando IRCTL dalle impostazioni del runtime di integrazione in Microsoft Purview. Selezionare il runtime di integrazione e in Impostazioni è possibile visualizzare il collegamento Scarica IRCTL e installa runtime di integrazione . Selezionarlo per scaricare lo strumento.

È possibile usare la riga di comando IRCTL per configurare o gestire un runtime di integrazione self-hosted supportato da Kubernetes. Usare questa sintassi per eseguire i comandi IRCTL dalla finestra del terminale:

./irctl [command][flags]...

• Il comando specifica l'operazione da eseguire
• I flag specificano i parametri per l'operazione

Comando	Descrizione
config	Gestisce le configurazioni IRCTL
creare	Creare una nuova risorsa SHIR
cancellare	Eliminare una risorsa SHIR
descrivere	Descrive il file SHIR in esecuzione nel cluster Kubernetes
Guida	Fornisce assistenza su qualsiasi comando
immagazzinamento	Gestire l'archiviazione locale riservata per SHIR
registro	Gestire i log di SHIR
aggiornamento	Aggiornare un SHIR alla stessa versione con IRCTL

Configurazione

Gestire le configurazioni IRCTL.

./irctl config [flags]
./irctl config [command]

Comando	Descrizione
mettere	Modificare una configurazione SHIR.
vista	Visualizzare tutte le configurazioni SHIR.

Bandiera	Tipo di parametro	Descrizione
-h,--help		Guida per la configurazione

Set di configurazioni

Modificare una configurazione del runtime di integrazione self-hosted.

./irctl config set <config-name> <config-value> [flags]

Bandiera	Tipo di parametro	Descrizione
-c, --context	stringa	Verrà usato il nome del contesto Kubernetes da usare, se non specificato, il contesto corrente della configurazione di Kube.
-h,--help		Guida per la configurazione

Visualizzazione configurazione

Visualizzare tutte le configurazioni SHIR.

./irctl 

Bandiera	Tipo di parametro	Descrizione
-c, --context	stringa	Verrà usato il nome del contesto Kubernetes da usare, se non specificato, il contesto corrente della configurazione di Kube.
-h,--help		Guida per la configurazione

Configurazioni SHIR consentite

Nome configurazione	Tipo di configurazione	Valori validi	Valore predefinito (valore non impostato)	Descrizione	Persiste tramite reinstallazione
autoUpdate.enabled	Booleano	vero/falso	true	Controlla se l'SHIR corrente deve essere aggiornato automaticamente.	Sì

Creare

Creare una nuova risorsa SHIR.

./irctl create [flags]

Bandiera	Tipo di parametro	Descrizione
-c,--context	stringa	Verrà usato il nome del contesto Kubernetes da usare, se non specificato, il contesto corrente della configurazione di Kube
-h,--help		Guida per la creazione
-r,--registration-key	stringa	Chiave per registrare SHIR
-s,--selector	stringa	Selettore di nodo (query sull'etichetta) per filtrare, supporta '='. (ad esempio,--selector key1=value1,key2=value2) Selezionare i nodi in base alle etichette per SHIR in cui eseguire. Il valore predefinito è vuoto, ovvero SHIR verrà eseguito in tutti i nodi.

Esempio:

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

Aggiornamento

Aggiornare un SHIR alla stessa versione con IRCTL.

./irctl upgrade [flags]
./irctl upgrade [command]

Comando	Descrizione
stato	Monitora lo stato dell'aggiornamento SHIR più recente.

Bandiera	Tipo di parametro	Descrizione
-c,--context	stringa	Verrà usato il nome del contesto Kubernetes da usare, se non specificato, il contesto corrente della configurazione di Kube
-h,--help		Guida per l'aggiornamento

Elimina

Eliminare una risorsa SHIR.

./irctl delete [flags]

Bandiera	Tipo di parametro	Descrizione
-c,--context	stringa	Verrà usato il nome del contesto Kubernetes da usare, se non specificato, il contesto corrente della configurazione di Kube
-h,--help		Guida per l'eliminazione

Descrivere

Descrivere SHIR in esecuzione nel cluster Kubernetes.

./irctl describe [flags]

Bandiera	Tipo di parametro	Descrizione
-c,--context	stringa	Verrà usato il nome del contesto Kubernetes da usare, se non specificato, il contesto corrente della configurazione di Kube
-h,--help		Guida per la descrizione

Archiviazione

Gestire i file nell'archiviazione condivisa SHIR.

./irctl storage [flags]
./irctl storage [command]

Comando	Descrizione
caricare	Caricare i file nell'archiviazione condivisa SHIR.
lista	Elencare i file nell'archiviazione condivisa SHIR.
cancellare	Eliminare i file nell'archiviazione condivisa SHIR.

Bandiera	Tipo di parametro	Descrizione
-h,--help		Guida per l'archiviazione

Caricamento dell'archiviazione

Caricare i file nell'archiviazione condivisa SHIR.

./irctl storage upload -s <source> -d <destination> [flags]

Bandiera	Tipo di parametro	Descrizione
-c,--context	stringa	Verrà usato il nome del contesto Kubernetes da usare, se non specificato, il contesto corrente della configurazione di Kube.
-d,--stringa di destinazione	stringa	Percorso per archiviare il file/cartella caricato nell'archiviazione condivisa SHIR.
-h,--help		Guida per l'eliminazione
-s,--source	stringa	Percorso del file/cartella da caricare.

Elenco di archiviazione

Elencare i file nell'archiviazione condivisa SHIR.

./irctl storage list <path> [flags]

Bandiera	Tipo di parametro	Descrizione
-c,--context	stringa	Verrà usato il nome del contesto Kubernetes da usare, se non specificato, il contesto corrente della configurazione di Kube.
-h,--help		Guida per l'elenco.

Eliminazione dell'archiviazione

Eliminare i file nell'archiviazione condivisa SHIR.

./irctl storage delete <path> [flags]

Bandiera	Tipo di parametro	Descrizione
-c,--context	stringa	Verrà usato il nome del contesto Kubernetes da usare, se non specificato, il contesto corrente della configurazione di Kube.
-h,--help		Guida per l'eliminazione.

Log

Operazioni di log da SHIR.

./irctl log [flags]
./irctl log [command]

Comando	Descrizione
caricare	Caricare i log da SHIR.
scaricare	Scaricare i log da SHIR.

Bandiera	Tipo di parametro	Descrizione
-h,--help		Guida per il log.

Caricamento del log

Caricare i log da SHIR.

./irctl log upload [flags]
./irctl log upload [command]

Comando	Descrizione
Stato	Monitora lo stato del caricamento del log SHIR.

Bandiera	Tipo di parametro	Descrizione
-c,--context	stringa	Verrà usato il nome del contesto Kubernetes da usare, se non specificato, il contesto corrente della configurazione di Kube.
-h,--help		Guida per il caricamento.
-t,--timeout	int	Timeout per l'operazione di caricamento del log in secondi: [900, 3600]. Il valore predefinito è 900 secondi. (Valore predefinito 900)

Download del log

Caricare i log da SHIR.

./irctl log download [flags]

Bandiera	Tipo di parametro	Descrizione
-c,--context	stringa	Verrà usato il nome del contesto Kubernetes da usare, se non specificato, il contesto corrente della configurazione di Kube.
-d,--destinazione	stringa	Percorso locale per archiviare i log scaricati da SHIR.
-h,--help		Guida per il download.

Operazioni successive

• Installare e configurare il runtime di integrazione supportato da kubernetes
• Scegliere la configurazione del runtime di integrazione corretta
• Risolvere i problemi relativi al runtime di integrazione supportato da kubernetes