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

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

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

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

ALM на базе Azure DevOps.

Замечание

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

Microsoft Power Platform Build Tools теперь доступны для использования в регионах GCC и GCC High.

Что такое средства сборки Microsoft Power Platform?

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

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

  • Помощник
  • Проверка качества
  • Решение
  • Управление средой

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

Что такое 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 — это версия, которую Microsoft поддерживает и в которую добавляет новые функции.

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

Important

Вы не можете одновременно использовать разные версии задач Power Platform Build Tools в вашем конвейере сборки.

Скачайте инструменты сборки Microsoft Power Platform

Microsoft Power Platform Build Tools можно установить в вашу организацию Azure DevOps из Azure Marketplace.

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

Получите средства сборки Microsoft Power Platform

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

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

Тип подключения Description
Субъект-служба через Workload Identity Federation (рекомендуется) Использует проверку подлинности на основе субъекта-службы с использованием федеративных учетных данных. Рекомендуется для клиентов, которым требуется многофакторная проверка подлинности.
Субъект-служба и секрет клиента Использует проверку подлинности на основе субъекта-службы.
Имя пользователя и пароль Подключение общей службы с именем пользователя и паролем. Не поддерживает пользователей, которым требуется многофакторная проверка подлинности.

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

Чтобы настроить подключение с использованием субъекта-службы, необходимо сначала выполнить проверку подлинности профиля Power Platform с необходимыми разрешениями. Необходимо добавить приложение Microsoft Entra ID и связанного пользователя приложения в среду Dataverse.

Создание субъекта-службы и секрета клиента

Используйте команду pac admin create-service-principal, чтобы создать и настроить субъект-службу, которая будет использоваться с задачами Microsoft Power Platform Build Tools.

Эта команда сначала регистрирует объект приложения и соответствующее имя субъекта-службы в Microsoft Entra ID. Затем он добавляет приложение в качестве пользователя-администратора в тенант Microsoft Power Platform.

Эта команда имеет два параметра:

имя краткое имя Обязательный Description
environment env Да ИД или URL-адрес среды, в которую требуется добавить пользователя приложения.
role r Нет Имя или идентификатор роли безопасности для применения к пользователю приложения. Значением по умолчанию является "Системный администратор".

Средству проверки решений требуется роль с привилегией prvAppendmsdyn_analysisjob, чтобы дополнять таблицу msdyn_analysisjob. По умолчанию роль безопасности «Системный администратор» имеет эту привилегию.

Используйте следующую команду:

C:\> pac admin create-service-principal  --environment <environment id>

При успешном выполнении команда отображает четыре столбца:

  • Power Platform TenantId (идентификатор арендатора)
  • ИД приложения
  • Секрет клиента (в чистом тексте)
  • Истечение срока действия

Рассмотрим пример.

PS C:\>pac admin create-service-principal --environment d3fcc479-0122-e7af-9965-bde57f69ee1d
Connected as admin@M365x57236726.onmicrosoft.com
Successfully assigned user adde6d52-9582-4932-a43a-beca5d182301 to environment d3fcc479-0122-e7af-9965-bde57f69eeld with security role System Administrator
Tenant ID                            Application ID                       Client Secret                           Expiration
2b0463ed-efd7-419d-927d-a9dca49d899c adde6d52-9582-4932-a43a-beca5d182301 beY8Q~JBZ~CBDgIKKBjbZ3g6BofKzoZkYj23Hbf 7/31/2024 4:27:03 PM

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

Important

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

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

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

PS C:\>pac admin assign-user --user "adde6d52-9582-4932-a43a-beca5d182301" --role "System administrator" --environment d3fcc479-0122-e7af-9965-bde57f69ee1d --application-user
Connected to... SnDemoDev
Connected as admin@M365x57236726.onmicrosoft.com
Successfully assigned user adde6d52-9582-4932-a43a-beca5d182301 to environment d3fcc479-0122-e7af-9965-bde57f69ee1d with security role System Administrator

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

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

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

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

Почему новая задача основана на интерфейсе командной строки Power Platform, а не на PowerShell?

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

Инструменты сборки Microsoft Power Platform работают только с Power Apps?

Build Tools работают для приложений на основе холста и модели, виртуальных агентов Microsoft Copilot Studio, потоков пользовательского интерфейса и традиционных потоков, AI Builder, настраиваемых соединителей и потоков данных — все это теперь можно добавить в решение. Этот список также включает приложения для взаимодействия с клиентами (Dynamics 365 Sales, обслуживание клиентов, службу полей, маркетинг и Project Service Automation). Отдельные задачи сборки доступны для приложений для управления финансами и операциями.

Ранее я установил предварительную версию средств сборки. Можно ли выполнить обновление с предварительной версии Power Apps средств сборки до средств сборки Power Platform?

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

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

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

Сколько стоят инструменты сборки Microsoft Power Platform?

Средства сборки доступны бесплатно. Однако для использования средств сборки требуется действительная подписка для Azure DevOps. Дополнительные сведения см. в разделе Pricing для Azure DevOps.

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

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

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

Выходные данные задачи проверки — это SARIF-файл. И VS Code, и Visual Studio расширения доступны для просмотра и выполнения действий в ФАЙЛАх SARIF.

См. также

Заметки о выпуске Power Platform Build Tools для Azure DevOps
Задачи Build Tools
Практические занятия по Microsoft Power Platform Build Tools

  • Last updated on