Microsoft Power Platform Build Tools pour Azure DevOps
Utilisez les outils Microsoft Power Platform Build Tools pour automatiser les tâches courantes de création et de déploiement associées aux applications créées dans Microsoft Power Platform. Ces tâches incluent :
- Synchronisation des métadonnées de la solution (également appelées solutions) qui contiennent les différents composants de la plateforme, notamment :
- Les applications d’engagement client : Dynamics 365 Sales, Customer Service, Field Service, Marketing et Project Service Automation
- Applications de canevas
- Applications pilotées par modèle
- Flux de l’interface utilisateur
- Agents virtuels
- Modèles AI Builder
- Connecteurs entre les environnements de développement et le contrôle de code source
- Génération d’artefacts de build
- Déploiement dans des environnements en aval
- Approvisionnement ou désapprovisionnement des environnements
- Exécution de vérifications d’analyse statique sur les solutions à l’aide du service de vérification de Power Apps
Utilisez les tâches Microsoft Power Platform Build Tools avec toute autre tâche Azure DevOps pour composer vos pipelines de build et de mise en production. Les pipelines que les équipes mettent généralement en place incluent Initiate, Export from Dev, Build et Release.
Note
Les outils Microsoft Power Platform Build Tools ne sont pris en charge que dans les environnements Microsoft Dataverse avec une base de données. Pour plus d’informations : Créer un environnement avec une base de données
Microsoft Power Platform Build Tools sont maintenant disponibles pour une utilisation dans les régions GCC et GCC High.
En quoi consistent Microsoft Power Platform Build Tools ?
Les outils Microsoft Power Platform Build Tools sont un ensemble de tâches de build Azure DevOps spécifiques à Power Platform qui permettent d’éviter de télécharger manuellement des outils et des scripts personnalisés pour gérer le cycle de vie des applications créées sur Microsoft Power Platform.
Vous pouvez utiliser les tâches individuellement, par exemple importer une solution dans un environnement en aval, ou ensemble dans un pipeline afin d’orchestrer un scénario, par exemple générer un artefact de build, déployer à des fins de test ou récolter les modifications du créateur. Les tâches de build peuvent principalement être classées en quatre types :
- Aide
- Contrôle de la qualité
- Solution
- Gestion des environnements
Pour plus d’informations sur les tâches disponibles, voir Tâches Microsoft Power Platform Build Tools.
Qu’est-ce que Power Platform Build Tools version 2.0 ?
En plus des fonctionnalités offertes par Power Platform Build Tools, la version 2.0 de Power Platform Build Tools est basée sur la CLI Power Platform.
Power Platform Build Tools version 1.0 est basé sur PowerShell. Power Platform Build Tools 2.0 est la version qui sera mise en service et des fonctionnalités plus récentes ajoutées.
Pour les versions précédentes de Power Platform Build Tools, nous effectuerons des mises à jour de sécurité critiques si nécessaire. Nous recommandons vivement aux clients de passer au plus tôt à Power Platform Build Tools version 2.0.
Important
Vous ne pouvez pas mélanger les versions de tâche pour Power Platform Build Tools dans votre pipeline de build.
Obtenir Microsoft Power Platform Build Tools
Microsoft Power Platform Build Tools peut être installé dans votre organisation Azure DevOps à partir de Place de marché Azure.
Une fois installés, toutes les tâches incluses dans Microsoft Power Platform Build Tools seront disponibles pour être ajoutées à n’importe quel pipeline, nouveau ou existant. Vous pouvez les trouver en recherchant "Power Platform".
Connexion aux environnements
Pour interagir avec l’environnement Microsoft Power Platform, vous devez établir une connexion afin que les tâches de l’outil de build puissent effectuer les actions requises. Il existe deux types de connexions disponibles :
| Connection type | Description |
|---|---|
| Principal de service et clé secrète client (recommandé) | Utilise l’authentification basée sur le principal de service et prend en charge l’authentification multifacteur |
| Nom d′utilisateur/mot de passe | Une connexion de service générique avec un nom d’utilisateur et un mot de passe. Ne prend pas en charge l’authentification multifacteur. |
Configurer les connexions de service à l’aide d’un principal de service
Pour configurer une connexion à l’aide du principal de service, vous devez d’abord disposer d’un profil Power Platform authentifié avec les autorisations requises. Vous devez ajouter une application Microsoft Entra ID et l’utilisateur associé de l’application à l’environnement Dataverse.
Créer un principal de service et une clé secrète client
Utilisez la commande pac admin create-service-principal pour créer et configurer le principal de service à utiliser avec les tâches Microsoft Power Platform Build Tools.
Cette commande enregistre d’abord un objet Application et le nom du principal de service (SPN) correspondant dans Microsoft Entra ID. Ensuite, elle ajoute l’application en tant qu’utilisateur administrateur au locataire Microsoft Power Platform.
Cette commande comporte deux paramètres :
| nom | nom court | Requise | Description |
|---|---|---|---|
environment |
env |
Oui | ID ou URL de l’environnement auquel ajouter un utilisateur d’application. |
role |
r |
No | Nom ou ID du rôle de sécurité à appliquer à l’utilisateur de l’application. La valeur par défaut est « Administrateur système ». Le vérificateur de solutions nécessite un rôle avec le privilège prvAppendmsdyn_analysisjob à ajouter à la table msdyn_analysisjob. Le rôle Administrateur système dispose de ce privilège par défaut. |
Vous pouvez l’utiliser comme suit :
C:\> pac admin create-service-principal --environment <environment id>
En cas de réussite, quatre colonnes s’affichent :
- ID client Power Platform
- Application ID
- Clé secrète client (en texte clair)
- Expiration
Par exemple :
PS C:\>pac admin create-service-principal --environment d3fcc479-0122-e7af-9965-bde57f69ee1d
Connected as admin@M365x57236726.onmicrosoft.com
Successfully assigned user adde6d52-9582-4932-a43a-beca5d182301 to environment d3fcc479-0122-e7af-9965-bde57f69eeld with security role System Administrator
Tenant ID Application ID Client Secret Expiration
2b0463ed-efd7-419d-927d-a9dca49d899c adde6d52-9582-4932-a43a-beca5d182301 beY8Q~JBZ~CBDgIKKBjbZ3g6BofKzoZkYj23Hbf 7/31/2024 4:27:03 PM
Utilisez les informations affichées pour configurer la connexion du service Power Platform.
Important
Gardez la clé secrète client en toute sécurité. Une fois l’invite de commandes effacée, vous ne pouvez plus récupérer la même clé secrète client.
Configurer l’environnement avec l’ID d’application
Vous devez ajouter l’ID d’application en tant qu’utilisateur d’application dans l’environnement Microsoft Power Platform auquel vous vous connectez. Il existe deux façons d’y parvenir.
- Vous pouvez consulter cet article : Création d’un utilisateur de l’application.
- Vous pouvez utiliser Power Platform CLI. Par exemple :
PS C:\>pac admin assign-user --user "adde6d52-9582-4932-a43a-beca5d182301" --role "System administrator" --environment d3fcc479-0122-e7af-9965-bde57f69ee1d --application-user
Connected to... SnDemoDev
Connected as admin@M365x57236726.onmicrosoft.com
Successfully assigned user adde6d52-9582-4932-a43a-beca5d182301 to environment d3fcc479-0122-e7af-9965-bde57f69ee1d with security role System Administrator
Assurez-vous que l’utilisateur d’application ajouté a le rôle d’administrateur système attribué (disponible dans « Gérer les rôles » dans les paramètres de sécurité de l’utilisateur d’application).
Forum Aux Questions (FAQ)
Est-ce que mes anciens pipelines Microsoft Power Platform Build Tools continuent de fonctionner ?
Les pipelines plus anciens continuent de fonctionner, mais les nouvelles fonctionnalités ne sont pas ajoutées aux tâches plus anciennes. Si vous souhaitez tester les fonctionnalités les plus récentes, nous vous recommandons vivement de modifier la version de votre tâche dans le pipeline.
Pourquoi avez-vous basé la nouvelle tâche sur la CLI Power Platform au lieu de PowerShell ?
Les tâches Power Platform CLI sont multiplateformes avec une grande flexibilité, y compris l’exécution sur Linux. Ce sont les mêmes tâches qui sont disponibles avec les actions Power Platform pour GitHub. Vous avez maintenant une expérience cohérente entre Azure DevOps et GitHub.
Les outils Microsoft Power Platform Build Tools fonctionnent-ils uniquement pour Power Apps ?
Les Build Tools fonctionnent à la fois pour les applications canevas et pilotées par modèle, Power Virtual Agents, les flux d’interface utilisateur et les flux traditionnels, AI Builder, les connecteurs personnalisés et les dataflows, qui peuvent tous désormais être ajoutés à une solution. Cette liste comprend également les applications d’engagement client (Dynamics 365 Sales, Customer Service, Field Service, Marketing et Project Service Automation). Des tâches de build distinctes sont disponibles pour les applications de finances et d’opérations.
J’avais précédemment installé la version préliminaire de Build Tools - puis-je mettre à niveau à partir de la version préliminaire de Power Apps Build Tools vers Power Platform Build Tools ?
Vous ne pouvez pas effectuer une mise à niveau à partir de la version préliminaire car nous avons dû introduire des changements importants dans la version à disponibilité générale. Pour ne plus utiliser la version préliminaire, vous devez installer Microsoft Power Platform Build Tools et recréez vos pipelines ou reconfigurez vos pipelines existants pour utiliser les nouvelles tâches Build Tools. Vous devez également créer de nouvelles connexions de service.
Puis-je inclure un flux et des applications canevas ?
Oui, les flux et les applications canevas sont disponibles pour les solutions, donc si ces composants sont ajoutés à votre solution, ils peuvent participer au cycle de vie de votre application. Cependant, certaines étapes nécessitent toujours des configurations manuelles. La nécessité d’une configuration manuelle sera abordée plus tard cette année lorsque nous introduirons les variables d’environnement et les connecteurs. Une liste des limitations actuelles est disponible ici : Limitations connues.
Combien coûtent Microsoft Power Platform Build Tools ?
Les Build Tools sont disponibles gratuitement. Toutefois, un abonnement valide à Azure DevOps est nécessaire pour utiliser les Build Tools. De plus amples informations sont disponibles dans Tarification pour Azure DevOps.
Je peux voir l’extension, mais pourquoi n’ai-je pas d’option pour l’installer ?
Si vous ne voyez pas l’option installer, vous ne disposez probablement pas des privilèges d’installation nécessaires dans votre organisation Azure DevOps. De plus amples informations sont disponibles dans Gérer les autorisations d’extension.
Comment les développeurs peuvent-ils utiliser les résultats de la tâche de vérificateur ?
La sortie de la tâche Vérificateur est un Fichier Sarif et les extensions VS Code et Visual Studio sont disponibles pour visualiser et prendre des mesures sur les fichiers Sarif.
Voir aussi
Tâches de build tools
Labos Microsoft Power Platform Build Tools