Dela via

Snabbstart: Kör ett arbetsbelastningsexempel (förhandsversion)

  • Artikel

Den här snabbstartsguiden visar hur du skapar och kör en Microsoft Fabric-arbetsbelastning med hjälp av en exempelarbetsbelastning.

Förutsättningar

Innan du börjar kontrollerar du att följande är installerat i systemet:

Steg-för-steg-guide

Aktivera anpassade arbetsbelastningar

Konfigurera administratörsportalen på följande sätt:

  1. Logga in på Infrastrukturresurser med ett administratörskonto .

  2. Från Inställningar går du till administratörsportalen.

    Skärmbild som visar hur du kommer till infrastrukturadministrationsportalen.

  3. I avsnittet Ytterligare arbetsbelastningar (förhandsversion) aktiverar du inställningen Kapacitetsadministratörer och deltagare kan lägga till och ta bort ytterligare klientinställningar för arbetsbelastningar . Du kan aktivera det för hela organisationen eller specifika grupper.

Konfigurera exempelprojektet

  1. Klona lagringsplatsen: Klona lagringsplatsen som finns här: Exempel på Project Directory

  2. Installera beroenden: Navigera till Frontend katalogen i den klonade lagringsplatsen och kör följande kommando:

    npm install

  3. Starta den lokala servern: Starta en lokal Node.js-server med hjälp webpack av följande:

    npm start

    Servern körs vanligtvis på port 60006. Bekräfta att servern fungerar genom att 127.0.0.1:60006/manifests öppna och kontrollera konfigurationsfilen .env.dev i klientdelsmappen.

  4. Aktivera klientdelsutvecklingsläge: I klientinställningarna i administratörsportalen under avsnittet Ytterligare arbetsbelastningar (förhandsversion) och aktivera kapacitetsadministratörerna kan utveckla ytterligare arbetsbelastningar. Klientinställning. Den här inställningen tillåter anslutningar till den lokala servern och bevaras mellan webbläsarsessioner.

Köra en exempelarbetsbelastning

När den lokala servern körs och utvecklarläget är aktiverat visas den nya exempelarbetsbelastningen på menyn.

  1. Få åtkomst till exempelarbetsbelastningen: Om du vill starta skapa-upplevelsen går du till startsidan för exempelarbetsbelastningen.

Förbereda utvecklingsmiljön

  1. Klona pannplåten: Klona boilerplate-projektet som finns här: Exempelprojektkatalog

  2. Öppna lösningen: Öppna lösningen i Visual Studio 2022 för att säkerställa kompatibilitet med net7.

  3. Appregistrering: Följ autentiseringsguiden för att konfigurera Microsoft Entra-ID-autentisering för säkra interaktioner inom arkitekturen.

  4. Uppdatera OneLake DFS-bas-URL: Ändra EnvironmentConstants.cs filen i mappen så att den src/Constants/ matchar din miljö.

  5. Konfigurera arbetsbelastningsinställningar: Uppdatera src/Config/workload-dev-mode.json och src/appsettings.json med din specifika konfigurationsinformation:

    • Kopiera workload-dev-mode.json från src/Config till C:\ och uppdatera följande fält så att de matchar konfigurationen:

    Kommentar

    Du kan kopiera den till valfri annan sökväg och konfigurera kommandoradsargumentet "-DevMode:LocalConfigFilePath" i projektet för att ange sökvägen.

    • CapacityGuid: Ditt kapacitets-ID finns i infrastrukturportalen under Kapacitetsinställningar för administratörsportalen.

    • ManifestPackageFilePath: Platsen för manifestpaketet. När du skapar lösningen sparas manifestpaketet i src\bin\Debug. Mer information om manifestpaketet finns i de senare stegen.

    • WorkloadEndpointURL: Arbetsbelastningens slutpunkts-URL.

    • I filen src/appsettings.json uppdaterar du följande fält så att de matchar konfigurationen:

      • PublisherTenantId: ID för arbetsbelastningsutgivarens klientorganisation.
      • ClientId: Klient-ID (AppID) för arbetsbelastningen Microsoft Entra-programmet.
      • ClientSecret: Hemligheten för arbetsbelastningens Microsoft Entra-program.
      • Målgrupp: Målgruppen för inkommande Microsoft Entra-token finns i din appregistrering som du skapade under avsnittet "Exponera ett API". Detta kallas även program-ID-URI.

  6. Konfigurera WorkloadManifest.xml-filen: Konfigurera WorkloadManifest.xml-filen med följande Microsoft Entra-programinformation:

    • AppID
    • ResourceID
    • Omdirigerings-URI

  7. Generera manifestpaket: Skapa lösningen för att skapa manifestpaketfilen, som omfattar validering och packning av nödvändiga XML- och JSON-filer.

    • Utlösaren Fabric_Extension_BE_Boilerplate_WorkloadManifestValidator.exe på workloadManifest.xml i Packages\manifest\files\ (du hittar koden för valideringsprocessen i katalogen \workloadManifestValidator). Om verifieringen misslyckas genereras en felfil som anger den misslyckade verifieringen.
    • Om felfilen finns misslyckas bygget med "WorkloadManifest-valideringsfel". Du kan dubbelklicka på felet i VS Studio så visas felfilen.
    • Efter valideringen packar du WorkloadManifest.xml- och FrontendManifest.json-filerna i ManifestPackage.1.0.0.nupkg. Det resulterande paketet finns i src\bin\Debug.

    Kopiera filen ManifestPackage.1.0.0.nupkg till sökvägen som definierats i workload-dev-mode.json-konfigurationsfilen.

  8. Kör DevGateway: Kör "Microsoft.Fabric.Workload.DevGateway.exe" och autentisera som kapacitetsadministratör.

  9. Starta projektet: Ange projektet "Boilerplate" som startprojekt i Visual Studio och kör det.

Ytterligare steg

  • Uppdatera konfigurationsfilerna för arbetsbelastningen efter behov.
  • Skapa lösningen för att säkerställa att alla beroenden är korrekt länkade.
  • Kör klientdelen och devgateway för att upprätta kommunikation med infrastrukturresursernas serverdel.
  • Skapa objekt och kör jobb för att testa de fullständiga funktionerna i din arbetsbelastning.

Relaterat innehåll