Piezīmes
Lai piekļūtu šai lapai, ir nepieciešama autorizācija. Varat mēģināt pierakstīties vai mainīt direktorijus.
Lai piekļūtu šai lapai, ir nepieciešama autorizācija. Varat mēģināt mainīt direktorijus.
Š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
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).
Pēc konta izveides izveidojiet repozitoriju, izvēloties Izveidot repozitoriju vai Jaunu.
Var tikt parādīts šāds alternatīvs izvietošanas ekrāns:
Izveido jaunu repozitoriju un nosauc to
poweractionslab. Pārliecinieties, ka izvēlaties pievienot README failu , lai uzsāktu repozitoriju, un izvēlieties izveidot repozitoriju.
Jauna noslēpuma izveide pakalpojuma vadītāja autentifikācijai
Dodieties uz savu repozitoriju un izvēlieties Iestatījumi. Paplašini Noslēpumus un tad izvēlies Darbības.
Noslēpumu lapā nosauciet noslēpumu
PowerPlatformSPN. 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.
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ē
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.
Jūs redzat jaunu YAML failu ar pamata darba plūsmu, kas palīdz sākt ar GitHub darbībām.
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.
Atjauniniet
<ENVIRONMENTURL>ar tās izstrādes vides vietrādi URL, no kuras vēlaties eksportēt (piemēram:https://poweractionsdev.crm.dynamics.com).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.
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.
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.
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
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.
Pēc 5–10 sekundēm darba plūsma sākas. Tu vari izvēlēties darba plūsmu, lai sekotu progresam.
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.Izvēlieties zaru, ko darbība izveidoja.
Pārbaudi, vai
solutions/ALMLabmape 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.Ekrānā "Atvērt pull pieprasījumu" pievieno nosaukumu un aprakstu, ja vēlies, tad izvēlies Izveidot pull request.
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.
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ē
Ej uz Actions un izvēlies Jauns darba process.
Izvēlies pats izveidot darba plūsmu.
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ā.
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.
Atkārtoti pielāgojamas darbplūsmas izsaukšana laidiena notikumā
Šajā sadaļā jūs izsaucat atkārtoti izmantojamo darba plūsmu izlaiduma notikumā.
Ej uz Actions un izvēlies Jauns darba process.
Izvēlieties iestatiet darbplūsmu pats.
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ā.
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.
- Atjauniniet
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.
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ā.
Dodieties uz Releases.
Atlasiet Izveidot jauna laidiena melnrakstu.
Pievienojiet laidiena atzīmi, virsrakstu un izvēlieties Publicēt laidienu.
Atlasiet Darbības, lai skatītu darbojošos darbplūsmu.
Izvēlieties darbojošos darbplūsmu, lai skatītu darbības to izpildes laikā.
Uzgaidiet, līdz tiek pabeigta katra darbība.
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ā.
Dodieties uz ALMLab risinājumu savā izstrādes vidē un izvēlieties Rediģēt vai izvēlieties risinājuma rādīšanas nosaukumu.
Atlasiet un skatiet tabulu Brīvā laika pieprasījums.
Izvēlieties + Add kolonnu un izveidojiet jaunu kolonnu, kā parādīts nākamajā attēlā.
Atjauninātās lauku vērtības:**
- Parādāmais vārds: apstiprināts
- Datu tips: jā/nē
Atlasiet Gatavs.
Atlasiet Saglabāt tabulu.
Atgriezies savā GitHub repozitoriju cilnē Darbības, izvēlies Palaist darba plūsmu un izvēlies pogu Palaist darba plūsmu.
Pēc 5–10 sekundēm darba plūsma sākas. Izvēlieties darba plūsmu, lai sekotu tās progresam.
Kad darba plūsma ir pabeigta, dodieties uz jauno zaru, izvēloties Code un pēc tam Branches.
Izvēlieties zaru, ko izveidojāt, paplašinot ieguldījumu un izvēloties Open pull request.
Pievieno nosaukumu (pēc izvēles) un tad izvēlies Create pull request.
Pēc satura atjauninājumiem izvēlieties cilni "Faili mainīti ".
Ņ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ā.
Atgriezieties cilnē Saruna . Izvēlieties Pull requests un tad iepriekš izveidojāt pull request.
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.
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!