Microsoft Power Platform Build Tools para Azure DevOps

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.

ALM impulsado por Azure DevOps.

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 unha colección 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. Podes categorizar en xeral as tarefas de construción 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 Microsoft services e á que engade funcións máis recentes.

Para versións anteriores de Power Platform Build Tools, Microsoft proporciona actualizacións críticas de seguridade segundo sexa necesario. Pasar a Power Platform Build Tools versión 2.0 canto antes.

Importante

Non podes mesturar e combinar versións de tarefas para Power Platform Build Tools na túa canle 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".

Descarga as ferramentas de compilación Microsoft 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 para usar 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 Necesario Descripción
environment env Si O ID ou URL do entorno ao que engadir un usuario da aplicación.
role r Non Nome ou ID do rol de seguridade para 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.

Usa o comando así:

C:\> pac admin create-service-principal  --environment <environment id>

Cando ten éxito, o comando mostra 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 a liña de comandos, non podes 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.

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 canalizacións máis antigas seguen funcionando, pero as funcións máis novas non están dispoñibles nas tarefas máis antigas. Se queres usar as funcións máis novas, cambia a versión da túa tarefa no pipeline.

Por que baseou a nova tarefa en Power Platform CLI en lugar de PowerShell?

As tarefas da CLI de Power Platform son multiplataforma con gran flexibilidade, incluíndo executar en runners Linux. Estas tarefas son as mesmas 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 de modelos, axentes virtuais de Microsoft Copilot Studio, fluxos de interface e fluxos tradicionais, AI Builder, conectores personalizados e fluxos de datos, todo o cal agora podes engadir 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.

Anteriormente instalei a vista previa das Ferramentas de Compilación: ¿podo actualizar da vista previa de Power Apps Build Tools a Power Platform Build Tools?

Non podes actualizar desde a versión previa porque tivemos que introducir cambios importantes na versión xeralmente dispoñible (GA). Para pasar da versión previa, necesitas instalar as ferramentas de compilación de Microsoft Power Platform e reconstruír as túas canalizacións ou reconfigurar as túas existentes para usar as novas tarefas de Ferramentas de Construción. Tamén debes crear novas conexións de servizo.

Podo incluír aplicacións de fluxo e lenzo?

Si, as aplicacións de fluxos e canvas son conscientes da solución, así que se engades estes compoñentes á túa solución, poden participar no ciclo de vida da tú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. Unha lista das limitacións actuais está dispoñible no artigo sobre 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, necesitas unha subscrición válida a Azure DevOps para usar as ferramentas de compilación. Para máis información, consulta 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 de instalación, probablemente carezas dos privilexios necesarios de instalación na túa organización de Azure DevOps. Para máis información, consulte Xestionar permisos de extensión.

Como poden os desenvolvedores usar os resultados da tarefa Checker?

A saída da tarefa Checker é un ficheiro SARIF. 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

  • Última actualización o