Dela via


Konfigurera molnläge för arbetsbelastning

I den här artikeln lär du dig kraven för att distribuera en arbetsbelastning som fungerar på en fjärrserver med internetåtkomst i Microsoft Fabric.

Distributionen har två huvuddelar:

  • Klientkod för arbetsbelastning: Klientdelskod som är inbäddad som en iFrame i Microsoft Fabric-användargränssnittet.
  • Arbetsbelastningsserverdel: Den serverdelskomponent på serversidan som bearbetar din arbetsbelastning.

Distribuera båda komponenterna som molntjänster. Du kan vara värd för de två komponenterna på separata servrar om det behövs.

Om du vill arbeta med din arbetsbelastning i molnläge måste du konfigurera appinformationen och domänerna på rätt sätt.

ResourceId-format för Microsoft Entra-ID-app

Appvärdet för Microsoft Entra-ID resourceId :t bör vara i följande format:

https://<ISV's tenant verified domain>/<workload frontend server>/<workload backend server>/<workload id>/<optional string>
  • ISV:s klient verifierade domän: En exakt matchning av den verifierade domänen i utgivarens klientorganisation utan prefix eller underdomäner. Lär dig hur du lägger tillen anpassad domän i Microsoft Entra.
  • Klientdelsserver för arbetsbelastning: Klientdelsserverns namn som det visas i klientdels-URL:en (det extra segmentet i klientdels-URL:en ovanpå den verifierade domänen).
  • Serverdelsserver för arbetsbelastning: Serverdelens servernamn som det visas i serverdels-URL:en (det extra segmentet i serverdels-URL:en ovanpå den verifierade domänen).
  • Arbetsbelastnings-ID: Arbetsbelastnings-ID som det visas i arbetsbelastningsmanifestet.
  • Resurs-ID: En valfri sträng kan läggas till i slutet av resourceId värdet.

Kommentar

  • *.onmicrosoft underdomäner tillåts inte i URL:er.
  • Den valfria strängen måste innehålla alfanumeriska (engelska) tecken eller bindestreck och får inte överstiga 36 tecken.

Klientdels- och serverdelsdomäner

  • Klientdels- och serverdels-URL:er måste vara underdomäner för resourceId värdet, med högst ett extra segment.
  • Värddomänen för svars-URL:en ska vara samma som klientdelsvärddomänen.

Exempel

  • Microsoft Entra ID-appvärde resourceId : https://datafactory.contoso.com/feserver/beserver/Fabric.WorkloadSample/123
  • Klientdelsdomän: https://feserver.datafactory.contoso.com
  • Serverdelsdomän: https://beserver.datafactory.contoso.com
  • Omdirigerings-URI: https://feserver.datafactory.contoso.com/close

Konfigurera arbetsbelastningens slutpunkter

Så här konfigurerar du arbetsbelastningens slutpunkter:

  1. Lägg till arbetsbelastningens serverdels-URL i CloudServiceConfiguration avsnittet i manifestet och ge den Workloadnamnet .

  2. Lägg till arbetsbelastningens klientdels-URL i CloudServiceConfiguration avsnittet i manifestet och ge den Frontendnamnet .

Här är ett exempel:

<CloudServiceConfiguration>
    <Cloud>Public</Cloud>
    ...
    <Endpoints>
        <ServiceEndpoint>
        <Name>Workload</Name>
        <Url>https://beserver.datafactory.contoso.com/workload</Url>
        </ServiceEndpoint>
        <ServiceEndpoint>
        <Name>Frontend</Name>
        <Url>https://feserver.datafactory.contoso.com</Url>
        </ServiceEndpoint>
    </Endpoints>
</CloudServiceConfiguration>

Konfigurera ditt program i Microsoft Entra-ID

Så här konfigurerar du ditt program i Microsoft Entra:

  1. Omdirigerings-URL:en ska peka på din url för klientdelen som läggs till med /close. Exempel: feserver.datafactory.contoso.com/close
  2. Program-ID-URI:n ska matcha programmets verifierade domän.

Kommentar

Alla andra programkonfigurationer i Microsoft Entra-ID är desamma som i utvecklarläge.

Konfigurera din arbetsbelastning (serverdel)

  1. I serverdelsexemplet öppnar du src/appsettings.json och konfigurerar följande inställningar:

    • För PublisherTenantId väljer du utgivarens klientorganisations-ID.
    • För ClientId anger du ditt program-ID (finns i översikten över Microsoft Entra-ID).
    • För ClientSecret anger du hemligheten du skapade när du konfigurerade Microsoft Entra ID-appen.
    • För Målgrupp anger du den ID-URI som du konfigurerade i Microsoft Entra-ID-appen.
  2. Öppna src/Packages/manifest/WorkloadManifest.xml.

  3. Under AADAppanger du AppId, redirectUrioch ResourceId (ID-URI).

Observera de krav som anges i XSD-filen och översikten över serverdelsmanifestet.

Konfigurera klientdelsappen

I .env.test-filen anger du WORKLOAD_BE_URL till arbetsbelastningens serverdels-URL (ange till beserver.datafactory.contoso.comexempel ).

Här är ett exempel:

WORKLOAD_NAME=Fabric.WorkloadSample
WORKLOAD_BE_URL=beserver.datafactory.contoso.com