Delen via


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:

  1. Voeg de back-end-URL van de workload toe aan de CloudServiceConfiguration sectie in het manifest en geef deze een Workloadnaam.

  2. Voeg de front-end-URL van de workload toe aan de CloudServiceConfiguration sectie in het manifest en geef deze een Frontendnaam.

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:

  1. De omleidings-URL moet verwijzen naar uw front-end-URL die is toegevoegd aan /close. Bijvoorbeeld: feserver.datafactory.contoso.com/close.
  2. 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

  1. 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.
  2. Open src/Packages/manifest/WorkloadManifest.xml.

  3. Stel onder AADApp, stel AppId, redirectUrien ResourceId (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