Compartir a través de

Entorno de ejecución de integración autohospedado compatible con IRCTL para Kubernetes

  • Artículo

Para administrar el SHIR de Microsoft Purview Kubernetes localmente, necesita una herramienta de línea de comandos denominada IRCTL. Puede descargar esta herramienta durante el proceso de creación de SHIR. IRCTL es una herramienta de línea de comandos para administrar su SHIR de Microsoft Purview.

Requisitos previos

Los requisitos del sistema para IRCTL son:

  • Máquina que ejecuta IRCTL : el sistema operativo es Linux o Windows compatible con TLS 1.2
  • La máquina para ejecutar IRCTL debe poder conectarse a los siguientes puntos de conexión:
Nombre de dominio Puertos de salida Descripción
Nube pública: *.compute.governance.azure.com
Azure Government:*.compute.governance.azure.us
China: *.compute.governance.azure.cn		 443 Necesario para conectarse al servicio Microsoft Purview. Si usa puntos de conexión privados de Microsoft Purview, este punto de conexión está cubierto por el punto de conexión privado de la cuenta.
  • Contexto de Kubernetes: el contexto de Kubernetes, que contiene información del clúster de Kubernetes y los permisos y credenciales del usuario para este clúster, es necesario para comunicarse con el clúster de Kubernetes. Para facilitar la configuración de los permisos del usuario para la administración de SHIR, puede empezar con kubernetes Administración rol. Este contexto se genera con la configuración del clúster de Kubernetes y se guarda en un archivo de configuración. Dónde y cómo puede obtener este archivo depende de la configuración del clúster de Kubernetes.
    • Si usa kubeadm init para configurar el clúster de Kubernetes, puede encontrar el archivo de configuración en /etc/Kubernetes/admin.conf.
    • Si usa AKS, puede seguir las instrucciones de AKS para usar el comando az del módulo de PowerShell para obtener las credenciales de este clúster en el equipo local. El contexto se puede combinar con el archivo de configuración en $HOME/.kube/config directamente.
    • Si usa otras herramientas para configurar un clúster de Kubernetes, consulte la documentación de Kubernetes.
    • Como tiene el archivo de configuración del contexto de Kubernetes, combínelo con el archivo de configuración, que es $HOME/.kube/config, en la máquina en la que desea ejecutar el comando IRCTL. También puede establecer el archivo de configuración del contexto de Kubernetes en una variable de entorno denominada KUBECONFIG. Para obtener más información sobre el contexto de Kubernetes, consulte Configuración del acceso a varios clústeres.

Instalación y ejecución de IRCTL

Para controlar y administrar un entorno de ejecución de integración autohospedado compatible con Kubernetes, los usuarios pueden descargar una herramienta de línea de comandos denominada IRCTL. Los usuarios también pueden supervisar el estado en el portal mediante la línea de comandos IRCTL y kubectl. Estos son los pasos para el entorno de ejecución de integración autohospedado compatible con Kubernetes.

Descargar IRCTL más reciente para Windows

Versión específica

Para descargar una versión específica de IRCTL, cambie el segmento de versión en la dirección URL: https://aka.ms/purview-irctl/irctl-windows-<version>.tar.gz

Por ejemplo, para la versión 1.0.0: https://aka.ms/purview-irctl/irctl-windows-1.0.0.tar.gz

Las versiones IRCTL disponibles se pueden encontrar en las notas de la versión de IRCTL.

Después de descargar la herramienta:

  1. Descomprima y abra la carpeta de herramientas.

  2. Muévalo a una ubicación de la máquina donde puede acceder a ella desde la línea de comandos.

  3. Abra la línea de comandos y vaya a la carpeta donde se hospeda la aplicación IRCTL.

  4. Use los siguientes comandos para interactuar con IRCTL y siga estos pasos para instalar un entorno de ejecución de integración compatible con Kubernetes.

Detalles del comando IRCTL

Puede descargar la herramienta de línea de comandos IRCTL desde la configuración del entorno de ejecución de integración en Microsoft Purview. Seleccione el entorno de ejecución de integración y, en Configuración , puede ver el vínculo Descargar IRCTL e instalar integration runtime . Selecciónela para descargar la herramienta.

Puede usar la línea de comandos IRCTL para configurar o administrar un entorno de ejecución de integración autohospedado compatible con Kubernetes. Use esta sintaxis para ejecutar comandos IRCTL desde la ventana del terminal:

./irctl [command][flags]...
  • Comando especifica la operación que desea realizar
  • Flags especifica parámetros para la operación
Comando Descripción
config Administra las configuraciones de IRCTL
crear Creación de un nuevo recurso SHIR
borrar Eliminación de un recurso SHIR
describir Describe el SHIR que se ejecuta en el clúster de Kubernetes.
Ayuda Proporciona ayuda sobre cualquier comando
almacenamiento Administración del almacenamiento local reservado para SHIR
registro Administración de registros de SHIR
actualización Actualización de un SHIR a la misma versión con IRCTL

Configuración

Administrar configuraciones de IRCTL.

./irctl config [flags]
./irctl config [command]
Comando Descripción
set Modifique una configuración de SHIR.
vista Ver todas las configuraciones de SHIR.
Flag Tipo de parámetro Descripción
-h,--help Ayuda para la configuración

Conjunto de configuración

Modifique una configuración del entorno de ejecución de integración autohospedado.

./irctl config set <config-name> <config-value> [flags]
Flag Tipo de parámetro Descripción
-c, --context string Se usará el nombre del contexto de Kubernetes que se usará, si no se especifica, el contexto actual de la configuración de Kube.
-h,--help Ayuda para la configuración

Vista de configuración

Ver todas las configuraciones de SHIR.

./irctl
Flag Tipo de parámetro Descripción
-c, --context string Se usará el nombre del contexto de Kubernetes que se usará, si no se especifica, el contexto actual de la configuración de Kube.
-h,--help Ayuda para la configuración

Configuraciones de SHIR permitidas

Nombre de configuración Tipo de configuración Valores válidos Valor predeterminado (valor sin establecer) Descripción Persiste a través de la reinstalación
autoUpdate.enabled Booleano verdadero/falso true Controla si el SHIR actual debe actualizarse automáticamente. Sí

Crear

Cree un nuevo recurso SHIR.

./irctl create [flags]
Flag Tipo de parámetro Descripción
-c,--context string Se usará el nombre del contexto de Kubernetes para usar, si no se especifica, el contexto actual de la configuración de Kube.
-h,--help Ayuda para crear
-r,--registration-key string Clave para registrar SHIR
-s,--selector string El selector de nodos (consulta de etiquetas) por el que se va a filtrar, admite '='. (por ejemplo,--selector key1=value1,key2=value2) Seleccione los nodos por etiquetas dadas para que SHIR se ejecute. El valor predeterminado está vacío, lo que significa que SHIR se ejecutará en todos los nodos.

Ejemplo:

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

Actualización

Actualice un SHIR a la misma versión con IRCTL.

./irctl upgrade [flags]
./irctl upgrade [command]
Comando Descripción
status Supervisa el estado de la actualización de SHIR más reciente.
Flag Tipo de parámetro Descripción
-c,--context string Se usará el nombre del contexto de Kubernetes para usar, si no se especifica, el contexto actual de la configuración de Kube.
-h,--help Ayuda para la actualización

Eliminar

Elimine un recurso SHIR.

./irctl delete [flags]
Flag Tipo de parámetro Descripción
-c,--context string Se usará el nombre del contexto de Kubernetes para usar, si no se especifica, el contexto actual de la configuración de Kube.
-h,--help Ayuda para eliminar

Describir

Describir SHIR que se ejecuta en el clúster de Kubernetes.

./irctl describe [flags]
Flag Tipo de parámetro Descripción
-c,--context string Se usará el nombre del contexto de Kubernetes para usar, si no se especifica, el contexto actual de la configuración de Kube.
-h,--help Ayuda para describir

Almacenamiento

Administrar archivos en el almacenamiento compartido shir.

./irctl storage [flags]
./irctl storage [command]
Comando Descripción
cargar Cargue archivos en el almacenamiento compartido shir.
list Enumerar archivos en el almacenamiento compartido SHIR.
borrar Eliminar archivos en el almacenamiento compartido shir.
Flag Tipo de parámetro Descripción
-h,--help Ayuda para el almacenamiento

Carga de almacenamiento

Cargue archivos en el almacenamiento compartido shir.

./irctl storage upload -s <source> -d <destination> [flags]
Flag Tipo de parámetro Descripción
-c,--context string Se usará el nombre del contexto de Kubernetes que se usará, si no se especifica, el contexto actual de la configuración de Kube.
Cadena -d,--destination string Ruta de acceso para almacenar el archivo o la carpeta cargados en el almacenamiento compartido shir.
-h,--help Ayuda para eliminar
-s,--source string Ruta de acceso al archivo o carpeta que se va a cargar.

Lista de almacenamiento

Enumerar archivos en el almacenamiento compartido SHIR.

./irctl storage list <path> [flags]
Flag Tipo de parámetro Descripción
-c,--context string Se usará el nombre del contexto de Kubernetes que se usará, si no se especifica, el contexto actual de la configuración de Kube.
-h,--help Ayuda para la lista.

Eliminación de almacenamiento

Eliminar archivos en el almacenamiento compartido shir.

./irctl storage delete <path> [flags]
Flag Tipo de parámetro Descripción
-c,--context string Se usará el nombre del contexto de Kubernetes que se usará, si no se especifica, el contexto actual de la configuración de Kube.
-h,--help Ayuda para eliminar.

Log

Operaciones de registro desde SHIR.

./irctl log [flags]
./irctl log [command]
Comando Descripción
cargar Carga de registros desde SHIR.
descargar Descargue los registros de SHIR.
Flag Tipo de parámetro Descripción
-h,--help Ayuda para el registro.

Carga de registros

Carga de registros desde SHIR.

./irctl log upload [flags]
./irctl log upload [command]
Comando Descripción
Estado Supervisa el estado de la carga del registro shir.
Flag Tipo de parámetro Descripción
-c,--context string Se usará el nombre del contexto de Kubernetes que se usará, si no se especifica, el contexto actual de la configuración de Kube.
-h,--help Ayuda para la carga.
-t,--timeout Entero Tiempo de espera para la operación de carga de registros en segundos: [900, 3600]. El valor predeterminado es 900 segundos. (Valor predeterminado 900)

Descarga de registros

Carga de registros desde SHIR.

./irctl log download [flags]
Flag Tipo de parámetro Descripción
-c,--context string Se usará el nombre del contexto de Kubernetes que se usará, si no se especifica, el contexto actual de la configuración de Kube.
-d,--destinación string Ruta de acceso local para almacenar los registros descargados de SHIR.
-h,--help Ayuda para la descarga.

Pasos siguientes