Поделиться через

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

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

  • Синхронизация метаданных решения (также называемых решениями), которые содержат различные компоненты платформы, такие как:
    • Приложения для взаимодействия с клиентами: Dynamics 365 Sales, Служба клиентов, Служба полей, Маркетинг и Project Service Automation
    • Приложения на основе холста
    • Приложения на основе моделей
    • Потоки пользовательского интерфейса
    • Виртуальные агенты
    • модели "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?

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

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

Важно

В одном конвейере сборки невозможно смешивать разные версии задач 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, необходимо установить подключение, чтобы задачи средства сборки могли выполнять необходимые действия. Доступны два типа соединений:

Тип подключения Описание
Субъект-служба через 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.

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

название краткое имя Обязательное Описание
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.

Важно

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

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

Необходимо добавить ИД приложения в качестве пользователя приложения в среду 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 являются мультиплатформенными и обеспечивают высокую гибкость, включая возможность запуска на Linux. Это те же задачи, которые доступны в Power Platform Actions для GitHub. Теперь у вас есть согласованный интерфейс между Azure DevOps и GitHub.

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

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

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

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

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

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

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

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

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

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

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

Выходные данные задачи проверки — это файл Sarif и расширения VS Code и Visual Studio доступны для просмотра и выполнения действий в Sarif files.

См. также

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

  • Last updated on