Freigeben über

Microsoft Fabric Extensibility Toolkit-Validierer

Das Microsoft Fabric Extensibility Toolkit Validator ist ein umfassendes Überprüfungstool für Microsoft Fabric-Workloads. Es hilft Herausgebern, ihre Workloads auf Microsoft Fabric-Anforderungen zu überprüfen, bevor Sie eine offizielle Zertifizierung einreichen.

Dieses Tool ist das öffentliche Überprüfungstool für externe Partner und Kunden, die Fabric-Workloads entwickeln.

Überblick

Mit dem Überprüfungstool können Ersteller von Arbeitslasten ihre Microsoft Fabric-Workloads selbst validieren. Es wurde entwickelt, um potenzielle Probleme frühzeitig im Entwicklungsprozess zu identifizieren, wodurch der offizielle Validierungsprozess wahrscheinlicher erfolgreich ist.

Von Bedeutung

Erfolgreiche Selbstvalidierung ist keine Garantie für das Bestehen der offiziellen Validierung, aber sie erhöht die Wahrscheinlichkeit eines Erfolgs, da häufige Probleme frühzeitig erkannt werden.

Voraussetzungen

  • Node.js (Version 14 oder höher)
  • Microsoft Fabric-Konto mit Zugriff auf Fabric Workload Hub
  • Chrome/Chromium-Browser (für automatisiertes Manifestdownload)
  • Workload-Paket, das mit dem Microsoft Fabric Extensibility Toolkit erstellt wurde
  • Published Workload – Ihre Workload muss an einen Mandanten veröffentlicht werden, bevor die Überprüfung beginnen kann.

Tipp

Verwenden Sie für die Überprüfung einen anderen Mandanten als für die Veröffentlichung. Auf diese Weise können Sie erfahren, was Endbenutzer sehen und eine realistischere Validierungsumgebung bieten.

Get started

1. Erstellen Sie Ihre Arbeitslast

Erstellen Sie zunächst Ihre Workload mit dem offiziellen Starterkit:

  1. Klonen Sie das Fabric Extensibility Toolkit (Starter Kit).
  2. Folgen Sie der Toolkit-Dokumentation, um Ihre Workload zu erstellen.

2. Installieren von Abhängigkeiten

Navigieren Sie zum Validatorverzeichnis, und installieren Sie die Abhängigkeiten:

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

3. Grundlegende Validierung

Führen Sie eine vollständige Überprüfung für Ihre Workload aus:

Befehl "Grundlegende Überprüfung"

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

Beispiel mit realer Arbeitsauslastung

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

Für Workloads in der GA-Phase

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

Hinweis

Stellen Sie sicher, dass Sie vor der Überprüfung bei Microsoft Fabric in Ihrem Browser angemeldet sind, und stellen Sie sicher, dass Ihre Workload im Zielmandanten veröffentlicht und zugänglich ist.

Befehlszeilenoptionen

Option Description Example
--workload-name Vollständiger Workloadname (Publisher.Product) "Contoso.DataProcessor"
--workload-stage Überprüfungsphase "Preview" oder "GA"
--help Hilfeinformationen anzeigen (nur Kennzeichnung)

Validierungsprozess

Der Validator durchläuft mehrere Phasen:

  1. Manifestdownload – Lädt Ihr Workload-Manifest automatisch aus Fabric Workload Hub herunter.
  2. Testermittlung – Identifiziert anwendbare Testfälle basierend auf Ihrem Workloadtyp.
  3. Testausführung : Führt Überprüfungstests mit den konfigurierten Validatoren (sowohl automatisiert als auch manuell) aus.
  4. Berichterstellung – Erstellt umfassende Berichte in mehreren Formaten.

Ausgabestruktur

Nach der Überprüfung finden Sie Ergebnisse im Results Verzeichnis:

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

Das Tool verwendet eine Reihe von spezialisierten Validatoren, um verschiedene Aspekte Ihrer Workload zu überprüfen. Einige Validatoren sind automatisiert, während andere manuelle Interaktionen erfordern.

Problembehandlung

Browserprobleme

  • Stellen Sie sicher, dass Chrome/Chromium installiert und zugänglich ist.
  • Stellen Sie sicher, dass Sie in Ihrem Browser bei Microsoft Fabric angemeldet sind.
  • Überprüfen Sie die Netzwerkkonnektivität mit Fabric-Diensten.

Manifest-Download-Probleme

  • Überprüfen Sie, ob der Name des Workloads genau übereinstimmt (Beachtung der Groß- und Kleinschreibung).
  • Stellen Sie sicher, dass die Workload im Fabric Workload Hub bereitgestellt und zugänglich ist.
  • Überprüfen Sie die Authentifizierung und Berechtigungen.

Probleme bei der Testausführung

  • Überprüfen Sie die Überprüfungsprotokolle im Ergebnisverzeichnis.
  • Überprüfen Sie die Dokumentation zu einzelnen Testfällen in validator/validators/.
  • Überprüfen Sie, ob auf alle erforderlichen Workloadressourcen zugegriffen werden kann.

Verwandte Inhalte

  • Last updated on