Configurer les pipelines ALM Accelerator
Les pipelines sont les moteurs d’ALM Accelerator. Ils automatisent le processus ALM pour Power Platform. Ils sont créés à l’aide d’Azure Pipelines, un service de Azure DevOps, et stockés dans un Azure DevOps projet.
Quatre pipelines principaux sont utilisés pour automatiser le processus ALM :
- Import
- Export
- Delete
- Créer/Déployer
Les pipelines sont conçus pour être utilisés avec l’application canevas ALM Accelerator. Vous n’avez pas besoin d’utiliser cette application, mais nous le recommandons. L’application fournit une interface simple pour appeler les pipelines et un moyen de les configurer sans avoir à comprendre les paramètres sous-jacents.
Scénarios courants de pipeline d’ALM Accelerator
Les pipelines ALM Accelerator et l’application ont des configurations par défaut qui vous permettent de démarrer rapidement avec ALM pour Power Platform. Les pipelines peuvent couvrir de nombreux scénarios ALM différents pour répondre aux exigences de votre organisation. Vous trouverez ci-dessous une description de certains scénarios courants et de la manière dont ils peuvent être couverts par la configuration des pipelines et les profils et étapes de déploiement associés dans l’application ALM Accelerator, ou directement via le pipeline.
Installer des pipelines dans un projet et du code source dans un autre projet
Dans l’application ALM Accelerator et dans les profils de déploiement, vous pouvez spécifier un projet de pipeline et un projet source. Une option dans le Assistant Installation pour spécifier un projet de pipeline et un référentiel distincts. Ces options sont utiles si vous souhaitez segmenter le stockage des solutions en fonction des utilisateurs, de la structure de l’entreprise ou d’autres facteurs. Dans la plupart des cas, les fichiers YAML du pipeline sont stockés dans le projet de pipeline et les pipelines d’exportation, d’importation et de suppression sont créés dans le projet où la solution est contrôlée par la source.
Exécutez les pipelines sans ALM Accelerator
L’application canevas ALM Accelerator fournit une couche de boutons simple pour exécuter les pipelines. Cependant, vous n’avez pas besoin de l’application pour les exécuter. Si vous souhaitez utiliser les pipelines indépendamment de l’application, exécutez-les directement à partir de la ligne de commande. Vous pouvez également générer votre propre application. Utilisez un connecteur personnalisé pour l’API Azure DevOps, inclus dans la solution ALM Accelerator qui peut être utilisée avec Power Automate pour appeler les pipelines ou d’autres technologies Power Platform.
Dans dles deux cas, pour utiliser indépendante des pipelines consiste à comprendre les paramètres transmis.
Paramètres de pipeline
Paramètres pour import-unmanaged-to-dev-environment : Utilisez le pipeline d’importation de solutions pour importer une solution non gérée à partir du contrôle de source dans un environnement de développement environnement.
Le tableau suivant décrit les paramètres d’importation du pipeline.
| Paramètre | Exemple | Description |
|---|---|---|
| Project | Mon projet Azure DevOps | Le nom du projet dans lequel importer la solution |
| Repo | Mon référentiel Azure DevOps | Le nom du référentiel depuis lequel importer la solution |
| SolutionName | NomDeMaSolution | Le nom de la solution à importer |
| me@example.com | L’adresse e-mail de l’utilisateur qui importe la solution | |
| UserName | Nom, Prénom | Le nom d’utilisateur de l’utilisateur qui importe la solution |
| Agence | main | La branche à partir de laquelle construire et importer la solution |
| ServiceConnectionName | Maconnexionauservice | Le nom de la connexion au service à utiliser pour l’importation |
| ServiceConnectionUrl | exemple.crm.dynamics.com | URL de l’environnement de création pour l’importation |
| EnvironmentName | MonEnvironnementDev | Utilisé pour rechercher les paramètres de déploiement dans le pipeline de déploiement ; renvoie un nom de dossier sous le répertoire de configuration dans la source de la solution |
Paramètres pour delete-unmanaged-solution-and-components : Utilisez le pipeline de suppression de solution pour supprimer une solution non gérée et tous ses composants d’un développement environnement.
Le tableau suivant décrit les paramètres de suppression du pipeline.
| Paramètre | Exemple | Description |
|---|---|---|
| SolutionName | NomDeMaSolution | Nom de la solution à supprimer |
| ServiceConnectionName | Maconnexionauservice | Le nom de la connexion au service à utiliser pour la solution à supprimer |
| ServiceConnectionUrl | exemple.crm.dynamics.com | URL de l’environnement de création de la solution à supprimer |
Paramètres pour export-solution-to-git : Utilisez le pipeline de solution d’exportation pour exporter la solution vers un référentiel Git.
Le tableau suivant décrit les paramètres d’exportation du pipeline.
| Paramètre | Exemple | Description |
|---|---|---|
| Project | Mon projet Azure DevOps | Le nom du projet vers lequel exporter le code source de la solution |
| Repo | Mon référentiel Azure DevOps | Le nom du référentiel vers lequel exporter le code source de la solution |
| SolutionName | NomDeMaSolution | Le nom de la solution à exporter |
| me@example.com | L’adresse e-mail de l’utilisateur qui exporte la solution | |
| UserName | Nom, Prénom | Le nom d’utilisateur de l’utilisateur qui exporte la solution |
| CommitMessage | Correction du bogue n° 1234 | Une description des modifications à stocker dans la validation dans le référentiel |
| Agence | main | Soit la branche source à partir de laquelle créer une branche, soit la branche existante dans laquelle opérer la validation |
| BranchToCreate | fonctionnalité-1234 | Nom unique d’une nouvelle branche à créer en fonction du paramètre Branch si nécessaire |
| ServiceConnectionName | Maconnexionauservice | Le nom de la connexion au service à utiliser pour l’exportation de la solution |
| ServiceConnectionUrl | exemple.crm.dynamics.com | URL de l’environnement de création où la solution non gérée à exporter existe |
| Données | [JSON Paramètres de déploiement] | Chaîne JSON contenant les paramètres de déploiement à utiliser pour l’exportation et la configuration des pipelines de déploiement |
| PortalSiteName | SiteDeMonPortail | Le nom du site web Power Pages associé à la solution à exporter |
Personnaliser le contrôle de version des solutions lors de l’utilisation des pipelines ALM Accelerator pour les exporter ou les déployer
Par défaut, les versions des solutions exportées et déployées utilisent le nom spécifié dans le fichier YAML du pipeline de déploiement. Toutefois, les pipelines ALM Accelerator vous permettent de personnaliser le contrôle de version d’une solution à son exportation ou déploiement. Les sections suivantes présentent les méthodes disponibles.
Contrôle de version exporté
Utilisez le numéro de version exporté par les pipelines comme numéro de version dans tous les environnements déployés. Créez une variable appelée UseSolutionVersionFromDataverse dans votre pipeline d’exportation ou une variable globale dans la bibliothèque de variables pour ALM Accelerator. Donnez-lui une valeur de True. La variable garantit que le numéro de version exporté dans votre solution est conservé dans les environnements en aval et se reflète également dans votre contrôle de code source lorsque la source de la solution est validée.
Logique de contrôle de version personnalisée
Utilisez les crochets ALM Accelerator pour définir la version de la solution. Ajoutez votre logique personnalisée au build-solution-pack-pre-hook.yml modèle pour manipuler Solution.xml directement ou en utilisant d’autres outils comme version de la solution pac.
Gestion des versions personnalisée de vos propres modèles
La possibilité d’apporter vos propres modèles pour générer des pipelines de déploiement offre une flexibilité pour le contrôle de version lors de l’exportation initiale d’une solution. Par exemple, créez une copie d’un build-deploy-validation/test/prod-SampleSolution.yml et remplacez le nom de build par défaut par une stratégie de gestion des versions basée sur configurer les numéros d’exécution ou de génération :
build:
- name: 1.0.$(Date:yyyyMMdd)$(Rev:.r)
...
Une fois vos modèles en place, mettre à jour les étapes de déploiement dans votre profil de déploiement pour pointer vers eux.
Personnaliser le nombre d’étapes de déploiement dans vos pipelines et les noms des environnements cibles
À l’instar du contrôle de version personnalisé avec modèles, la possibilité d’apporter vos propres modèles pour générer des pipelines de déploiement offre une plus grande flexibilité lorsque les pipelines de déploiement sont générés lors de l’exportation initiale d’une solution. Spécifier le projet dans lequel vos modèles existent et le chemin d’accès au modèle à utiliser pour générer les pipelines de déploiement. Les paramètres du projet et du chemin d’accès résident dans la table Profil de déploiement et étapes de déploiement dans l’application d’administration ALM Accelerator.
Le chemin d’accès au modèle est relatif à la racine de l’emplacement du pipeline d’exportation. Par exemple, le chemin d’accès aux modèles de pipeline de déploiement d’environnement de validation par défaut est /Pipelines/build-deploy-validation-SampleSolution.yml. Pour utiliser un modèle dans le même projet que le pipeline d’exportation, spécifiez le chemin en tant que /Pipelines/build-deploy-validation-MyCustomTemplate.yml.
La table suivante décrit des espaces réservés ans les modèles pour les valeurs spécifiques à la solution suivantes qui sont remplacées lorsque le pipeline de déploiement est généré.
| Espace réservé | Description |
|---|---|
| SampleSolutionName | Nom de la solution à déployer |
| RepositoryContainingTheBuildTemplates | Référentiel contenant les modèles de build à utiliser pour le pipeline de déploiement |
| BranchContainingTheBuildTemplates | Branche contenant les modèles de build à utiliser pour le pipeline de déploiement |
| alm-accelerator-variable-group | Le groupe de variables globales que les modèles de build utilisent pour le pipeline de déploiement |
Nous vous recommandons de copier un modèle de pipeline build-deploy-validation/test/prod-SampleSolution.yml pour commencer avec votre propre modèle personnalisé.
Exécutez des étapes personnalisées dans vos pipelines sans modifier les modèles par défaut
Les modèles de pipelines ALM Accelerator ont plusieurs points d’extension, ou crochets, qui vous permettent de personnaliser les pipelines tout en réduisant au minimum les conflits de fusion dans les scénarios de mise à niveau. En savoir plus sur les hooks ALM Accelerator.
Activer/désactiver des actions spécifiques dans les pipelines
Les pipelines utilisent des variables pour déterminer si une tâche doit s’exécuter ou non ou quelle tâche parmi plusieurs possibilités doit s’exécuter. La table suivante décrit les variables qui peuvent être définies sur un pipeline individuel ou via alm-accelerator-variable-group à tous les pipelines.
Note
Pour définir ces variables pour des solutions spécifiques lors de l’exportation, créez un pipeline d’exportation spécifique basé sur le modèle de pipeline d’exportation. Nommez-la export-solution-to-git-{SolutionName}. L’application ALM Accelerator utilise ce pipeline d’exportation pour la solution plutôt que le pipeline à usage général export-solution-to-git pipeline.
| Variable | Default | Pipeline(s) | Description |
|---|---|---|---|
| GenerateDeploymentSettings | Vrai | Export | Si false, les paramètres de déploiement ne sont pas générés et stockés dans le contrôle de code source. |
| UseDeploymentSettingsPlaceholders | Vrai | Export | Si false, les paramètres de déploiement n’utilisent pas les espaces réservés et toutes les valeurs des paramètres de déploiement sont enregistrées dans les fichiers deploymentSettings.json et customDeploymentSettings.json.IMPORTANT : Les informations sensibles peuvent être enregistrées en texte brut dans vos paramètres de déploiement. Tous les utilisateurs ayant accès au contrôle de code source peuvent lire ces valeurs. Faites attention si vous définissez une valeur pour cette variable. |
| DisableFlows | False | Export | Si true, tous les flux sont désactivés dans le code source décompressée avant la validation. |
| UseSolutionVersionFromDataverse | False | Export | Si true, le numéro de version exporté dans votre solution est conservé dans les environnements en aval. Le numéro de version est reflété dans votre contrôle de code source lorsque la source de la solution est validée. |
| DoNotExportCurrentEnvironmentVariableValues | False | Export | Si true, les valeurs des variables d’environnement sont supprimées du code source de la solution décompressée. |
| PublishCustomizationsBeforeExport | Vrai | Export | Si false, les personnalisations ne sont pas publiées avant l’exportation de la solution. Cette option est utile si vous travaillez dans un environnement partagé et souhaitez uniquement exporter les dernières personnalisations publiées. |
| CacheEnabled | Vrai | Exporter/Déployer | Si false, la mise en cache des modules PowerShell est désactivée. Cette option est utile si vos pipelines exécutent le nettoyage du répertoire de cache après l’exécution des pipelines. |
| ProcessCanvasApps | Vrai | Exporter/Déployer | Si False, les applications canevas ne sont pas décompressées lors de l’exportation ou compressées lors des générations. REMARQUE : La fonctionnalité de décompression et d’emballage du canevas est actuellement dans version préliminaire . Non recommandé pour une utilisation dans des environnements de production actuellement. Cependant, vous ne pouvez pas afficher le code source du canevas dans le contrôle de code source, sauf si vous définissez cette variable sur True. |
| DisableSolutionChecker | False | Déployer | Si la valeur est true, le vérificateur de solution ne s’exécute pas sur chaque génération lancée via une demande d’extraction. |
| SkipSolutionImport | False | Déployer | Si la valeur est true, l’étape d’importation de la solution est ignorée pendant le déploiement. Cependant, d’autres activités telles que l’activation et le partage de flux doivent toujours être effectuées. |