Compartir a través de

herramientas de compilación de Microsoft Power Platform para Azure DevOps

Utiliza las Herramientas de Build de Microsoft Power Platform para automatizar las tareas comunes de compilación e implementación relacionadas con las aplicaciones basadas en 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 involucración del cliente: Dynamics 365 Sales, servicio al cliente, servicio de campo, 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
  • Realización de comprobaciones de análisis estáticos en soluciones mediante el servicio de comprobador de Power Apps

Utiliza las tareas de herramientas de compilación de Microsoft Power Platform junto con cualquier otra tarea de Azure DevOps disponible para componer tus canalizaciones de compilación y lanzamiento. Los procesos que los equipos implementan comúnmente incluyen Exportar desde desarrollo, Compilar y Liberar.

ALM con tecnología Azure DevOps.

Nota

Las herramientas de compilación de Microsoft Power Platform son admitidas solo para 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 ya están disponibles para su uso en GCC y GCC High regiones.

¿Qué son las herramientas de compilación de Microsoft Power Platform?

Microsoft Power Platform Build Tools son una colección de tareas de compilación específicas de Power Platform Azure DevOps que eliminan la necesidad de descargar manualmente herramientas personalizadas y scripts para administrar el ciclo de vida de las aplicaciones basadas 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
  • Control de calidad
  • Solución
  • Administración de entornos

Para obtener más información sobre las tareas disponibles, vea 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 Power Platform CLI.

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 recientes.

Para las versiones anteriores de Power Platform Build Tools, realizaremos actualizaciones de seguridad críticas según sea necesario. Recomendamos encarecidamente que los clientes pasen 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 herramientas de compilación de Microsoft Power Platform

Microsoft Power Platform Build Tools se puede instalar en la organización de Azure DevOps desde Azure Marketplace.

Después de la instalación, todas las tareas incluidas en las herramientas de compilación de Microsoft Power Platform estarán disponibles para agregarlas a cualquier canalización nueva o existente. Puede encontrarlas buscandor "Power Platform".

Obtén Microsoft Power Platform Build Tools

Conexión a entornos

Para interactuar con el entorno de Microsoft Power Platform, debe establecer una conexión para que las tareas de la herramienta de compilación puedan realizar las acciones necesarias. Hay dos tipos de conexiones disponibles:

Tipo de conexión Descripción
Entidad 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.
Secreto de cliente y entidad de servicio Usa 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 proporciona soporte a los usuarios que requieren 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 un 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 de servicio que se usará con las tareas de las Microsoft Power Platform Build Tools.

Este comando primero registra un objeto de aplicación y el correspondiente Service Principal Name (SPN) en Microsoft Entra ID. A continuación, agrega la aplicación como 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 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 ID de Inquilino
  • Id. de solicitud
  • 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 la conexión de servicio de 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 identificador de aplicación como usuario de aplicación en el entorno de Microsoft Power Platform con el que se va a conectar. 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)

¿Continuarán funcionando mis antiguas canalizaciones de la herramienta de compilación de 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 la nuevo tarea en Power Platform CLI en lugar de PowerShell?

Las tareas de Power Platform CLI son multiplataforma con gran flexibilidad, incluida la ejecución en ejecutores de Linux. Estas son las mismas tareas que están disponibles con acciones de Power Platform para GitHub. Ahora tiene una experiencia coherente entre Azure DevOps y GitHub.

¿Las herramientas de creación de Microsoft Power Platform funcionan solo para Power Apps?

Las herramientas de compilación funcionan tanto para aplicaciones controladas por modelos como para lienzos, Microsoft Copilot Studio agentes virtuales, flujos de interfaz de usuario y flujos tradicionales, AI Builder, conectores personalizados y flujos de datos, todos los cuales ahora se pueden agregar a una solución. Esta lista también incluye aplicaciones de interacción con clientes (Dynamics 365 Sales, Servicio de atención al cliente, Servicio de campo, Marketing y Project Service Automation). Las tareas de compilación separadas están disponibles para las aplicaciones de finanzas y operaciones.

I había instalado previamente la versión preliminar de las herramientas de compilación: ¿puedo actualizar desde la versión preliminar de las herramientas de compilación de Power Apps a 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 las herramientas de compilación de Microsoft Power Platform y recompilar las canalizaciones o volver a configurar las canalizaciones existentes para usar las nuevas tareas de Herramientas de compilación. También debe crear nuevas conexiones de servicio.

¿Puedo incluir aplicaciones de lienzo y flujo?

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 compilación de Microsoft Power Platform?

Las Build Tools están disponibles sin coste alguno. Sin embargo, se requiere una suscripción válida a Azure DevOps para usar las herramientas de compilación. Puede encontrar más información Precios para Azure DevOps.

Veo la extensión, pero ¿por qué no tengo la opción de instalarla?

Si no ve la opción install, es probable que no tenga 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?

La salida de la tarea Comprobador es un archivo Sarif, y las extensiones VS Code y Visual Studio están disponibles para ver e interactuar con archivos Sarif.

Consulte también

Notas de la versión de Power Platform Build Tools para Azure DevOps
Tareas de herramientas de compilación
Microsoft Power Platform Laboratorios de herramientas de desarrollo

  • Last updated on