Condividi tramite

Validatore del Microsoft Fabric Extensibility Toolkit

Microsoft Fabric Extensibility Toolkit Validator è uno strumento di convalida completo per i carichi di lavoro di Microsoft Fabric. Consente agli editori di convalidare i carichi di lavoro rispetto ai requisiti di Microsoft Fabric prima di inviare la certificazione ufficiale.

Questo strumento è lo strumento di convalida pubblica per partner esterni e clienti che sviluppano carichi di lavoro *Fabric*.

Informazioni generali

Lo strumento di convalida consente agli autori di carichi di lavoro di convalidare automaticamente i carichi di lavoro di Microsoft Fabric. È progettato per identificare i potenziali problemi all'inizio del processo di sviluppo, rendendo più probabile che il processo di convalida ufficiale abbia esito positivo.

Importante

La convalida automatica con esito positivo non garantisce il superamento della convalida ufficiale, ma aumenta significativamente la probabilità di successo intercettando i problemi comuni in anticipo.

Prerequisiti

  • Node.js (versione 14 o successiva)
  • Account di Microsoft Fabric con accesso all'hub di carico di lavoro di Fabric
  • Chrome/Chromium Browser (per il download automatico del manifesto)
  • Pacchetto di carico di lavoro costruito con Microsoft Fabric Extensibility Toolkit
  • Carico di lavoro pubblicato : il carico di lavoro deve essere pubblicato in un tenant prima di poter iniziare la convalida.

Suggerimento

Usare un tenant diverso per la convalida rispetto a quello usato per la pubblicazione. Ciò consente di sperimentare ciò che gli utenti finali vedranno e forniscono un ambiente di convalida più realistico.

Get started

Costruire il tuo carico di lavoro

Prima di tutto, creare il carico di lavoro usando il kit di avvio ufficiale:

  1. Clonare Fabric Extensibility Toolkit (starter kit).
  2. Seguire la documentazione del toolkit per costruire il carico di lavoro.

2. Installare le dipendenze

Navigare alla directory del validatore e installare le dipendenze:

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

3. Convalida di base

Eseguire una convalida completa per il carico di lavoro:

Comando di convalida di base

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

Esempio con carico di lavoro reale

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

Per i carichi di lavoro di livello generale

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

Annotazioni

Assicurarsi di aver eseguito l'accesso a Microsoft Fabric nel browser prima di eseguire la convalida e assicurarsi che il carico di lavoro sia pubblicato e accessibile nel tenant di destinazione.

Opzioni della riga di comando

Opzione Description Example
--workload-name Nome completo del carico operativo (Publisher.Product) "Contoso.DataProcessor"
--workload-stage Fase di convalida "Preview" o "GA"
--help Mostra informazioni di aiuto (solo bandiera)

Processo di convalida

Il validatore si svolge in diverse fasi:

  1. Download manifest - Scarica automaticamente il manifest del carico di lavoro dal Fabric Workload Hub.
  2. Test Discovery — identifica i test case applicabili in base al tipo di carico di lavoro.
  3. Esecuzione test - esegue test di convalida usando i validatori configurati (sia automatici sia manuali).
  4. Generazione di report: crea report completi in più formati.

Struttura di output

Dopo la convalida, i risultati saranno disponibili nella Results directory:

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

Validatori

Lo strumento usa un set di validator specializzati per controllare diversi aspetti del carico di lavoro. Alcuni validator sono automatizzati, mentre altri richiedono l'interazione manuale.

Risoluzione dei problemi

Problemi del browser

  • Assicurarsi che Chrome/Chromium sia installato e accessibile.
  • Assicurati di aver eseguito l'accesso a Microsoft Fabric nel browser.
  • Controllare la connettività di rete ai servizi Fabric.

Problemi di download del manifesto

  • Verificare che il nome del carico di lavoro corrisponda esattamente (con distinzione tra maiuscole e minuscole).
  • Verificare che il carico di lavoro sia distribuito e accessibile in Fabric Workload Hub.
  • Controllare l'autenticazione e le autorizzazioni.

Problemi di esecuzione dei test

  • Esaminare i log di convalida nella directory Risultati.
  • Controllare la documentazione del singolo caso di test in validator/validators/.
  • Verificare che tutti gli asset del carico di lavoro necessari siano accessibili.

Contenuti correlati

  • Last updated on