Partager via

Manifeste de charge de travail dans le Kit de ressources d’extensibilité

Le manifeste de charge de travail (WorkloadManifest.xml) est la configuration au niveau de la charge de travail pour votre charge de travail. Il indique à Fabric quelle est votre charge de traitement et comment atteindre votre interface frontale afin que l'hôte puisse l'initialiser en toute sécurité. Il complète, mais ne remplace pas, les définitions de produit et d’élément :

  • Les métadonnées de produit (pour la découverte et la publication) résident dans Product.json.
  • Les types d’éléments et leurs comportements résident dans les manifestes d’élément et les fichiers JSON.

Définition du manifeste de charge de travail

  • Identité de la charge de travail : WorkloadName ([Organisation].[ WorkloadId]) et Version (version sémantique)
  • Modèle d’hébergement : HostingType (utilisation FERemote)
  • Application Microsoft Entra frontale : AADFEApp>AppId
  • Points de terminaison frontaux : ServiceEndpoint entrées avec Name (par exemple, Frontend), Url (localhost dans le développement; le domaine de production doit être un sous-domaine de votre domaine Entra vérifié) et IsEndpointResolutionService. Consultez conditions générales de publication pour les restrictions de domaine.
  • Relaxation facultative du bac à sable : EnableSandboxRelaxation uniquement lorsque des fonctionnalités iFrame spéciales sont requises (par exemple, le lancement de téléchargements de fichiers)

Meilleures pratiques

  • Maintenir la cohérence des versions dans votre application et votre manifeste
  • Déclarer les autorisations minimales nécessaires (principe du privilège minimum)
  • Valider le manifeste dans le cadre de l’intégration continue

Structure

Éléments clés dans le manifeste et ce qu’ils signifient :

  • Élément racine avec une version de schéma (par exemple, SchemaVersion="2.0.0").
  • Workload nœud avec des attributs tels que :
    • WorkloadName — identificateur unique dans le formulaire [Organization].[WorkloadId] (par exemple, Org.MyWorkload). Si vous n’avez pas l’intention de publier sur d’autres locataires, vous pouvez utiliser Org.[WorkloadId]. Pour la publication sur les locataires, inscrivez un nom de charge de travail complet auprès de Fabric.
    • HostingType — indique l’hébergement de charge de travail ; utiliser FERemote.
  • Version node : version sémantique de votre package de charge de travail.
  • RemoteServiceConfiguration > CloudServiceConfiguration contenant:
    • Cloud (par exemple, Public).
    • AADFEApp > AppId : contient l’ID d’application Microsoft Entra frontend.
    • EnableSandboxRelaxation — définissez-le true si vous avez besoin de fonctionnalités iFrame spéciales (par exemple, lancer des téléchargements de fichiers). Conservez false par défaut pour la sécurité.
    • Endpoints > ServiceEndpoint entrées avec :
      • Name (par exemple, Frontend).
      • Url — où le serveur frontal est hébergé. Utiliser https://localhost:port pour le développement. En production, le domaine doit être un sous-domaine de votre domaine Entra vérifié. Consultez les conditions générales de publication pour connaître les restrictions de domaine complètes.
      • IsEndpointResolutionService.

Générer des résultats et des placeholders

Dans le Starter-Kit, remplit les espaces réservés chaque fois que le manifeste est créé en fonction de la configuration dans le fichier d’environnement. Le manifeste finalisé final est créé dans le build/Manifest répertoire. L’utilisation d’espaces réservés et leur remplissage à partir des environnements vous permet de créer différents environnements sans modifier les fichiers ou les scripts. La sortie de build est utilisée par :

  • DevGateway : Inscrivez votre instance de développement locale auprès de Fabric afin que votre application puisse se charger à l’intérieur du portail Fabric pendant le développement.
  • DevServer : qui fournit les informations à l’infrastructure
  • Portail d’administration : pour les tests et la production, chargez le package de manifeste via le portail d’administration fabric dans le cadre de la publication. Consultez Publier votre charge de travail.

Learn more

Contenu connexe

  • Last updated on