Tareas de Microsoft Power Platform Build Tools

Las tareas de compilación disponibles se describen en las siguientes secciones. Luego, mostraremos algún ejemplo de canalizaciones de Azure DevOps que hacen uso de estas tareas. Para obtener información sobre las herramientas de compilación y cómo descargarlas, vea Microsoft Power Platform Build Tools para Azure DevOps.

Tarea de ayuda

Las tareas auxiliares disponibles se describen a continuación.

Instalador de herramientas Power Platform

Esta tarea debe agregarse una vez antes que cualquier tarea de Power Platform Build Tools de compilación en canalizaciones de compilación y lanzamiento. Esta tarea instala un conjunto de herramientas específicas de Power Platform–que necesita el agente para ejecutar las tareas de compilación de Microsoft Power Platform. Esta tarea no requiere más configuración cuando se agrega, pero contiene parámetros para las versiones específicas de cada una de las herramientas que se están instalando.

Para mantenerse actualizado con las versiones de la herramienta a lo largo del tiempo, asegúrese de que estos parámetros correspondan a las versiones de las herramientas que se requieren para que la canalización se ejecute correctamente.

Fragmento de código YAML (instalador)

# Installs default Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@0
  displayName: 'Power Platform Tool Installer'

# Installs specific versions of the Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@0
  displayName: 'Power Platform Tool Installer'
  inputs:
    DefaultVersion: false
    XrmToolingPackageDeploymentVersion: 3.3.0.928

Parámetros (instalador)

Power Platform WhoAmI

Verifica una conexión del servicio de entorno Power Platform mediante la conexión y la realización de una solicitud WhoAmI. Esta tarea puede ser útil para incluirla al principio de la canalización para verificar la conectividad antes de que comience el procesamiento.

Fragmento de código YAML (WhoAmI)

# Verifies an environment service connection
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.whoami.PowerPlatformWhoAmi@0
  displayName: 'Power Platform WhoAmI'

  inputs: 
#   Service Principal/client secret (supports MFA)
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'My service connection'

# Verifies an environment service connection
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.whoami.PowerPlatformWhoAmi@0
  displayName: 'Power Platform WhoAmI'

  inputs:
#   Username/password (no MFA support)
    PowerPlatformEnvironment: 'My service connection'

Parámetros (WhoAmI)

Comprobación de calidad

A continuación se muestran las tareas disponibles para comprobar la calidad de una solución.

Power Platform Checker

Esta tarea del comprobador de PowerApps ejecuta una comprobación de análisis estático en sus soluciones frente a un conjunto de reglas de prácticas recomendadas para identificar cualquier patrón problemático que pueda haber introducido accidentalmente al generar la solución.

Fragmento de código YAML (comprobador)

# Static analysis check of your solution
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.checker.PowerPlatformChecker@0
  displayName: 'Power Platform Checker '
  inputs:
    PowerPlatformSPN: 'Dataverse service connection'
    RuleSet: '0ad12346-e108-40b8-a956-9a8f95ea18c9'

# Static analysis check of your solution
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.checker.PowerPlatformChecker@0
  displayName: 'Power Platform Checker '
  inputs:
    PowerPlatformSPN: 'Dataverse service connection'
    UseDefaultPACheckerEndpoint: false
    CustomPACheckerEndpoint: 'https://japan.api.advisor.powerapps.com/'
    FileLocation: sasUriFile
    FilesToAnalyzeSasUri: 'SAS URI'
    FilesToAnalyze: '**\*.zip'
    FilesToExclude: '**\*.tzip'
    RulesToOverride: 'JSON array'
    RuleSet: '0ad12346-e108-40b8-a956-9a8f95ea18c9'

Parámetros (comprobador)

Tareas de solución

Este conjunto de tareas puede automatizar las acciones de la solución. Las tareas de entorno descritas más adelante en esta sección que crean, copian o restauran un entorno sobrescribirán las conexiones de servicio con los entornos recién creados. Esto hace posible realizar tareas de solución en entornos que se crean a pedido.

Importar solución Power Platform

Importa una solución a un entorno de destino.

Fragmento de código YAML (Importar)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@0
  displayName: 'Power Platform Import Solution '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    HoldingSolution: true
    OverwriteUnmanagedCustomizations: true
    SkipProductUpdateDependencies: true
    ConvertToManaged: true

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@0
  displayName: 'Power Platform Import Solution '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    AsyncOperation: true
    MaxAsyncWaitTime: 60
    PublishWorkflows: false

Parámetros (Importar)

Aplicar actualización de la solución de Power Platform

Actualiza una solución que se ha importado como solución de retención.

Fragmento de código YAML (actualización)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.apply-solution-upgrade.PowerPlatformApplySolutionUpgrade@0
  displayName: 'Power Platform Apply Solution Upgrade '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionName: 'Contoso_sample'
    AsyncOperation: false

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.apply-solution-upgrade.PowerPlatformApplySolutionUpgrade@0
  displayName: 'Power Platform Apply Solution Upgrade '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'
    MaxAsyncWaitTime: 45

Parámetros (actualización)

Exportar solución Power Platform

Exporta una solución desde un entorno fuente.

Fragmento de código YAML (Exportar)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-solution.PowerPlatformExportSolution@0
  displayName: 'Power Platform Export Solution '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionName: 'Contoso_sample'
    SolutionOutputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    Managed: true
    MaxAsyncWaitTime: 120

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-solution.PowerPlatformExportSolution@0
  displayName: 'Power Platform Export Solution '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'
    SolutionOutputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    Managed: true
    MaxAsyncWaitTime: 120
    ExportAutoNumberingSettings: true
    ExportCalendarSettings: true
    ExportCustomizationSettings: true
    ExportEmailTrackingSettings: true
    ExportGeneralSettings: true
    ExportIsvConfig: true
    ExportMarketingSettings: true
    ExportOutlookSynchronizationSettings: true
    ExportRelationshipRoles: true
    ExportSales: true

Parámetros (Exportar)

Desempaquetar solución de Power Platform

Toma un archivo de la solución comprimido y lo descompone en varios archivos XML de forma que estos archivos se puedan leer y administrar más fácilmente mediante un sistema de control de origen.

Fragmento de código YAML (Desempaquetar)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.unpack-solution.PowerPlatformUnpackSolution@0
  displayName: 'Power Platform Unpack Solution '
  inputs:
    SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    SolutionTargetFolder: 'C:\Public'
    SolutionType: Both

Parámetros (desempaquetar)

Empaquetar solución de Power Platform

Empaqueta una solución representada en el control de origen en un archivo solution.zip que se puede importar en otro entorno.

Fragmento de código YAML (empaquetar)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.pack-solution.PowerPlatformPackSolution@0
  displayName: 'Power Platform Pack Solution '
  inputs:
    SolutionSourceFolder: 'C:\Public'
    SolutionOutputFile: 'Contoso_sample_1_0_0_1_managed.zip'
    SolutionType: Managed

Parámetros (empaquetar)

Eliminar solución de Power Platform

Elimina una solución en el entorno de destino.

Fragmento de código YAML (Eliminar)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.delete-solution.PowerPlatformDeleteSolution@0
  displayName: 'Power Platform Delete Solution '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'

Parámetros (Eliminar)

Publicación de personalizaciones Power Platform

Publica todas las personalizaciones en un entorno.

Fragmento de código YAML (Publicar)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.publish-customizations.PowerPlatformPublishCustomizations@0
  displayName: 'Power Platform Publish Customizations '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '

Parámetros (publicar)

Establecer versión de la solución de Power Platform

Actualiza la versión de una solución.

Fragmento de código YAML (Versión)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.set-solution-version.PowerPlatformSetSolutionVersion@0
  displayName: 'Power Platform Set Solution Version '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'
    SolutionVersionNumber: 1.0.0.0

Parámetros (versión)

Si bien el número de versión se puede codificar en la canalización, se recomienda utilizar una variable de canalización de Azure DevOps como BuildId. Esto proporciona opciones para definir la forma exacta del número de versión en la pestaña "Opciones", por ejemplo: $(Año:yyyy)-$(Mes:MM)-$(Día:dd)-$(rev:rr)-3

Esta definición se puede usar en la tarea Establecer versión de solución estableciendo la propiedad Número de versión con: $(Build.BuildId) en lugar de codificar 20200824.0.0.2.

Alternativamente, un resultado de script de tarea en línea de powershell $(formato de obtención de fecha aaaa.MM.dd.HHmm) establecido en la variable vacía denominada SolutionVersion como host de escritura ("##vso[task.setvariable variable=SolutionVersion;]$version"), definir la versión de la solución en $(SolutionVersion).

Implementar paquete de Power Platform

Implementa un paquete en un entorno. La implementación de un paquete en lugar de un único archivo de solución proporciona una opción para implementar varias soluciones, datos y código en un entorno.

Fragmento de código YAML (Implementar)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.deploy-package.PowerPlatformDeployPackage@0
  displayName: 'Power Platform Deploy Package '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    PackageFile: 'C:\Users\Public\package.dll'
    MaxAsyncWaitTime: 120

Parámetros (Implementar)

Tareas de administración de entornos

Automatice las tareas comunes de administración del ciclo de vida del entorno (ELM).

Crear entorno de Power Platform

Crear un entorno nuevo. La creación de un nuevo entorno también crea automáticamente BuildTools.EnvironmentUrl.

Fragmento de código YAML (crear entorno)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.create-environment.PowerPlatformCreateEnvironment@0
  displayName: 'Power Platform Create Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    DisplayName: 'First Coffee test'
    DomainName: firstcoffee

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.create-environment.PowerPlatformCreateEnvironment@0
  displayName: 'Power Platform Create Environment '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    DisplayName: 'First Coffee prod'
    EnvironmentSku: Production
    AppsTemplate: 'D365_CustomerService,D365_FieldService'
    LocationName: canada
    LanguageName: 1036
    CurrencyName: ALL
    DomainName: firstcoffee

Parámetros (crear entorno)

Eliminar entorno de Power Platform

Elimina un entorno.

Fragmento de código YAML (Eliminar entorno)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.delete-environment.PowerPlatformDeleteEnvironment@0
  displayName: 'Power Platform Delete Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'

Parámetros (Eliminar entorno)

Copia de seguridad del entorno de Power Platform

Realiza una copia de seguridad de un entorno.

Fragmento de código YAML (entorno de copia de seguridad)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.backup-environment.PowerPlatformBackupEnvironment@0
  displayName: 'Power Platform Backup Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    BackupLabel: 'Full backup - $(Build.BuildNumber)'

Parámetros (entorno de copia de seguridad)

Copiar entorno de Power Platform

Copia un entorno a un entorno de destino. Dos tipos de copias están disponibles: completa y mínima. Una copia completa incluye datos y metadatos de la solución (personalizaciones), mientras que una copia mínima solo incluye los metadatos de la solución pero no los datos reales.

Fragmento de código YAML (entorno de copia)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.copy-environment.PowerPlatformCopyEnvironment@0
  displayName: 'Power Platform Copy Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.copy-environment.PowerPlatformCopyEnvironment@0
  displayName: 'Power Platform Copy Environment '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'
    CopyType: MinimalCopy
    OverrideFriendlyName: true
    FriendlyName: 'Contoso Test'
    DisableAdminMode: false

Parámetros (entorno de copia)

Construir y liberar canalizaciones

Ahora que hemos identificado lo que se puede hacer con las herramientas de compilación, veamos cómo puede aplicar estas herramientas a sus canalizaciones de compilación y lanzamiento. Una visión general conceptual se muestra a continuación. Veamos algunos detalles de la implementación de la canalización utilizando las tareas de la herramienta de compilación en las subsecciones siguientes.

Para obtener más información sobre la creación de estas canalizaciones y, en realidad, realizar la creación práctica de canalizaciones utilizando las Microsoft Power Platform Build Tools, complete los laboratorios de Build Tools, que puede descargar desde GitHub.

Más información sobre canalizaciones Azure DevOps: Usar Azure Pipelines

Crear canalización: exporta una solución desde un entorno de desarrollo (DEV)

La siguiente figura muestra las tareas de la herramienta de compilación que puede agregar a una canalización que exporta una solución desde un entorno de desarrollo.

Crear canalización: crea un solución administrada

La siguiente figura muestra las tareas de la herramienta de compilación que puede agregar a una canalización que compila una solución administrada.

Lanzar canalización: implementación en un entorno de producción (PROD)

La siguiente figura muestra las tareas de la herramienta de compilación que puede agregar a una canalización que implementa un entorno de producción.

Vea también

Microsoft Power Platform Build Tools para Azure DevOps