Споделяне чрез

Ръчно конфигуриране на ALM Accelerator

  • Статия

Можете да конфигурирате компонентите на или с помощта на придружаващото ALM Accelerator for Power Platform приложение за администриране, или ръчно. Тази статия ви води през конфигурирането на приложението ръчно и е структурирана в седем раздела:

Предварителни изисквания

Преди да инсталирате 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 ускорителят използва Azure DevOps за контрол на източника и разполагане. Ако нямате Azure DevOps организация, регистрирайте се безплатно за до петима потребители на Azure DevOps сайта.

  • За да изпълните стъпките в този раздел, имате нужда от следните потребители и разрешения в Azure, Azure DevOps, и Power Platform:

    • Лицензиран потребител на Azure с разрешения за създаване и преглед Microsoft Entra на групи, създаване на регистрации на приложения и даване на съгласие на администратор за регистрации на приложения в Microsoft Entra ИД
    • Лицензиран Azure DevOps потребител с разрешения за създаване и управление на тръбопроводи, сервизни връзки, репо сделки и разширения
    • Лицензиран Power Platform потребител с разрешения да създава потребители на приложения и да им дава административни разрешения

  • Следните съединители трябва да са на разположение, за да се използват заедно в средата, в която се внася ALM ускорителят:

  • Инсталирайте Creator Kit в средата, в която инсталирате ALM Accelerator.

Основна настройка

Следващите стъпки са общи за функционалността на ALM Accelerator и не са специфични за нито един проект или решение.

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

Създайте регистрация на приложение за ALM Accelerator, за да предоставите на приложението и свързаните с него тръбопроводи разрешения, необходими за извършване на операции в 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, след което изберетеДелегирани разрешения и Анализ.Всички (не се изисква съгласие от администратор).

    Това разрешение е необходимо за извършване на статичен анализ чрез програмата за проверка наприложението.

  7. Изберете Добавяне на разрешения, за да добавите съветника PowerApps API Analysis.All разрешение за регистрация на приложението.

  8. Изберете + Добавяне на разрешение отново.

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

    Това разрешение е необходимо за свързване към Azure DevOps чрез персонализирания конектор в приложението ALM Accelerator.

  10. Ако сте добавили Azure DevOps разрешението от раздела API, които моята организация използва , копирайте ИД на приложението (клиента) за използване по-нататък в тази процедура.

    Ще го използвате като ИД наDevOps приложение (клиент), което е различно от ИД на приложението (клиент), което ще копирате по-късно в тази процедура.

    Екранна снимка на прозореца Искане на разрешения за API, като са маркирани APIs, които моята организация използва, и ИД на приложение (клиент).

    Ако не можете да намерите Azure DevOps разрешението в раздела API, които моята организация използва , изпълнете следните стъпки, за да получите ИД наприложението DevOps (клиент):

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

    Екранна снимка на страница за Azure DevOps влизане в организация, като параметърът client_id в URL адреса е осветен.

  11. Изберете Добавяне на разрешения, за да добавите разрешение за Azure DevOps API user_impersonation към регистрацията на приложението.

  12. Изберете Даване на съгласие на администратор за <вашия клиент>.

Конфигуриране на клиентската тайна и пренасочване на URI

  1. В левия страничен панел изберете Сертификати & тайни.

  2. Изберете + Нова тайна на клиента.

  3. Изберете дата на изтичане и след това изберете Добави.

  4. Копирайте клиентската тайна стойност за използване по-късно. Това е единственият път, когато можете да копирате стойността. Уверете се, че сте го направили, преди да напуснете страницата.

  5. В левия страничен панел изберете Общ преглед.

  6. Копирайте ИД на приложението (клиента) и ИД науказателя (клиента).

  7. Изберете Конфигуриране.

Даване на разрешение за управление на приложения на Power за регистрацията на приложението ви

Дайте на Power App Management разрешения за регистрация на приложението си, така че тръбопроводите да могат да извършват действията, от които се нуждаят във вашата среда. За да направите това, изпълнете следната кратка команда на PowerShell като интерактивен потребител, който има Power Apps административни привилегии. Трябва да изпълните тази команда само веднъж, след като създадете регистрацията си за приложението.

Важно

Следната кратка команда PowerShell дава на регистрацията на приложението повишени разрешения като Power Platform Admin. Правилата за защита на вашата организация може да не позволяват тези типове разрешения. Уверете се, че са разрешени, преди да продължите. Ако те не са разрешени, определени възможности не работят в тръбопроводите на ALM Accelerator.

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 Accelerator използва няколко Azure DevOps разширения, включително някои разширения на трети страни, които са налични на Azure DevOps пазара. Уебсайтът на всяко разширение на трета страна и връзка към техния изходен код са предоставени в следните инструкции. Научете как да оценявате издател на разширения за пазара.

  1. влезте в Azure DevOps.

  2. Изберете Настройки на организацията.

  3. Изберете Общи>разширения.

  4. Търсене и инсталиране на следните разширения:

Клонирайте YAML тръбопроводите от GitHub към вашия екземпляр на Azure DevOps

  1. Отидете и https://aka.ms/coe-alm-accelerator-templates-latest-release копирайте URL адреса на най-новото издание.

  2. влезте в Azure DevOps.

  3. Създаване на проект или избор на съществуващ проект.

  4. Изберете Repos и след това изберете Импортиране на хранилище в списъка с хранилища.

  5. Поставете URL адреса, който копирахте в стъпка 1, като URL адрес наклонинг и след това изберете Импортиране.

  6. Потвърдете, че клонът по подразбиране за репото е основен. Изберете Репо сделки и клонове и се уверете, че основният клон е маркиран по подразбиране.

    Ако не е, изберете трите вертикални точки (⋮), съответстващи на главния клон, и от менюто Още опции изберете Задай като клон по подразбиране.

    Бележка

    Това репо е мястото, където се изпълняват шаблоните за тръбопроводи за решения и тръбопроводите за износ / внос. По-късно, когато създавате тръбопроводите за вашите решения, може да се наложи да се обърнете към този конкретен проект и репо, ако решите да използвате различно репо за контрол на източника за вашите решения.

Създавайте конвейери за импортиране, изтриване и експортиране на решения

Създаване на канали за импортиране, изтриване и експортиране въз основа на YAML в репото Azure DevOps . Тези тръбопроводи се изпълняват, когато използвате приложението, за да къмчите решение в Git, да импортирате решение или да изтриете решение.

Бележка

Ако очаквате всичките ви експорти да извършват едни и същи действия, независимо от решението, за което се изпълнява газопроводът, можете да създадете един експортен тръбопровод, както е описано в този раздел. Въпреки това може да се нуждаете от различни действия за експортиране въз основа на решението. В този случай можете да добавите името на решението към тръбопровода export-solution-to-git, като export-solution-to-git-SampleSolution, за да може приложението да изпълни вашите конкретни тръбопроводи за решения, когато извършвате действията в приложението.

Следващата таблица показва съответствието между YAML файла в репо сделката и придружаващия го тръбопровод.

YAML файл Име на конвейера
export-solution-to-git.yml export-solution-to-git
import-unmanaged-to-dev-environment.yml import-unmanaged-to-dev-environment
delete-unmanaged-solution-and-components.yml delete-unmanaged-solution-and-components

  1. В Azure DevOps отидете на Конвейери>Създаване на нов конвейер.

  2. Изберете Azure Repos Git за вашето хранилище за код и след това посочете Azure DevOps репото, което сте създали и сийдирани с шаблоните за тръбопроводи в по-ранните стъпки.

  3. На страницата Конфигуриране на вашия конвейер изберете Съществуващ YAML файл на Azure Pipelines и посочете /Pipelines/export-solution-to-git.yml, /Pipelines/import-unmanaged-to-dev-environment.yml или /Pipelines/delete-unmanaged-solution-and-components.yml.

  4. Изберете Продължи, след което изберетеЗапиши .

  5. Изберете менюто Още (...) до Изпълнение на тръбопровод и след това изберетеПреименуване/преместване .

  6. Променете името на канала на export-solution-to-git, import-unmanaged-to-dev-environment или delete-unmanaged-solution-and-components, според случая.

  7. Изберете Запиши.

Създаване на променливи на конвейер за експортиране (по избор)

Можете да зададете променливи на тръбопровода в тръбопровода export-solution-to-git, за да контролирате каква информация се запазва за управление на източника. За да приложите тези настройки глобално, задайте променливите на вашия тръбопровод export-solution-to-git. За да приложите настройките към конкретни решения при експортиране, създайте експортен канал за вашето решение, както е описано в бележката в предишния раздел, и задайте променливите на този тръбопровод.

За да сте сигурни, че текущите стойности на променливите на средата никога не са обвързани с контрола на източника по време на процеса на експортиране, създайте променливата DoNotExportCurrentEnvironmentVariableValues на вашия тръбопровод export-solution-to-git и задайте стойността й на True.

Важно

Тази променлива на тръбопровода се препоръчва, за да можете да използвате функционалността за конфигуриране на разполагането в ускорителя ALM.

За да сте сигурни, че стойностите на конкретни променливи на средата по подразбиране са зададени по време на експортирането на решение, създайте променливата VerifyDefaultEnvironmentVariableValues във вашия тръбопровод export-solution-to-git и задайте стойността й на True. Задайте стойностите на променливите на средата по подразбиране в customDeploymentSettings.json, както е описано в ръководството за конфигуриране на разполагането.

  1. В Azure DevOps изберете Библиотека с>канали Създаване>на нова група променливи.

  2. Назовете новата променлива група alm-accelerator-variable-group, точно както е дадено тук.

    Тръбопроводите се отнасят до тази специфична променлива група, така че тя трябва да бъде наречена точно както е показано. Ако решите да използвате различна конвенция за именуване за вашата група променливи, трябва да промените части от тръбопроводите, за да препращате към името, което използвате вместо това.

  3. Добавете следните променливи към групата променливи:

    Име Описание Стойност
    AADHost Крайна Microsoft Entra точка на разрешението За публични облаци използвайте login.microsoftonline.com. За правителствени облаци използвайте съответния URL адрес за упълномощаване.
    ProcessCanvasApps Дали приложенията за платно се разопаковат по време на експортиране или се опаковат по време на компилации Ако е False, тогава приложенията за платно не се разопаковат по време на експортиране или опаковани по време на компилации. Функционалността за разопаковане и опаковане на приложението за платно е в преглед и не се препоръчва за използване в производствени среди в момента. Не можете обаче да видите изходния код на платното в контролата източник, освен ако не зададете тази променлива на True.

  4. (По избор) Ако използвате автоматизация за тестване на платно студио във вашите тръбопроводи, добавете следните променливи към групата променливи:

    Име Стойност
    TestAutomationLoginMethod CloudIdentity
    TestAutomationMakerPortalUrl URL адресът от портала на Power Apps производителя, обикновено *https://make.powerapps.com*
    TestAutomationUsername Потребителският акаунт, използван за изпълнение на автоматизираните тестове
    TestAutomationPassword Паролата за потребителския акаунт, използвана за изпълнение на автоматизираните тестове

  5. (По избор) По подразбиране глобалните променливи са ограничени и трябва да конфигурирате достъпа за всеки тръбопровод. Можете да опростите това и да разрешите достъп за всеки тръбопровод. Под групата Променлива ( Библиотека за тръбопроводи>alm-accelerator-variable-group>) изберетеРазрешения за тръбопроводи в горното меню, изберете ( ...) и след това изберетеОтворен достъп .

Задаване на разрешения за услугата за изграждане на проект

Важно

Azure DevOps съдържа редица акаунти за "Изграждане на услуга" и може да е объркващо, докато следвате стъпките в този раздел. Обърнете специално внимание на имената и формата, посочени в стъпки 3 и 5. Може да се наложи да потърсите конкретния акаунт, ако не се показва в първоначалния списък.

  1. В Azure DevOps изберете Настройки на проекта.

  2. Изберете Хранилища>Сигурност.

  3. Под Потребители потърсете и изберете Услуга за изграждане на колекция от проекти (Име на вашата организация).

    Бележка

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

  4. Задайте следните разрешения за потребителя на услугата за изграждане:

    Разрешение Стойност
    Дайте своя принос Разрешаване
    Допринесете за заявки за изтегляне Разрешаване
    Създаване на клон Разрешаване
    Редактиране на правила Разрешаване

  5. Под Потребители потърсете и изберете Услуга за изграждане на име на проект (Име на вашата организация).

  6. Задайте същите стойности, както в стъпка 4.

  7. Изберете Тръбопроводи, изберете трите точки (...) в горния десен ъгъл и след това изберете Управление на защитата.

  8. Задайте следните разрешения за потребителя на услугата за изграждане на име на проект ( името навашата организация):

    Разрешение Стойност
    Редактиране на конвейер за изграждане Разрешаване
    Редактиране на качеството на изработката Разрешаване
    Управление на опашката за изграждане Разрешаване
    Замяна на валидирането на регистрацията чрез компилация Разрешаване
    Актуализиране на информацията за изграждане Разрешаване
    View изгражда тръбопровод Разрешаване
    Преглед на компилации Разрешаване

  9. Изберете Настройки>на проекта Набори от агенти, изберете Защита и след това изберете Добави.

  10. Потърсете и изберете Име на вашия проект Услуга за изграждане (Име на вашата организация).

  11. Задайте ролята на читателя.

  12. Избери Добавяне.

  13. (По избор) По подразбиране разрешенията за тръбопровод за всяко хранилище са ограничени и трябва да ги конфигурирате поотделно. Можете да опростите това и да разрешите достъп за всеки тръбопровод. Под Хранилища> на настройки на проекта изберете всяко хранилище последователно. Изберете Защита в горното меню. Намерете блока с разрешения за тръбопровод, изберете ( ...) и след това изберетеОтворен достъп .

Настройка на проект за разработка

Следващият раздел ви води през стъпките, необходими за настройване на всеки от проектите за развитие, които подкрепяте. В този контекст проектът за разработка включва инфраструктурата и конфигурацията, която поддържа здравословно управление на жизнения цикъл на приложенията (ALM), включително конфигурацията на средата Dataverse , която поддържа самия процес на ALM.

Създаване на сервизни връзки за Azure DevOps достъп Power Platform

Всяка Dataverse среда – разработване, валидиране, тестване и производство – трябва да има връзка с Power Platform Azure DevOps услугата. Изпълнете следните стъпки за всяка от вашите среди.

Бележка

Потребителите на приложението ALM Accelerator виждат само среди, в които имат роля на потребител или администратор във връзката с Azure DevOps услугата. Ако работят в среда за личностно развитие, създателите трябва да имат потребителска или администраторска роля във връзката с услугата за тяхната среда за личностно развитие. Връзките за услуги за проверка, тестване и производствена среда, като услугата за изграждане, се нуждаят само от разрешения, предоставени на тръбопроводи.

  1. влезте в Azure DevOps и след това изберете вашия проект.

  2. Изберете Настройки на проекта Връзки с услуги и след това изберете Създаване на връзка с> услуга.

  3. Потърсете и изберете типа на връзката с Power Platform услугата.

  4. Изберете Напред.

  5. За URL адрес на сървъра въведете URL адреса на вашата среда; например, https://myorg.crm.dynamics.com/.

    Важно

    Трябва да включите наклонената наклонена черта (/) в URL адреса; т.е. след .com в този пример.

  6. За Име на връзка с услуга въведете същия URL адрес, който сте въвели в стъпка 4, включително наклонената черта за обучение напред (/).

  7. Въведете ИД на клиент, ИД наприложение (клиент) и клиентска тайна , от които сте копирали Microsoft Entra , когато сте създали регистрацията на приложението.

  8. Изберете Даване на разрешения за достъп до всички тръбопроводи.

  9. Изберете Запиши.

Връзките на услугата трябва да предоставят потребителски разрешения на всички потребители във всички среди, до които потребителите трябва да имат достъп от приложението (например среди на производителя).

  1. В списъка Връзки с услуги изберете връзката с услугата, която да бъде споделена с потребителите.

  2. Изберете Още(... ) в горния десен ъгъл и след това изберете Защита.

  3. В списъка Група или Потребител изберете потребителя или групата, на които искате да предоставите потребителски разрешения.

  4. Изберете потребителя, изберете роля и след това изберете Добавяне.

Повторете стъпките в този раздел за всяка от вашите среди за разработка, проверка, тестване и производство.

Задаване на разрешения за услугата за изграждане на проект за използване на връзките на услугата

  1. В Azure DevOps изберете Настройки на проекта Връзки с> услуги.

  2. Изберете (...) в горния десен ъгъл, изберете Защита и след това изберете Добави.

  3. Потърсете и изберете Име на вашия проект Услуга за изграждане (Име на вашата организация).

  4. Задайте ролята на администратор и след това изберете Добави .

Създаване на потребител на приложението в средите ви на Dataverse

Създайте потребител на приложение във вашата среда, за да позволите на тръбопроводите да се свържат Dataverse. Направете това във всяка среда, в която планирате да използвате ALM Accelerator.

  1. Влезте в центъра Power Platform за администриране.

  2. Изберете вашата среда за разработка и след това изберете Настройки.

  3. Изберете Потребители + разрешения>Потребители на приложения.

  4. Изберете + Нов потребител на приложението.

  5. Изберете + Добавяне на приложение, изберете регистрацията на приложението, която създадохте по-рано, и след това изберете Добави.

  6. Изберете филиала.

  7. Изберете иконата на молив вдясно от Права за достъп и след това изберете права за достъп за потребителя на приложението.

    Препоръчваме ви да дадете на системния администратор на приложението права за достъп привилегии, така че потребителят да може да изпълнява необходимите функции във всяка среда.

  8. Изберете Създаване.

Повторете тези стъпки във вашата среда за проверка, тестване и производство.

Настройка на решението

Когато създавате решение в Dataverse, трябва да създадете тръбопроводи специално за това решение. Следните примерни тръбопроводи са включени в директорията Pipelines в хранилището на coe-alm-templates :

Примерните тръбопроводи предоставят гъвкавост на организациите да съхраняват своите шаблони за тръбопроводи в отделен проект или хранилище от конкретния конвейер за решения YAML. Следвайте стъпките в този раздел, за да конфигурирате вашия канал за решения. Повторете тези стъпки за всяко решение, за което използвате ALM ускорителя за управление на източника.

Важно

YAML за вашия тръбопровод за решения винаги се съхранява в същото репо, което използвате за контрол на източника за вашето решение. Въпреки това, шаблоните за тръбопроводи – т.е. папката Pipeline\Templates – могат да съществуват или в същото репо като вашия тръбопровод за решения YAML, или в отделно репо или проект.

Създайте конвейери за изграждане и внедряване на решение

Тръбопроводите за решения се използват за изграждане и внедряване на вашите решения с контролиран източник в среди във вашия клиент. Примерните тръбопроводи предполагат, че използвате само три среди: валидиране, тестване и производство. Можете обаче да създадете толкова тръбопроводи за решения, колкото е необходимо, въз основа на стратегията за околната среда на вашата организация.

Примерните тръбопроводи за разполагане се задействат от промени в клон (т.е. тестване и производство) или като част от политиката на клона в Azure DevOps (т.е. валидиране). Научете повече за задаването на правила за клонове за проверка на заявки за изтегляне. Можете също така да стартирате тръбопроводи ръчно, без спусък.

Следвайте стъпките в този раздел, за да създадете канали за разполагане от примерния тръбопровод YAML. Следващата таблица описва конфигурацията на тръбопровода.

Важно

Името на тръбопровода трябва да бъде точно както е показано в следващата таблица, с името на вашето решение на мястото на MyNewSolution.

YAML име на файла на конвейер Име на конвейера Правилата за клонове са активирани Необходимо
build-deploy-validation-MyNewSolution.yml разполагане-валидиране-MyNewSolution Да Да
build-deploy-test-MyNewSolution.yml deploy-test-MyNewSolution No Да
build-deploy-prod-MyNewSolution.yml deploy-prod-MyNewSolution No Не (преминете към следващия раздел)

Бележка

Следващите стъпки създават изграждане и разполагане на тръбопроводи за валидиране, тестване и производствени среди. Въпреки това, може да искате да изградите и разположите валидиране и тестване и след това да разположите артефактите от тестовата компилация до производството. Ако случаят е такъв, следвайте стъпките в този раздел само за вашите среди за валидиране и тестване. След това преминете към Създаване на решение конвейер за внедряване за конфигуриране на вашия тръбопровод за освобождаване.

Създаване на файл за тръбопровод

  1. В Azure DevOps отидете в хранилището, което съдържа папката конвейери, която сте ангажирали, и изберете папка Конвейери.

  2. Отворете един от трите примерни тръбопровода за разполагане и копирайте YAML, за да го използвате в новия си тръбопровод.

  3. Забележете името на репото за използване във вашия конвейер.

  4. Отидете до репото, което искате да използвате за контрол на източника за вашето решение.

  5. Създайте клон на базата на вашия клон по подразбиране и го наименувайте за вашето решение; например, MyNewSolution.

    Този клон става следващата версия (v-next) клон за вашето решение. Цялата работа по разработката трябва да бъде разклонена от този клон към личния работен клон на разработчика и след това да се слее в клона v-next, за да се премине към валидиране и тестване. По-късно, когато изданието е готово, клонът v-next може да бъде обединен в основния клон или клон по подразбиране.

  6. Изберете Създаване от горното меню и след това изберете Папка.

  7. Дайте на новата папка същото име като вашето решение.

  8. Дайте име на новия YAML файл на тръбопровода, например build-deploy-validation-SampleSolution.yml,build-deploy-test-SampleSolution.yml или build-deploy-prod-SampleSolution.yml.

  9. Изберете Създаване.

Актуализиране и записване на файла

  1. Поставете YAML, който копирахте в стъпка 2 в предишния раздел, в новия файл на тръбопровода.

  2. Променете следните стойности в новия канал YAML:

    • Промяна на хранилищата>на ресурси>Име на името на репото, което съдържа вашите шаблони за тръбопроводи.

      В този пример репото се нарича coe-alm-accelerator-templates и съществува в същия проект като MyNewSolution repo. Ако хранилището на шаблони е в друг Azure DevOps проект, използвайте формата ProjectName/RepoName. Можете също да зададете клон за мястото, където живеят вашите шаблони, като използвате параметъра, ref ако е необходимо.

    • Променете всяка стойност, която препраща към SampleSolutionName , на уникалното име на вашето решение; например MyNewSolution.

  3. Изберете Ангажимент, за да запазите промените.

  4. В Azure DevOps, отидете на Конвейери и след това изберете Създаване на нов конвейер.

  5. Изберете Azure Repos Git за вашето хранилище на кодове.

  6. Изберете DevOps хранилище, което съдържа YAML на конвейера за внедряване.

  7. На страницата Конфигуриране на вашия тръбопровод изберете YAML файла Съществуващи канали на Azure, посочете YAML файла във вашето репо, който създадохте по-рано, и след това изберете Продължи.

  8. Изберете Запиши, изберете (...) до Изпълнение на тръбопровод и след това изберете Преименуване/преместване.

  9. Променете името на канала на deploy-validation-MyNewSolution, deploy-test-MyNewSolution или deploy-prod-MyNewSolution, където MyNewSolution е името на вашето решение.

  10. Изберете Запиши.

  11. Ако вашият нов тръбопровод не е създаден в клона по подразбиране на хранилището: Изберете Редактиране в тръбопровода. Изберете (...) в горния десен ъгъл и след това изберете Превключватели. Изберете раздела YAML и след това изберете Получаване на източници. Променете клона по подразбиране за ръчни и планирани компилации, така че да сочат към вашия клон на решение. Научете повече за това как да конфигурирате превключвателите на тръбопроводи.

  12. Повторете предишните стъпки, за да създадете конвейер за внедряване за всяка от вашите среди, като се позовавате на примерния конвейер за внедряване YAML от репо на coe-alm-accelerator-templates ( deploy-validation-SampleSolution.yml,deploy-test-SampleSolution.yml иdeploy-prod-SampleSolution.yml ).

  13. Изберете Записване и поставяне на опашка и след това Записване.

Създаване на конвейера за внедряване на решения (по избор)

Както бе споменато по-рано, стъпките в предишния раздел създават тръбопроводи, които изграждат и разгръщат за валидиране, тестване и производствени среди. Можете обаче да създадете отделно решение конвейер за внедряване, ако искате да изградите и разположите само за валидиране и тестване и след това да разположите артефактите от тестовата компилация до производството.

Следвайте стъпките в този раздел, за да създадете решение конвейер за внедряване от примерния тръбопровод YAML. Следващата таблица описва конфигурацията на тръбопровода.

Важно

Името на тръбопровода трябва да бъде точно както е показано в следващата таблица, с името на вашето решение на мястото на MyNewSolution.

YAML име на файла на конвейер Име на конвейера Правилата за клонове са активирани
deploy-prod-MyNewSolution.yml deploy-prod-MyNewSolution No

  1. В Azure DevOps отидете в хранилището, което съдържа папката конвейери, която сте ангажирали, и изберете папка Конвейери.

  2. Отворете примерния тръбопровод за разполагане deploy-prod-pipelineartifact-SampleSolution.yml и копирайте YAML, за да го използвате в новия си тръбопровод.

  3. Забележете името на репото за използване във вашия конвейер.

  4. Отидете до репото, което искате да използвате за контрол на източника за вашето решение.

  5. Изберете Създаване от горното меню и след това изберете Файл.

  6. Дайте име на новия YAML файл на тръбопровода; например,deploy-prod-MyNewSolution.yml , където MyNewSolution е името на вашето решение.

  7. Изберете Създаване.

  8. Поставете YAML, който сте копирали в стъпка 2, в новия файл на тръбопровода.

  9. Променете следните стойности в новия канал YAML:

    • Промяна на клоновете>за задействане>Включете клоновете, в които промените трябва да задействат внедряване в производството.

    • Промяна на хранилищата>на ресурси>Име на името на репото, което съдържа вашите шаблони за тръбопроводи.

      В този пример репото се нарича coe-alm-accelerator-templates и съществува в същия проект като MyNewSolution repo. Ако хранилището на шаблони е в друг Azure DevOps проект, използвайте формата ProjectName/RepoName. Можете също да зададете клон за мястото, където живеят вашите шаблони, като използвате параметъра, ref ако е необходимо.

    • Актуализирайте източника>на тръбопроводи>за ресурси , за да зададете тръбопровода за изграждане, който съдържа артефактите, които този тръбопровод трябва да разположи. В този случай ще разположите артефактите от тестовия тръбопровод, който създадохте по-рано, който изгради и внедри вашето решение в тестовата среда.

    • Променете всяка стойност, която препраща към SampleSolutionName , на уникалното име на вашето решение; например MyNewSolution.

  10. Повторете стъпки от 11 до 20 в предишния раздел за deploy-validation-ALMAcceleratorSampleSolution и deploy-test-ALMAcceleratorSampleSolution, за създаване на конвейер от новия производствен конвейер YAML с име deploy-prod-ALMAcceleratorSampleSolution.

Задайте конвейер за внедряване променливи

За всеки конвейер за внедряване, който сте конфигурирали по-рано, трябва да зададете стойностите на променливите EnvironmentName и ServiceConnection въз основа на средата, в която се разгръща конвейерът. Можете също така да настроите променливата EnableFlows да изключи Power Automate потоци като част от внедряване.

Създаване на променливи за свързване на среда и услуга (задължително)

Всеки конвейер за внедряване изисква променливата на средата EnvironmentName и променливата за свързване на услугата ServiceConnection.

  • EnvironmentName указва Azure DevOps средата която се внедрява, за да позволи проследяване на хронологията на внедряване и да зададе разрешения и одобрения за внедряване в конкретни среди. Задайте тази стойност на Validate, Testили Production, според случая.

  • ServiceConnection указва как конвейер за внедряване се свързва с Power Platform. Позволените стойности са имената на връзките на услугата, които сте създали по-рано.

  1. Изберете Редактиране на всеки от каналите за внедряване.

  2. Изберете Променливи в дефиницията конвейер за внедряване, за да отворите редактора на променливи.

  3. За да добавите променлива, изберете (+). Въведете името на променливата и подходящата стойност.

Повторете тези стъпки, за да създадете променливите EnvironmentName и ServiceConnection .

Създайте променливата EnableFlows (по избор)

Можете да зададете стойността на конвейерна променлива с име EnableFlows на False, за да пропуснете стъпките, които автоматично активират Power Automate потоци като част от внедряване. Стойността по подразбиране на променливата EnableFlows е True.

Задайте правила за клонове за валидиране на заявка за изтегляне

Създайте правила за клон за изпълнение на конвейера, който сте създали по-рано, когато се създаде заявка за изтегляне.

  1. В Azure DevOps отидете на Хранилища и след това изберете папка Клонове.

  2. Намерете клона, за който искате да създадете политика за заявка за изтегляне. Изберете (…) отдясно на клона и след това изберете Правила на клон.

  3. На страницата Правила за клонове отидете на Проверка на компилация.

  4. Изберете +, за да добавите нова политика на клона.

  5. В списъка Изграждане на конвейер изберете конвейера, който сте създали по-рано.

  6. Посочете филтър за пътя ако е приложимо, за да се уверите, че само промените в указания път задействат тръбопровода за заявката за изтегляне.

  7. Задайте Активатор на Автоматично.

  8. Задайте Изискване на правилата на Задължително.

  9. Задайте превключвателя Изтичане на компилация на Незабавно.

  10. Задайте показвано име за политиката на вашия клон; например Валидиране на PR изграждане.

  11. Изберете Запиши.

Екранна снимка на избор на настройки за политика за изграждане на валидиране.

Задаване на разрешения за достъп до ресурси за тръбопроводи

Тръбопроводите се нуждаят от достъп до необходимите ресурси, като хранилища, групи променливи и връзки към услуги, за да работят. За да разрешите достъп, имате три възможности.

Дайте достъп по време на първото изпълнение

Можете да разрешите достъп до необходимия ресурс по време на първото изпълнение на конвейера.

  1. Задействайте тръбопровода и отворете тръбопровода в Azure DevOps.
  2. Изберете Преглед в банера „изисква се разрешение“.
  3. Изберете Разрешение за всеки необходим ресурс.

Дайте изрично разрешение

Можете да дадете изрично разрешение за конвейер за достъп до необходимите репо сделки.

  1. В Azure DevOps отворете Настройки на проекта.
  2. Изберете Репозитории и след това изберете хранилище.
  3. Изберете раздела Защита.
  4. Превъртете надолу до Разрешения за конвейер и изберете +.
  5. Изберете тръбопровода, на който искате да дадете достъп до хранилището.

Можете да дадете изрично разрешение за конвейер за достъп до необходимите групи променливи.

  1. В Azure DevOps изберете Тръбопроводи>Библиотека и след това изберете група променливи.
  2. Изберете Разрешения за конвейер.
  3. Изберете + и след това изберете тръбопровода, на който искате да предоставите достъп до групата променливи.

Можете да дадете изрично разрешение на тръбопровод за достъп до необходимите сервизни връзки.

  1. В Azure DevOps отворете Настройки на проекта.
  2. Изберете Връзки с услуги и след това изберете връзка с услуга.
  3. Изберете Още действия (...) и след това изберете Защита.
  4. Превъртете надолу до Разрешения за конвейер и изберете +.
  5. Изберете тръбопровода, който искате да дадете достъп до сервизната връзка.

Предоставяне на достъп до всички тръбопроводи

Можете да разрешите на всички тръбопроводи, както тези, които имате сега, така и тези, които създавате в бъдеще, да имат достъп до необходимите хранилища.

  1. В Azure DevOps отворете Настройки на проекта.
  2. Изберете Репозитории и след това изберете хранилище.
  3. Изберете раздела Защита.
  4. Превъртете надолу до Разрешения за конвейер.
  5. Изберете Още действия (...), изберете Отворен достъп и след това потвърдете, когато бъдете подканени.

Можете да разрешите на всички тръбопроводи достъп до необходимите променливи групи.

  1. В Azure DevOps изберете Тръбопроводи>Библиотека и след това изберете група променливи.
  2. Изберете Разрешения за конвейер.
  3. Изберете Още действия (...), изберете Отворен достъп и след това потвърдете, когато бъдете подканени.

Можете да разрешите на всички тръбопроводи достъп до необходимите сервизни връзки.

  1. В Azure DevOps отворете Настройки на проекта.
  2. Изберете Връзки с услуги и след това изберете връзка с услуга.
  3. Изберете Още действия (...) и след това изберете Защита.
  4. Изберете връзка с услуга, изберете Още действия (...) и след това изберете Защита.
  5. Превъртете надолу до Разрешения за конвейер.
  6. Изберете Още действия (...), изберете Отворен достъп и след това потвърдете, когато бъдете подканени.

Задаване на обхват на упълномощаване за проект

Обхватът на разрешението за работа може да бъде зададен за цялата Azure DevOps организация или за конкретен проект. Забранете обхвата на разрешението за работа до текущия проект за настройка на канали за освобождаване, ако изберете друг Azure DevOps проект за инсталиране на шаблоните.

Задаване на обхват на упълномощаване за работа на ниво организация за всички проекти

  1. В Azure DevOps, изберете Настройки на > организацията Настройки на канали Настройки > наканали.
  2. Забранете обхвата на разрешението за оторизация на задание до текущия проект за настройка на канали за освобождаване.

Създаване на конфигурация за разполагане (по избор)

Трябва да създадете няколко конфигурации в целева среда, след като решението е внедрено. Тези конфигурации са специфични за средата и включват препратки към връзки, променливи на средата и разрешения за групи и Microsoft Entra екипи, в допълнение към споделянето на приложения за Dataverse платно и актуализирането на собствеността на компонентите на решението, като Power Automate например потоци. Заедно с тези конфигурации, целевата среда често се нуждае от примерни или конфигурационни данни, които са свързани с Dataverse таблици в решението, за да осигури пълно ALM изживяване от край до край.

Ако вашето решение изисква тези други конфигурации или данни, следвайте ръководството за конфигуриране на разполагането, за да конфигурирате вашите тръбопроводи въз основа на средата, в която разполагате.

Импортиране на решението и конфигуриране на приложението

Импортирайте приложението за платно ALM Accelerator във вашата Power Platform среда и след това конфигурирайте включения персонализиран конектор за Azure DevOps.

Инсталирайте ALM ускорителя в Dataverse

  1. Решението ALM Accelerator зависи от комплекта Creator. Инсталирайте Creator Kit сега.

  2. Изтеглете най-новия завършено решение файл от GitHub. Превъртете надолу до Активи и изберете CenterofExcellenceALMAccelerator_<най-новата версия>_managed.zip.

  3. влезте в Power Apps и след това изберете средата, в която искате да хоствате приложението ALM Accelerator.

  4. В левия страничен панел изберете Решения.

  5. Изберете Импортиране на решение>Преглед и след това отидете до местоположението на завършено решение, която сте изтеглили, и изберете файла.

  6. Изберете Напред и след това изберете отново Следващ.

  7. На страницата Връзки изберете или създайте връзка, към която да свържете CDS DevOps връзката Dataverse.

    Когато създавате връзка за HTTP Microsoft Entra, използвайте Microsoft Graph и за двата параметъра.

  8. Изберете Импортиране.

Конфигуриране на потребителския конектор DevOps

  1. Изберете Данни>Потребителски конектори>CustomAzureDevOps.

  2. Изберете Редактиране. На страницата Защита изберете Редактиране и след това задайте следните полета:

    Име Стойност
    Тип удостоверяване ОАут 2.0
    Доставчик на самоличност Azure Active Directory
    ИД на клиента ИД на приложението (клиента), който сте копирали, когато сте създали регистрацията на приложението
    Тайна на клиент Тайната стойност на приложението (клиента), която сте копирали, когато сте създали регистрацията на приложението
    ИД на клиент Оставете стойността по подразбиране, обща
    URL адрес на ресурс ИД на приложението DevOps (клиент), който сте копирали, когато сте добавили разрешения към регистрацията на приложението си
    Пренасочване на URL адрес Автогенерира. Ако забележите квадратчето "Актуализиране до уникален URL адрес за пренасочване" под "Пренасочване на URL адрес", моля, поставете отметка в квадратчето.

  3. Изберете Актуализиране на конектор.

Добавете "Пренасочване на URL" като "Пренасочване на URI"

Автоматично генерираният "Redirect URL" от горния раздел трябва да бъде добавен като "Redirect URI" към регистрацията на приложението.

  1. Върнете се към регистрацията на приложението, която сте създали.

  2. В левия страничен панел изберете Общ преглед.

  3. Изберете Добавяне на URI за пренасочване.

  4. Изберете + Добавяне на платформа и след това изберетеУеб .

  5. Под текстовото поле Пренасочване на URI поставете автоматично генерирания "Пренасочване URL адрес", копиран от горния раздел.

  6. Изберете Конфигуриране.

Тестване на конектора по избор

  1. Отваряне на менюто Тест.

  2. Изберете Нова връзка и след това следвайте подканите, за да създадете връзка.

  3. В Power Apps, изберете вашата среда и след това изберете Dataverse>Потребителски съединители>CustomAzureDevOps.

  4. Изберете Редактиране, отидете на страницата Тест и след това намерете операцията GetOrganizations .

  5. Изберете Тестова операция.

  6. Потвърдете отговор че върнатият статус е 200 и че тялото отговор е JSON представителство на вашата Azure DevOps организация.

    Екранна снимка на тестовите настройки за защита за потребителски Azure DevOps конектор.

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

Прочетете повече