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

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

  • Синхронизация метаданных решения (также называемых решениями), которые содержат различные компоненты платформы, такие как приложения для взаимодействия с клиентами (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 версии 1.0.* теперь доступны для использования в регионах GCC и GCC High.
Microsoft Power Platform Build Tools версии 2.0 теперь доступны, кроме регионов GCC и GCC High.

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

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

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

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

  • Решение

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

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

Что такое Power Platform Build Tools версии 2.0?

В дополнение к тому, что предоставляют Power Platform Build Tools, версия 2.0 Power Platform Build Tools построена на основе интерфейса командной строки Power Platform. Power Platform Build Tools версии 1.0, как первый выпуск, основаны на PowerShell. В будущем Power Platform Build Tools 2.0 — это версия, которая будет обслуживаться и в которую будут добавляться новые функции. Для предыдущих версий Power Platform Build Tools мы будем делать критические обновления безопасности по мере необходимости. Мы настоятельно рекомендуем клиентам перейти на Power Platform Build Tools версии 2.0 как можно раньше.

Важно!

Вы не можете смешивать и сопоставлять версии задач для 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

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

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

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

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

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

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

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

Затем это приложение добавляется в качестве пользователя администратора в сам клиент Microsoft 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:

  • Первый запрос: войти как администратор в экземпляр AAD, связанный с клиентом Microsoft Power Platform
  • Второй запрос: войти в систему как арендатор администратор клиента в сам клиент Microsoft Power Platform

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

  • Power Platform TenantId
  • Application ID
  • Секрет клиента (открытым текстом)

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

Важно!

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

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

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

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

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

Будет ли мои старые конвейеры Microsoft Power Platform Build Tool продолжают работать?

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

Почему вы положили в основу новой задачи интерфейс командной строки Power Platform вместо PowerShell?

Задачи интерфейса командной строки Power Platform являются мультиплатформенными с большой гибкостью, включая запуск на Linux. Это те же задачи, которые доступны с действиями Power Platform для GitHub. Теперь у вас есть единообразный опыт между Azure DevOps и GitHub.

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

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

Я ранее установил предварительную версию инструментов сборки — могу ли я обновить предварительную версию 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.

См. также

Задачи средств сборки
Лаборатории Microsoft Power Platform Build Tools

Примечание

Каковы ваши предпочтения в отношении языка документации? Пройдите краткий опрос (обратите внимание, что этот опрос представлен на английском языке).

Опрос займет около семи минут. Личные данные не собираются (заявление о конфиденциальности).