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 | Descripción |
|---|---|
| Entidad de servicio y secreto de cliente (recomendado) | Utiliza la autenticación basada en la entidad principal del servicio y admite la autenticación multifactor |
| Nombre de usuario/contraseña | Conexión de servicio genérica con nombre de usuario y contraseña. No admite la 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 el privilegio prvAppendmsdyn_analysisjob para anexar 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)
¿Seguirán funcionando mis anteriores canalizaciones de Microsoft Power Platform Build Tool?
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é basó la nueva tarea en la CLI de Power Platform en lugar de PowerShell?
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 Build Tools funcionan sólo para Power Apps?
Las Build Tools funcionan tanto para aplicaciones de lienzo como para aplicaciones basadas en modelos, Power Virtual Agents, flujos de interfaz de usuario y flujos tradicionales, AI Builder, conectores personalizados y flujos de datos. Ahora todos ellos se pueden agregar a una solución. 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.
Ya había instalado la vista previa de las herramientas de compilación. ¿Puedo actualizar desde la vista previa de Power Apps Build Tools para Power Platform Build Tools?
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 Microsoft Power Platform Build Tools?
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.
Veo la extensión, pero ¿por qué no tengo la opción de 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 usar los resultados de la tarea de comprobación?
El resultado de la tarea de comprobación es un Archivo Sarif y ambas extensiones, VS Code y Visual Studio, están disponibles para ver y tomar medidas en los archivos Sarif.
Consulte también
Tareas de herramientas de compilación
Laboratorios de Microsoft Power Platform Build Tools