Vadovėlis: sprendimo diegimo automatizavimas naudojant Microsoft Power Platform GitHub Actions

Šioje mokymo priemonėje sužinote, kaip:

  • Sukurkite naują „GitHub“ saugyklą
  • Dviejų GitHub darbo eigų kūrimas naudojant GitHub Actions Microsoft Power Platform

Darbo eiga gali automatiškai eksportuoti jūsų programą (kaip nesuvaldytą sprendimą) iš talpinamos programos, sukurti artefaktą (sutvarkytą sprendimą) ir talpinti programą į jūsų gamybos aplinką. Šie mokymai naudoja ALMLab sprendimą, kurį sukūrėte ir aplinkas, kurias nustatėte ankstesnių mokymų metu.

Susiję mokymai: Pradėkite dirbti ir Kurti modeliu pagrįstą programą.

GitHub paskyros kūrimas

  1. Eikite į ir pasirinkite Prisiregistruotihttps://github.com arba Pradėti nemokamą bandomąją versiją (arba prisijunkite, jei turite esamą paskyrą).

    Kurti paskyrą

  2. Sukūrę paskyrą sukurkite saugyklą pasirinkdami Kurti saugyklą arba Nauja.

    Sukurkite saugyklą

    Galite matyti tolesnį alternatyvų užsklandos ekraną:

    Sukurkite naują saugyklą

  3. Sukurkite naują saugyklą ir pavadinkite ją poweractionslab. Įsitikinkite, kad pasirinkote Įtraukti README failą , kad inicijuotumėte pasikartojimą, ir pasirinkite Kurti saugyklą.

    Inicijuokite atpirkimo sandorį.

Naujo pagrindinės tarnybos autentifikavimo slaptojo rakto kūrimas

  1. Eikite į saugyklą ir pasirinkite Parametrai. Išplėskite Secrets, tada pasirinkite Veiksmai.

  2. Puslapyje Paslaptys pavadinkite slaptą PowerPlatformSPN. Įveskite kliento slaptą informaciją iš programos registracijos, kurią sukūrėte Microsoft Entra į lauką Reikšmė, tada pasirinkite Įtraukti slaptą. Vėliau šiame mokyme nurodysite kliento slaptą informaciją YML failuose, kurie apibrėžia GitHub darbo eigas.

    Pagrindinės tarnybos slaptojo rakto kūrimas

    Dabar kliento slaptasis raktas saugiai saugomas kaip „GitHub” slaptasis raktas.

Kurkite darbo eigą, kad eksportuotumėte ir išpakuotumėte sprendimo failą į naują padalinį

  1. Pasirinkite Veiksmai, tada patys pasirinkite nustatyti darbo eigą. Arba pasirinkite Konfigūruoti lauke Paprasta darbo eiga , esančiame po šiai saugyklai siūloma sekcija .

    Sąrankos darbo eiga.

  2. Matote naują YAML failą su pagrindine darbo eiga, kad galėtumėte pradėti GitHub veiksmus.

    YML failo pavyzdys

  3. Panaikinkite iš anksto paruoštą turinį, tada įklijuokite turinį iš export-and-branch-solution-with-spn-auth.yml failo. Pervardykite failą į export-and-branch-solution.yml.

    Pervardykite ir pakeiskite turinį.

  4. Naujinkite <ENVIRONMENTURL> su URL diegimo aplinkai, kurią norite eksportuoti iš sprendimo (pavyzdžiui: https://poweractionsdev.crm.dynamics.com).

  5. Atnaujinkite <APPID> ir <TENANT ID> su savo reikšmėmis.

    • Jei naudojate kredencialus, įklijuokite export-and-branch-solution.yml failą, o ne export-and-branch-solution-with-spn-auth.yml failo turinį. Atnaujinkite <USERNAME> vartotojo vardu, kurį naudojate prisijungti prie aplinkos.

      Pervardyti ir pakeisti turinį

    Arbatpinigiai

    Jei nesate susipažinę su GitHub Actions ir norite sužinoti daugiau, peržiūrėkite oficialius dokumentus adresu https://docs.github.com/en/actions.

  6. Dabar esate pasirengę atlikti pakeitimus. Rinkitės Pradėti keitimą, įveskite Kurti eksportavimo yml pavadinimo laukelyje ir tuomet įveskite aprašą (pasirenkamas). Toliau rinkitės Sukurti naują failą.

    Pradėkite įsipareigoti.

Sveikiname, sukūrėte pirmąją GitHub darbo eigą atlikdami šiuos veiksmus:

  • Kas esu aš: užtikrina, kad galite sėkmingai prisijungti prie aplinkos, iš kurios norite eksportuoti.
  • Eksportuoti sprendimą: eksportuojamas sprendimo failas iš jūsų kūrimo aplinkos.
  • Išskleisti sprendimą: sprendimo failas, kurį eksportuoja serveris, yra suglaudintas (zip) failas su konsoliduotais konfigūracijos failais. Šie pradiniai failai netinka šaltinio kodo valdymui, nes jie nėra sudaryti taip, kad šaltinio kodo valdymo sistemoms būtų įmanoma tinkamai atlikti skirtingus failų keitimus ir užfiksuoti keitimus, kuriuos norite atlikti šaltinio valdikliui. Turite išpakuoti sprendimų failus, kad jie būtų tinkami šaltinio kontrolės saugyklai ir apdorojimui.
  • Filialo sprendimas: sukuria naują šaką eksportuotam sprendimui saugoti.

Bandykite eksportuotą ir išpakuotą darbo eigą

  1. Toliau, bandykite tos darbo eigos vykdymus. Eikite į Veiksmai, pasirinkite Vykdyti darbo eigą ir pasirinkite Vykdyti darbo eigą. Jei naudojate kitą sprendimo pavadinimą nei ALMLab, čia pakeiskite reikšmę, bet kitos reikšmės liks tokios pačios.

    Vykdyti darbo eigą.

  2. Po 5–10 sekundžių pradedama darbo eiga. Galite pasirinkti vykdomą darbo eigą, kad galėtumėte stebėti eigą.

    Spustelėkite norėdami peržiūrėti darbo eigą.

    Pasirinkite ir peržiūrėkite darbo eigą.

  3. Baigę darbo eigą, patikrinkite, ar sukurta nauja šaka su išpakuoto į solutions/ALMLab aplanką sprendimu. Eikite į skirtuką Kodas ir išplėskite šakų išplečiamąjį sąrašą.

  4. Pasirinkite šaką, kurią sukūrė veiksmas.

  5. Patikrinkite, ar solutions/ALMLab aplankas sukurtas naujoje šakoje. Tada sukurkite traukimo užklausą, kad sulietumėte keitimus į pagrindinę šaką. Pasirinkite Bendradarbiauti ir iškylantajame meniu pasirinkite Atidaryti traukos užklausą.

  6. Ekrane Atidaryti patraukimo užklausą įtraukite pavadinimą ir aprašą, jei norite, tada pasirinkite Kurti dėmesį atkreipiančią užklausą.

  7. Ekranas atnaujinamas, kad būtų rodoma nauja gavimo užklausa. Kai kuriate traukimo užklausą, gaunate patvirtinimą, kad jūsų šaka neprieštarauja pagrindinei šakai. Šis patvirtinimas reiškia, kad galite automatiškai sulieti keitimus į pagrindinę šaką. Pasirinkite Sulieti dėmesį atkreipiant užklausą , tada pasirinkite Patvirtinti suliejimą. Jei norite, pasirinkite Naikinti šaką, kad pašalintumėte nebeveiksią šaką.

    Žiūrėti skyrius

  8. Grįžkite į numatytąją (pagrindinę) šaką ir patikrinkite, ar sprendimas ten pasiekiamas.

Sukurkite pakartotinai naudojamą darbo eigą, kad sukurtumėte artefaktą ir importuotumėte į gamybą

Šiame skyriuje sukurkite papildomą darbo eigą, kuri:

  • Sukurs suvaldytą sprendimą ir jį publikuos kaip „GitHub“ artefaktą
  • Importuos sukurtą artefaktą į gamybos aplinką

  1. Eikite į Veiksmai ir pasirinkite Nauja darbo eiga.

    Sukurkite naują darbo eigą.

  2. Pasirinkite patys nustatyti darbo eigą.

    Nustatykite darbo eigą.

  3. Pervardykite darbo eigos pavadinimą į release-solution-to-prod-with-inputs. Nukopijuokite turinį iš release-solution-to-prod-with-inputs.yml failo ir įklijuokite jį ekrane Redaguoti naują failą .

    Pervardykite ir įklijuokite kodą.

  4. Atlikite keitimus. Rinkitės Atlikti keitimą ir tada įtraukite pavadinimą ir aprašą (pasirenkama). Toliau rinkitės Sukurti naują failą.

    Atlikite pakeitimus.

Iškinkite pakartotinai naudotinos darbo eigos iškvietimą leidimo įvykyje

Šiame skyriuje iškviečiate pakartotinai naudojamą darbo eigą leidimo įvykyje.

  1. Eikite į Veiksmai ir pasirinkite Nauja darbo eiga.

    Sukurkite naują darbo eigą.

  2. Rinkitės nustatyti darbo eigą pačiam.

    Nustatykite darbo eigą.

  3. Pervardykite darbo eigos pavadinimą į release-action-call. Nukopijuokite turinį iš release-action-call.yml failo ir įklijuokite jį ekrane Redaguoti naują failą .

    Pervardykite ir įklijuokite kodą.

  4. Naujinkite tolesnius kintamuosius naujosios darbo eigos faile:

    • Atnaujinkite <BUILD_ENVIRONMENT> komponavimo versijos aplinkos, kurią naudojate valdomam sprendimui generuoti, URL. Pavyzdžiui: https://poweractionsbuild.crm.dynamics.com.
    • Atnaujinkite <PROD_ENVIRONMENT> gamybos aplinkos, kurioje diegiate, URL. Pavyzdžiui: https://poweractionsprod.crm.dynamics.com.
    • Atnaujinkite <APP_ID> programos (kliento) ID, kurį randate "Microsoft" Azure Portal App registrations dalyje, pasirinkdami registraciją, kurią sukūrėte anksčiau šiame mokymo kurse.
    • Atnaujinkite <TENANT_ID> naudodami katalogo (nuomotojo) ID, kurį randate "Microsoft" Azure Portal App registrations disko dalyje, pasirinkdami registraciją, kurią sukūrėte anksčiau šiame mokymo kurse.

  5. Atlikite keitimus. Rinkitės Atlikti keitimą ir tada įtraukite pavadinimą (pasirinktinas) ir aprašą (pasirenkama). Toliau rinkitės Sukurti naują failą.

    Atlikite pakeitimus.

bandykite leidimą į gamybos darbo eigą

Dabar esate pasirengę patikrinti paskutinę darbo eigą. Ši darbo eiga paleidžiama, kai naujas leidimas diegiamas į gamybą.

  1. Eikite į Leidimai.

    Eikite į leidimus.

  2. Rinkitės Sudaryti naują leidimą.

  3. Įtraukite leidimo žymą, pavadinimą ir rinkitės Publikuoti leidimą.

  4. Rinkitės Veiksmai tam, kad peržiūrėtumėte vykdomą darbo eigą.

    Pasirinkite, kad peržiūrėtumėte darbo eigą.

  5. Rinkitės vykdomą darbo eigą, kad matytumėte veiksmus jų vykdymo metu.

    Peržiūrėti darbo eigą.

  6. Palaukite, kol baigsis visi veiksmai.

    Peržiūrėti šaką.

  7. Pasibaigus darbo eigai, prisijunkite prie savo gamybos aplinkos ir patikrinkite, ar sprendimas įdiegtas kaip valdomas sprendimas.

Talpinkite naujinimą ir peržiūrėkite keitimus prieš gamybos leidimą

Išbandykite visą procesą ir peržiūrėkite, kaip galite peržiūrėti ir patikrinti taikomosios programos pakeitimus prieš diegdami jį gamybai.

  1. Eikite į "ALMLab" sprendimą kūrimo aplinkoje ir pasirinkite Redaguoti arba pasirinkite sprendimo rodomą pavadinimą.

    Redaguoti sprendimą.

  2. Rinkitės ir peržiūrėkite Nedirbamo laiko užklausos lentelę.

    Peržiūrėkite lentelę.

  3. Pasirinkite + Įtraukti stulpelį ir sukurkite naują stulpelį, kaip parodyta toliau pateiktame paveikslėlyje.

    Stulpelio įtraukimas.

    Atnaujintos lauko reikšmės:**

    • Rodomas pavadinimas: Patvirtinta
    • Duomenų tipas: Taip/Ne

  4. Pasirinkite Atlikta.

  5. Pasirinkite Įrašyti lentelę. Stulpelio įtraukimas.

  6. Grįžkite į GitHub saugyklų skirtuką Veiksmai, pasirinkite Vykdyti darbo eigą, tada pasirinkite mygtuką Vykdyti darbo eigą.

    Vykdykite darbo eigą.

  7. Po 5–10 sekundžių pradedama darbo eiga. Pasirinkite vykdomą darbo eigą, kad galėtumėte stebėti jos eigą.

    Pasirinkite darbo eigą.

    Peržiūrėkite darbo eigą.

  8. Baigę darbo eigą, eikite į naują šaką pasirinkdami Kodas , tada – Šakos.

    Eikite į filialą.

  9. Pasirinkite šaką, kurią sukūrėte plėsdami bendradarbiauti , ir pasirinkite Atidaryti traukos užklausą.

  10. Įtraukite pavadinimą (pasirinktinai), tada pasirinkite Kurti dėmesį atkreipiančią užklausą.

  11. Atnaujinę turinį pasirinkite skirtuką Failai pakeisti .

  12. Atminkite, kad sprendimo keitimai yra paryškinti žaliai siekiant parodyti, kad šis failo skyrius buvo įtrauktas, kai buvo palygintas su tuo pačiu pagrindinio skyriaus failu.

  13. Grįžkite į skirtuką Pokalbis . Pasirinkite Dėmesį atkreipiamos užklausos , tada pasirinkite anksčiau sukurtą traukimo užklausą.

  14. Puslapyje Traukos užklausa pasirinkite "Squash" ir suliekite , kad atnaujintą sprendimo failą sulietumėte į pagrindinę šaką. Pasirinktinai panaikinkite tai, kas dabar sulieta į pagrindinį.

    Atidarykite naujos šakos ištraukimo užklausą, peržiūrėkite pakeitimus ir suliekite į numatytąją šaką

  15. Atlikite veiksmus, nurodytus skyriuje Leidimo tikrinimas gamybos darbo eigoje , kad sukurtumėte naują leidimą ir patikrintumėte, ar atnaujintas sprendimas įdiegtas jūsų gamybos aplinkoje.

Sveikiname, sėkmingai nustatėte CI / CD darbo eigos pavyzdį naudodami GitHub veiksmus!

Taip pat žr.

Automatizuokite savo darbo eigą nuo idėja iki gamybos

  • Paskutinį kartą atnaujinta