Nota
O acceso a esta páxina require autorización. Pode tentar iniciar sesión ou modificar os directorios.
O acceso a esta páxina require autorización. Pode tentar modificar os directorios.
Usa as ferramentas de compilación de Microsoft Power Platform para automatizar tarefas comúns de compilación e despregamento relacionadas con aplicacións construídas en Microsoft Power Platform. Entre estas tarefas inclúese:
- Sincronizar metadatos da solución (tamén coñecidos como solucións) que contén os distintos compoñentes da plataforma, como:
- Aplicacións de compromiso co cliente: Dynamics 365 Sales, Servizo ao Cliente, Servizo de Campo, Marketing e Project Service Automation
- Aplicacións de lenzo
- Aplicacións controladas por modelos
- fluxos de interface de usuario
- Axentes virtuais
- Modelos de AI Builder
- Conectores entre contornos de desenvolvemento e control de fontes
- Xeración de artefactos de compilación
- Implantación en ambientes descendentes
- Contornas de aprovisionamento ou desaprovisionamento
- Realizar comprobacións de análise estática contra solucións usando o servizo de comprobación de Power Apps
Usa as tarefas de Microsoft Power Platform Build Tools xunto con calquera outra tarefa dispoñible de Azure DevOps para compoñer as túas canles de compilación e lanzamento. As canles que os equipos teñen normalmente postos en marcha inclúen Iniciar, Exportar de Programación, Compilar e Lanzar.
Nota
Microsoft Power Platform Build Tools só son compatibles con un entorno Microsoft Dataverse con base de datos. Máis información: Crear un ambiente cunha base de datos
Microsoft Power Platform Ferramentas de Construción están agora dispoñibles para o seu uso nas rexións GCC e GCC High.
Que son as ferramentas de compilación de Microsoft Power Platform?
Microsoft Power Platform Build Tools son un conxunto de tarefas específicas de compilación de Azure DevOps para Power Platform que eliminan a necesidade de descargar manualmente ferramentas e scripts personalizados para xestionar o ciclo de vida das aplicacións construídas en Microsoft Power Platform.
Podes usar as tarefas de forma individual, como importar unha solución a un ambiente posterior ou xuntos nunha canalización para organizar un escenario como xerar un artefacto de compilación, desprégase para probar ou cambios do fabricante da colleita. As tarefas de compilación pódense clasificar en catro tipos:
- Auxiliar
- Control de calidade
- Solución
- Xestión de ambientes
Para máis información sobre as tarefas dispoñibles, véxase Microsoft Power Platform Tarefas de ferramentas de construción.
Que é Power Platform Build Tools versión 2.0?
Ademais do que proporcionan as Power Platform Build Tools, a versión 2.0 de Power Platform Build Tools está baseada en Power Platform CLI.
Power Platform A versión 1.0 de Build Tools baséase en PowerShell. Power Platform Build Tools 2.0 é a versión que terá servizo e engadirase funcións máis novas.
Para as versións anteriores de Power Platform Ferramentas de compilación, faremos actualizacións de seguranza críticas segundo sexa necesario. Recomendamos encarecidamente que os clientes pasen a Power Platform Build Tools versión 2.0 como mínimo.
Importante
Non pode mesturar e combinar versións de tarefas para Power Platform Build Tools na súa canalización de compilación.
Obtén as ferramentas de compilación da Microsoft Power Platform
Microsoft Power Platform Ferramentas de Compilación poden instalarse na túa organización Azure DevOps desde Azure Marketplace.
Tras a instalación, todas as tarefas incluídas nas ferramentas de compilación de Microsoft Power Platform estarán dispoñibles para engadir a calquera pipeline novo ou existente. Podes atopalas buscando por "Power Platform".
Conexión con ambientes
Para interactuar co entorno Microsoft Power Platform, debes establecer unha conexión para que as tarefas da ferramenta de compilación poidan realizar as accións requiridas. Hai dous tipos de conexións dispoñibles:
| Tipo de conexión | Descripción |
|---|---|
| Principal de servizo mediante Workload Identity Federation (recomendado) | Usa a autenticación baseada no principal do servizo mediante credenciais federadas. Recomendado para inquilinos que requiren autenticación multifactor. |
| Principal do servizo e segredo do cliente | Usa a autenticación baseada no principal de servizo. |
| Nome de usuario/contrasinal | Unha conexión de servizo xenérica con nome de usuario e contrasinal. Non admite usuarios que requiran autenticación multifactor. |
Configurar as conexións de servizo mediante un director de servizo
Para configurar unha conexión mediante o principal de servizo, primeiro debes ter un Power Platform perfil autenticado cos permisos necesarios. Debes engadir unha aplicación Microsoft Entra ID e un usuario de aplicación asociado ao entorno Dataverse.
Crear o principal de servizo e o segredo do cliente
Usa o comando pac admin create-service-principal para crear e configurar o principal de servizo que se use coas tarefas de Microsoft Power Platform Build Tools.
Este comando rexistra primeiro un obxecto Application e o correspondente Nome Principal do Servizo (SPN) no Microsoft Entra ID. Logo engade a aplicación como usuario administrador ao inquilino de Microsoft Power Platform.
Este comando ten dous parámetros:
| nome | Nome curto | Obrigatorio | Descripción |
|---|---|---|---|
environment |
env |
Si | O ID ou URL do entorno ao que engadir un usuario da aplicación. |
role |
r |
No | Nome ou ID de rol de seguranza que se aplicará ao usuario da aplicación. O valor predeterminado é: "Administrador do sistema".
Solution Checker require un rol co privilexio prvAppendmsdyn_analysisjob para anexar á táboa msdyn_analysisjob. O rol de administrador do sistema ten este privilexio por defecto. |
Podes usalo así:
C:\> pac admin create-service-principal --environment <environment id>
Cando teña éxito, móstranse catro columnas:
- TenantId de Power Platform
- ID de aplicación
- Segredo do cliente (en texto claro)
- Caducidade
Por exemplo:
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
Use a información mostrada para configurar a conexión de servizo de Power Platform.
Importante
Manteña o cliente en segredo e seguro. Unha vez que se borra o símbolo do sistema, non pode recuperar o mesmo segredo do cliente de novo.
Configurar o contorno co ID de aplicación
Debes engadir o ID da aplicación como usuario de aplicación no entorno Microsoft Power Platform ao que te conectas. Hai dúas formas de facelo.
- Podes revisar este artigo: Creación de usuarios da aplicación.
- Podes usar Power Platform CLI. Por exemplo:
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
Asegúrese de que o usuario da aplicación engadido teña asignado o rol de administrador do sistema (dispoñible en "Xestionar roles" na configuración de seguranza do usuario da aplicación).
Preguntas máis frecuentes (PMF)
¿Seguirán funcionando as miñas antigas canles de ferramentas Microsoft Power Platform Build?
As conducións antigas seguen funcionando, pero as funcións máis novas non se engadirán ás tarefas máis antigas. Se quere exercer as funcións máis novas, recomendámoslle encarecidamente que cambie a versión da súa tarefa en proceso.
Por que baseou a nova tarefa en Power Platform CLI en lugar de PowerShell?
As tarefas de Power Platform CLI son multiplataforma cunha gran flexibilidade, incluído a execución en servidores de Linux. Estas son as mesmas tarefas que están dispoñibles con Power Platform Actions para GitHub. Agora tes unha experiencia consistente entre Azure DevOps e GitHub.
As ferramentas de compilación Microsoft Power Platform só funcionan para Power Apps?
As ferramentas de compilación funcionan tanto para aplicacións de canvas como baseadas en modelos, axentes virtuais de Microsoft Copilot Studio, fluxos UI e fluxos tradicionais, AI Builder, conectores personalizados e fluxos de datos, todos os cales agora poden engadirse a unha solución. Esta lista tamén inclúe aplicacións de compromiso co cliente (Dynamics 365 Sales, Customer Service, Field Service, Marketing e Project Service Automation). Tarefas de compilación separadas están dispoñibles para as aplicacións de Finanzas e Operacións.
Xa instalara previamente a vista previa das Ferramentas de Compilación: podo actualizar da vista previa de Power Apps Ferramentas de Compilación a Power Platform Build Tools?
Non podes actualizar desde a versión versión preliminar xa que tivemos que introducir algúns cambios máis importantes na versión xeralmente dispoñible. Para pasar da versión previa, tes que instalar as ferramentas de compilación de Microsoft Power Platform e reconstruír as túas canalizacións, ou reconfigurar as túas cadeas existentes para usar as novas tarefas de Ferramentas de Construción. Tamén debe crear novas conexións de servizo.
Podo incluír aplicacións de fluxo e lenzo?
Si, os fluxos e as aplicacións de lenzo recoñecen as solucións, polo que se estes compoñentes se engaden á súa solución, poden participar no ciclo de vida da súa aplicación. Non obstante, algúns pasos aínda requiren configuracións manuais. A necesidade dunha configuración manual será abordada a finais deste ano cando introduzamos variables de contorno e conectores. A continuación facilítase unha lista das limitacións actuais: limitacións coñecidas.
Canto custan as Ferramentas de Compilación Microsoft Power Platform?
As Build Tools están dispoñibles sen ningún custo. Con todo, é necesario ter unha subscrición válida a Azure DevOps para utilizar as Ferramentas de Compilación. Hai máis información dispoñible Prezos para Azure DevOps.
Podo ver a extensión, pero por que non teño unha opción para instalala?
Se non ves a opción install, probablemente che falten os privilexios necesarios de instalación na túa organización Azure DevOps. Máis información dispoñible Xestionar permisos de extensión.
Como poden os desenvolvedores usar os resultados da tarefa Checker?
A saída da tarefa Checker é un ficheiro Sarif e tanto as extensións VS Code como Visual Studio están dispoñibles para ver e realizar accións sobre ficheiros Sarif.
Consulte tamén
Power Platform Build Tools para notas de Azure DevOps versión
Construír tarefas de ferramentas
Microsoft Power Platform Laboratorios de ferramentas de construción