Microsoft Power Platform Build Tools para Azure DevOps
Utilice las herramientas de compilación de Microsoft Power Platform para automatizar tareas comunes de compilación y de implementación creadas con Microsoft Power Platform. Estas tareas incluyen:
- Sincronización de metadatos de la solución (también conocidos como soluciones) que contienen los diversos componentes de la plataforma, como:
- Aplicaciones de Customer Engagement: Dynamics 365 Sales, Customer Service, Field Service, Marketing y Project Service Automation
- Aplicaciones de lienzo
- Aplicaciones basadas en modelo
- Flujos de interfaz de usuario
- Agentes virtuales
- Modelos de AI Builder
- Conectores entre entornos de desarrollo y control de código fuente
- Generando artefactos de compilación
- Implementación en entornos descendentes
- Entornos de aprovisionamiento o desaprovisionamiento
- Realizar comprobaciones de análisis estático contra soluciones utilizando el servicio de comprobación de Power Apps
Usar tareas de Microsoft Power Platform Build Tools se pueden usar junto con cualquier otra tarea de Azure DevOps disponible para componer sus canaliaciones de compilación y versiones. Los procesos que los equipos implementan comúnmente incluyen Exportar desde desarrollo, Compilar y Liberar.
Nota
Microsoft Power Platform Build Tools solo son compatibles con un entorno de Microsoft Dataverse con una base de datos. Más información: Crear un entorno con una base de datos
Microsoft Power Platform Build Tools ahora están disponibles para su uso en las regiones de GCC y GCC High.
¿Qué son las Microsoft Power Platform Build Tools?
Microsoft Power Platform Build Tools son una colección de tareas de compilación de tareas de compilación de Azure DevOps específicas de Power Platform que eliminan la necesidad de descargar manualmente las herramientas y los scripts personalizados para administrar el ciclo de vida de las aplicaciones creadas en Microsoft Power Platform.
Puede usr las tareas individualmente, como importar una solución en un entorno descendente, o usarse conjuntamente en una canalización para coordinar un escenario, como generar un artefacto de compilación, implementar para probar o recoger cambios del creador. Las tareas de compilación se pueden clasificar en general en cuatro tipos:
- Ayuda
- Comprobación de calidad
- Solución
- Administración de entornos
Para obtener más información sobre las tareas disponibles, consulte Tareas de Microsoft Power Platform Build Tools.
¿Qué es Power Platform Build Tools versión 2.0?
Además de lo que Power Platform Build Tools proporciona, la versión 2.0 de Power Platform Build Tools está basada en CLI de Power Platform.
Power Platform Build Tools versión 1.0 se basa en PowerShell. Power Platform Build Tools 2.0 es la versión que se reparará y se agregarán características más nuevas.
Para las versiones anteriores de Power Platform Build Tools, realizaremos actualizaciones de seguridad críticas según sea necesario. Recomendamos enfáticamente que los clientes se muden a Power Platform Build Tools versión 2.0 como mínimo.
Importante
No puede mezclar y combinar versiones de tareas para Power Platform Build Tools en su canalización de compilación.
Obtener Microsoft Power Platform Build Tools
Microsoft Power Platform Build Tools se pueden instalar en la organización de Azure DevOps desde Azure Marketplace.
Después de la instalación, todas las tareas incluidas en las Microsoft Power Platform Build Tools estarán disponibles para agregar a cualquier canalización nueva o existente. Puede encontrarlas buscando "Power Platform".
Conexión a entornos
Para interactuar con el entorno Microsoft Power Platform, debe establecer una conexión para que las diversas tareas de la herramienta de compilación puedan realizar las acciones requeridas. Hay dos tipos de conexiones disponibles:
| Connection type | Description |
|---|---|
| Principal de servicio a través de la federación de identidad de carga de trabajo (recomendado) | Utiliza autenticación basada en entidad de servicio a través de credenciales federadas. Recomendado para inquilinos que requieren autenticación multifactor. |
| Principal del servicio y secreto del cliente | Utiliza autenticación basada en entidad de servicio. |
| Nombre de usuario/contraseña | Conexión de servicio genérica con nombre de usuario y contraseña. No admite usuarios que requieran autenticación multifactor. |
Configurar conexiones de servicio utilizando una entidad de servicio
Para configurar una conexión mediante la entidad de servicio, primero debe tener un perfil de Power Platform autenticado con los permisos necesarios. Debe agregar una aplicación de Microsoft Entra ID y el usuario de aplicación asociado al entorno de Dataverse.
Crear la entidad de servicio y el secreto de cliente
Use el comando pac admin create-service-principal para crear y configurar la entidad principal de servicio que se usará con las tareas de Microsoft Power Platform Build Tools.
Este comando primero registra un objeto Aplicación y el Nombre de entidad de seguridad de servicio (SPN) en Microsoft Entra ID. Luego agrega la aplicación como un usuario Administrador al inquilino de Microsoft Power Platform.
Este comando tiene dos parámetros:
| name | nombre corto | Obligatorio | Descripción |
|---|---|---|---|
environment |
env |
Sí | Id. o URL del entorno al que se va a agregar un usuario de aplicación. |
role |
r |
No | Nombre o id. del rol de seguridad que se aplicará al usuario de aplicación. El valor predeterminado es: 'System Administrator'. Solution Checker requiere un rol con privilegio prvAppendmsdyn_analysisjob para agregar a la tabla msdyn_analysisjob. El rol de Adminitrador del sistema tiene este privilegio de forma predeterminada. |
Puede usarlo así:
C:\> pac admin create-service-principal --environment <environment id>
Una vez realizado correctamente, se muestran cuatro columnas:
- Power Platform TenantId
- Application ID
- Secreto de cliente (en texto claro)
- Expiración
Por ejemplo:
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
Utilice la información que se muestra para configurar el servicio de conexión Power Platform.
Importante
Mantenga el secreto de cliente seguro y protegido. Una vez que se borra el símbolo del sistema, no puede recuperar el mismo secreto de cliente nuevamente.
Configurar el entorno con la ID de la aplicación
Debe agregar el ID de la aplicación debe agregarse como usuario de la aplicación en el entorno Microsoft Power Platform al que se está conectando. Hay dos formas en las que puede hacerlo.
- Puede revisar este artículo: Creación de usuarios de la aplicación.
- Puede usar Power Platform CLI. Por ejemplo:
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 el usuario de la aplicación agregado tenga asignada el rol Administrador del sistema (disponible en "Administrar roles" en la configuración de seguridad para el usuario de la aplicación).
Preguntas más frecuentes (P+F)
¿Mis antiguas canalizaciones de herramientas de compilación seguirán funcionando? Microsoft Power Platform
Las canalizaciones más antiguas siguen funcionando, pero no se agregarán funciones más nuevas a las tareas más antiguas. Si desea ejercitar las funciones más nuevas, le recomendamos encarecidamente que cambie la versión de su tarea en proceso.
¿Por qué basaste el nuevo tarea en CLI en lugar de PowerShell? Power Platform
Las tareas de Power Platform CLI son multiplataforma con gran flexibilidad, incluida la ejecución en corredores de Linux. Estas son las mismas tareas que están disponibles con Acciones de Power Platform para GitHub. Ahora tiene una experiencia consistente entre Azure DevOps y GitHub.
¿Las Microsoft Power Platform herramientas de compilación solo funcionan para Power Apps?
Las herramientas de compilación funcionan tanto para aplicaciones basadas en lienzo como en modelos, agentes virtuales de CoPilot Studio, flujos de UI y flujos tradicionales, conectores personalizados y flujos de datos, todos los cuales ahora se pueden agregar a una solución. Microsoft AI Builder Esta lista también incluye las aplicaciones de Customer Engagement (Dynamics 365 Sales, Customer Service, Field Service, Marketing y Project Service Automation). Las tareas de compilación separadas están disponibles para las aplicaciones de finanzas y operaciones.
Anteriormente había instalado el versión preliminar de Build Tools: ¿puedo actualizar desde el versión preliminar de Build Tools a Build Tools? Power Apps Power Platform
No puede actualizar desde la versión de vista previa, ya que tuvimos que introducir algunos cambios importantes en la versión Generalmente disponible. Para pasar de la versión preliminar, debe instalar Microsoft Power Platform Build Tools y reconstruir sus canalizaciones, o vuelva a configurar sus canalizaciones existentes para usar las nuevas tareas de Build Tools. También debe crear nuevas conexiones de servicio.
¿Puedo incluir aplicaciones de flujo y de lienzo?
Sí, los flujos y las aplicaciones de lienzo tienen en cuenta las soluciones, por lo que si estos componentes se agregan a la solución, pueden participar en el ciclo de vida de la aplicación. Sin embargo, algunos pasos aún requieren configuraciones manuales. La necesidad de la configuración manual se solucionará este año más adelante, cuando introduzcamos variables de entorno y conectores. Una lista de las limitaciones actuales está disponible aquí: Limitaciones conocidas.
¿Cuánto cuestan las herramientas de construcción? Microsoft Power Platform
Las Build Tools están disponibles sin coste alguno. Sn embargo, se requiere una suscripción válida a Azure DevOps para usar las Build Tools. Hay más información disponible: Precios de Azure DevOps.
Puedo ver la extensión, pero ¿por qué no tengo una opción para instalarla?
Si no ve la opción instalar es probable que le falten los privilegios de instalación necesarios en la organización de Azure DevOps. Más información disopnible: Administrar permisos de extensiones.
¿Cómo pueden los desarrolladores utilizar los resultados del Comprobador tarea?
La salida del verificador tarea es un archivo Sarif y tanto VS Code como las extensiones están disponibles para ver y tomar medidas en los archivos Sarif. Visual Studio
Consulte también
Power Platform Notas de la versión de Build Tools for Azure DevOps
Tareas de la herramienta de creación
Microsoft Power Platform Laboratorios de herramientas de construcción