Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Dans ce tutoriel, vous allez apprendre à :
- Créer un nouveau dépôt GitHub
- Créez deux flux de travail GitHub à l’aide de GitHub Actions pour Microsoft Power Platform
Les workflows peuvent exporter automatiquement votre application (en tant que solution non gérée) à partir d’un environnement de développement, générer un artefact de construction (solution gérée) et déployer l’application dans votre environnement de production. Ce tutoriel utilise la solution ALMLab que vous avez créée et les environnements que vous avez configurés dans les didacticiels précédents.
Tutoriels associés : Premier pas, et Créer une application pilotée par modèle.
Créer un compte GitHub
Accédez à https://github.com et sélectionnez S’inscrire ou démarrer un essai gratuit (ou connectez-vous si vous disposez d’un compte existant).
Après avoir créé votre compte, créez un dépôt en sélectionnant Créer un dépôt ou Nouveau.
Vous pouvez voir l’écran d’accueil alternatif suivant :
Créez votre nouveau dépôt et nommez-le
poweractionslab. Veillez à sélectionner Ajouter un fichier README pour lancer le référentiel et choisissez Créer un référentiel.
Création d’un nouveau secret pour l’authentification du principal de service
Accédez à votre référentiel et sélectionnez Paramètres. Développez Secrets, puis sélectionnez Actions.
Dans la page Secrets , nommez le secret
PowerPlatformSPN. Entrez la clé secrète client à partir de l’inscription de l’application que vous avez créée dans Microsoft Entra dans le champ Valeur, puis sélectionnez Ajouter un secret. Vous référencerez la clé secrète client dans les fichiers YML qui définissent les flux de travail GitHub plus loin dans ce tutoriel.
La clé secrète client est maintenant stockée de manière sécurisée en tant que secret GitHub.
Créez un flux de travail pour exporter et décompresser le fichier de solution dans une nouvelle branche
Sélectionnez Actions, puis configurez un flux de travail vous-même. Vous pouvez également sélectionner Configurer dans la zone Flux de travail simple sous la section suggérée pour ce référentiel.
Vous voyez un nouveau fichier YAML avec un flux de travail de base pour vous aider à prendre en main GitHub actions.
Supprimez le contenu précréé, puis collez le contenu du fichier export-and-branch-solution-with-spn-auth.yml . Renommez le fichier en
export-and-branch-solution.yml.
Mettez à jour
<ENVIRONMENTURL>avec l’URL de l’environnement de développement à partir duquel vous souhaitez exporter (Par exemple :https://poweractionsdev.crm.dynamics.com).Mettre à jour
<APPID>et<TENANT ID>avec vos valeurs.Si vous utilisez des informations d’identification, collez le fichier export-and-branch-solution.yml au lieu du contenu du fichier export-and-branch-solution-with-spn-auth.yml. Mettez à jour
<USERNAME>avec le nom d’utilisateur que vous utilisez pour vous connecter à l’environnement.
Astuce
Si vous n'êtes pas familiarisé avec GitHub Actions et que vous souhaitez en savoir plus, consultez la documentation officielle à l'adresse https://docs.github.com/en/actions.
Vous êtes maintenant prêt à valider vos modifications. Sélectionner Commencer la validation, tapez Créer un yml d’exportation dans le champ de titre, puis ajoutez une description (facultatif). Ensuite, cliquez sur Valider un nouveau fichier.
Félicitations, vous avez créé votre premier flux de travail GitHub à l’aide des actions suivantes :
- Qui suis-je : garantit que vous pouvez vous connecter avec succès à l’environnement à partir duquel vous souhaitez exporter.
- Solution d’exportation : permet d’exporter le fichier de solution depuis votre environnement de développement.
- Décompresser la solution : le fichier solution que le serveur exporte est un fichier compressé (zip) avec des fichiers de configuration consolidés. Ces fichiers initiaux ne conviennent pas à la gestion du code source, car ils ne sont pas structurés pour permettre aux systèmes de gestion du code source d’effectuer correctement un diff sur les fichiers et d’enregistrer les modifications que vous souhaitez valider dans la gestion de versions. Vous devez décompresser les fichiers de solution pour les rendre adaptés au stockage et au traitement du contrôle de code source.
- Solution de branche : permet de créer une branche pour stocker la solution exportée.
Tester l’exportation et décompresser le workflow
Ensuite, vérifiez que le workflow s’exécute. Accédez à Actions, sélectionnez Exécuter le flux de travail, puis exécutez le flux de travail. Si vous utilisez un autre nom de solution que
ALMLab, modifiez la valeur ici, mais conservez les autres valeurs identiques.
Après 5 à 10 secondes, le flux de travail démarre. Vous pouvez sélectionner le flux de travail en cours d’exécution pour surveiller la progression.
Une fois le flux de travail terminé, vérifiez qu’une nouvelle branche est créée avec la solution décompressée dans le dossier
solutions/ALMLab. Accédez à l’onglet Code et développez la liste déroulante branches.Sélectionnez la branche que l’action a créée.
Vérifiez que le
solutions/ALMLabdossier est créé dans la nouvelle branche. Ensuite, créez une pull request pour fusionner les modifications dans la branche principale. Sélectionnez Contribuer et dans le menu volant sélectionnez Ouvrir la demande d’extraction.Dans l’écran Ouvrir une pull request, ajoutez un titre et une description si vous le souhaitez, puis sélectionnez Créer une pull request.
L’écran est mis à jour pour afficher la nouvelle pull request. Lorsque vous créez la pull request, vous obtenez la confirmation que votre branche n’a aucun conflit avec la branche principale. Cette confirmation signifie que les modifications peuvent être fusionnées automatiquement dans la branche principale. Sélectionnez Demande d’extraction de fusion, puis sélectionnez Confirmer la fusion. Si vous le souhaitez, sélectionnez supprimer la branche pour supprimer la branche obsolète.
Revenez à la branche par défaut (principale) et vérifiez que la solution y est disponible sur cette branche.
Créer un workflow réutilisable pour générer un artefact de build et l’importer en production
Dans cette section, créez un workflow supplémentaire qui :
- Crée une solution gérée et le publie en tant qu’artefact GitHub
- Importe l’artefact de création dans l’environnement de production
Accédez à Actions et sélectionnez Nouveau flux de travail.
Choisir configurer vous-même un workflow.
Renommez le titre du flux de travail en
release-solution-to-prod-with-inputs. Copiez le contenu du fichier release-solution-to-prod-with-inputs.yml et collez-le dans l’écran Modifier le nouveau fichier .
Validez les modifications. Choisissez Démarrer la validation, puis ajoutez un titre et une description (facultatif). Ensuite, cliquez sur Valider un nouveau fichier.
Appelez le workflow réutilisable sur l’événement de publication
Dans cette section, vous appelez le flux de travail réutilisable sur l’événement release.
Accédez à Actions et sélectionnez Nouveau flux de travail.
Choisir configurer vous-même un workflow.
Renommez le titre du flux de travail en
release-action-call. Copiez le contenu du fichier release-action-call.yml et collez-le dans l’écran Modifier le nouveau fichier .
Mettez à jour les variables suivantes dans le nouveau fichier de workflow :
- Mettez à jour
<BUILD_ENVIRONMENT>avec l’URL de l’environnement de création que vous utilisez pour générer la solution gérée. Par exemple :https://poweractionsbuild.crm.dynamics.com. - Mettez à jour
<PROD_ENVIRONMENT>avec l’URL de l’environnement de production sur lequel vous effectuez le déploiement. Par exemple :https://poweractionsprod.crm.dynamics.com. - Mettez à jour
<APP_ID>avec l’ID d’application (client) que vous trouvez dans le panneau inscriptions d'applications de Microsoft Portail Azure en sélectionnant l’inscription que vous avez créée précédemment dans ce didacticiel. - Mettez à jour
<TENANT_ID>avec l’ID de répertoire (abonné) qui se trouve dans la Lame d’enregistrements d’applications du portail Microsoft Azure en sélectionnant l’enregistrement créé précédemment dans ce didacticiel.
- Mettez à jour
Enregistrez les modifications. Choisissez Démarrer la validation puis ajoutez un titre (facultatif) et une description (facultatif). Ensuite, cliquez sur Valider un nouveau fichier.
Tester la mise en production du workflow
Vous êtes maintenant prêt à tester le dernier flux de travail. Ce flux de travail se déclenche lorsqu’une nouvelle version est déployée en production.
Accédez à Versions.
Sélectionnez Créer un brouillon d’une nouvelle version.
Ajoutez une balise de version, un titre et choisissez Publier la version.
Sélectionnez Actions pour afficher le workflow en cours.
Choisissez le workflow en cours pour afficher les actions au fur et à mesure de leur exécution.
Attendre que chaque action se termine.
Une fois le flux de travail terminé, connectez-vous à votre environnement de production et vérifiez que la solution est déployée en tant que solution managée.
Déployer la mise à jour et examiner les modifications avant la sortie de production
Testez le processus de bout en bout, puis découvrez comment afficher et valider les modifications apportées à une application avant de la déployer en production.
Accédez à la solution ALMLab dans votre environnement de développement, puis sélectionnez Modifier ou sélectionner le nom complet de la solution.
Sélectionnez et affichez la table Demande d’absence.
Sélectionnez + Ajouter une colonne et créez la nouvelle colonne, comme indiqué dans la figure suivante.
Valeurs de champ mises à jour:**
- Nom d’affichage : approuvé
- Type de données : Oui/Non
Sélectionnez Terminé.
Sélectionnez Enregistrer la table.
Revenez à votre onglet Actions des référentiels GitHub, sélectionnez Exécuter le workflow, et sélectionnez le bouton Exécuter le workflow.
Après 5 à 10 secondes, le flux de travail démarre. Sélectionnez le flux de travail en cours d’exécution pour surveiller sa progression.
Une fois le flux de travail terminé, accédez à la nouvelle branche en sélectionnant Code , puis Branches.
Sélectionnez la branche que vous avez créée en développant contribute et en sélectionnant Ouvrir une pull request.
Ajoutez un titre (facultatif), puis sélectionnez Créer une demande d’extraction.
Une fois le contenu mis à jour, sélectionnez l’onglet Fichiers modifiés .
Notez que les modifications apportées à la solution sont surlignées en vert pour indiquer que cette section du fichier a été ajoutée par rapport au même fichier dans la branche principale.
Revenez à l’onglet Conversation. Sélectionnez Demandes d’extraction, puis sélectionnez la demande d’extraction précédemment créée.
Sur la page Demande d’extraction, sélectionnez Écraser et fusionner pour fusionner le fichier de solution mis à jour dans votre branche principale. Si vous le souhaitez, supprimez cet élément désormais fusionné en principal.
Suivez les étapes de la section Tester la mise en production du workflow pour créer une version et valider que la solution mise à jour a été déployée dans votre environnement de production.
Félicitations, vous avez correctement configuré un exemple de flux de travail CI/CD à l’aide de GitHub actions !