Konfigurer cloudtilstand for arbejdsbelastning

I denne artikel kan du få mere at vide om kravene til installation af en arbejdsbelastning, der fungerer på en ekstern server med internetadgang i Microsoft Fabric.

Udrulningen har to hoveddele:

• Klientkode til arbejdsbelastning: Frontendkode, der er integreret som en iFrame i Brugergrænsefladen i Microsoft Fabric.
• Backend af arbejdsbelastning: Den backend- og serverkomponent, der behandler din arbejdsbelastning.

Udrul begge komponenter som cloudtjenester. Du kan hoste de to komponenter på separate servere, hvis det er nødvendigt.

Hvis du vil arbejde med din arbejdsbelastning i cloudtilstand, skal du konfigurere dine appoplysninger og domæner korrekt.

Formatet ressource-id for microsoft entra-id-app

Appværdien resourceId for Microsoft Entra ID skal være i følgende format:

https://<ISV's tenant verified domain>/<workload frontend server>/<workload backend server>/<workload id>/<optional string>

• ISV'ens lejerbekræftede domæne: Et nøjagtigt match af det bekræftede domæne i udgiverens lejer uden præfikser eller underdomæner. Få mere atvide om, hvordan du føjer et brugerdefineret domæne til Microsoft Entra.
• Frontendserver til arbejdsbelastning: Navnet på frontendserveren, som det vises i frontend-URL-adressen (det ekstra segment i frontend-URL-adressen oven på det bekræftede domæne).
• Backendserver til arbejdsbelastning: Navnet på backendserveren, som det vises i URL-adressen til backend (det ekstra segment i backend-URL-adressen oven på det bekræftede domæne).
• arbejdsbelastnings-id: Arbejdsbelastnings-id'et, som det vises i arbejdsbelastningsmanifestet.
• Ressource-id: En valgfri streng kan føjes til slutningen af værdien resourceId .

Bemærk

• *.onmicrosoft underdomæner er ikke tilladt i URL-adresser.
• Den valgfri streng må kun indeholde alfanumeriske (engelske) tegn eller bindestreger og må ikke være længere end 36 tegn.

Frontend- og backenddomæner

• URL-adresser til frontend og backend skal være underdomæner for værdien resourceId med maksimalt ét ekstra segment.
• Værtsdomænet for svar-URL-adressen skal være det samme som frontendværtsdomænet.

Eksempler

• Appværdi resourceId for Microsoft Entra ID: https://datafactory.contoso.com/feserver/beserver/Fabric.WorkloadSample/123
• Frontenddomæne: https://feserver.datafactory.contoso.com
• Backenddomæne: https://beserver.datafactory.contoso.com
• Omdirigerings-URI: https://feserver.datafactory.contoso.com/close

Konfigurer arbejdsbelastningens slutpunkter

Sådan konfigurerer du slutpunkterne for arbejdsbelastningen:

1. Føj url-adressen til arbejdsbelastningens backend til CloudServiceConfiguration sektionen i manifestet, og navngiv den Workload.

2. Føj url-adressen til arbejdsbelastningens frontend til CloudServiceConfiguration sektionen i manifestet, og navngiv den Frontend.

Her er et eksempel:

<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>

Konfigurer dit program i Microsoft Entra ID

Sådan konfigurerer du dit program i Microsoft Entra:

1. URL-adressen til omdirigering skal pege på frontend-URL-adressen, der er føjet til /close. F.eks., feserver.datafactory.contoso.com/close.
2. Program-id'ens URI skal svare til det bekræftede domæne for dit program.

Bemærk

Alle andre programkonfigurationer i Microsoft Entra ID er de samme som i udviklertilstand.

Konfigurer din arbejdsbelastning (backend)

1. Åbn src/appsettings.json i backend-eksemplet, og konfigurer følgende indstillinger:

   • For PublisherTenantId skal du vælge udgiverens lejer-id.
   • For ClientId skal du angive dit program-id (findes i oversigten over Microsoft Entra ID).
   • For ClientSecret skal du angive den hemmelighed, du oprettede, da du konfigurerede appen Microsoft Entra ID.
   • For Målgruppe skal du angive den id-URI, du har konfigureret i appen Microsoft Entra ID.

2. Åbn src/Packages/manifest/WorkloadManifest.xml.

3. Under AADAppskal du angive AppId, redirectUriog ResourceId (id-URI'en).

Bemærk de krav, der er angivet i XSD-filen og oversigten over backendmanifestet.

Konfigurer din frontendapp

I .env.test-filen skal du angive WORKLOAD_BE_URL til url-adressen til arbejdsbelastningens backend (f.eks. angive den til beserver.datafactory.contoso.com).

Her er et eksempel:

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