Pamācība: Automatizējiet risinājumu izvietošanu, izmantojot GitHub Actions for Microsoft Power Platform

Šajā apmācībā uzzināsit, kā:

  • Jauna GitHub repozitorija izveide
  • Izveidojiet divas GitHub darba plūsmas, izmantojot GitHub Actions for Microsoft Power Platform

Darbplūsmas var automātiski eksportēt jūsu programmu (kā nepārvaldītu risinājumu) no izstrādes vides, ģenerēt būvējuma artefaktu (pārvaldītu risinājumu) un izvietot programmu ražošanas vidē. Šī apmācība izmanto ALMLab risinājumu, kuru izveidojāt, un vides, ko iestatījāt iepriekšējās apmācībās.

Saistītās apmācības: Darba sākšana un Modeļa vadītas programmas izveide.

Izveido GitHub kontu

  1. Dodieties uz https://github.com un izvēlieties Reģistrēties vai Sākt bezmaksas izmēģinājumu (vai piesakieties, ja jums ir esošs konts).

    Konta izveide

  2. Pēc konta izveides izveidojiet repozitoriju, izvēloties Izveidot repozitoriju vai Jaunu.

    Repozitorija izveide

    Var tikt parādīts šāds alternatīvs izvietošanas ekrāns:

    Jauna repozitorija izveide

  3. Izveido jaunu repozitoriju un nosauc to poweractionslab. Pārliecinieties, ka izvēlaties pievienot README failu , lai uzsāktu repozitoriju, un izvēlieties izveidot repozitoriju.

    Sāciet repo.

Jauna noslēpuma izveide pakalpojuma vadītāja autentifikācijai

  1. Dodieties uz savu repozitoriju un izvēlieties Iestatījumi. Paplašini Noslēpumus un tad izvēlies Darbības.

  2. Noslēpumu lapā nosauciet noslēpumuPowerPlatformSPN. Ievadiet klienta noslēpumu no lietojumprogrammas reģistrācijas, ko izveidojāt Microsoft Entra, laukā Value, un pēc tam izvēlieties Add secret. Vēlāk šajā pamācībā jūs atsauksieties uz klienta noslēpumu YML failos, kas definē GitHub darba plūsmas.

    Pakalpojuma vadītāja noslēpuma izveide

    Klienta noslēpums tagad tiek droši glabāts kā GitHub noslēpums.

Izveidojiet darbplūsmu, lai eksportētu un atpakotu risinājuma failu jaunā filiālē

  1. Izvēlies Darbības, un tad izvēlies izveidot darba plūsmu pats. Vai arī izvēlieties ConfigureSimple workflow lodziņā zem ieteiktās sadaļas šai krātuves sadaļai.

    Iestatīšanas darbplūsma.

  2. Jūs redzat jaunu YAML failu ar pamata darba plūsmu, kas palīdz sākt ar GitHub darbībām.

    Parauga YML fails

  3. Izdzēsiet iepriekš izveidoto saturu un pēc tam ielīmējiet saturu no export-and-branch-solution-with-spn-auth.yml faila. Pārdēvē failu par export-and-branch-solution.yml.

    Pārdēvējiet un aizstājiet saturu.

  4. Atjauniniet <ENVIRONMENTURL> ar tās izstrādes vides vietrādi URL, no kuras vēlaties eksportēt (piemēram: https://poweractionsdev.crm.dynamics.com).

  5. Atjaunināt <APPID> un <TENANT ID> ar savām vērtībām.

    • Ja izmanto akreditācijas datus, ielīmē export-and-branch-solution.yml failu, nevis export-and-branch-solution-with-spn-auth.yml faila saturu. Atjauniniet <USERNAME> ar lietotājvārdu, ko izmantojat, lai pieslēgtos videi.

      Satura pārdēvēšana un aizstāšana

    Padoms

    Ja neesat pazīstams ar GitHub Actions un vēlaties uzzināt vairāk, apskatiet oficiālo dokumentāciju vietnē https://docs.github.com/en/actions.

  6. Tagad tu esi gatavs veikt savas izmaiņas. Atlasiet Sākt izpildi, nosaukuma laukā ierakstiet Izveidot eksportēšanas yml un pēc tam pievienojiet aprakstu (neobligāti). Pēc tam atlasiet Izpildīt jaunu failu.

    Sāciet apņemties.

Apsveicam, jūs izveidojāt savu pirmo GitHub darba plūsmu, izmantojot šādas darbības:

  • Kas es esmu: Nodrošina, ka jūs varat veiksmīgi savienoties ar vidi, no kuras vēlaties eksportēt.
  • Eksportēt risinājumu: eksportē risinājuma failu no izstrādes vides.
  • Atpakošanas risinājums: Risinājuma fails, ko serveris eksportē, ir saspiests (zip) fails ar konsolidētiem konfigurācijas failiem. Šie sākotnējie faili nav piemēroti avota koda pārvaldībai, jo tie nav strukturēti tā, lai avota koda pārvaldības sistēmas varētu pareizi atšķirt failus un fiksēt izmaiņas, kuras vēlaties veikt avota kontrolei. Tev jāatpako risinājuma faili, lai tie būtu piemēroti avota kontrolei, glabāšanai un apstrādei.
  • Filiāles risinājums: izveido jaunu filiāli, lai saglabātu eksportēto risinājumu.

Darbplūsmas eksportēšanas un atpakošanas testēšana

  1. Pēc tam pārbaudiet, vai darbplūsma tiek palaista. Dodieties uz Actions, izvēlieties Run workflow un izvēlieties Run workflow. Ja izmantojat citu risinājuma nosaukumu nekā ALMLab, mainiet vērtību šeit, bet pārējās vērtības atstājiet nemainīgas.

    Palaist darbplūsmu.

  2. Pēc 5–10 sekundēm darba plūsma sākas. Tu vari izvēlēties darba plūsmu, lai sekotu progresam.

    Noklikšķiniet, lai skatītu darbplūsmu.

    Izvēlieties un skatiet darba plūsmu.

  3. Kad darba plūsma ir pabeigta, pārbaudiet, vai ir izveidots jauns zars ar risinājumu, kas ir izpakots mapē solutions/ALMLab . Dodieties uz cilni Kods un paplašiniet zaru nolaižamo izvēlni.

  4. Izvēlieties zaru, ko darbība izveidoja.

  5. Pārbaudi, vai solutions/ALMLab mape ir izveidota jaunajā zarā. Pēc tam izveido pull request, lai apvienotu izmaiņas galvenajā zarā. Izvēlieties Piedalīties un lidojumā izvēlieties Atvērt pull pieprasījumu.

  6. Ekrānā "Atvērt pull pieprasījumu" pievieno nosaukumu un aprakstu, ja vēlies, tad izvēlies Izveidot pull request.

  7. Ekrāns tiek atjaunināts, lai parādītu jauno pull request. Kad izveido pull request, saņem apstiprinājumu, ka tava filiāle nav konflikta ar galveno filiāli. Šis apstiprinājums nozīmē, ka izmaiņas var automātiski apvienot galvenajā atzarā. Izvēlieties Merge pull request un pēc tam izvēlieties Apstiprināt apvienošanu. Pēc izvēles izvēlieties dzēst zaru, lai noņemtu tagad nefunkcionējošo zaru.

    Skatīt zarus

  8. Atgriezies pie noklusējuma (galvenā) zara un pārbaudi, vai risinājums tur ir pieejams.

Atkārtoti izveidojamas darbplūsmas izveide, lai ģenerētu artefaktu un importētu to ražošanā

Šajā sadaļā izveidojiet papildu darba plūsmu, kas:

  • Izveido pārvaldītu risinājumu un publicē to kā GitHub artefaktu
  • Ģenerēta artefakta importēšana ražošanas vidē
  1. Ej uz Actions un izvēlies Jauns darba process.

    Izveidojiet jaunu darbplūsmu.

  2. Izvēlies pats izveidot darba plūsmu.

    Iestatiet darbplūsmu.

  3. Pārdēvē darba plūsmas nosaukumu par release-solution-to-prod-with-inputs. Nokopējiet saturu no release-solution-to-prod-with-inputs.yml faila un ielīmējiet to Rediģēt jaunu failu ekrānā.

    Pārdēvējiet un ielīmējiet kodu.

  4. Izpildiet izmaiņas. Izvēlieties Sākt izpildi un pēc tam pievienojiet nosaukumu un aprakstu (neobligāti). Pēc tam atlasiet Izpildīt jaunu failu.

    Veiciet izmaiņas.

Atkārtoti pielāgojamas darbplūsmas izsaukšana laidiena notikumā

Šajā sadaļā jūs izsaucat atkārtoti izmantojamo darba plūsmu izlaiduma notikumā.

  1. Ej uz Actions un izvēlies Jauns darba process.

    Izveidojiet jaunu darbplūsmu.

  2. Izvēlieties iestatiet darbplūsmu pats.

    Iestatiet darbplūsmu.

  3. Pārdēvē darba plūsmas nosaukumu par release-action-call. Kopējiet saturu no release-action-call.yml faila un ielīmējiet to Rediģēt jauna faila ekrānā.

    Pārdēvējiet un ielīmējiet kodu.

  4. Jaunajā darbplūsmas failā atjauniniet tālāk norādītos mainīgos.

    • Atjauniniet <BUILD_ENVIRONMENT> ar URL uz būvēšanas vidi, kuru izmantojat pārvaldītā risinājuma ģenerēšanai. Piemēram, https://poweractionsbuild.crm.dynamics.com.
    • Atjauniniet <PROD_ENVIRONMENT> ar URL uz ražošanas vidi, kurā izvietojat. Piemēram, https://poweractionsprod.crm.dynamics.com.
    • Atjauniniet <APP_ID> ar Application (Client) ID, ko atrodat Microsoft Azure Portal App registrations lapā, izvēloties iepriekš šajā pamācībā izveidoto reģistrāciju.
    • Atjauniniet <TENANT_ID> ar Directory (tenant) ID, ko atrodat Microsoft Azure Portal App registrations blade, izvēloties iepriekš šajā pamācībā izveidoto reģistrāciju.
  5. Izpildiet izmaiņas. Izvēlieties Sākt izpildi un pēc tam pievienojiet nosaukumu (neobligāti) un aprakstu (neobligāti). Pēc tam atlasiet Izpildīt jaunu failu.

    Veiciet izmaiņas.

Izlaišanas ražošanas darbplūsmā testēšana

Tagad esat gatavs pārbaudīt pēdējo darba plūsmu. Šī darba plūsma tiek aktivizēta, kad jauna versija tiek izlaista ražošanā.

  1. Dodieties uz Releases.

    Naviģējiet uz laidieniem.

  2. Atlasiet Izveidot jauna laidiena melnrakstu.

  3. Pievienojiet laidiena atzīmi, virsrakstu un izvēlieties Publicēt laidienu.

  4. Atlasiet Darbības, lai skatītu darbojošos darbplūsmu.

    Atlasiet, lai skatītu darbplūsmu.

  5. Izvēlieties darbojošos darbplūsmu, lai skatītu darbības to izpildes laikā.

    Skatīt darbplūsmu.

  6. Uzgaidiet, līdz tiek pabeigta katra darbība.

    Skatīt filiāli.

  7. Kad darba plūsma ir pabeigta, piesakieties savā ražošanas vidē un pārliecinieties, ka risinājums ir izvietots kā pārvaldīts risinājums.

Atjauninājuma izvietošana un izmaiņu pārskatīšana pirms ražošanas laidiena

Pārbaudiet gala līdz galam procesu un tad paskatieties, kā varat skatīt un validēt izmaiņas lietotnē pirms tās izvietošanas ražošanā.

  1. Dodieties uz ALMLab risinājumu savā izstrādes vidē un izvēlieties Rediģēt vai izvēlieties risinājuma rādīšanas nosaukumu.

    Rediģēt risinājumu.

  2. Atlasiet un skatiet tabulu Brīvā laika pieprasījums.

    Skatīt tabulu.

  3. Izvēlieties + Add kolonnu un izveidojiet jaunu kolonnu, kā parādīts nākamajā attēlā.

    Kolonnas pievienošana.

    Atjauninātās lauku vērtības:**

    • Parādāmais vārds: apstiprināts
    • Datu tips: jā/nē
  4. Atlasiet Gatavs.

  5. Atlasiet Saglabāt tabulu. Kolonnas pievienošana.

  6. Atgriezies savā GitHub repozitoriju cilnē Darbības, izvēlies Palaist darba plūsmu un izvēlies pogu Palaist darba plūsmu.

    Palaidiet darbplūsmu.

  7. Pēc 5–10 sekundēm darba plūsma sākas. Izvēlieties darba plūsmu, lai sekotu tās progresam.

    Atlasiet darbplūsmu.

    Skatiet darbplūsmu.

  8. Kad darba plūsma ir pabeigta, dodieties uz jauno zaru, izvēloties Code un pēc tam Branches.

    Naviģējiet uz filiāli.

  9. Izvēlieties zaru, ko izveidojāt, paplašinot ieguldījumu un izvēloties Open pull request.

  10. Pievieno nosaukumu (pēc izvēles) un tad izvēlies Create pull request.

  11. Pēc satura atjauninājumiem izvēlieties cilni "Faili mainīti ".

  12. Ņemiet vērā, ka risinājumā veiktās izmaiņas ir izceltas zaļā krāsā, lai norādītu, ka šī faila sadaļa tika pievienota, salīdzinot to ar to pašu failu galvenajā zarā.

  13. Atgriezieties cilnē Saruna . Izvēlieties Pull requests un tad iepriekš izveidojāt pull request.

  14. Pull pieprasījuma lapā izvēlieties Squash un apvienojiet, lai apvienotu atjaunināto risinājuma failu ar galveno zaru. Pēc izvēles izdzēsiet, kas tagad ir apvienots ar galveno.

    Atvērt izvilkšanas pieprasījumu jaunam zaram, skatīt izmaiņas un sapludināt uz noklusējuma zaru

  15. Izpildiet soļus sadaļā "Testēt izlaidumu ražošanā ", lai izveidotu jaunu versiju un pārbaudītu, vai atjauninātais risinājums ir izvietots jūsu ražošanas vidē.

Apsveicam, jūs veiksmīgi izveidojāt parauga CI/CD darba plūsmu, izmantojot GitHub darbības!

Skatiet arī

Automatizējiet darbplūsmu no ideja līdz ražošanai