Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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.comAzure Government: *.compute.governance.azure.usChina: *.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 initpara 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.
- Si usa
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:
Descomprime y abre la carpeta de herramientas.
Muévalo a una ubicación del equipo donde pueda acceder a él desde la línea de comandos.
Abra la línea de comandos y vaya a la carpeta donde se hospeda la aplicación IRCTL.
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. |