Delen via

Snel aan de slag: Een voorbeeld van een workload uitvoeren

  • Artikel

Deze snelstartgids laat zien hoe u een Microsoft Fabric-workload maakt en uitvoert met behulp van een voorbeeldworkload.

Vereisten

Voordat u begint, moet u ervoor zorgen dat het volgende op uw systeem is geïnstalleerd:

Stapsgewijze handleiding

Aangepaste workloads inschakelen

Configureer de beheerportal als volgt:

  1. Meld u aan bij Fabric met een beheerdersaccount.

  2. Ga vanuit Instellingen naar de beheerportal.

    Schermopname die laat zien hoe u toegang krijgt tot de fabric-beheerportal.

  3. Schakel in de sectie Extra workloads de capaciteitsbeheerders en inzenders in en kunnen extra tenantinstellingen voor workloads toevoegen en verwijderen. U kunt deze inschakelen voor de hele organisatie of specifieke groepen.

Het voorbeeldproject instellen

  1. Kloon de opslagplaats: Kloon de opslagplaats die hier is gevonden: Voorbeeldprojectmap

  2. Afhankelijkheden installeren: Navigeer naar de Frontend map in de gekloonde opslagplaats en voer de volgende opdracht uit:

    npm install

  3. Start de lokale server: start een lokale Node.js server met behulp van webpack het volgende:

    npm start

    De server wordt doorgaans uitgevoerd op poort 60006. Controleer of de server operationeel is door 127.0.0.1:60006/manifests het configuratiebestand .env.dev in de front-endmap te openen en te controleren.

  4. De front-endontwikkelaarsmodus inschakelen: in de tenantinstellingen in de beheerportal, onder de sectie Aanvullende workloads , en kunnen de capaciteitsbeheerders extra workloads ontwikkelen. Tenantinstelling. Met deze instelling kunt u verbindingen met uw lokale server maken en blijven bestaan tussen browsersessies.

Een voorbeeldworkload uitvoeren

Zodra de lokale server wordt uitgevoerd en de ontwikkelaarsmodus is ingeschakeld, wordt de nieuwe voorbeeldworkload weergegeven in het menu.

  1. Toegang tot de voorbeeldworkload: ga naar de startpagina van de voorbeeldworkload om de ervaring maken te starten.

De ontwikkelomgeving voorbereiden

  1. Open de oplossing: Open de oplossing in Visual Studio 2022 om compatibiliteit met net7 te garanderen.

  2. App-registratie: volg de verificatiehandleiding voor het instellen van Microsoft Entra ID-verificatie voor beveiligde interacties binnen de architectuur.

  3. OneLake DFS-basis-URL bijwerken: wijzig het EnvironmentConstants.cs bestand in de src/Constants/ map zodat deze overeenkomt met uw omgeving.

  4. Workloadinstellingen configureren: Bijwerken src/Config/workload-dev-mode.json en src/appsettings.json met uw specifieke configuratiedetails:

    • Kopieer workload-dev-mode.json van src/Config naar C:\ en werk de volgende velden bij zodat deze overeenkomen met uw configuratie:

    Notitie

    U kunt het kopiëren naar een ander pad en het opdrachtregelargument '-DevMode:LocalConfigFilePath' instellen in uw project om het pad op te geven.

    • WorkspaceGuid: uw werkruimte-id. Zoek deze in de browser-URL bij het selecteren van een werkruimte in Fabric, https://app.fabric.microsoft.com/groups/{WorkspaceID}/bijvoorbeeld.

    • ManifestPackageFilePath: de locatie van het manifestpakket. Wanneer u de oplossing bouwt, wordt het manifestpakket opgeslagen in src\bin\Debug. Meer informatie over het manifestpakket vindt u in de latere stappen.

    • WorkloadEndpointURL: URL van het workloadeindpunt.

    • Werk in het bestand src/appsettings.json de volgende velden bij zodat deze overeenkomen met uw configuratie:

      • PublisherTenantId: de id van de tenant van de workloaduitgever.
      • ClientId: Client-id (AppID) van de workload Microsoft Entra-toepassing.
      • ClientSecret: het geheim voor de Microsoft Entra-workloadtoepassing.
      • Doelgroep: De doelgroep voor binnenkomende Microsoft Entra-tokens vindt u in uw app-registratie die u hebt gemaakt onder de sectie 'Een API beschikbaar maken'. Dit wordt ook wel de URI van de toepassings-id genoemd.

  5. Configureer het WorkloadManifest.xml-bestand: configureer het WorkloadManifest.xml-bestand met de volgende Microsoft Entra-toepassingsgegevens:

    • AppID
    • ResourceID
    • RedirectURI

  6. Manifestpakket genereren: bouw de oplossing om het manifestpakketbestand te maken, waaronder het valideren en verpakken van de benodigde XML- en JSON-bestanden.

    • Trigger Fabric_Extension_BE_Boilerplate_WorkloadManifestValidator.exe op workloadManifest.xml in Packages\manifest\files\ (u vindt de code van het validatieproces in de map \workloadManifestValidator). Als de validatie mislukt, wordt er een foutenbestand gegenereerd dat de mislukte validatie aangeeft.
    • Als het foutbestand bestaat, mislukt de build met 'WorkloadManifest-validatiefout'. U kunt dubbelklikken op de fout in VS Studio en u ziet het foutenbestand.
    • Nadat de validatie is geslaagd, verpakt u de WorkloadManifest.xml- en FrontendManifest.json-bestanden in ManifestPackage.1.0.0.nupkg. Het resulterende pakket vindt u in src\bin\Debug.

    Kopieer het manifestpackage.1.0.0.nupkg-bestand naar het pad dat is gedefinieerd in het workload-dev-mode.json configuratiebestand.

  7. Voer de DevGateway uit: voer 'Microsoft.Fabric.Workload.DevGateway.exe' uit en meld u aan met een gebruiker met werkruimtebeheerdersbevoegdheden voor de werkruimte die is opgegeven in het WorkspaceGuid veld van workload-dev-mode.json.

  8. Start het project: Stel het project 'Standaard' in als het opstartproject in Visual Studio en voer het uit.

Aanvullende stappen

  • Werk de workloadconfiguratiebestanden indien nodig bij.
  • Bouw de oplossing om ervoor te zorgen dat alle afhankelijkheden correct zijn gekoppeld.
  • Voer de front-end en devgateway uit om communicatie met de fabric-back-end tot stand te brengen.
  • Maak items en voer taken uit om de volledige mogelijkheden van uw workload te testen.

Gerelateerde inhoud