Налаштування ALM Accelerator за допомогою програми адміністрування
Ви можете налаштувати компоненти як 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 несумісний із Dataverse for Teams. Як програма ALM Accelerator, так і пов’язані конвеєри припускають, що ви використовуєте повну версію Dataverse в усіх середовищах.
Ми рекомендуємо інсталювати ALM Accelerator у тому ж середовищі, що й інші рішення CoE Starter Kit. Дізнайтеся більше про те, як визначити найкращу стратегію для вашої організації:
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
Інсталюйте Creator Kit у середовищі, де ви встановлюєте прискорювач ALM.
Налаштування Microsoft Entra реєстрації додатків
Наступні кроки є загальними для функціональності прискорювача ALM і не є специфічними для будь-якого проекту чи рішення.
Створіть реєстрацію в додатку у своєму Microsoft Entra середовищі
Створіть реєстрацію програми для прискорювача ALM, щоб надати програмі та пов’язаним воронкам дозволи, необхідні для виконання операцій у Azure DevOps та/ Power Apps або Dataverse. Зробити це потрібно лише один раз.
У зазначених нижче кроках показано, як створити єдину реєстрацію програми з дозволами для Dataverse та Azure DevOps. Однак ви можете створити окремі реєстрації в програмах, щоб розподілити обов’язки. Перш ніж ухвалити рішення про стратегію реєстрації додатків, слід розглянути, як окремі реєстрації додатків впливають на технічне обслуговування та безпеку .
Створіть реєстрацію в додатку
Увійдіть у Портал Azure.
Виберіть Microsoft Entra Реєстрація> додатків ID.
Виберіть + Нова реєстрація, а потім дайте реєстрації назву, наприклад ALMAcceleratorServicePrincipal.
Залиште всі інші параметри на значеннях за замовчуванням і виберіть Зареєструватися.
Додайте дозволи на реєстрацію в додатку
На бічній панелі ліворуч виберіть дозволи API.
Виберіть+ Додати дозвіл.
Виберіть Dynamics CRM, а потім виберіть Делеговані дозволи та user_impersonation.
Виберіть Додати дозволи, щоб додати Dynamics CRM API user_impersonation дозвіл на реєстрацію додатка.
Натисніть + Додати дозвіл ще раз.
Виберіть вкладку API , які використовує моя організація. Знайдіть і виберіть PowerApps - Радник, а потім виберіть Делеговані дозволи та Аналіз.Все (згода адміністратора не потрібна).
Цей дозвіл потрібен для запуску статичного аналізу через перевірку додатків.
Виберіть Додати дозволи, щоб додати the-Advisor PowerApps API Analysis.Усі дозволи на реєстрацію програми.
Натисніть + Додати дозвіл ще раз.
На вкладці API Microsoft або на вкладці API, які використовує моя організація, виберіть Azure DevOps, а потім виберіть Делеговані дозволи та user_impersonation.
Цей дозвіл потрібен для підключення через Azure DevOps спеціальний з’єднувач у програмі ALM Accelerator.
Якщо ви додали Azure DevOps дозвіл від вкладки API, які використовує моя організація, скопіюйте ідентифікатор програми (клієнта) для використання пізніше в цій процедурі.
Ви використовуватимете його як ідентифікатор застосунку(клієнта) DevOps, який відрізняється від ідентифікатора програми (клієнта), який ви скопіюєте пізніше в цій процедурі.
Якщо ви не можете знайти Azure DevOps дозвіл на вкладці API , які використовує моя організація, виконайте такі дії, щоб отримати ідентифікатор програми (клієнта) DevOps:
- Відкрийте вікно приватного браузера та перейдіть до.
https://dev.azure.com/<your devops organization>/_apis
- На сторінці входу скопіюйте значення параметра client_id в URL-адресі.
- Відкрийте вікно приватного браузера та перейдіть до.
Виберіть Додати дозволи, щоб додати Azure DevOps API user_impersonation дозвіл на реєстрацію додатка.
Виберіть Надати згоду адміністратора для <свого клієнта>.
Налаштуйте секрет клієнта та перенаправте URI
На лівій бічній панелі виберіть Сертифікати та секрети.
Виберіть + Створити секретний ключ клієнта (client).
Виберіть дату завершення терміну дії, а потім натисніть кнопку Додати.
Скопіюйте секретне значення клієнта для використання пізніше. Це єдиний випадок, коли ви можете скопіювати значення. Обов’язково зробіть це перед тим, як залишити сторінку.
На бічній панелі ліворуч виберіть Огляд.
Скопіюйте ідентифікатор програми (клієнта) та ідентифікатор довідника (клієнта).
Виберіть Додати URI переспрямування.
Натисніть + Додати платформу, а потім виберіть Інтернет.
Для перенаправлення URI програми введіть
https://global.consent.azure-apim.net/redirect
.Можливо, вам доведеться змінити це значення після встановлення програми ALM Accelerator і налаштування Azure DevOps спеціального з’єднувача. Якщо URI переспрямування, який заповнюється в спеціальному з’єднувачі, відрізняється від того, що ви вводите тут, змініть цей URI, щоб він відповідав тому, що в спеціальному з’єднувачі.
Виберіть Налаштувати.
Надайте дозвіл Power App Management на реєстрацію вашого додатка
Надайте Power App Management дозволи на реєстрацію вашого застосунку, щоб конвеєри могли виконувати необхідні дії у вашому середовищі. Для цього запустіть наступний командлет PowerShell як інтерактивний користувач із Power Apps правами адміністратора. Вам потрібно виконати цю команду лише один раз, після створення реєстрації в програмі.
Важливо
Наведений нижче командлет PowerShell надає реєстрації в додатку підвищені дозволи, наприклад Power Platform Admin. Політики безпеки вашої організації можуть не дозволяти такі типи дозволів. Переконайтеся, що вони дозволені, перш ніж продовжити. Якщо їх не дозволено, певні можливості не працюватимуть у конвеєрах прискорювача ALM.
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.
авторизуйтесь в. Azure DevOps
Виберіть Налаштування організації.
Виберіть Загальні>розширення.
Знайдіть та встановіть такі розширення:
Power Platform Інструменти збірки (обов’язково): Це розширення містить завдання на збірку 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 Scans – Visual Studio Marketplace)
Імпортуйте рішення та налаштуйте застосунок
Імпортуйте програму ALM Accelerator canvas у своє Power Platform середовище, а потім налаштуйте спеціальний з’єднувач, що Azure DevOps входить до комплекту.
Встановіть прискорювач ALM у Dataverse
Завантажте останній файл керованого рішення з GitHub. Прокрутіть униз до розділу "Активи " та виберіть CenterofExcellenceALMAccelerator_<остання версія>_managed.zip.
увійдіть у Power Apps систему, а потім виберіть середовище, у якому ви хочете розмістити програму ALM Accelerator.
На бічній панелі ліворуч виберіть Рішення.
Виберіть Імпортувати рішення>Огляд, а потім перейдіть до розташування керованого рішення, яке ви завантажили, і виберіть файл.
Виберіть Далі > Далі.
На сторінці «Підключення » виберіть або створіть з’єднання для підключення з’єднання Dataverse CDS DevOps.
Коли ви створюєте з’єднання для HTTP with Microsoft Entra, використовуйте Microsoft Графік для обох параметрів.
Виберіть Імпортувати.
Налаштування настроюваного з’єднувача DevOps
Виберіть Data>Custom Connectors>CustomAzureDevOps.
Виберіть Редагування.
На вкладці Безпека виберіть Редагувати, а потім встановіть такі значення:
Ім'я Значення Тип аутентифікації OAuth 2.0 Постачальник посвідчень Microsoft Entra Ідентифікатор Ідентифікатор клієнта Ідентифікатор програми (клієнта), який ви скопіювали під час реєстрації додатка Секрет клієнта Секретне значення програми (клієнта), яке ви скопіювали під час реєстрації в додатку Ідентифікатор орендаря Залиште значення за замовчуванням, загальне URL ресурсу ID застосунку (клієнта) DevOps, який ви скопіювали під час додавання дозволів на реєстрацію застосунку Виберіть Оновити з’єднувач.
Переконайтеся, що URL-адреса переспрямування на сторінці Безпека є
https://global.consent.azure-apim.net/redirect
.Якщо це не так, скопіюйте URL-адресу. Поверніться до реєстрації програми, яку ви створили раніше, і замініть там URI перенаправлення на скопійовану URL-адресу.
Перевірте спеціальний з’єднувач
Відкрийте меню Тест.
Виберіть « Нове підключення», а потім дотримуйтесь підказок, щоб створити підключення.
У Power Apps виберіть своє середовище, а потім натисніть Dataverse>Настроювані з’єднувачі>CustomAzureDevOps.
Виберіть Редагувати, перейдіть на сторінку Тестування , а потім знайдіть операцію GetOrganizations .
Виберіть Тестова операція.
Підтвердьте, що повернутий статусвідповідь становить 200 , а відповідь Body є JSON-представництвом вашої організації. Azure DevOps
Налаштуйте свій перший Azure DevOps проект для використання з прискорювачем ALM
Використовуйте майстер, що входить до комплекту, щоб налаштувати свій Azure DevOps проект для розгортання Power Platform рішень за допомогою прискорювача ALM. Ви можете налаштувати існуючий порожній проект або створити його.
Відкрийте програму адміністрування прискорювача ALM.
На бічній панелі ліворуч виберіть Проекти в групі Azure DevOps .
Якщо вам буде запропоновано оновити теги випуску, натисніть «OK».
Виберіть свою Azure DevOps організацію зі списку.
У списку «Проекти» виберіть «Створити».
Виберіть Майстер проектів.
На кроці Projectкрок введіть назву вашого проекту. За бажанням введіть опис і ввімкніть підготовча версія функцій.
Виберіть Далі.
На кроці «Шаблони воронки» виберіть «Далі », щоб встановити шаблони у свій проєкт.
Додаток встановлює шаблони воронки продажів у новий репозиторій у проєкті. Крім того, ви можете налаштувати проект на використання шаблонів з проекту, в якому вони вже встановлені.
На кроках « Підключення до служб» виберіть середовища, для яких потрібно створити підключення до служби.
Можна вибрати кілька середовищ і одночасно створити підключення до служб для них усіх. Щоб використовувати різні реєстрації програм для своїх середовищ, створіть підключення служби для кожної реєстрації програми окремо.
Налаштувавши підключення служби для реєстрації програми, натисніть кнопку Додати.
Налаштувавши всі підключення до служби, натисніть кнопку Далі.
На кроці «Загальні конвеєрикрок » виберіть «Далі », щоб створити групи конвеєрів і змінних, а також встановити дозволи, Azure DevOps необхідні проєкту для функцій прискорювача ALM.
Створення користувача програми в середовищах Dataverse
Створіть користувача додатку у своїх середовищах, щоб дозволити пайплайнам Dataverse підключатися. Робіть це в кожному середовищі, для розгортання якого ви плануєте використовувати прискорювач ALM.
Авторизуйтесь в Центрі Power Platform адміністрування.
Виберіть своє середовище розробки, а потім натисніть Налаштування .
Виберіть Користувачі + дозволи>Користувачі програми.
Виберіть+ Новий користувач програми.
Натисніть + Додати програму, виберіть реєстрацію програми, яку ви створили раніше, а потім натисніть Додати.
Виберіть бізнес-одиницю.
Виберіть піктограму олівця праворуч від пункту Ролі безпеки, а потім виберіть ролі безпеки для користувача програми.
Ми рекомендуємо надати користувачеві програми привілеї ролі безпеки, щоб користувач міг виконувати необхідні функції в кожному середовищі.
Виберіть Створити.
Повторіть ці кроки у своїх середовищах перевірки, тестування та виробництва.
Налаштуйте мейкерів для використання програми ALM Accelerator
Налаштуйте дозволи користувача для облікового запису виробника в Dataverse та. Azure DevOps
Налаштуйте параметри користувача розгортання, щоб налаштувати взаємодію з користувачем програми та надати доступ до рішень і профілів розгортання.