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 participación del cliente (Dynamics 365 Sales, Customer Service, Field Service, Marketing y Project Service Automation), aplicaciones de lienzo, aplicaciones basadas en modelos, flujos de interfaz de usuario, agentes virtuales, modelos de AI Builder y conectores entre los entornos de desarrollo y el control de código fuente
  • Generando artefactos de compilación
  • Implementación en entornos descendentes
  • Entornos de aprovisionamiento o desaprovisionamiento
  • Realice comprobaciones de análisis estático contra soluciones utilizando el servicio de comprobación de Power Apps

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

ALM con tecnología de Azure DevOps.

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 versión 1.0.* ahora están disponibles para su uso en las regiones de GCC y GCC High.
Microsoft Power Platform Build Tools versión 2.0 ahora están disponibles excepto en GCC o 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 Power Platform–tareas de compilación específicas de Azure DevOps 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. Las tareas pueden utilizarse individualmente para realizar una tarea, como la importación de una solución a un entorno posterior, o utilizarse juntas en una canalización para orquestar un escenario como "generar un artefacto de compilación", "Implementar para probar" o "Recolectar 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, como en la primera versión, se basa en PowerShell. En adelante, Power Platform Build Tools 2.0 es la versión a la que se dará servicio y se añadirán nuevas funciones. Para versiones anteriores de Power Platform Build Tools, haremos 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 el 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".

Obtener las Microsoft Power Platform Build Tools

Conexión a entornos

Para interactuar con el entorno Microsoft Power Platform, se debe establecer una conexión que permita a las diversas tareas de la herramienta de compilación realizar las acciones requeridas. Hay dos tipos de conexiones disponibles:

  • Nombre de usuario / contraseña: configurado como una conexión de servicio genérica con nombre de usuario y contraseña. El nombre de usuario/contraseña no admite la autenticación multifactor.
  • Principal de servicio y secreto de cliente: (recomendado) Este tipo de conexión utiliza autenticación basada en principal de servicio y admite autenticación multifactor.

Configurar conexiones de servicio utilizando una entidad de servicio

Para configurar una conexión utilizando la entidad de servicio, primero debe crear un registro de aplicación en Azure Active Directory (AAD) con los permisos necesarios y luego cree el Usuario de la aplicación asociado en el entorno Microsoft Power Platform al que desea conectarse. Hemos ofrecido un script para facilitar algunos de los pasos necesarios en la sección siguiente, mientras que la información detallada con instrucciones manuales paso a paso está disponible en este artículo Registro de la aplicación de Azure.

Cree la entidad de servicio y el secreto de cliente con PowerShell

Este script de PowerShell ayuda a crear y configurar el servicio principal que se utilizará con las tareas de Microsoft Power Platform Build Tools. Primero registra un objeto Aplicación y el Nombre de entidad de seguridad de servicio (SPN) en AAD.

Esta aplicación se agrega como un usuario Administrador al propio inquilino de Microsoft Power Platform.

Instalación

Descargue el siguiente cmdlet de PowerShell: https://pabuildtools.blob.core.windows.net/spn-docs-4133a3fe/New-CrmServicePrincipal.ps1

  • Abra un símbolo del sistema normal de Windows PowerShell (estándar, no PS core)
  • Navegue a la carpeta donde guardó el script y desbloquee el script con el siguiente comando: `Unblock-File New-CrmServicePrincipal.ps1`
  • Ejecute el script: `.\New-CrmServicePrincipal.ps1`

El script aparecerá dos veces con los cuadros de diálogo de inicio de sesión de AAD:

  • Primera solicitud: iniciar la sesión como administrador en la instancia de AAD asociada al inquilino de Microsoft Power Platform
  • Segunda solicitud: iniciar sesión como administrador del inquilino en el propio inquilino de Microsoft Power Platform

Una vez realizado correctamente, se muestran tres columnas:

  • Power Platform TenantId
  • Application ID
  • Secreto de cliente (en texto claro)

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 de PowerShell, no puede recuperar el mismo secreto de cliente nuevamente.

Configurar el entorno con la ID de la aplicación

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. La información sobre cómo agregar un usuario de la aplicación está disponible en este artículo Creación de usuarios de aplicaciones.

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 seguirán funcionando, pero no se agregarán características 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 canalización.

¿Por qué basó la nueva tarea en la CLI de Power Platform en lugar de PowerShell?

Las tareas de CLI de Power Platform 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 consistente entre Azure DevOps y GitHub.

¿Las Microsoft Power Platform Build Tools funcionan sólo para Power Apps?

Las herramientas de compilación funcionan tanto para lienzos 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, todos los cuales ahora se pueden agregar a una solución. Esta lista también incluye aplicaciones de participación del cliente (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 se puede actualizar desde la versión preliminar, ya que hemos tenido que introducir algunos cambios de ruptura en la versión generalmente disponible. Para pasar de la versión preliminar, tiene que instalar las herramientas de compilación de Microsoft Power Platform Build Tools y reconstruir sus canalizaciones o reconfigurar las existentes para utilizar las nuevas tareas de las herramientas de compilación. También deberá crear nuevas conexiones de servicio.

¿Puedo incluir aplicaciones de flujo y de lienzo?

Sí, los flujos y las aplicaciones de lienzo reconocen las soluciones, por lo que si estos componentes se agregan a su solución, pueden participar en el ciclo de vida de su aplicación. Sin embargo, algunos pasos todavía requieren configuraciones manuales. La necesidad de configuración manual se abordará más adelante, cuando introduzcamos las variables de entorno y los conectores. La lista de las limitaciones actuales está disponible aquí: Limitaciones conocidas.

¿Cuánto cuestan las Microsoft Power Platform Build Tools?

Las herramientas de compilación están disponibles sin coste alguno. Sin embargo, una suscripción válida a Azure DevOps es necesaria para usar las Build Tools. Más información está disponible aquí 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 (que se muestra en la captura de pantalla siguiente) es probable que le falten los privilegios de instalación necesarios en la organización de Azure DevOps. Más información disponible aquí 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.

Vea también

Tareas de herramientas de compilación
Laboratorios de Microsoft Power Platform Build Tools

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).