Freigeben über

Schnellstart: Ausführen eines Workload-Beispiels

  • Artikel

Diese Schnellstartanleitung zeigt Ihnen, wie Sie einen Microsoft Fabric-Workload anhand eines Beispiel-Workloads erstellen und ausführen.

Voraussetzungen

Stellen Sie vor Beginn sicher, dass Sie die folgenden Komponenten auf Ihrem System installiert haben:

Leitfaden mit Schrittanleitungen

Aktivieren Sie benutzerdefinierte Workloads

Konfigurieren Sie das Verwaltungsportal wie folgt:

  1. Melden Sie sich mit einem Administrator-Konto bei Fabric an.

  2. Navigieren Sie im Verwaltungsportal zu Einstellungen.

    Screenshot, der zeigt, wie man zum Fabric-Verwaltungsportal gelangt.

  3. Aktivieren Sie im Abschnitt Zusätzliche Workloads die Kapazitätsadministratoren und Mitwirkender können zusätzliche Mandanteneinstellungen für Workloads hinzufügen und entfernen. Sie können sie für die gesamte Organisation oder für bestimmte Gruppen aktivieren.

Einrichten des Beispielprojekts

  1. Klonen Sie das Repository: Klonen Sie das Repository im Beispielprojektverzeichnis.

  2. Installieren von Abhängigkeiten: Navigieren Sie zum Frontend-Verzeichnis im geklonten Repository, und führen Sie den folgenden Befehl aus:

    npm install

  3. Starten Sie den lokalen Server: Starten Sie mit webpack einen lokalen Node.js Server, indem Sie Folgendes ausführen:

    npm start

    Der Server wird in der Regel auf Port 60006 ausgeführt. Vergewissern Sie sich, dass der Server betriebsbereit ist, indem Sie auf 127.0.0.1:60006/manifests zugreifen und die Konfigurationsdatei env.dev im Front-End-Ordner überprüfen.

  4. Aktivieren sie den Frontendentwicklermodus: In den Mandanteneinstellungen im Verwaltungsportal im Abschnitt Zusätzliche Workloads und aktivieren Sie die Mandanteneinstellung Kapazitätsadministratoren können zusätzliche Workloads entwickeln. Diese Einstellung ermöglicht Verbindungen mit Ihrem lokalen Server und wird über Browsersitzungen hinweg beibehalten.

Führen Sie eine Muster-Workload aus

Sobald der lokale Server läuft und der Entwicklermodus aktiviert ist, wird der neue Beispiel-Workload im Menü angezeigt.

  1. Greifen Sie auf den Beispiel-Workload zu: Navigieren Sie zur Homepage der Beispiel-Workload, um die Erfahrung Erstellen zu starten.

Vorbereiten der Entwicklungsumgebung

  1. Öffnen der Projektmappe: Öffnen Sie die Projektmappe in Visual Studio 2022, um die Kompatibilität mit net7 sicherzustellen.

  2. App-Registrierung: Befolgen Sie den Authentifizierungsleitfaden, um die Microsoft Entry ID-Authentifizierung für sichere Interaktionen innerhalb der Architektur einzurichten.

  3. Konfigurieren von Workload Einstellungen: Aktualisieren Sie src/Config/workload-dev-mode.json und src/appsettings.json mit ihren spezifischen Konfigurationsdetails.

    • Kopieren Sie workload-dev-mode.json von "src/Config" in C:\ und aktualisieren Sie die folgenden Felder entsprechend Ihrer Konfiguration:

    Hinweis

    Sie können es in einen beliebigen anderen Pfad kopieren und das Befehlszeilenargument „-DevMode:LocalConfigFilePath“ in Ihrem Projekt einrichten, um den Pfad anzugeben.

    • WorkspaceGuid: Ihre Arbeitsbereichs-ID. Suchen Sie sie in der Browser-URL, wenn Sie einen Arbeitsbereich in Fabric auswählen, z. B. https://app.fabric.microsoft.com/groups/{WorkspaceID}/.

    • ManifestPackageFilePath: Der Speicherort des Manifestpakets. Wenn Sie die Lösung erstellen, wird das Manifestpaket in src\bin\Debug gespeichert. Weitere Details zum Manifestpaket finden Sie in den späteren Schritten.

    • WorkloadEndpointURL: Workload Endpoint URL.

    • Aktualisieren Sie in der src/appsettings.json-Datei die folgenden Felder so, dass sie ihrer Konfiguration entsprechen:

      • PublisherTenantId: Die ID des Arbeitsauslastungs-Herausgebermandanten.
      • Client-Id: Client-ID (AppID) der Workload Microsoft-Entra-Anwendung.
      • ClientSecret: Der geheime Schlüssel für die Workload Microsoft Entra-Anwendung.
      • Zielgruppe: Die Zielgruppe für eingehende Microsoft Entra-Token finden Sie in Ihrer App-Registrierung, die Sie unter "Verfügbarmachen einer API" erstellt haben. Sie wird auch als Anwendungs-ID-URI bezeichnet.

  4. Konfigurieren Sie die Datei WorkloadManifest.xml: Konfigurieren Sie die Datei WorkloadManifest.xml mit den folgenden Microsoft Entra-Anwendungsdetails:

    • AppID
    • ResourceID
    • Umleitungs-URI

  5. Generieren eines Manifestpakets: Erstellen Sie die Lösung, um die Manifest-Paketdatei zu erstellen. Dazu gehört das Validieren und Packen der erforderlichen XML- und JSON-Dateien.

    • Lösen Sie Fabric_Extension_BE_Boilerplate_WorkloadManifestValidator.exe auf workloadManifest.xml in Packages\manifest\files\ aus (den Code des Validierungsprozesses finden Sie im Verzeichnis \workloadManifestValidator). Wenn die Überprüfung fehlschlägt, wird eine Fehlerdatei generiert, die die fehlgeschlagene Überprüfung angibt.
    • Wenn die Fehlerdatei vorhanden ist, schlägt der Build mit dem „WorkloadManifest-Überprüfungsfehler“ fehl. Sie können in VS Studio auf den Fehler doppelklicken und die Fehlerdatei wird angezeigt.
    • Nach erfolgreicher Validierung packen Sie die Dateien WorkloadManifest.xml und FrontendManifest.json in ManifestPackage.1.0.0.nupkg. Das resultierende Paket befindet sich in "src\bin\Debug".

    Kopieren Sie die ManifestPackage.1.0.0.nupkg-Datei in den Pfad, der in der Konfigurationsdatei workload-dev-mode.json definiert ist.

  6. Führen Sie DevGateway aus: Führen Sie „Microsoft.Fabric.Workload.DevGateway.exe“ aus, und melden Sie sich mit einem Benutzer an, der über WorkspaceGuidAdministratorrechte für den Arbeitsbereich verfügt, der im Feld von „workload-dev-mode.json“ angegeben ist.

  7. Starten des Projekts: Legen Sie das Projekt „Boilerplate“ als Startprojekt in Visual Studio fest und starten Sie es.

Zusätzliche Schritte

  • Aktualisieren Sie die Workloadkonfigurations-Dateien nach Bedarf.
  • Erstellen Sie die Lösung, um sicherzustellen, dass alle Abhängigkeiten ordnungsgemäß verknüpft sind.
  • Starten Sie das Front-End und devgateway, um die Kommunikation mit dem Fabric-Back-End herzustellen.
  • Erstellen Sie Objekte und führen Sie Aufträge aus, um die volle Leistungsfähigkeit Ihres Workloads zu testen.

Zugehöriger Inhalt