Udostępnij przez

Narzędzie walidacji rozszerzalności Microsoft Fabric

Zestaw narzędzi weryfikacyjnych Microsoft Fabric Extensibility Toolkit to kompleksowe narzędzie do walidacji obciążeń Microsoft Fabric. Pomaga to wydawcom weryfikować swoje obciążenia robocze pod kątem wymagań Microsoft Fabric przed przesłaniem do oficjalnej certyfikacji.

To narzędzie jest publicznym narzędziem do walidacji dla partnerów zewnętrznych i klientów rozwijających obciążenia środowiska Fabric.

Przegląd

Narzędzie do walidacji umożliwia twórcom obciążeń samodzielne weryfikowanie obciążeń usługi Microsoft Fabric. Jest ona przeznaczona do ułatwienia identyfikowania potencjalnych problemów na wczesnym etapie procesu rozwoju, zwiększając prawdopodobieństwo sukcesu oficjalnego procesu weryfikacji.

Ważne

Powodzenie samodzielnej weryfikacji nie gwarantuje przejścia oficjalnej weryfikacji, ale znacznie zwiększa prawdopodobieństwo powodzenia, przechwytując typowe problemy na wczesnym etapie.

Wymagania wstępne

  • Node.js (wersja 14 lub nowsza)
  • Konto usługi Microsoft Fabric z dostępem do usługi Fabric Workload Hub
  • Chrome/Chromium Browser (do automatycznego pobierania manifestu)
  • Pakiet obciążenia utworzony przy użyciu zestawu narzędzi Microsoft Fabric Extensibility Toolkit
  • Opublikowane obciążenie — obciążenie musi zostać opublikowane w tenant przed rozpoczęciem walidacji.

Wskazówka

Użyj innej dzierżawy do weryfikacji niż ta używana do publikowania. Dzięki temu można zobaczyć, co użytkownicy końcowi zobaczą i zapewnia bardziej realistyczne środowisko weryfikacji.

Wprowadzenie

1. Skompiluj obciążenie

Najpierw utwórz obciążenie przy użyciu oficjalnego zestawu startowego:

  1. Sklonuj zestaw narzędzi do rozszerzalności Fabric (pakiet startowy).
  2. Postępuj zgodnie z dokumentacją zestawu narzędzi, aby stworzyć swoje zadanie.

2. Instalowanie zależności

Przejdź do katalogu modułu sprawdzania poprawności i zainstaluj zależności:

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

3. Podstawowa walidacja

Uruchom pełną walidację obciążenia:

Podstawowe polecenie weryfikacji

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

Przykład z rzeczywistym obciążeniem

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

W przypadku obciążeń etapu ogólnie dostępnego

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

Uwaga / Notatka

Przed uruchomieniem walidacji upewnij się, że jesteś zalogowany do usługi Microsoft Fabric w przeglądarce oraz że twoje obciążenie zostało opublikowane i jest dostępne w docelowej dzierżawie.

Opcje wiersza polecenia

Option Description Example
--workload-name Pełna nazwa obciążenia roboczego (Publisher.Product) "Contoso.DataProcessor"
--workload-stage Etap weryfikacji "Preview" lub "GA"
--help Pokaż informacje o pomocy (tylko flaga)

Proces weryfikacji

Moduł sprawdzania poprawności przechodzi przez kilka etapów:

  1. Pobieranie manifestu — automatycznie pobiera manifest obciążenia z usługi Fabric Workload Hub.
  2. Odnajdywanie testów — identyfikuje odpowiednie przypadki testowe na podstawie typu obciążenia.
  3. Wykonywanie testu — uruchamia testy weryfikacyjne przy użyciu skonfigurowanych modułów sprawdzania poprawności (zarówno automatycznych, jak i ręcznych).
  4. Generowanie raportów — tworzy kompleksowe raporty w wielu formatach.

Struktura danych wyjściowych

Po weryfikacji wyniki znajdziesz w Results katalogu:

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

Moduły sprawdzania poprawności

Narzędzie używa zestawu wyspecjalizowanych walidatorów do sprawdzania różnych aspektów twojego obciążenia. Niektóre moduły sprawdzania poprawności są zautomatyzowane, a inne wymagają ręcznej interakcji.

Rozwiązywanie problemów

Problemy z przeglądarką

  • Upewnij się, że przeglądarka Chrome/Chromium jest zainstalowana i dostępna.
  • Upewnij się, że zalogowano się do usługi Microsoft Fabric w przeglądarce.
  • Sprawdź łączność sieciową z usługami Fabric.

Problemy z pobieraniem manifestu

  • Sprawdź, czy nazwa obciążenia jest dokładnie zgodna (z uwzględnieniem wielkości liter).
  • Upewnij się, że workload jest wdrażany i dostępny w Fabric Workload Hub.
  • Sprawdź uwierzytelnianie i uprawnienia.

Problemy z wykonywaniem testów

  • Przejrzyj dzienniki weryfikacji w katalogu Results.
  • Sprawdź dokumentację indywidualnego przypadku testowego w pliku validator/validators/.
  • Sprawdź, czy wszystkie wymagane zasoby związane z obciążeniem są dostępne.

Treści powiązane

  • Last updated on