задачи средств сборки Microsoft Power Platform

Доступные задачи сборки описаны в следующих разделах. Затем мы демонстрируем несколько примеров использования Azure Pipelines с этими задачами. Сведения о средствах сборки и их скачивании см. в разделе Microsoft Power Platform Средства сборки для Azure Pipelines.

Вспомогательная задача

Доступные вспомогательные задачи описаны далее.

Установщик инструментов Power Platform

Эту задачу необходимо добавить один раз перед любыми другими задачами Power Platform Build Tools в конвейерах сборки и выпуска. Эта задача устанавливает набор инструментов, специфичных для Power Platform, необходимых агенту для выполнения задач сборки Microsoft Power Platform. Эта задача не требует никакой дополнительной настройки после добавления. Эта задача содержит параметры для конкретных версий каждого из устанавливаемых инструментов.

Чтобы поддерживать актуальность версий инструментов с течением времени, убедитесь, что эти параметры соответствуют версиям инструментов, которые требуются для правильной работы конвейера.

Фрагмент кода YAML (установщик)

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

# Installs default Power Platform Build Tools and adds the pac cli to the `PATH` environment variable
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
  displayName: 'Power Platform Tool Installer'
  inputs:
    AddToolsToPath: true

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

Параметры (установщик)

Платформа Power WhoAmI

Проверяет подключение службы среды Power Platform путем подключения и отправки запроса WhoAmI. Эту задачу может быть полезно включить на раннем этапе конвейера для проверки возможности подключения до начала обработки.

Фрагмент кода YAML (WhoAmI)

# Verifies an environment service connection
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.whoami.PowerPlatformWhoAmi@2
  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@2
  displayName: 'Power Platform WhoAmI'

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

Параметры (WhoAmI)

Проверка качества

В следующем разделе представлены доступные задачи для проверки качества решения.

Средство проверки платформы Power Platform

В этой задаче выполняется проверка статического анализа ваших решений на соответствие набору рекомендуемых правил, чтобы выявить любые проблемные шаблоны, которые вы могли случайно ввести при создании решения.

Фрагмент кода YAML (средство проверки)

# Static analysis check of your solution
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.checker.PowerPlatformChecker@2
  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@2
  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'

Параметры (средство проверки)

Задачи решения

Этот набор задач может автоматизировать действия решения. Задачи среды, описанные ниже в этом разделе, которые создают, копируют или восстанавливают среду, перезаписывают соединения служб с вновь созданными средами. Эти задачи позволяют выполнять задачи решения для сред, создаваемых по запросу.

Импорт решения Power Platform

Импортирует решение в целевую среду.

Фрагмент кода YAML (Импорт)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@2
  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

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@2
  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

Параметры (Импорт)

Добавление компонентов решения Power Platform

Добавляет компонент решения в неуправляемое решение.

Фрагмент кода YAML (добавить)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.add-solution-component.PowerPlatformAddSolutionComponent@2
  displayName: 'Power Platform Add Solution Component '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    SolutionName: 'SampleSolution '
    Component: contact
    ComponentType: 1
    AddRequiredComponents: false

Параметры (добавить)

Применить обновление решения Power Platform

Обновляет решение, которое было импортировано как решение хранения.

Фрагмент кода YAML (Обновление)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.apply-solution-upgrade.PowerPlatformApplySolutionUpgrade@2
  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@2
  displayName: 'Power Platform Apply Solution Upgrade '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'
    MaxAsyncWaitTime: 45

Параметры (Обновление)

Экспорт решения Power Platform

Экспорт решения из исходной среды.

Фрагмент кода YAML (Экспорт)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-solution.PowerPlatformExportSolution@2
  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@2
  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

Параметры (Экспорт)

Распаковка решения Power Platform

Принимает сжатый файл решения и разбивает его на несколько файлов XML и других файлов, чтобы система управления исходным кодом могла более легко считывать эти файлы и управлять этими файлами.

Фрагмент кода YAML (распаковать)

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

Параметры (распаковать)

Упаковка решения Power Platform

Упаковывает решение, представленное в управлении исходным кодом версиями, в файл solution.zip, который можно импортировать в другую среду.

Фрагмент кода YAML (упаковать)

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

Параметры (упаковать)

Удаление решения Power Platform

Удаление решения в целевой среде.

Фрагмент кода YAML (Удалить)

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

Параметры (Удалить)

Публикация настроек Power Platform

Публикует все настройки в среде.

Фрагмент кода YAML (опубликовать)

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

Параметры (Опубликовать)

Задание версии решения Power Platform

Обновляет версию решения.

Фрагмент кода YAML (Версия)

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

Параметры (Версия)

Хотя номер версии можно жестко закодировать в конвейере, рекомендуется использовать переменную конвейера Azure DevOps, например BuildId. Это предоставляет параметры для определения точной формы номера версии на вкладке «Параметры», например: $(Год:yyyy)-$(Месяц:MM)-$(День:dd)-$(версия:rr)-3

Это определение затем можно использовать в задаче установки версии решения, задав свойство "Номер версии" с помощью: $(Build.BuildId) вместо жесткого кодирования 20200824.0.0.2.

В качестве альтернативы для вывода встроенного скрипта задачи PowerShell $(Get-Date -Format yyyy.MM.dd.HHmm) задана пустая переменная с именем SolutionVersion как Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version"), задать версию решения как $(SolutionVersion).

Задание переменных подключения Power Platform

Устанавливает переменные PowerPlatformSetConnectionVariables.BuildTools.* для предоставления пользовательским задачам скрипта возможности использовать подключение к службе как единый источник истины.

Задаются следующие переменные:

• PowerPlatformSetConnectionVariables.BuildTools.TenantId
• PowerPlatformSetConnectionVariables.BuildTools.ApplicationId
• PowerPlatformSetConnectionVariables.BuildTools.ClientSecret
• PowerPlatformSetConnectionVariables.BuildTools.DataverseConnectionString

Фрагмент YAML (SetConnectionVariables)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.set-connection-variables.PowerPlatformSetConnectionVariables@2
  displayName: 'Power Platform Set Connection Variables '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
  timeoutInMinutes: 2
  retryCountOnTaskFailure: 5

Параметры (SetConnectionVariables)

Развертывание пакета Power Platform

Развертывает пакет в среде. Развертывание пакета, а не одного файла решения, дает вам возможность развернуть несколько решений, данных и кода в среде.

Фрагмент кода YAML (Развернуть)

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

Параметры (Развернуть)

Задачи управления средой

Автоматизируйте общие задачи управления жизненным циклом среды (ELM).

Создание среды Power Platform

Создает новую среду. Создание новой среды также автоматически создает BuildTools.EnvironmentUrl.

Фрагмент кода YAML (Create-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.create-environment.PowerPlatformCreateEnvironment@2
  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@2
  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

Параметры (Create-env)

Удаление среды Power Platform

Удаление среды.

Фрагмент кода YAML (Delete-env)

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

Параметры (Delete-env)

Назначить пользователя в Power Platform

Назначение пользователя целевой среде с указанной ролью безопасности.

Фрагмент кода YAML (AssignUser-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.assign-user.PowerPlatformAssignUser@2
  displayName: 'Power Platform Assign User '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    User: EnvironmentUsername
    Role: 'Environment Maker'
    ApplicationUser: true

Параметры (AssignUser-env)

Сброс среды Power Platform

Сбрасывает среду.

Фрагмент кода YAML (Reset-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.reset-environment.PowerPlatformResetEnvironment@2
  displayName: 'Power Platform Reset Environment '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    CurrencyName: ALL
    Purpose: 'Reset to PointInTime'
    AppsTemplate: 'D365_CustomerService,D365_FieldService'

Параметры (Reset-env)

Резервная копия среды Power Platform

Создание резервной копии среды.

Фрагмент кода YAML (Backup-env)

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

Параметры (Backup-env)

Копирование среды Power Platform

Копирование среды в целевую среду. Доступны два типа копирования: полное и минимальное. Полная копия включает в себя как данные, так и метаданные решения (настройки), тогда как минимальная копия включает только метаданные решения, но не фактические данные.

Фрагмент кода YAML (Copy-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.copy-environment.PowerPlatformCopyEnvironment@2
  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@2
  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'
    SkipAuditData: true
    MaxAsyncWaitTime: 60

Параметры (Copy-env)

Восстановление среды Power Platform

Восстанавливает среду из заданной резервной копии.

Фрагмент кода YAML (Restore-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.restore-environment.PowerPlatformRestoreEnvironment@2
  displayName: 'Power Platform Restore Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'
    RestoreLatestBackup: false
    RestoreTimeStamp: '12/01/2022 09:00'
    FriendlyName: 'Contoso Test'

Параметры (Restore-env)

Экспорт данных Dataverse

Экспорт данных из среды с предоставленной схемой.

Фрагмент кода YAML (exportdata-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-data.PowerPlatformExportData@2
  displayName: 'Power Platform Export Data '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    SchemaFile: 'C:\tempschema.xml'
    DataFile: exportdata.zip
    Overwrite: true

Параметры (exportdata-env)

Импорт данных Dataverse

Импорт данных в среду.

Фрагмент кода YAML (importdata-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-data.PowerPlatformImportData@2
  displayName: 'Power Platform Import Data '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    DataFile: 'C:\Data\Import.zip'

Параметры (importdata-env)

задачи управления Power Pages

Задачи для работы с веб-сайтом Power Pages.

Загрузка PAPortal Power Platform

Скачайте содержимое веб-сайта Power Pages из текущей среды Dataverse.

Фрагмент кода YAML (download-paportal)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.download-paportal.PowerPlatformDownloadPaportal@2
  displayName: 'Power Platform Download PAPortal '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    DownloadPath: 'C:\portals'
    WebsiteId: 'f88b70cc-580b-4f1a-87c3-41debefeb902'
    Overwrite: true

Параметры (download-paportal)

Отправка PAPortal Power Platform

Отправьте содержимое веб-сайта Power Pages в текущую среду Dataverse.

Фрагмент кода YAML (upload-paportal)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.upload-paportal.PowerPlatformUploadPaportal@2
  displayName: 'Power Platform Upload PAPortal '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    UploadPath: 'C:\portals\starter-portal'

Параметры (upload-paportal)

Каталог для задач Power Platform (предварительная версия)

Эти задачи выполняют действия для каталога в Power Platform и включают следующее.

Установка элемента каталога

Установка элемента catalog в целевую среду.

Параметры (каталог-установка)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools-DEV.install-catalog.PowerPlatformInstallCatalog@2
  displayName: 'Power Platform Install Catalog '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    Environment: '$(BuildTools.EnvironmentUrl)'
    CatalogItemId: '00000000-0000-0000-0000-000000000001'
    TargetEnvironmentUrl: 'https://test.crm.dynamics.com/'
    PollStatus: true

Отправка утверждения каталога

Отправить запрос на утверждение catalog.

Параметры (каталог-отправка)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools-DEV.submit-catalog.PowerPlatformSubmitCatalog@2
  displayName: 'Power Platform Submit Catalog '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    Environment: '$(BuildTools.EnvironmentUrl)'
    CatalogSubmissionFile: submission.json
    UsePackageSolutionZipFile: true
    FileType: SolutionZipFile
    SolutionZipFile: solution.zip
    PollStatus: true

Состояние запроса каталога

Получите статус запроса на установку/отправку каталога.

Параметры (каталог-статус)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools-DEV.catalog-status.PowerPlatforCatalogStatus@2
  displayName: 'Power Platform Catalog Status '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    Environment: '$(BuildTools.EnvironmentUrl)'
    TrackingId: '00000000-0000-0000-0000-000000000002'
    RequestType: Submit

Конвейеры сборки и выпуска

Теперь, когда мы определили, что можно сделать с помощью средств сборки, давайте посмотрим, как вы можете применить эти средства к своим конвейерам сборки и выпуска. Концептуальный обзор показан ниже. Давайте рассмотрим некоторые сведения о реализации конвейера с помощью задач средств сборки в следующих подразделах.

Чтобы узнать больше о создании этих конвейеров и фактически заняться практической разработкой конвейеров с помощью средств сборки Microsoft Power Platform, выполните лабораторные работы по средствам сборки, которые можно скачать с GitHub.

Дополнительные сведения о Azure Pipelines: Use Azure Pipelines

Конвейер сборки: экспортировать решение из среды разработки (DEV)

На следующем рисунке показаны задачи средства сборки, которые можно добавить в конвейер, который экспортирует решение из среды разработки.

Конвейер сборки: создать управляемое решение

На следующем рисунке показаны задачи средства сборки, которые можно добавить в конвейер, который собирает управляемое решение.

Конвейер выпуска: развертывание в рабочей среде (PROD)

На следующем рисунке показаны задачи средства сборки, которые можно добавить в конвейер, который развертывает в рабочей среде.

См. также

Средства сборки Microsoft Power Platform для Azure DevOps