Оқулық: Microsoft Power Platform арналған GitHub Actions-ті пайдаланып шешімді орналастыруды автоматтандыру

Мақала
03/27/2023

Бұл оқулықта келесі мәліметтер беріледі:

Жаңа GitHub репозиторийін жасау
Microsoft Power Platform бағдарламасына арналған GitHub әрекеттерін пайдаланып екі GitHub жұмыс ағынын жасау

Жұмыс ағындары бағдарламаңызды (басқарылмайтын шешім ретінде) әзірлеуші ортадан автоматты түрде экспорттап, құрастыру артефактісін жасайды (басқарылатын шешім) және бағдарламаны жұмыс ортасына орналастыра алады. Бұл оқулықта сіз жасаған ALMLab шешімі мен алдыңғы оқулықтарда орнатқан орталар пайдаланылады.

Қатысты оқулықтар: Жұмысты бастау және Модельге негізделген бағдарламаны құру.

GitHub тіркелгісін жасау

https://github.com веб-сайтына өтіп, Тіркелу немесе Тегін сынақ нұсқасын бастау түймелерін басыңыз (немесе егер тіркелгіңіз болса, кіріңіз).
Тіркелгіні жасағаннан кейін Репозиторий жасау немесе Жаңа опцияларын таңдау арқылы репозиторий жасаңыз.

Сіз келесі балама байланыс экранын көре аласыз:
Жаңа репозиторийіңізді жасаңыз және оны «poweractslab» деп атаңыз. Репозиторийді іске қосу үшін README файлын қосу опциясын таңдап, Репозиторий жасау түймешігін таңдаңыз.

Субьект‑қызмет аутентификациясының жаңа құпиясын жасау

Репозиторийге өтіп, Параметрлер түймесін басыңыз, одан кейін Құпиялар кеңейтіңіз, содан кейін Әрекеттер.
Құпиялар бетінде құпияны 'PowerPlatformSPN' деп атаңыз. Microsoft Entra ішінде жасалған қолданбаны тіркеуден клиент құпиясын пайдаланыңыз және оны Мән өрісіне енгізіңіз, содан кейін Қосу пәрменін таңдаңыз. құпия. Клиенттің құпиясына GitHub жұмыс ағынын осы зертханада кейінірек анықтау үшін пайдаланылатын YML файлдарында сілтеме жасалады.

Клиенттің құпиясы енді GitHub құпиясы ретінде қауіпсіз түрде сақталады.

Шешім файлын жаңа тармаққа экспорттау және орау үшін жұмыс ағынын жасаңыз

Әрекеттер және жұмыс ағынын жеке орнату түймелерін басыңыз немесе осы репозиторий үшін ұсынылған бөліміндегі Қарапайым жұмыс ағыны өрісіндегі "Конфигурациялау" түймесін басыңыз.
Бұл GitHub әрекеттерімен жұмысты бастауға көмектесетін негізгі жұмыс ағыны бар жаңа YAML файлын іске қосады.
Алдын ала жасалған мазмұнды жойыңыз, мазмұнды export-and-branch-solution-with-spn-auth.yml файлынан қойыңыз, содан кейін файлдың атын ' деп өзгертіңіз. экспорт және салалық шешім'.yml.
<ENVIRONMENTURL> параметрін экспорттайтын әзірлеу ортасына арналған (мысалы: https://poweractionsdev.crm.dynamics.com) URL мекенжайымен жаңартыңыз.
Мәндеріңізбен <APPID> және <TENANT ID> опцияларын жаңартыңыз.
- Тіркелгі деректерін пайдаланып жатсаңыз, export-and-branch-solution-with-spn-auth.yml файлының орнына export-and-branch-solution.yml файлын қойыңыз. <USERNAME> параметрін ортаға қосылу үшін пайдаланылатын пайдаланушы атымен жаңартыңыз.
Шайпұл

GitHub әрекеттерімен таныс болмасаңыз және көбірек білгіңіз келсе, https://docs.github.com/en/actions сайтындағы ресми құжаттаманы қараңыз.
Сіз енді өз өзгертулеріңізді жасауға дайынсыз. Шешімді бастау опциясын таңдап, тақырып өрісінде Экспорттық yml жасау опциясын енгізіп, содан кейін сипаттаманы қосыңыз (міндетті емес). Содан кейін, Жаңа файл жасау түймешігін басыңыз.

Құттықтаймыз, сіз келесі әрекеттерді пайдаланып алғашқы GitHub жұмыс ағыныңызды жасадыңыз:

Мен кіммін: экспортталатын ортаға сәтті қосыла алатыныңызды қамтамасыз етеді.
Шешімді экспорттау: Шешім файлын әзірлеу ортасынан экспорттайды.
Шешімнен шығару: Серверден экспортталатын шешім файлы біріктірілген конфигурация файлдары бар қысылған (zip) файл болып табылады. Бұл бастапқы файлдар бастапқы кодты басқаруға жарамайды, өйткені олар бастапқы кодты басқару жүйелерінде файлдарда әр түрлі дифференция жасауды және бастапқы бақылауға қажет өзгертулерді түсіруді ыңғайлы ету үшін құрылымдалмаған. Шешім файлдарын бастапқы басқаруды сақтау және өңдеу үшін қолайлы ету үшін оларды «орамасынан шығару» керек.
Тармақ шешімі: Экспортталған шешімді сақтау үшін жаңа тармақ жасайды.

Экспорттауды тексеріп, жұмыс ағынын бумадан шығару

Содан кейін, жұмыс ағынының іске қосылатынын тексеріңіз. Әрекеттер, Жұмыс ағынын іске қосу параметрлеріне өтіп, Жұмыс ағынын іске қосу опциясын таңдаңыз. Егер сізде ALMLab атауынан басқа шешім атауы болса, онда мәнді осы жерде өзгертіңіз, бірақ басқа мәндерді сол күйінде қалдырыңыз.
5-10 секундтан кейін жұмыс ағыны басталады және жұмыс барысын бақылау үшін іске қосылатын жұмыс ағынын таңдауға болады.
Жұмыс ағыны аяқталғаннан кейін шешімдер/ALMLab қалтасына бумадан шығарылған шешіммен жаңа тармақ жасалғанын тексеріңіз. Код қойындысына өтіңіз және тармақтарын кеңейтіңіз ашылмалы.
Әрекет арқылы жасалған тармақты таңдаңыз.
Шешімдер/ALMLab қалтасы жаңа тармақта жасалғанын растаңыз, содан кейін өзгерістерді негізгі тармаққа біріктіру үшін қосу сұрауын жасаңыз. Үлес қосу және жылжымалы терезеде басыңыз Тарту сұрауын ашу.
Өзгертулерді енгізу сұрауын ашу пішінінде тақырып пен сипаттама қосып (қажетінше), содан кейін Өзгертулерді енгізу сұрауын жасау түймесін таңдаңыз.
Экран жаңадан жасалған өзгертулер енгізу сұрауын көрсетіп жаңартылады. Өзгертулерді енгізу сұрауы жасалған кезде, біздің филиалдың негізгі филиалмен қайшылықтары жоқ екенін көрсететін растау беріледі. Бұл растау өзгерістерді автоматты түрде негізгі тармаққа біріктіруге болатындығын білдіреді. Біріктіру сұрауын , содан кейін Біріктіруді растау түймесін басыңыз. Қажет болса, қазір істен шыққан филиалды тазалау үшін тармақты жою түймесін басыңыз.
Негізгі әрі әдепкі тармаққа қайта оралып, растаңыз, сондай-ақ шешім қазір сол жерде қолжетімді.

Құрастыру артефактісін жасау және өндіріске импорттау үшін қайта пайдаланылатын жұмыс ағынын жасау

Бұл бөлімде біз мынадай қосымша жұмыс ағынын жасаймыз:

Басқарылатын шешім жасайтын және оны GitHub артефактісі ретінде жариялайтын
Құрастыру артефактісін жұмыс ортасына импорттайтын

Әрекеттер бөліміне өтіп, Жаңа жұмыс ағыны опциясын таңдаңыз.
Жұмыс ағынын өз бетіңізше орнату түймешігін таңдаңыз.
Жұмыс процесінің атауын "шығарылым-шешім-енгізулері-бар-өнім" деп өзгертіңіз және мазмұнды шығарылым-шешім-өнімге-кірістері-мен-өнімге көшіріңіз.yml файл және оны Жаңа файлды өңдеу экранына қойыңыз.
Өзгерістерді бекітіңіз. Шешімді бастау түймешігін таңдап, содан кейін тақырып пен сипаттама қосыңыз (міндетті емес). Содан кейін, Жаңа файл жасау түймешігін таңдаңыз.

Шығарылым оқиғасында қайта пайдалануға болатын жұмыс ағынын шақыру

Бұл бөлімде біз шығарылым оқиғасында қайта пайдалануға болатын жұмыс ағынын шақырамыз.

Әрекеттер бөліміне өтіп, Жаңа жұмыс ағыны опциясын таңдаңыз.
Жұмыс ағынын өз бетіңізше орнату түймешігін таңдаңыз.
Жұмыс процесінің атауын "release-action-call" деп өзгертіңіз және мазмұнды release-action-call.yml файлынан көшіріп, оны ішіне қойыңыз. Жаңа файлды өңдеу экран.
Жаңа жұмыс ағыны файлында келесі айнымалыларды жаңартыңыз:
- Басқарылатын шешімді жасау үшін пайдаланылатын құрастыру ортасына арналған URL мекенжайымен <BUILD_ENVIRONMENT> параметрін жаңартыңыз. Мысалы: https://poweractionsbuild.crm.dynamics.com.
- Орналастыратын жұмыс ортасына арналған URL мекенжайымен <PROD_ENVIRONMENT> параметрін жаңартыңыз. Мысалы: https://poweractionsprod.crm.dynamics.com.
- <APP_ID> элементін бағдарлама (клиент) идентификаторымен жаңартыңыз, оны Microsoft Azure порталының бағдарламаларды тіркеу жолағында осы оқулықта бұрын жасалған тіркеуді басу арқылы табуға болады.
- <TENANT_ID> элементін каталог (клиент) идентификаторымен жаңартыңыз, оны Microsoft Azure порталының бағдарламаларды тіркеу жолағында осы оқулықта бұрын жасалған тіркеуді басу арқылы табуға болады.
Өзгерістерді бекітіңіз. Шешімді бастау түймешігін таңдап, содан кейін тақырып (міндетті емес) пен сипаттама қосыңыз (міндетті емес). Содан кейін, Жаңа файл жасау түймешігін таңдаңыз.

Өндірістік жұмыс ағынына шығаруды тексеріңіз

Сіз соңғы жұмыс ағынын тексеруге дайынсыз. Бұл жұмыс ағыны өндіріске жаңа шығарылым орналастырылған кезде іске қосылады.

Шығарылымдар бөліміне өтіңіз.
Жаңа шығарылым жобасын жасау опциясын таңдаңыз.
Шығарылым тегін, тақырыбын қосып, Шығарылымды жариялау опциясын таңдаңыз.
Іске қосылған жұмыс ағынын қарау үшін Әрекеттер опциясын таңдаңыз.
Әрекеттердің орындалу барысында оларды қарау үшін орындалатын жұмыс ағынын таңдаңыз.
Әрбір әрекеттің аяқталғанын күтіңіз.
Жұмыс ағыны аяқталғаннан кейін жұмыс ортасына кіріп, шешім басқарылатын шешім ретінде орналастырылғанын тексеріңіз.

Өндіріс шығарылымы алдында жаңартуды орналастыру және өзгерістерді қарап шығу

Енді біз үздіксіз процесті тексеріп, содан кейін оны өндіріске орналастырмас бұрын бағдарламадағы өзгерістерді қарау және тексеру жолдарын көретін боламыз.

Әзірлеу ортасында ALMLab шешіміне өтіп, Өңдеу опциясын таңдаңыз немесе көрсетілген шешім атауын басыңыз.
Демалыс күндеріндегі сұраулар кестесін таңдап, қараңыз.
+ Баған қосу опциясын таңдап, төмендегі суретте көрсетілгендей жаңа баған жасаңыз.

Жаңартылған өріс мәндері:**
- Көрсетілетін атау: Бекітілді
- Деректер түрі: Иә/Жоқ
Дайын түймесін басыңыз.
Кестені сақтау түймесін басыңыз
GitHub репозиторийінің Әрекеттер қойыншасына қайта өтіп, Жұмыс ағынын іске қосу опциясын таңдаңыз да, Жұмыс ағынын іске қосу түймешігін таңдаңыз.
5-10 секундтан кейін жұмыс ағыны басталады және оның жұмыс барысын бақылау үшін іске қосылатын жұмыс ағынын басуға болады.
Жұмыс ағыны аяқталғаннан кейін Код, содан кейін Тармақтар опцияларын таңдау арқылы жаңа тармаққа өтіңіз.
Үлесті кеңейту арқылы жасалған тармақты таңдап, Өзгертулерді енгізу сұрауын ашу опциясын басыңыз.
Тақырып (міндетті емес) қосып, содан кейін Қосу сұрауын жасау опциясын басыңыз.
Мазмұнды жаңартудан кейін Өзгертілген файлдар қойыншасын басыңыз.
Файлдың осы бөлімі негізгі тармақтағы бірдей файлмен салыстырғанда қосылғанын көрсететін шешімнің өзгерістері жасыл түспен ерекшеленгеніне назар аударыңыз.
Сұхбат қойыншасына оралыңыз. Қосу сұраулары опциясын таңдап, содан кейін бұрын жасалған қосу сұрауын таңдаңыз.
Қосу сұрауы бетінде жаңартылған шешім файлын негізгі тармаққа біріктіру үшін Ығыстыру және біріктіру опциясын таңдаңыз, енді негізгіге біріктірілген элементті жоюдың қажеті жоқ.
Жаңа шығарылым жасау үшін Өндірістік жұмыс ағынына шығаруды тексеру бөліміндегі қадамдарды орындап, жаңартылған шешімнің жұмыс ортасына орналастырылғандығын тексеріңіз.