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

Вы можете настраивать компоненты ALM Accelerator for Power Platform с помощью приложения для администрирования или вручную. Эта статья поможет вам использовать приложение администрирования и состоит из семи разделов:

• Необходимые условия
• Настройка регистраций приложений Microsoft Entra
• Установите расширения Azure DevOps
• Импорт решения и настройка приложения
• Настройка первого проекта Azure DevOps для использования с акселератором ALM
• Создание пользователя приложения в своей среде Dataverse
• Настройка создателей для использования приложения ALM Accelerator

Необходимые условия

Перед установкой ALM Accelerator for Power Platform убедитесь, что выполнены следующие предварительные условия.

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

  Замечание

  ALM Accelerator не совместимо с Dataverse for Teams. И приложение ALM Accelerator, и связанные конвейеры предполагают использование полной версии Dataverse во всех средах.

  Мы рекомендуем устанавливать ALM Accelerator в одной среде с другими решениями CoE Starter Kit. Узнайте больше о том, как определить наилучшую стратегию для своей организации:

  • Разработайте стратегию среды клиента, чтобы внедрить Power Platform в большом масштабе
  • Стратегия среды для ALM

• ALM Accelerator использует Azure DevOps для контроля версий и развертываний. Если у вас нет организации Azure DevOps, зарегистрируйтесь бесплатно для до пяти пользователей на сайте Azure DevOps.

• Чтобы выполнить действия, описанные в этом разделе, вам потребуются следующие пользователи и разрешения в Azure, Azure DevOps и Power Platform:

  • Лицензированный Azure пользователь с разрешениями на создание и просмотр групп Microsoft Entra, создание регистраций приложений и предоставление администратору согласия администратора на регистрацию приложений в Microsoft Entra ID
  • Лицензированный Azure DevOps пользователь с разрешениями на создание конвейеров, подключений служб, репозиториев и расширений, а также управление ими
  • Лицензированный пользователь Power Platform с разрешениями на создание пользователей приложения и предоставление административных разрешений

• Должны быть доступны следующие соединители, используемые вместе в среде, в которую импортируется ALM Accelerator:

  • Dataverse (устаревший)
  • HTTP
  • Power Apps для разработчиков
  • HTTP с Microsoft Entra ID (с доступом к конечной точке https://graph.microsoft.com)
  • ALM Accelerator Custom DevOps (этот соединитель создается как часть импорта решения ускорителя)
  • Office 365 Пользователи
  • HTTP

• Установите "Набор создателя" в среде, в которой вы устанавливаете ALM Accelerator.

Настройка регистрации приложений Microsoft Entra

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

Создание регистрации приложения в среде Microsoft Entra

Создайте регистрацию приложения для акселератора ALM, чтобы предоставить приложению и связанным конвейерам разрешения, необходимые для выполнения операций в Azure DevOps и Power Apps или Dataverse. Это необходимо сделать только один раз.

Ниже показано, как создать одну регистрацию приложения с разрешениями для Dataverse и Azure DevOps. Однако для разделения ответственности может потребоваться создать отдельные регистраций приложений. Прежде чем выбрать ту или иную стратегию регистрации приложений, оцените, как раздельная регистрация приложений повлияет на удобство обслуживания и безопасность.

Создание регистрации приложения

1. Войдите на портал Azure.

2. Выберите Microsoft Entra ID>Регистрации приложений.

3. Выберите + Создать регистрацию, а затем дайте регистрации имя, например: ALMAcceleratorServicePrincipal.

4. Во всех остальных параметрах оставьте значения по умолчанию и нажмите Регистрация.

Добавление разрешений в регистрацию приложения

1. На левой боковой панели выберите Разрешения API.

2. Выберите + Добавить разрешение.

3. Выберите Dynamics CRM, а затем выберите Делегированные разрешения и user_impersonation.

4. Выберите Добавить разрешения, чтобы добавить разрешение Dynamics CRM API user_impersonation в регистрацию приложения.

5. Снова нажмите + Добавить разрешение.

6. Откройте вкладку API, которые использует моя организация. Найдите и выберите PowerApps-Advisor, а затем выберите Делегированные разрешения и Analysis.All (согласие администратора не требуется).

   Это разрешение необходимо для выполнения статического анализа посредством средства проверки приложений.

7. Выберите Добавить разрешения, чтобы добавить разрешение PowerApps-Advisor API Analysis.All в регистрацию приложения.

8. Снова нажмите + Добавить разрешение.

9. На вкладке Microsoft APIs или вкладке API, используемые моей организацией выберите Azure DevOps и затем выберите Делегированные разрешения и user_impersonation.

   Это разрешение требуется для подключения к Azure DevOps через настраиваемый соединитель в приложении акселератора ALM.

10. Если вы добавили разрешение Azure DevOps из вкладки APIs, используемые моей организацией, скопируйте идентификатор приложения (клиента) для последующего использования в этой процедуре.

    Вы будете использовать его как Идентификатор приложения (клиента) DevOps, и с ним не следует путать Идентификатор приложения (клиента), которые вы скопируете позже в этой процедуре.

    

    Если вы не можете найти разрешение Azure DevOps на вкладке APIs, которую использует моя организация>, выполните следующие действия, чтобы получить идентификатор приложения DevOps (клиент:

    1. Откройте окно браузера в приватном режиме и перейдите по адресу https://dev.azure.com/<your devops organization>/_apis.
    2. На странице входа скопируйте значение параметра client_id в URL-адресе.

    

11. Выберите Добавить разрешения, чтобы добавить разрешение user_impersonation для API Azure DevOps в регистрацию приложения.

12. Выберите Предоставить согласие администратора для <ваш клиент>.

Настройте секрет клиента и URI перенаправления

1. На левой боковой панели выберите Сертификаты & секреты.

2. Выберите + Создать секрет клиента.

3. Выберите дату окончания срока действия, а затем нажмите Добавить.

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

5. На левой боковой панели выберите Обзор.

6. Скопируйте идентификатор приложения (клиента) и идентификатор каталога (клиента).

7. Выберите Добавить URI перенаправления.

8. Выберите + Добавить платформу, затем выберите Интернет.

9. В качестве URI перенаправления приложения введите https://global.consent.azure-apim.net/redirect.

   Это значение может потребоваться изменить после установки приложения акселератора ALM и настройки пользовательского соединителя Azure DevOps. Если URI перенаправления, указанный в настраиваемом соединителе, будет отличаться от введенного здесь, измените этот URI, чтобы он совпадал с URI в настраиваемом соединителе.

10. Выберите и настройте.

Предоставление разрешения на управление Power App для вашей регистрации приложения

Предоставьте разрешения на управление Power App своей регистрации приложения, чтобы конвейеры могли выполнять необходимые действия в ваших средах. Для этого запустить следующий командлет PowerShell от имени интерактивного пользователя, у которого есть административные привилегии Power Apps. Вам нужно выполнить эту команду только один раз после создания регистрации приложения.

Install-Module -Name Microsoft.PowerApps.Administration.PowerShell
Install-Module -Name Microsoft.PowerApps.PowerShell -AllowClobber
New-PowerAppManagementApp -ApplicationId <the Application (client) ID you copied when you created the app registration>

Установка расширений Azure DevOps

Акселератор ALM использует несколько расширений Azure DevOps, включая некоторые сторонние расширения, доступные в Azure DevOps Marketplace. Веб-сайт каждого стороннего расширения и ссылка на соответствующий исходный код приведены в следующих инструкциях. Узнайте, как оценить издатель расширений Marketplace.

1. Войдите в Azure DevOps.

2. Выберите параметры организации.

3. Выберите Общие>Расширения.

4. Найдите и установите следующие расширения:

   • Power Platform Build Tools (обязательно): это расширение содержит задачи сборки Microsoft для Power Platform. (https://marketplace.visualstudio.com/items?itemName=microsoft-IsvExpTools.PowerPlatform-BuildTools)

   • Замена токенов (обязательно): конвейеры используют это расширение для замены токенов в файлах конфигурации и хранения безопасных значений в закрытых переменных, настроенных для конвейера. (https://marketplace.visualstudio.com/items?itemName=qetza.replacetokens | https://github.com/qetza/vsts-replacetokens-task)

   • вкладка SARIF SAST Scans (необязательно): с помощью этого расширения можно визуализировать файлы SARIF, которые создаются средством проверки решений во время сборки. (Вкладка сканирования SARIF SAST — Visual Studio Marketplace)

     Снимок экрана вкладки SARIF SAST Scans в Azure DevOps.

Импорт решения и настройка приложения

Импортируйте приложение на основе холста ALM Accelerator в свою среду Power Platform, а затем настройте прилагаемый пользовательский соединитель для Azure DevOps.

Установка ALM Accelerator в Dataverse

1. Скачайте последнюю версию файла управляемого решения из GitHub. Прокрутите вниз до пункта Ресурсы и выберите CenterofExcellenceALMAccelerator_<последняя версия>_managed.zip.

2. Войдите в Power Apps и выберите среду, в которой вы хотите разместить приложение ALM Accelerator.

3. На левой боковой панели выберите Решения.

4. Выберите Импорт решения>Обзор, а затем перейдите к расположению загруженного вами файла управляемого решения и выберите его.

5. Выберите Далее, затем снова выберите Далее.

6. На странице Подключения выберите или создайте подключение для подключения CDS DevOps к Dataverse.

   При создании подключения для HTTP с Microsoft Entra используйте Microsoft Graph для обоих параметров.

7. Нажмите Импорт.

Настройка пользовательского соединителя DevOps

1. Выберите Данные>Настраиваемые соединители>CustomAzureDevOps.

2. Выберите Правка.

3. На вкладке Безопасность выберите Изменить, а затем установите следующие значения:

   Name	Value
   Тип проверки подлинности	OAuth 2.0
   Провайдер удостоверений личности	Microsoft Entra ID
   идентификатор клиента	Идентификатор приложения (клиента), который вы скопировали при создании регистрации приложения
   Секрет клиента	Значение секрета приложения (клиента), которое вы скопировали при создании регистрации приложения
   Идентификатор клиента	Оставьте значение по умолчанию (общий).
   URL-адрес ресурса	Идентификатор приложения (клиента) DevOps, который вы скопировали, когда добавляли разрешения в регистрацию вашего приложения

4. Выберите Обновить соединитель.

5. Убедитесь, что URL-адрес перенаправления на странице Безопасность имеет значение https://global.consent.azure-apim.net/redirect.

   Если это не так, скопируйте URL-адрес. Вернитесь к созданной вами ранее регистрации приложенияи поменяйте там URI перенаправления на скопированный URL-адрес.

Тестирование настраиваемого соединителя

1. Откройте меню Тест.

2. Выберите Создать подключение и создайте подключение, следуя отображаемым инструкциям.

3. В Power Apps выберите среду, а затем выберите Dataverse>Custom Connectors>CustomAzureDevOps.

4. Выберите Изменить, перейдите на страницу Тестирование и найдите операцию GetOrganizations.

5. Выберите Тест операции.

6. Перепроверьте, что возвращенный Response Status равен 200, а Response Body — это представление вашей организации Azure DevOps в формате JSON.

   

Настройка первого проекта Azure DevOps для использования с акселератором ALM

Используйте мастер настройки, чтобы настроить проект Azure DevOps для развертывания решений Power Platform при помощи ALM Accelerator. Вы можете настроить существующий пустой проект или создать новый проект.

1. Откройте приложение администрирования ALM Accelerator.

2. На левой боковой панели выберите Projects в группе Azure DevOps.

3. Если вам будет предложено обновить Теги выпуска, выберите ОК.

4. Выберите свою Azure DevOps организацию в списке.

5. В списке проектов выберите Создать.

6. Выберите Мастер проектов.

7. На шаге Проект введите имя для своего проекта. При желании введите описание и включите предварительные версии функций.

8. Нажмите кнопку Далее.

9. На шаге Шаблоны конвейеров выберите Далее для установки шаблонов в ваш проект.

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

10. На шагах Подключения к службе выберите среды, для которых вы хотите создать подключение к службе.

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

11. Настроив подключение к службе для регистрации приложения, выберите Добавить.

12. Настроив все подключения к службе, выберите Далее.

13. На шаге Generic Pipelines выберите Next, чтобы создать конвейеры и группу переменных и задать разрешения Azure DevOps, необходимые для работы с акселератором ALM.

Создание пользователя приложения в своей среде Dataverse

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

1. Войдите в центр администрирования Power Platform.

2. Выберите свою среду разработки, а затем выберите Параметры.

3. Выберите Пользователи + разрешения>Пользователи приложения.

4. Выберите + Новый пользователь приложения.

5. Выберите + Добавить приложение, выберите ранее созданную вами регистрацию приложения, а затем выберите Добавить.

6. Выберите бизнес-единицу.

7. Нажмите значок карандаша справа от Роли безопасности и выберите роли безопасности для пользователя приложения.

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

8. Нажмите кнопку "Создать".

Повторите эти действия для своих проверочной, тестовой и рабочей сред.

Настройка создателей для использования приложения ALM Accelerator

• Настройка разрешений пользователя для учетной записи производителя в Dataverse и Azure DevOps.

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

Подробнее

• ALM Accelerator for Power Platform
• Настройте профили развертывания
• Конфигурация и развертывание данных в конвейерах
• Настройка синхронизации конвейеров