Cloudmodus workload instellen
In dit artikel vindt u informatie over de vereisten voor het implementeren van een workload die werkt op een externe server met internettoegang in Microsoft Fabric.
De implementatie heeft twee hoofdonderdelen:
- Workloadclientcode: Front-endcode die is ingesloten als een iFrame in de gebruikersinterface van Microsoft Fabric.
- Back-end van workload: het back-endonderdeel aan de serverzijde dat uw workload verwerkt.
Implementeer beide onderdelen als cloudservices. U kunt de twee onderdelen op afzonderlijke servers hosten, indien nodig.
Als u wilt werken met uw workload in de cloudmodus, moet u uw app-gegevens en -domeinen correct configureren.
ResourceId-indeling van Microsoft Entra ID-app
De app-waarde resourceId
van Microsoft Entra ID moet de volgende indeling hebben:
https://<ISV's tenant verified domain>/<workload frontend server>/<workload backend server>/<workload id>/<optional string>
- Isv's tenant geverifieerd domein: een exacte overeenkomst van het geverifieerde domein in de tenant van de uitgever zonder voorvoegsels of subdomeinen. Meer informatie over hettoevoegen van een aangepast domein aan Microsoft Entra.
- Front-endserver voor workload: de naam van de front-endserver zoals deze wordt weergegeven in de front-end-URL (het extra segment in de front-end-URL boven op het geverifieerde domein).
- Back-endserver voor workload: de naam van de back-endserver zoals deze wordt weergegeven in de back-end-URL (het extra segment in de back-end-URL boven op het geverifieerde domein).
- Workload-ID: de workload-id zoals deze wordt weergegeven in het workloadmanifest.
- Resource-id: Een optionele tekenreeks kan worden toegevoegd aan het einde van de
resourceId
waarde.
Notitie
*.onmicrosoft
subdomeinen zijn niet toegestaan in URL's.- De optionele tekenreeks mag alleen alfanumerieke (Engelse) tekens of afbreekstreepjes bevatten en mag niet langer zijn dan 36 tekens.
Front-end- en back-enddomeinen
- Front-end- en back-end-URL's moeten subdomeinen van de
resourceId
waarde zijn, met maximaal één extra segment. - Het hostdomein van de antwoord-URL moet hetzelfde zijn als het front-endhostdomein.
Voorbeelden
- App-waarde voor Microsoft Entra ID
resourceId
:https://datafactory.contoso.com/feserver/beserver/Fabric.WorkloadSample/123
- Front-enddomein:
https://feserver.datafactory.contoso.com
- Back-enddomein:
https://beserver.datafactory.contoso.com
- URI omleiden:
https://feserver.datafactory.contoso.com/close
De eindpunten van de workload configureren
De eindpunten van de workload configureren:
Voeg de back-end-URL van de workload toe aan de
CloudServiceConfiguration
sectie in het manifest en geef deze eenWorkload
naam.Voeg de front-end-URL van de workload toe aan de
CloudServiceConfiguration
sectie in het manifest en geef deze eenFrontend
naam.
Hier volgt een voorbeeld:
<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>
Uw toepassing configureren in Microsoft Entra-id
Uw toepassing configureren in Microsoft Entra:
- De omleidings-URL moet verwijzen naar uw front-end-URL die is toegevoegd aan
/close
. Bijvoorbeeld:feserver.datafactory.contoso.com/close
. - De URI van de toepassings-id moet overeenkomen met het geverifieerde domein van uw toepassing.
Notitie
Alle andere toepassingsconfiguraties in Microsoft Entra-id zijn hetzelfde als in de ontwikkelaarsmodus.
Uw workload (back-end) configureren
Open in het back-endvoorbeeld src/appsettings.json en configureer de volgende instellingen:
- Selecteer voor PublisherTenantId de tenant-id van de uitgever.
- Voer voor ClientId uw toepassings-id in (te vinden in het overzicht van De Microsoft Entra-id).
- Voer voor ClientSecret het geheim in dat u hebt gemaakt toen u de Microsoft Entra ID-app hebt geconfigureerd.
- Voer voor doelgroep de id-URI in die u hebt geconfigureerd in de Microsoft Entra ID-app.
Open src/Packages/manifest/WorkloadManifest.xml.
Stel onder
AADApp
, stelAppId
,redirectUri
enResourceId
(de id-URI).
Let op de vereisten die zijn opgegeven in het XSD-bestand en het overzicht van het back-endmanifest.
Uw front-end-app configureren
Stel in het .env.test-bestand de back-end-URL van uw workload in (bijvoorbeeld op beserver.datafactory.contoso.com
).WORKLOAD_BE_URL
Hier volgt een voorbeeld:
WORKLOAD_NAME=Fabric.WorkloadSample
WORKLOAD_BE_URL=beserver.datafactory.contoso.com