Упутство: Аутоматизовање примене решења помоћу GitHub радњи за Microsoft Power Platform

У овом упутству, сазнаћете како да:

Токови посла могу аутоматски да извезу вашу апликацију (као некомплетно решење) из развојног окружења, генеришу артефакт израде (комплетно решење) и примењују апликацију у ваше производно окружење. Ово упутство користи ALMLab решење које сте изградили и окружења која сте поставили у претходним упутствима.

Повезана упутства: Почетни кораци и Градња апликације засноване на моделу.

Креирање GitHub налога

1. Идите на https://github.com и кликните на Пријави се или Покрените бесплатну пробну верзију (или се пријавите ако имате постојећи налог).

   

2. Када креирате налог, направите спремиште избором опције Направите спремиште или Ново.

   

   Можда ћете видети следећи алтернативни одредишни екран:

   

3. Креирајте ваше ново спремиште и назовите га 'поwерацтионслаб'. Обавезно изаберите Додајте датотеку ПРОЧИТАЈ МЕ да покренете спремиште, па одаберите Направи спремиште.

   

Креирање нове тајне за потврду идентитета принципала услуге

1. Идите у ваше спремиште и кликните на Подешавања , затим проширите Тајне , а затим и кликните на Акције.

2. На страници Тајне назовите тајну 'ПоверПлатформСПН'. Користите тајну клијента из регистрације апликације креиране у Microsoft Entra и унесите је у поље Вредност , а затим изаберите Додај тајну. Тајна клијента ће бити наведена у YML датотекама које се користе за дефинисање GitHub токова посла касније у овој лабораторији.

   

   Тајна клијента је сада безбедно ускладиштена као GitHub тајна.

Направите ток посла за извоз и распакујте датотеку решења у нову грану

1. кликните на дугме Радње и кликните на сами подесите ток посла или кликните на „Конфигуриши“ у оквиру Једноставан ток посла испод одељка Предложено за ово спремиште.

   

2. Ово ће покренути нову YAML датотеку са основним током посла који ће вам помоћи да започнете са GitHub радњама.

   

3. Обришите унапред креирани садржај, налепите садржај из еxпорт-анд-бранцх-солутион-wитх-спн-аутх.yмл датотеке , а затим преименујте датотеку у 'еxпорт-анд-бранцх-солутион'.yмл.

   

4. Ажурирајте <ENVIRONMENTURL> URL адресом за развојно окружење из којег желите да извезете решење (на пример: https://poweractionsdev.crm.dynamics.com).

5. Ажурирајте <APPID> и <TENANT ID> својим вредностима.

   • Ако користите акредитиве, налепите датотеку export-and-branch-solution.yml уместо садржаја датотеке export-and-branch-solution-with-spn-auth.yml. Ажурирајте <USERNAME> корисничким именом које користите за повезивање са окружењем.

     

   Савет

   Уколико нисте упознати са GitHub радњама и желите да сазнате више, погледајте званичну документацију на https://docs.github.com/en/actions.

6. Сада сте спремни да извршите своје промене. Изаберите Започни извршавање, упишите Креирај YML за извоз у поље за наслов, а затим додајте опис (опционално). Затим кликните на Изврши нову датотеку.

   

Честитамо, управо сте креирали свој први GitHub ток посла користећи следеће радње:

• Ко сам ја : Обезбеђује да можете успешно да се повежете са окружењем из којег извозите.
• Извоз решења : Извози датотеку решења из вашег развојног окружења.
• Унпацк Солутион : Датотека решења која се извози са сервера је компримована (зип) датотека са консолидованим конфигурационим датотекама. Ове почетне датотеке нису погодне за управљање изворним кодом, јер нису структуриране тако да системима за управљање изворним кодом буде могуће да изводити исправне разлике у датотекама и хватати промене које желите да предате контроли извора. Потребно је да "распакујете" датотеке решења како бисте их учинили погодним за складиштење и обраду контроле извора.
• Грана Решење : Ствара нову грану за чување извезеног решења.

Тестирање тока посла извоза и распакивања

1. Затим тестирајте да ли је ток посла активан. Идите на Радње, Покретање тока посла и одаберите Покрени ток посла. Ако имате други назив решења од 'ALMLab', онда промените вредност овде, али оставите остале вредности какве јесу.

   

2. Након 5–10 секунди ток посла ће се покренути и можете изабрати активни ток посла да бисте надгледали напредак.

   

   

3. Када се ток посла заврши, потврдите да је креирана нова грана са решењем распакованим у фасциклу solutions/ALMLab. Идите на картицу Код и проширите падајуће листе гране.

4. Изаберите грану која је креирана радњом.

5. Потврдите да је фасцикла solutions/ALMLab креирана у новој грани, а затим креирајте захтев за преглед измена како бисте објединили промене у главну грану. Кликните на дугме Допринеси и у модулу кликните на дугме Отвори захтев за спајање.

6. На екрану Отварање захтева за преглед измена додајте наслов и опис, по жељи, а затим кликните на Креирај захтев за преглед измена.

7. Екран ће се ажурирати приказујући новокреирани захтев за преглед измена. Како се буде креирао захтев за преглед измена, биће пружена потврда која показује да наша грана нема неусаглашености са главном граном. Ова потврда значи да се промене могу аутоматски објединити у главну грану. Кликните на дугме Стопи захтев за повлачење, а затим кликните на дугме Потврди спајање. Опционално, кликните на „Избриши грану“ да бисте очистили сада нефункционалну грану.

   

8. Вратите се у подразумевану (главну) грану и потврдите да је решење сада тамо такође доступно.

Направите ток посла који може поново да се употреби за генерисање артефакта градње и увоз у продукцију

У овом одељку ћемо креирати додатни ток посла који:

• Креира комплетно решење и објављује га као GitHub артефакт
• Увози артефакт израде у производно окружење

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

   

2. Одаберите сами подесите ток посла.

   

3. Преименујте наслов тока посла у "релеасе-солутион-то-прод-wитх-инпутс" и копирајте садржај из релеасе-солутион-то-прод-wитх-инпутс.yмл датотеке и налепите га на екран Едит неw филе .

   

4. Извршите промене. Одаберите Започни извршавање, а затим додајте наслов и опис (опционално). Затим изаберите Изврши нову датотеку.

   

Позивање тока посла који је могуће поново користити на догађају издавања

У овом одељку ћемо позвати ток посла који је могуће поново користити за догађај издавања.

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

   

2. Одаберите сами подесите ток посла.

   

3. Преименујте наслов тока посла у "релеасе-ацтион-цалл" и копирајте садржај из релеасе-ацтион-цалл.yмл датотеке и налепите га на екран Едит неw филе .

   

4. Ажурирајте следеће променљиве у новој датотеци тока посла:

   • Ажурирајте <BUILD_ENVIRONMENT> URL адресом за окружење израде које користите за генерисање комплетног решења. На пример: https://poweractionsbuild.crm.dynamics.com
   • Ажурирајте <PROD_ENVIRONMENT> URL адресом за производно окружење у које примењујете. На пример: https://poweractionsprod.crm.dynamics.com
   • Ажурирајте <APP_ID> помоћу ID-а апликације (клијента) који се може наћи у Листи регистрације апликација Microsoft Azure портала кликом на регистрацију креирану претходно у овом упутству.
   • Ажурирајте <TENANT_ID> помоћу ID-а директоријума (закупца) који се може наћи у Листи регистрације апликација Microsoft Azure портала кликом на регистрацију креирану претходно у овом упутству.

5. Извршите промене. Одаберите Започни увођење, а затим додајте наслов (опционално) и опис (опционално). Затим изаберите Изврши нову датотеку.

   

Тестирајте ток посла за пуштање у производњу

Сада сте спремни за тестирање последњег тока посла. Овај ток посла се покреће када се ново издање постави у производњу.

1. Идите на Издања.

   

2. Изаберите Радна верзија новог издања.

3. Додајте ознаку издања, наслов и одаберите Објави издање.

4. Изаберите Радње да бисте видели текући ток посла.

   

5. Одаберите текући ток посла да бисте видели радње док се изводе.

   

6. Сачекајте да се свака радња заврши.

   

7. Када се ток посла заврши, пријавите се у своје производно окружење и потврдите да је решење постављено као комплетно решење.

Примените исправку и прегледајте промене пре пуштања у рад

Сада ћемо тестирати поступак од почетка до краја, а затим ћемо видети како можемо да прегледамо и потврдимо промене у апликацији пре него што се примени у производњу.

1. Дођите до ALMLab решења у вашем развојном окружењу и одаберите Уређуј или кликните на име за приказ решења.

   

2. Изаберите и прегледајте табелу Захтев за одсуство.

   

3. Кликните на + Додај колону и креирајте нову колону као што је приказано на доњој слици.

   

   Ажуриране вредности поља:**

   • < ДИЦТ__име за приказ >Дисплаy наме : Одобрено
   • Тип података: Да/Не

4. Кликните на Готово .

5. Кликните на дугме Сачувај табелу

6. Вратите се на своја GitHub спремишта на картици Радње, одаберите Покрени ток посла и изаберите дугме Покрени ток посла.

   

7. Након 5–10 секунди, ток посла ће се покренути и можете кликнути на активни ток посла да бисте надгледали његов напредак.

   

   

8. Када се ток посла заврши, дођите до нове гране избором ставке Кôд, а затим Гране.

   

9. Изаберите грану која је креирана развијањем опције Допринос и кликните на Нови захтев за преглед измена.

10. Додајте наслов (опционално), а затим кликните на Направи захтев за преглед измена.

11. Након ажурирања садржаја, кликните на картицу Промењене датотеке.

12. Приметићете да су промене решења означене зеленом бојом да би се означило да је овај одељак датотеке додат у поређењу са истом датотеком у главној грани.

13. Вратите се на картицу Разговор. Изаберите Захтеви за преглед измена, а затим изаберите претходно креирани захтев за преглед измена.

14. На страници Захтев за преглед измена, изаберите Збијање и обједињавање да бисте објединили ажурирану датотеку решења у главну грану. Опционално избришите то што је сад обједињено у главну грану.

    

15. Следите кораке у одељку Тестирање издања у производном току посла да бисте креирали ново издање и потврдили да је ажурирано решење постављено у ваше производно окружење.

Честитамо, успешно сте подесили пробни CI/CD ток посла помоћу GitHub радњи!

Такође погледајте

Аутоматизујте свој радни ток од идеја до производње