Configurer le mode cloud de charge de travail

Article
12/03/2024

Dans cet article, vous découvrirez les conditions requises pour déployer une charge de travail qui fonctionne sur un serveur distant avec accès à Internet dans Microsoft Fabric.

Le déploiement se décompose en deux parties :

Code client de charge de travail : code front-end incorporé en tant qu’iFrame dans l’interface utilisateur de Microsoft Fabric.
Back-end de charge de travail : composant back-end qui traite votre charge de travail.

Déployez les deux composants en tant que services cloud. Vous pouvez héberger les deux composants sur des serveurs distincts si nécessaire.

Pour utiliser votre charge de travail en mode cloud, vous devez configurer correctement les informations et domaines de votre application.

Format resourceId de l’application Microsoft Entra ID

La valeur resourceId d’application Microsoft Entra ID doit être au format suivant :

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

Domaine vérifié par le locataire d’ISV : correspondance exacte du domaine vérifié dans le locataire du serveur de l’éditeur sans préfixes ni sous-domaines. Découvrez comment ajouter un domaine personnalisé à Microsoft Entra.
Serveur front-end de charge de travail : nom du serveur front-end tel qu’il apparaît dans l’URL front-end (segment supplémentaire dans l’URL front-end au-dessus du domaine vérifié).
Serveur back-end de charge de travail : le nom du serveur back-end tel qu’il apparaît dans l’URL du back-end (le segment supplémentaire dans l’URL du back-end au-dessus du domaine vérifié).
ID de charge de travail : l’ID de charge de travail tel qu’il apparaît dans le manifeste de charge de travail.
ID de ressource : une chaîne facultative peut être ajoutée à la fin de la valeur resourceId.

Remarque

Les sous-domaines *.onmicrosoft ne sont pas autorisés dans les URL.
La chaîne facultative doit contenir des caractères alphanumériques (anglais) ou des traits d’union uniquement et ne peuvent pas dépasser une longueur de 36 caractères.

Domaines front-end et back-end

Les URL front-end et back-end doivent être des sous-domaines de resourceId avec maximum un segment supplémentaire.
Le domaine hôte de l’URL de réponse doit être le même que le domaine hôte du front-end.

Exemples

Valeur resourceId de l’application Microsoft Entra ID : https://datafactory.contoso.com/feserver/beserver/Fabric.WorkloadSample/123
Domaine front-end : https://feserver.datafactory.contoso.com
Domaine back-end : https://beserver.datafactory.contoso.com
URI de redirection : https://feserver.datafactory.contoso.com/close

Configurer les points de terminaison de la charge de travail

Pour configurer les points de terminaison de la charge de travail :

Ajoutez l’URL back-end de la charge de travail à la section CloudServiceConfiguration du manifeste et nommez-la Workload.
Ajoutez l’URL front-end de la charge de travail à la section CloudServiceConfiguration du manifeste et nommez-la Frontend.

Voici un exemple :

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

Configurer votre application dans Microsoft Entra ID

Pour configurer votre application dans Microsoft Entra :

L’URL de redirection doit pointer vers votre URL front-end ajoutée avec /close. Par exemple : feserver.datafactory.contoso.com/close.
L’URI de l’ID d’application doit correspondre au domaine vérifié de votre application.

Remarque

Toutes les autres configurations d’application dans Microsoft Entra ID sont identiques au mode développeur.

Configurer votre charge de travail (back-end)

Dans l’exemple back-end, ouvrez src/appsettings.json et configurez les paramètres suivants :
- Pour PublisherTenantId, sélectionnez l’ID de locataire de l’éditeur.
- Pour ClientId, entrez votre ID d’application (disponible dans la vue d’ensemble de Microsoft Entra ID).
- Pour ClientSecret, entrez le secret que vous avez créé lors de la configuration de l’application Microsoft Entra ID.
- Pour Audience, entrez l’URI d’ID que vous avez configuré dans l’application Microsoft Entra ID.
Ouvrez src/Packages/manifest/WorkloadManifest.xml.
Sous AADApp, définissez AppId, redirectUri et ResourceId (URI d’ID).

Notez les exigences spécifiées dans Fichier XSD et la vue d’ensemble du manifeste back-end.

Configurer votre application front-end

Dans le fichier .env.test, définissez WORKLOAD_BE_URL sur l’URL back-end de votre charge de travail (par exemple, définissez-la sur beserver.datafactory.contoso.com).