Delen via

Microsoft Fabric Extensibility Toolkit Validator

De Validator voor Microsoft Fabric Extensibility Toolkit is een uitgebreid validatieprogramma voor Microsoft Fabric-workloads. Hiermee kunnen uitgevers hun workloads valideren op basis van Microsoft Fabric-vereisten voordat ze worden ingediend voor officiële certificering.

Dit hulpprogramma is het openbare validatieprogramma voor externe partners en klanten die Fabric-workloads ontwikkelen.

Overzicht

Met het validatieprogramma kunnen makers van workloads hun Microsoft Fabric-workloads zelf valideren. Het is ontworpen om potentiële problemen vroeg in het ontwikkelingsproces te identificeren, waardoor het officiële validatieproces waarschijnlijker zal slagen.

Belangrijk

Geslaagde zelfvalidatie is geen garantie voor het behalen van officiële validatie, maar het verhoogt de kans op succes aanzienlijk door veelvoorkomende problemen vroeg op te sporen.

Vereiste voorwaarden

  • Node.js (versie 14 of hoger)
  • Microsoft Fabric-account met toegang tot Fabric Workload Hub
  • Chrome/Chromium Browser (voor geautomatiseerde manifestdownload)
  • Workloadpakket opgebouwd met de Microsoft Fabric Extensibility Toolkit
  • Gepubliceerde workload : uw workload moet worden gepubliceerd naar een tenant voordat de validatie kan worden gestart.

Aanbeveling

Gebruik een andere tenant voor validatie dan de tenant die wordt gebruikt voor publicatie. Hierdoor kunt u ervaren wat eindgebruikers zien en een realistischere validatieomgeving bieden.

Get started

Uw workload opbouwen

Maak eerst uw workload met behulp van de officiële starterkit:

  1. Kloon de Fabric Extensibility Toolkit (starter kit).
  2. Volg de toolkitdocumentatie om uw workload te bouwen.

2. Afhankelijkheden installeren

Navigeer naar de validatiemap en installeer de afhankelijkheden:

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

3. Basisvalidatie

Voer een volledige validatie uit voor uw workload:

Basisvalidatieopdracht

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

Voorbeeld met echte werkbelasting

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

Voor GA-fase workloads

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

Opmerking

Zorg ervoor dat u bent aangemeld bij Microsoft Fabric in uw browser voordat u validatie uitvoert en zorg ervoor dat uw workload is gepubliceerd en toegankelijk is in de doeltenant.

Opdrachtregelopties

Optie Description Example
--workload-name Volledige werklastnaam (Publisher.Product) "Contoso.DataProcessor"
--workload-stage Validatiefase "Preview" of "GA"
--help Help-informatie weergeven (enkel vlag)

Validatieproces

De validator doorloopt verschillende fasen:

  1. Manifest downloaden : downloadt uw workloadmanifest automatisch vanuit Fabric Workload Hub.
  2. Testdetectie : identificeert toepasselijke testcases op basis van uw workloadtype.
  3. Testuitvoering : voert validatietests uit met behulp van de geconfigureerde validators (zowel geautomatiseerd als handmatig).
  4. Rapportgeneratie : uitgebreide rapporten in meerdere indelingen maken.

Uitvoerstructuur

Na validatie vindt u resultaten in de 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

Validatoren

Het hulpprogramma maakt gebruik van een set gespecialiseerde validators om verschillende aspecten van uw workload te controleren. Sommige validaties zijn geautomatiseerd, terwijl andere handmatige interactie vereisen.

Probleemoplossingsproces

Browserproblemen

  • Zorg ervoor dat Chrome/Chromium is geïnstalleerd en toegankelijk is.
  • Zorg ervoor dat u bent aangemeld bij Microsoft Fabric in uw browser.
  • Controleer de netwerkverbinding met Fabric-services.

Problemen met downloaden van manifesten

  • Controleer of de naam van de workload precies overeenkomt (hoofdlettergevoelig).
  • Zorg ervoor dat de workload is geïmplementeerd en toegankelijk is in de Fabric Workload Hub.
  • Controleer de verificatie en machtigingen.

Problemen met testuitvoering

  • Controleer validatielogboeken in de map Resultaten.
  • Raadpleeg de afzonderlijke testcasedocumentatie in validator/validators/.
  • Controleer of alle vereiste workload-assets toegankelijk zijn.

Verwante inhoud

  • Last updated on