IRCTL para Kubernetes admite el entorno de ejecución de integración autohospedado

Importante

Se retirarán el Catálogo unificado de Microsoft Purview y las funcionalidades clásicas de gobierno de datos de Microsoft Purview (anteriormente Azure Purview). Microsoft está consolidando sus capacidades de gobernanza de datos en Microsoft Fabric. Ya no puede crear cuentas nuevas y las funcionalidades existentes permanecerán en modo de mantenimiento hasta el 12 de noviembre de 2027. Para conocer los plazos de retirada, las instrucciones de transición y los próximos pasos recomendados, consulte el anuncio de retirada de la gobernanza de datos de Microsoft Purview.

Para administrar el SHIR de Kubernetes de Microsoft Purview 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 el 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 que ejecute IRCTL debe poder conectarse a los siguientes puntos de conexión:
Nombre de dominio Puertos de salida Description
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 permisos y credenciales de 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 comenzar con el rol de Administración de Kubernetes. 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 PowerShell module para obtener las credenciales de este clúster en la máquina local. El contexto se puede combinar con el archivo de configuración directamente $HOME/.kube/config .
    • 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. O bien, 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.

Instalar y ejecutar 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. A continuación se indican los pasos para crear un entorno de ejecución de integración autohospedado compatible con Kubernetes.

Versión específica

Para descargar una versión específica del 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 disponibles de IRCTL se pueden encontrar en las notas de la versión de IRCTL.

Después de descargar la herramienta:

  1. Descomprime y abre la carpeta de herramientas.

  2. Muévalo a una ubicación del equipo donde pueda acceder a él 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 de Integration Runtime en Microsoft Purview. Seleccione el entorno de ejecución de integración y, en Configuración , verá el vínculo Descargar IRCTL e instalar entorno de ejecución de integración . Selecciónalo para descargar la herramienta.

Puede usar la línea de comandos de 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 de terminal:

./irctl [command][flags]...
  • El comando especifica la operación que desea realizar
  • Las marcas especifican los parámetros de la operación
Comando Descripción
Origen de Administra configuraciones de IRCTL
crear Creación de un nuevo recurso SHIR
eliminar Eliminar un recurso SHIR
Describir Describe la SHIR que se ejecuta en el clúster de Kubernetes
Ayuda Proporciona ayuda sobre cualquier comando
almacenamiento Administrar el almacenamiento local reservado para SHIR
de registro Gestionar registros de SHIR
actualización Actualizar una SHIR a la misma versión que IRCTL

Origen de

Administre las 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 Description
-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 Description
-c, --context string Nombre del contexto de Kubernetes que se va a usar, si no se especifica, se usa 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 Description
-c, --context string Nombre del contexto de Kubernetes que se va a usar, si no se especifica, se usa el contexto actual de la configuración de Kube.
-h,--help Ayuda para la configuración

Configuraciones de SHIR permitidas

Nombre de la configuración Tipo de configuración Valores válidos Valor predeterminado (valor no establecido) Description Persiste durante la reinstalación
autoUpdate.enabled Booleano verdadero/falso true Controla si el SHIR actual se debe actualizar automáticamente. Sí

Crear

Cree un nuevo recurso SHIR.

./irctl create [flags]
Flag Tipo de parámetro Description
-c,--contexto string Nombre del contexto de Kubernetes que se va a usar, si no se especifica, se usa 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 etiqueta) para filtrar, admite "=". (Por ejemplo,--Selector key1=value1,key2=value2) Seleccione nodos por etiquetas especificadas para que se ejecute SHIR. El valor predeterminado está vacío, lo que significa que SHIR se ejecuta en todos los nodos.

Ejemplo:

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

Actualización

Actualice un SHIR a la misma versión que 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 Description
-c,--contexto string Nombre del contexto de Kubernetes que se va a usar, si no se especifica, se usa el contexto actual de la configuración de Kube
-h,--help Ayuda para la actualización

Eliminar

Eliminar un recurso SHIR.

./irctl delete [flags]
Flag Tipo de parámetro Description
-c,--contexto string Nombre del contexto de Kubernetes que se va a usar, si no se especifica, se usa el contexto actual de la configuración de Kube
-h,--help Ayuda para eliminar

Describir

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

./irctl describe [flags]
Flag Tipo de parámetro Description
-c,--contexto string Nombre del contexto de Kubernetes que se va a usar, si no se especifica, se usa el contexto actual de la configuración de Kube
-h,--help Ayuda para describir

Almacenamiento

Administrar archivos en el almacenamiento compartido de SHIR.

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

Carga de almacenamiento

Cargar archivos en el almacenamiento compartido SHIR.

./irctl storage upload -s <source> -d <destination> [flags]
Flag Tipo de parámetro Description
-c,--contexto string Nombre del contexto de Kubernetes que se va a usar, si no se especifica, se usa el contexto actual de la configuración de Kube.
-d,--cadena de destino string Ruta de acceso para almacenar el archivo/carpeta cargado 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 los archivos en el almacenamiento compartido de SHIR.

./irctl storage list <path> [flags]
Flag Tipo de parámetro Description
-c,--contexto string Nombre del contexto de Kubernetes que se va a usar, si no se especifica, se usa 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 Description
-c,--contexto string Nombre del contexto de Kubernetes que se va a usar, si no se especifica, se usa 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 Cargar registros desde SHIR.
Descargar Descargue registros de SHIR.
Flag Tipo de parámetro Description
-h,--help Ayuda para el registro.

Carga de registros

Cargar 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 Description
-c,--contexto string Nombre del contexto de Kubernetes que se va a usar, si no se especifica, se usa 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 registro en segundos: [900, 3600]. El valor predeterminado es 900 segundos. (Valor predeterminado 900)

Descarga de registros

Cargar registros desde SHIR.

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

Pasos siguientes