Utilisation en mode cloud (aperçu)

Article
08/16/2024

Dans cette section, nous couvrons les conditions requises pour déployer une charge de travail qui fonctionne sur un serveur distant avec accès à Internet. Le déploiement est composé de deux parties principales :

Code client de charge de travail : composant frontal incorporé en tant qu’iFrame au sein de l’interface utilisateur fabric.
Backend de charge de travail : composant côté serveur qui traite votre charge de travail.

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

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

Le resourceId de l’application Microsoft Entra ID doit être conforme 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 publication sans préfixes ni sous-domaines. Découvrez comment ajouter un domaine personnalisé à Microsoft Entra.
Serveur frontal de charge de travail : nom du serveur frontal tel qu’il apparaît dans l’URL frontale (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.
À la fin de resourceId, il peut y avoir une chaîne facultative.

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 du resourceId avec un maximum de 1 segment supplémentaire.
Le domaine hôte de l’URL de réponse doit être le même que le domaine hôte du frontend.

Exemples :

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

Configuration des 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 charge de travail.

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

<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

Lorsque vous configurez votre application dans Microsoft Entra ID, vérifiez que les éléments suivants s’appliquent :

L’URL de redirection doit pointer vers votre URL frontale ajoutée avec /close, par example, 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 de développement.

Configuration de votre charge de travail (back-end)

Accédez à src/appsettings.json dans l’exemple Backend et configurez les éléments suivants :

PublisherTenantId : l’ID client de l’éditeur.
ClientId : votre ID d’application (trouvé dans Microsoft Entra ID sous vue d’ensemble).
ClientSecret : le secret créé précédemment lors de la configuration de l’application Microsoft Entra ID.
Audience : l’URI d’ID configuré précédemment dans l’application Microsoft Entra ID.

Ensuite, configurez votre WorkloadManifest.xml en accédant à src/Packages/manifest/WorkloadManifest.xml votre AppId, redirectUri et l’URI ResourceId (ID) sous « AADApp ». Notez les exigences spécifiées par le fichier XSD et la vue d’ensemble du manifeste back-end suivant.

Configuration de votre application front-end

Définissez WORKLOAD_BE_URL sur l’URL du backend de votre charge de travail (par exemple beserver.datafactory.contoso.com) dans le fichier .env.test.

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

Partager via