Configurare la modalità cloud del carico di lavoro

In questo articolo vengono illustrati i requisiti per la distribuzione di un carico di lavoro che opera su un server remoto con accesso a Internet in Microsoft Fabric.

La distribuzione ha due parti principali:

• Codice client del carico di lavoro: codice front-end incorporato come iFrame nell'interfaccia utente di Microsoft Fabric.
• Back-end del carico di lavoro: componente back-end, lato server che elabora il carico di lavoro.

Distribuire entrambi i componenti come servizi cloud. Se necessario, è possibile ospitare i due componenti in server separati.

Per usare il carico di lavoro in modalità cloud, è necessario configurare correttamente le informazioni e i domini dell'app.

Formato resourceId app Microsoft Entra ID

Il valore dell'app resourceId Microsoft Entra ID deve essere nel formato seguente:

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

• Dominio verificato del tenant isv: corrispondenza esatta del dominio verificato nel tenant dell'editore senza prefissi o sottodomini. Informazioni su comeaggiungere un dominio personalizzato a Microsoft Entra.
• Server front-end del carico di lavoro: nome del server front-end visualizzato nell'URL front-end (segmento aggiuntivo nell'URL front-end sopra il dominio verificato).
• Server back-end del carico di lavoro: nome del server back-end visualizzato nell'URL back-end (segmento aggiuntivo nell'URL back-end sopra il dominio verificato).
• ID dei carichi di lavoro: ID del carico di lavoro visualizzato nel manifesto del carico di lavoro.
• ID risorsa: è possibile aggiungere una stringa facoltativa alla fine del resourceId valore.

Domini front-end e back-end

• Gli URL front-end e back-end devono essere sottodomini del resourceId valore, con un massimo di un segmento aggiuntivo.
• Il dominio host dell'URL di risposta deve corrispondere al dominio host front-end.

Esempi

• Valore dell'app resourceId Microsoft Entra ID: https://datafactory.contoso.com/feserver/beserver/Fabric.WorkloadSample/123
• Dominio front-end: https://feserver.datafactory.contoso.com
• Dominio back-end: https://beserver.datafactory.contoso.com
• URI di reindirizzamento: https://feserver.datafactory.contoso.com/close

Configurare gli endpoint del carico di lavoro

Per configurare gli endpoint del carico di lavoro:

1. Aggiungere l'URL back-end del carico di lavoro alla CloudServiceConfiguration sezione nel manifesto e denominarlo Workload.

2. Aggiungere l'URL front-end del carico di lavoro alla CloudServiceConfiguration sezione nel manifesto e denominarlo Frontend.

Ecco un esempio:

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

Configurare l'applicazione in Microsoft Entra ID

Per configurare l'applicazione in Microsoft Entra:

1. L'URL di reindirizzamento deve puntare all'URL front-end aggiunto con /close. Ad esempio: feserver.datafactory.contoso.com/close.
2. L'URI ID applicazione deve corrispondere al dominio verificato dell'applicazione.

Configurare il carico di lavoro (back-end)

1. Nell'esempio back-end aprire src/appsettings.json e configurare le impostazioni seguenti:

   • Per PublisherTenantId selezionare l'ID tenant del server di pubblicazione.
   • Per ClientId immettere l'ID applicazione (disponibile nella panoramica di Microsoft Entra ID).
   • Per ClientSecret immettere il segreto creato durante la configurazione dell'app Microsoft Entra ID.
   • Per Destinatari immettere l'URI ID configurato nell'app Microsoft Entra ID.

2. Aprire src/Packages/manifest/WorkloadManifest.xml.

3. In AADAppimpostare AppId, redirectUrie ResourceId (URI ID).

Si notino i requisiti specificati nel file XSD e nella panoramica del manifesto back-end.

Configurare l'app front-end

Nel file con estensione env.test impostare l'URL WORKLOAD_BE_URL back-end del carico di lavoro, ad esempio impostarlo su beserver.datafactory.contoso.com.

Ecco un esempio:

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