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

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

  • Синхронизация метаданных решения (также называемых решениями), которые содержат различные компоненты платформы, такие как приложения Customer Engagement (Dynamics 365 Sales, Customer Service, Field Service, Marketing и Project Service Automation), приложения на основе холста, приложения на основе моделей, потоки пользовательского интерфейса, виртуальные агенты, модели AI Builder и соединители между средами разработки и системой контроля версий
  • Создание артефактов сборки
  • Развертывание в нижестоящих средах
  • Подготовка или отмена подготовки сред
  • Выполните проверки со статическим анализом для решений с помощью службы средства проверки Power Apps

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

ALM от Azure DevOps

Примечание

Microsoft Power Platform Build Tools поддерживаются только для среды Microsoft Dataverse с базой данных. Дополнительные сведения: Создание среды с базой данных

Что такое Microsoft Power Platform Build Tools?

Microsoft Power Platform Build Tools — это набор Power Platform–специализированных задач сборки Azure DevOps, который устраняет необходимость вручную загружать настраиваемые инструменты и сценарии для управления жизненным циклом приложений, созданных на основе Power Platform. Задачи могут использоваться по отдельности для выполнения простой задачи, такой как импорт решения в нижестоящую среду, или использоваться вместе в конвейере для организации сценария, такого как "создание артефакта сборки", "развертывание для тестирования" или "изменения разработчика урожая". Задачи сборки можно главным образом разделить на четыре типа:

  • Вспомогательная функция

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

  • Решение

  • Управление средой

Для получения дополнительной информации о доступных задачах см. Задачи Microsoft Power Platform Build Tools.

Получение Microsoft Power Platform Build Tools

Microsoft Power Platform Build Tools могут быть установлены в вашей организации Azure DevOps из Azure Marketplace.

После установки все задачи, включенные в Microsoft Power Platform Build Tools будут доступны для добавления в любой новый или существующий конвейер. Вы можете найти их, выполнив поиск "Power Platform".

Получить Microsoft Power Platform Build Tools

Подключение к средам

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

  • Имя пользователя и пароль: настроено как подключение общей службы с именем пользователя и паролем. Обратите внимание, что имя пользователя и пароль не поддерживают многофакторную аутентификацию.
  • Субъект-служба и секрет клиента: (рекомендуется) этот тип соединения использует аутентификацию на основе субъекта-службы и поддерживает многофакторную аутентификацию.

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

Чтобы настроить соединение с использованием субъекта-службы, сначала необходимо создать регистрацию приложения в Azure Active Directory (AAD) с необходимыми разрешениями, а затем создайте связанного пользователя приложения в среде Power Platform, к которой вы хотите подключиться. Мы даем сценарий, чтобы облегчить выполнение некоторых шагов, описанных в разделе ниже, в то время как подробная информация с пошаговыми инструкциями вручную доступна здесь.

Создание субъекта-службы и секрета клиента с помощью PowerShell

Этот сценарий PowerShell помогает в создании и настройке субъекта-службы для использования с задачами Microsoft Power Platform Build Tools. Сначала он регистрирует объект приложения и соответствующее имя субъекта-службы (SPN) в AAD.

Затем это приложение добавляется в качестве пользователя администратора в сам клиент Power Platform.

Установка

Загрузите следующий командлет PowerShell: https://pabuildtools.blob.core.windows.net/spn-docs-4133a3fe/New-CrmServicePrincipal.ps1

  • Откройте обычную командную строку Windows PowerShell (стандартно, не ядро PS)
  • Перейдите в папку, в которой вы сохранили сценарий, и разблокируйте сценарий, используя следующую команду: `Unblock-File New-CrmServicePrincipal.ps1`
  • Выполните сценарий: `.\New-CrmServicePrincipal.ps1`

Сценарий выдаст два запроса в диалоговых окнах входа AAD:

  • 1-й запрос: войти как администратор в экземпляр AAD, связанный с клиентом Microsoft Power Platform
  • 2-й запрос: войти в качестве администратор клиента в сам клиент Microsoft Power Platform

В случае успеха отображаются 3 столбца:

  • Power Platform TenantId
  • ИД приложения
  • Секрет клиента (открытым текстом)

Используйте отображаемую информацию для настройки подключения службы Power Platform.

Важно!

Храните секрет клиента в безопасном месте. После очистки командной строки PowerShell вы не сможете снова получить тот же секрет клиента.

Настройте среду с помощью идентификатора приложения

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

Убедитесь, что добавленному пользователю приложения назначена системная роль "администратор" (доступна в разделе "Управление ролями" в настройках безопасности для пользователя приложения).

Часто задаваемые вопросы

Microsoft Power Platform Build Tools работают только для Power Apps?

Инструменты сборки работают как с приложениями на основе холста, так и с приложениями на основе модели, Power Virtual Agents, потоками пользовательского интерфейса и традиционными потоками, AI Builder, пользовательскими соединителями и потоками данных, все из которых теперь можно добавить в решение. Сюда также входят приложения Customer Engagement (Dynamics 365 Sales, Customer Service, Field Service, Marketing, and Project Service Automation). Отдельные задачи сборки доступны для приложений Finance and Operations.

Я ранее установил предварительную версию инструментов сборки — могу ли я обновить предварительную версию Power Apps Build Tools до Power Platform Build Tools?

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

Могу ли я включить поток и приложения на основе холста?

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

Сколько стоит Microsoft Power Platform Build Tools?

Build Tools доступны бесплатно. Тем не менее, действительная подписка на Azure DevOps требуется для использования Build Tools. Больше информации доступно в разделе Цены на Azure DevOps.

Я вижу расширение, но почему у меня нет возможности его установить?

Если вы не видите вариант установить вариант, то вам, скорее всего, не хватает необходимых прав установки в вашей организации Azure DevOps. Больше информации доступно в разделе Управление расширениями разрешений.

Как разработчики могут использовать результаты задачи средства проверки?

Результатом задачи средства проверки является файл Sarif, VS Code и расширения Visual Studio доступны для просмотра и выполнения действий с файлами Sarif.

См. также

Задачи средств сборки