Configuration de l’intégration de Git Dataverse (version préliminaire)
[Cet article fait partie de la documentation préliminaire et peut faire l’objet de modifications.]
L’intégration de Git dans Dataverse est initiée depuis Power Platform dans la zone Solutions dans Power Apps (make.powerapps.com). Cet article traite de l’intégration de solutions Dataverse avec Git, en se concentrant sur la connexion à Azure DevOps et la liaison à votre environnement pour Dynamics 365 et Power Platform.
Important
- Cette fonctionnalité est en version préliminaire.
- Les fonctionnalités en version préliminaire ne sont pas destinées à une utilisation en production et peuvent être restreintes. Ces fonctionnalités sont disponibles avant une publication officielle afin que les clients puissent y accéder de façon anticipée et fournir des commentaires.
- Cette fonctionnalité n’est actuellement disponible que pour les environnements qui ont été créés pour des cycles de lancement anticipés. Accédez à Environnements du cycle de lancement anticipé.
Conditions préalables à l’intégration de Git avec Dataverse
Dataverse Fonctionnalité d’intégration Git des Environnements gérés. Les environnements de développement doivent être activés en tant qu’environnements gérés pour utiliser la fonctionnalité.
Un abonnement Azure DevOps et des licences pour les utilisateurs qui interagissent avec le contrôle de code source sont requis lors de la connexion de votre environnement Dataverse à Git.
Note
Un nombre limité de licences est disponible dans Azure DevOps dans le plan de base du service. Accédez aux Services Azure DevOps pour plus d’informations sur les licences et la tarification pour Azure DevOps.
L’autorisation Azure DevOps Services pour effectuer des validations et lire les fichiers sources est requise. Les membres du groupe de sécurité Contributeurs ont l’autorisation.
Un environnement Power Platform avec Dataverse et le rôle de sécurité Administrateur système est requis pour se connecter à Git, ce qui termine la liaison initiale de votre environnement ou de votre solution à un projet dans Azure DevOps.
Configuration d’Azure DevOps
Pour démarrer, vous avez besoin d’un projet Azure DevOps et d’un référentiel auxquels connecter votre environnement Dataverse. Si vous n’avez pas encore configuré de projet et de référentiel Azure DevOps, procédez comme suit pour créer un projet et un référentiel dans Azure DevOps.
- Connectez-vous à Azure DevOps et sélectionnez votre organisation.
- Sélectionnez Nouveau projet, entrez un nom et assurez-vous que votre contrôle de version est défini sur Git pour votre projet, puis sélectionnez Créer.
- Dans le nouveau projet, sélectionnez Référentiels, puis sélectionnez Initialiser en bas de la page pour initialiser le référentiel par défaut.
Assurez-vous que tous les utilisateurs qui apportent des modifications dans votre environnement ont accès à votre référentiel et peuvent valider les modifications. Passez en revue votre configuration de licences et vos groupes de sécurité Azure DevOps pour vous assurer qu’ils peuvent utiliser le panneau de contrôle de code source de la solution.
Connecter Dataverse à Git
Pour connecter votre environnement Dataverse à Git, liez votre environnement à un projet dans Azure DevOps. Vous pouvez lier votre environnement à un projet à l’aide d’une liaison d’environnement ou de solution. Pour en savoir plus sur les différences entre la liaison d’environnement et la liaison de solution, accédez à Comment choisir entre la liaison d’environnement et la liaison de solution.
Connectez-vous à Power Apps, puis accédez à Solutions.
Dans la zone Solutions, sélectionnez Se connecter à Git dans la barre de commandes.
Sélectionnez Environnement ou Solution depuis les options du type de connexion, et sélectionnez votre organisation et votre projet Azure DevOps.
Important
Une fois définis, ces paramètres ne peuvent plus être modifiés.
Pour plus d’informations sur les différences entre la liaison d’environnement et de solution, consultez la section suivante.
En fonction de votre type de liaison, vous pouvez sélectionner un projet, un référentiel ou une branche et entrer un dossier auquel lier l’environnement ou la solution. Sélectionnez Se connecter.
Comment choisir entre la liaison d’environnement et la liaison de solution
Important
Ces liaisons ne peuvent pas être modifiées après la configuration initiale, il est donc important de choisir la bonne stratégie de liaison pour votre organisation et votre environnement.
Si vous ne savez pas quelle stratégie de liaison utiliser, la liaison d’environnement est l’approche recommandée pour commencer à intégrer Git dans Dataverse. Voici quelques différences clés entre la liaison d’environnement et la liaison de solution pour vous aider à choisir l’approche qui vous convient le mieux.
Liaison d’environnement
La liaison d’environnement est un processus unique permettant de lier l’ensemble de votre environnement Dataverse et toutes les solutions et composants non gérés de l’environnement dans un référentiel et un dossier uniques. Lorsque vous choisissez de lier l’ensemble de l’environnement, toutes les personnalisations non gérées effectuées dans toute solution personnalisée non gérée sont stockées dans un seul dossier et une seule branche Git, et vous n’avez pas besoin de configurer d’autres solutions une fois sélectionnées. Le système permet à plusieurs solutions d’utiliser un seul emplacement de dossier racine et garde une trace des composants appartenant à chaque solution dans un fichier distinct. Il n’est plus nécessaire d’utiliser un dossier racine unique pour chaque solution. Si vous utilisez la liaison d’environnement, vous pouvez sélectionner le référentiel, la branche et le dossier auxquels lier l’environnement lors de la configuration initiale.
Liaison de solution
La liaison de solution peut être utilisée pour la gestion de version de plusieurs solutions au sein du même environnement afin de séparer les référentiels ou les dossiers. La liaison de solution offre une flexibilité supplémentaire dans l’organisation de vos fichiers sources, mais nécessite plus de gestion de la part des créateurs pour intégrer de nouvelles solutions au contrôle de code source. Le système exige qu’il n’y ait qu’un seul emplacement dans le contrôle de code source pour chaque objet de solution, ce qui signifie que si vous choisissez de lier des solutions à différents emplacements source, le système ne vous permet pas d’avoir le même composant dans plusieurs solutions. La liaison de solution ne nécessite pas la sélection d’un référentiel ou d’une solution lors de la configuration initiale. Au lieu de cela, vous sélectionnez le référentiel et le dossier auxquels lier chaque solution lorsque vous êtes prêt à lier la solution au contrôle de code source.
Autres considérations
Si vous sélectionnez la liaison d’environnement, toutes les nouvelles solutions non gérées sont automatiquement synchronisées avec le code source sans autre action, et si vous sélectionnez par liaison de solution, la création ultérieure d’une solution nécessite que la solution soit également configurée pour le contrôle de code source avant d’être synchronisée avec le contrôle de code source. Pensez à la sécurité de la synchronisation de toutes les solutions par rapport à la flexibilité d’avoir différents dossiers et liens de code source pour chaque solution.
Liaison d’une solution à un référentiel et à un dossier (lors de l’utilisation de la stratégie de liaison de solution)
Une fois que vous avez connecté votre environnement à Git à l’aide de la stratégie de liaison de solution, vous pouvez lier une solution à un référentiel et à un dossier dans le même projet Azure DevOps.
- Dans la zone Solutions, sélectionnez les trois points verticaux en regard de la solution que vous souhaitez associer à la gestion de versions, puis sélectionnez Connecter à Git.
- Sélectionnez une branche existante ou créez-en une, entrez un dossier Git auquel lier la solution, puis sélectionnez Connecter.
Valider votre connexion
Pour valider votre connexion à Git, créez une solution ou apportez des modifications à une solution existante et affichez les modifications en procédant comme suit :
- Sur la page Solutions, ouvrez la solution dans laquelle vous souhaitez afficher les modifications.
- Dans le volet de gauche, sélectionnez Contrôle de code source pour afficher les modifications apportées à la solution.
Vous pouvez maintenant afficher les modifications apportées à la solution et valider et pousser les modifications vers le référentiel, ainsi qu’afficher la branche actuelle à laquelle votre solution est liée.
Étapes suivantes
Une fois votre environnement et vos solutions connectés à Git, vous pouvez commencer à apporter des modifications à vos solutions, ainsi qu’à valider et appliquer ces modifications au référentiel. Pour plus d’informations sur les opérations de contrôle de code source, accédez à Opérations du référentiel de contrôle de code source (version préliminaire).