Compartir a través de

Validador del kit de herramientas de extensibilidad de Microsoft Fabric

El validador del kit de herramientas de extensibilidad de Microsoft Fabric es una herramienta de validación completa para cargas de trabajo de Microsoft Fabric. Ayuda a los publicadores a validar sus cargas de trabajo con respecto a los requisitos de Microsoft Fabric antes de enviarlos para la certificación oficial.

Esta herramienta es la herramienta de validación pública para asociados externos y clientes que desarrollan cargas de trabajo de Fabric.

Información general

La herramienta de validación permite a los creadores de cargas de trabajo validar automáticamente sus cargas de trabajo de Microsoft Fabric. Está diseñado para ayudar a identificar posibles problemas al principio del proceso de desarrollo, lo que hace que el proceso de validación oficial sea más probable que se realice correctamente.

Importante

La validación automática correcta no garantiza el paso de la validación oficial, pero aumenta significativamente la probabilidad de éxito detectando problemas comunes al principio.

Prerrequisitos

  • Node.js (versión 14 o posterior)
  • Cuenta de Microsoft Fabric con acceso a Fabric Workload Hub
  • Chrome/Chromium Browser (para descarga automatizada de manifiestos)
  • Paquete de carga de trabajo creado con el Kit de herramientas de extensibilidad de Microsoft Fabric
  • Carga de trabajo publicada - la carga de trabajo debe publicarse en un arrendatario para iniciar la validación.

Sugerencia

Usa una entidad diferente para la validación que la utilizada para la publicación. Esto le permite experimentar lo que verán los usuarios finales y proporciona un entorno de validación más realista.

Comienza

1. Construir la carga de trabajo

En primer lugar, cree la carga de trabajo con el kit de inicio oficial:

  1. Clone el Kit de herramientas de extensibilidad de Fabric (kit de inicio).
  2. Siga la documentación del kit de herramientas para compilar la carga de trabajo.

2. Instalación de dependencias

Vaya al directorio del validador e instale las dependencias:

cd fabric-extensibility-toolkit-validator/validator
npm install

3. Validación básica

Ejecute una validación completa para la carga de trabajo:

Comando de validación básica

node index.js --workload-name "YourPublisher.YourWorkload" --workload-stage "Preview"

Ejemplo con carga de trabajo real

node index.js --workload-name "Contoso.DataProcessor" --workload-stage "Preview"

Para cargas de trabajo de fase GA

node index.js --workload-name "Contoso.DataProcessor" --workload-stage "GA"

Nota:

Asegúrese de que ha iniciado sesión en Microsoft Fabric en el explorador antes de ejecutar la validación y asegúrese de que la carga de trabajo está publicada y accesible en el inquilino de destino.

Opciones de línea de comandos

Opción Description Example
--workload-name Nombre completo de la carga de trabajo (Publisher.Product) "Contoso.DataProcessor"
--workload-stage Fase de validación "Preview" o "GA"
--help Mostrar información de ayuda (solo indicador)

Proceso de validación

El validador se ejecuta en varias fases:

  1. Descarga del manifiesto : descarga automáticamente el manifiesto de carga de trabajo de Fabric Workload Hub.
  2. Detección de pruebas: identifica los casos de prueba aplicables en función del tipo de carga de trabajo.
  3. Ejecución de pruebas: ejecuta pruebas de validación mediante los validadores configurados (tanto automatizados como manuales).
  4. Generación de informes: crea informes completos en varios formatos.

Estructura de salida

Después de la validación, encontrará resultados en el Results directorio:

Results/
├── YourPublisher.YourWorkload/
│   └── Preview/
│       └── [ValidationID]/
│           ├── YourPublisher.YourWorkload_Metadata.json
│           ├── YourPublisher.YourWorkload_Manifest.json
│           ├── YourPublisher.YourWorkload_Workload_Tests.json
│           ├── YourPublisher.YourWorkload.Item_Item_Tests.json
│           └── Reports/
│               ├── ValidationReport.md
│               ├── ValidationReport.html
│               └── ValidationReport.pdf

Validadores

La herramienta usa un conjunto de validadores especializados para comprobar distintos aspectos de la carga de trabajo. Algunos validadores están automatizados, mientras que otros requieren interacción manual.

Solución de problemas

Problemas del explorador

  • Asegúrese de que Chrome/Chromium está instalado y accesible.
  • Asegúrese de que ha iniciado sesión en Microsoft Fabric en el explorador.
  • Compruebe la conectividad de red con los servicios de Fabric.

Problemas de descarga de manifiestos

  • Compruebe que el nombre de la carga de trabajo coincide exactamente (distingue mayúsculas de minúsculas).
  • Asegúrese de que la carga de trabajo está implementada y accesible en Fabric Workload Hub.
  • Compruebe la autenticación y los permisos.

Problemas de ejecución de pruebas

  • Revise los registros de validación en el directorio Resultados.
  • Consulte la documentación del caso de prueba individual en validator/validators/.
  • Compruebe que se puede acceder a todos los recursos de carga de trabajo necesarios.

Contenido relacionado

  • Last updated on