DevGateway avec Microsoft Fabric

DevGateway est un petit outil que vous exécutez pendant le développement pour enregistrer votre instance de workload locale auprès de Fabric. Il indique au service Fabric où votre serveur frontal est hébergé (votre serveur DevServer sur localhost) et quels éléments sont disponibles, en fonction de vos manifestes. Avec DevGateway en cours d’exécution, Fabric peut charger votre interface utilisateur dans un iFrame et appeler votre serveur DevServer local pour lire les métadonnées de produit et d’élément, sans publier de package sur votre locataire.

Ce que fait DevGateway

• Inscrit une instance de charge de travail locale dans un espace de travail spécifique pour le développeur connecté actuel.
• Informez Fabric sur l'identité de votre charge de travail et votre point d'entrée à l'aide de vos manifestes.
• Route les appels d’hôte Fabric vers votre environnement local afin que la plateforme puisse charger votre front-end et découvrir des éléments pendant que vous effectuez une itération.
• Fonctionne main dans la main avec DevServer, qui héberge réellement votre frontend et expose des points de terminaison de manifeste.

Comment elle utilise les manifestes dans le développement

Votre charge de travail est guidée par les manifestes, tant en développement qu'en production. Pendant le développement :

• DevGateway utilise votre configuration locale pour publier les points d’identité et d’entrée de la charge de travail (tels que définis dans le manifeste de la charge de travail).
• Fabric appelle ensuite votre DevServer pour récupérer le manifeste produit et les manifestes d’élément via des points de terminaison locaux (par exemple, l’itinéraire du modèle), afin que le service puisse afficher les expériences de /manifests navigation, de vignettes et de création.

Cela reflète ce qui se passe au moment de la publication, mais tout reste local pour une itération rapide.

Flux de développement classique

1. Démarrez votre Serveur DevServer pour héberger le front-end sur localhost.
2. Démarrez DevGateway et connectez-vous avec un utilisateur qui est administrateur de l’espace de travail cible.
3. Ouvrez votre espace de travail Fabric et utilisez le point d’entrée de la charge de travail ; Fabric charge votre interface utilisateur dans un iFrame et découvre des éléments via vos manifestes.
4. Modifiez l’interface utilisateur et les fichiers manifestes, actualisez pour afficher immédiatement les modifications.

Consultez le didacticiel De prise en main pour obtenir des instructions de configuration pas à pas et de démarrage.

Entrées de configuration

Selon votre modèle, DevGateway lit une configuration locale qui inclut :

• Espace de travail cible pour l’inscription
• Point de terminaison frontal local (votre URL du serveur de développement)
• Chemins ou références à vos fichiers manifeste/éléments utilisés pendant le développement

Les scripts d’installation/génération de votre référentiel génèrent ou mettent à jour cette configuration automatiquement afin que DevGateway et DevServer restent synchronisés.

Conseils de dépannage

• Si l’interface utilisateur ne s’ouvre pas dans Fabric, vérifiez que vous avez démarré à la fois DevGateway et DevServer, et que vous êtes connecté à un espace de travail où vous disposez des autorisations requises.
• Si Fabric ne peut pas découvrir les éléments, vérifiez que le point de terminaison des manifestes de DevServer retourne un JSON valide et votre DevGateway pointe le service vers l’URL localhost correcte.
• Si des icônes ou des chaînes sont manquantes, vérifiez les chemins d’accès des ressources dans vos manifestes et que votre serveur DevServer les sert.

Voir aussi

• DevServer
• Vue d’ensemble du manifeste
• Manifeste de charge de travail
• Manifeste du produit
• Manifeste d'éléments