Configuración de la herramienta DIRCTL para el entorno de ejecución de integración autohospedado (versión preliminar)

La línea de comandos de Data Integration Runtime (DIRCTL) es . Herramienta de interfaz de línea de comandos (CLI) basada en NET que automatiza la administración del entorno de ejecución de integración de datos en clústeres de Kubernetes. Simplifica las operaciones complejas de Kubernetes con comandos sencillos y garantiza una comunicación segura con Microsoft Purview para la administración del ciclo de vida de registros y tokens.

Para administrar el entorno de ejecución de integración de datos autohospedado de Kubernetes de Microsoft Purview localmente, necesita la herramienta de línea de comandos DIRCTL. Puede descargar esta herramienta durante el proceso de creación del entorno de ejecución de integración de datos. Consulte las instrucciones de instalación siguientes para Windows y Linux sistemas operativos.

Configuración de Windows para la CLI de DIRCTL

  1. Descargue e instale la herramienta de la CLI de Kubectl.
  2. Coloque el archivo de configuración de kube generado en la carpeta específica del usuario según esta ruta de acceso: C:/Users/<user-folder>/.kube/. Copie el archivo y asígnele el nombre config.

    Nota:

    Este archivo de configuración es necesario para la autenticación DIRCTL en clústeres de Kubernetes.

  3. Descargue el paquete de la CLI de DIRCTL .zip para Windows.
  4. Extraiga el contenido en un directorio preferido en el equipo local.
  5. Abra un terminal en Windows.
  6. Vaya al directorio DIRCTL extraído.
  7. Use el comando <path-to-dirctl> cd para moverse a la carpeta.
  8. Ejecute comandos mediante ./DIRCTL'''.

configuración de Linux para la CLI de DIRCTL

  1. Descargue e instale la CLI de kubectl para la distribución de Linux.
  2. Coloque el archivo kubeconfig, para la autenticación en Kubernetes, en la carpeta kube predeterminada: ~/.kube/.
  3. Copie el archivo kubeconfig generado en el directorio específico del usuario. Asegúrese de que el archivo se denomina config: mkdir -p ~/.kube cp /path/to/your/kubeconfig ~/.kube/config

    Nota:

    Este archivo de configuración es necesario para la autenticación DIRCTL en clústeres de Kubernetes.

  4. Descargue el paquete de la CLI de DIRCTL para Windows o Linux.
  5. Abra un terminal y vaya al directorio DIRCTL: cd /your/target/directory/DIRCTL
  6. Ejecute comandos mediante: ./DIRCTL .

Comandos DIRCTL

  1. Ayuda de DIRCTL: el comando Ayuda proporciona una visión general completa de todos los comandos y funcionalidades disponibles dentro de la herramienta DIRCTL. Garantiza que puede usar la herramienta de forma eficaz proporcionando orientación y contexto para las tareas de integración de datos.

  2. Volver a registrar DIRCTL: ./DIRCTL re-register –registration-key <re-registration-key-value> use el comando Volver a registrar para volver a registrar un recurso de Data Integration Runtime existente, si está inactivo durante mucho tiempo, mediante una nueva clave de registro.

  3. Eliminación de DIRCTL: ./DIRCTL delete si desea anular el registro de un entorno de ejecución de integración de datos del sistema y liberar todos los pods de Kubernetes de la aplicación asociada, el comando Eliminar proporciona una solución simplificada. Este comando quita por completo el DIR de SQL Server Data Quality Services (DQS), lo que garantiza que no quede ningún resto del tiempo de ejecución ni de sus pods de aplicación. El comando también controla la terminación de todos los pods de Kubernetes en ejecución asociados a la aplicación DIR, liberando recursos dentro del sistema.

  4. Actualización de DIRCTL: ./DIRCTL upgrade –v <image version> el comando Actualizar permite actualizar sin problemas la versión de un entorno de ejecución de integración de datos a la versión más reciente disponible especificada por el usuario. Este proceso garantiza que el entorno de ejecución de integración de datos funcione con las características, mejoras y revisiones de seguridad más actualizadas, manteniendo su compatibilidad y eficacia dentro del sistema.

  5. DIRCTL Describir: ./DIRCTL describe El comando Describir proporciona información detallada sobre el estado y el rendimiento de las aplicaciones DIR y DIRCTL en ejecución. Comprueba el estado de los pods de aplicación, lo que garantiza que se identifiquen rápidamente los problemas o anomalías. Al ofrecer visibilidad en el entorno en tiempo de ejecución, esta funcionalidad admite la solución de problemas y el mantenimiento proactivo del sistema.

  6. Registro DIRCTL: ./DIRCTL log download –d <relative-destination-folder-path> use el comando Log para descargar los registros de todos los pods de aplicación de integration runtime de datos activos en una ruta de acceso de carpeta de destino especificada. Esta funcionalidad es especialmente vital para la depuración, la supervisión del rendimiento o las actividades de auditoría, ya que garantiza que tiene acceso a registros detallados en tiempo de ejecución. Al conservar registros completos, puede identificar de forma eficaz patrones, anomalías y posibles problemas, lo que lo convierte en una herramienta clave en el mantenimiento y la optimización del sistema.

  7. Configuración de DIRCTL: ./DIRCTL config auto-update-enable <true/false> actualice la configuración de auto-update-enable a false o true.

  • Last updated on