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. Entre las tareas, se incluyen las siguientes:

  • 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. En gran medida, puede clasificar las tareas de compilación en cuatro tipos:

  • Ayudante
  • 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 a la que Microsoft da servicio y a la que incorpora nuevas funcionalidades.

Para versiones anteriores de Power Platform Build Tools, Microsoft proporciona actualizaciones de seguridad críticas según sea necesario. Vaya a Power Platform Build Tools versión 2.0 lo antes posible.

Importante

No puedes mezclar distintas versiones de las tareas de Power Platform Build Tools en la 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 herramientas de compilación de Microsoft Power Platform.

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 identificador del rol de seguridad que se va a aplicar al usuario de la 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.

Use el comando de la siguiente manera:

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

Cuando se ejecuta correctamente, el comando muestra cuatro columnas:

  • Power Platform ID de Inquilino
  • Id. de solicitud
  • Secreto de cliente (en texto claro)
  • Caducidad

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 borre la línea de comandos, no podrá volver a recuperar ese mismo secreto de cliente.

Configurar el entorno con la ID de la aplicación

Debe agregar el id. de la aplicación como usuario de la aplicación en el entorno de Microsoft Power Platform al que se está conectando. Hay dos formas en las que puede hacerlo.

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 (FAQ)

¿Continuarán funcionando mis antiguas canalizaciones de la herramienta de compilación de Microsoft Power Platform?

Las canalizaciones anteriores siguen funcionando, pero las características más recientes no están disponibles en las tareas anteriores. Si desea usar las funciones más recientes, cambie la versión de la tarea en el flujo de trabajo.

¿Por qué basaste la nuevo tarea en Power Platform CLI en lugar de PowerShell?

Las tareas de la CLI de Power Platform son multiplataforma con gran flexibilidad, incluida la ejecución en ejecutores de Linux. Estas tareas son las mismas 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 lienzos como para modelos, 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 puede 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.

Anteriormente instaló la versión preliminar de Las herramientas de compilación: ¿puedo actualizar desde la versión preliminar de Power Apps Build Tools a Power Platform Build Tools?

No se puede actualizar desde la versión preliminar porque tuvimos que introducir algunos cambios importantes en la versión disponible con carácter general (GA). 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 admiten soluciones, por lo que, si agrega estos componentes a su solución, pueden participar en el ciclo de vida de su 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. Hay disponible una lista de las limitaciones actuales en el artículo 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, necesita una suscripción válida a Azure DevOps para usar las herramientas de compilación. Para obtener más información, consulte Precios de Azure DevOps.

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

Si no ve la opción de instalación, es probable que no tenga los privilegios de instalación necesarios en la organización de Azure DevOps. Para obtener más información, consulte Administración de permisos de extensión.

¿Cómo pueden los desarrolladores usar los resultados de la tarea de comprobación?

La salida de la tarea del Comprobador es un archivo SARIF. Tanto VS Code como las extensiones de Visual Studio están disponibles para ver y tomar medidas en archivos SARIF.

Véase 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