Kurz: Automatizácia nasadenia riešenia pomocou GitHub Actions na Microsoft Power Platform

V tomto kurze sa naučíte:

  • Vytvoriť nové úložisko GitHub
  • Vytvorenie dvoch GitHub pracovných postupov s použitím GitHub Actions pre Microsoft Power Platform

Pracovné postupy môžu automaticky exportovať vašu aplikáciu (ako nespravované riešenie) z vývojového prostredia, vygenerovať artefakt zostavy (spravované riešenie) a nasadiť aplikáciu do produkčného prostredia. Tento kurz používa riešenie ALMLab, ktoré ste vytvorili a prostredia, ktoré ste nastavili v predchádzajúcich kurzoch.

Súvisiace kurzy: Začíname a Vytvorenie modelom riadenej aplikácie.

Vytvorenie konta GitHub

  1. Prejdite na https://github.com lokalitu, vyberte položku Zaregistrovať sa alebo Spustiť bezplatnú skúšobnú verziu (alebo sa prihláste, ak máte existujúce konto).

    Vytvoriť konto

  2. Po vytvorení konta vytvorte odkladací priestor výberom položky Vytvoriť odkladací priestor alebo Nový.

    Vytvorte odkladací priestor

    Môže sa vám zobraziť nasledujúca alternatívna vstupná obrazovka:

    Vytvorenie nového odkladacieho priestoru

  3. Vytvorte nový odkladací priestor a pomenujte ho poweractionslab. Skontrolujte, či ste vybrali možnosť Pridať súbor README , čím spustíte odkladací priestor, a vyberte položku Vytvoriť odkladací priestor.

    Spustite repo.

Vytvorenie nového tajného kľúča pre autentifikáciu hlavného poskytovateľa služby

  1. Prejdite do odkladacieho priestoru a vyberte položku Nastavenia. Rozbaľte položku Secrets (Tajné kódy) a potom vyberte položku Actions (Akcie).

  2. Na stránke Secrets (Tajné kódy ) pomenujte tajný kód PowerPlatformSPN. Zadajte tajný kľúč klienta z registrácie aplikácie, ktorú ste vytvorili v službe Microsoft Entra, do poľa Hodnota a potom vyberte položku Pridať tajný kód. V súboroch YML, ktoré definujú pracovné postupy GitHub neskôr v tomto kurze, odkazujete na tajný kľúč klienta.

    Vytvorte tajný kľúč hlavného poskytovateľa služby

    Tajný kľúč klienta je teraz bezpečne uložený ako tajný kľúč GitHub.

Vytvorte pracovný postup na exportovanie a rozbalenie súboru riešenia do novej vetvy

  1. Vyberte položku Akcie a potom vyberte sami nastaviť pracovný postup. Alebo vyberte možnosť Konfigurovať v poli Jednoduchý pracovný postup v časti Navrhované pre tento odkladací priestor .

    Nastavenie pracovného postupu.

  2. Zobrazí sa nový súbor YAML so základným pracovným postupom, ktorý vám pomôže začať pracovať s GitHub akciami.

    Vzorový súbor YML

  3. Odstráňte predvytvorenie obsahu a potom prilepte obsah zo súboru export-and-branch-solution-with-spn-auth.yml . Premenujte súbor na export-and-branch-solution.yml.

    Premenujte a nahraďte obsah.

  4. Aktualizujte <ENVIRONMENTURL> s adresou URL vývojového prostredia, z ktorého chcete exportovať (napríklad: https://poweractionsdev.crm.dynamics.com).

  5. Aktualizujte <APPID> a <TENANT ID> svojimi hodnotami.

    • Ak použijete poverenia, prilepte export-and-branch-solution.yml súbor namiesto obsahu export-and-branch-solution-with-spn-auth.yml súboru. Aktualizujte <USERNAME> meno používateľa, ktoré používate na pripojenie k prostrediu.

      Premenujte a nahraďte obsah

    Prepitné

    Ak nie ste oboznámení s GitHub Actions a chcete sa dozvedieť viac, pozrite si oficiálnu dokumentáciu na stránke https://docs.github.com/en/actions.

  6. Teraz ste pripravení potvrdiť zmeny. Vyberte Spustiť potvrdenie, zadajte Vytvoriť export yml do poľa názvu a potom pridajte popis (voliteľný). Potom vyberte Potvrdiť nový súbor.

    Začnite sa zaväzovať.

Blahoželáme, vytvorili ste svoj prvý pracovný postup GitHub pomocou nasledujúcich akcií:

  • Kto som: Zaistí, že sa môžete úspešne pripojiť k prostrediu, z ktorého chcete exportovať.
  • Exportovať riešenie: Exportuje súbor riešenia z vášho vývojového prostredia.
  • Rozbaliť riešenie: Súbor riešenia, ktorý exportuje server, je komprimovaný súbor (zip) s konsolidovanými konfiguračnými súbormi. Tieto počiatočné súbory nie sú vhodné na správu zdrojového kódu, pretože nie sú štruktúrované tak, aby bolo možné, aby systémy správy zdrojového kódu správne rozlišovali v súboroch a zaznamenávali zmeny, ktoré chcete zaviazať k ovládaniu zdroja. Musíte rozbaliť súbory riešení, aby boli vhodné pre úložisko a spracovanie zdrojového ovládacieho prvku.
  • Riešenie pobočky: Vytvorí novú pobočku na uloženie exportovaného riešenia.

Otestujte export a rozbaľte pracovný postup

  1. Potom otestujte, či je pracovný postup spustený. Prejdite do časti Akcie, vyberte položku Spustiť pracovný postup a potom položku Spustiť pracovný postup. Ak použijete iný názov riešenia ako ALMLab, zmeňte hodnotu tu, ale ostatné hodnoty ponechajte rovnaké.

    Spustite pracovný postup.

  2. Po 5 – 10 sekundách sa spustí pracovný postup. Spustením pracovného postupu môžete monitorovať priebeh.

    Kliknutím zobrazíte pracovný postup.

    Vyberte a zobrazte pracovný postup.

  3. Po dokončení pracovného postupu skontrolujte, či sa v priečinku vytvorí nová vetva s riešením vybalenou solutions/ALMLab . Prejdite na kartu Kód a rozbaľte rozbaľovací zoznam vetiev.

  4. Vyberte vetvu, ktorú akcia vytvorila.

  5. Skontrolujte, solutions/ALMLab či je priečinok vytvorený v novej vetve. Potom vytvorte žiadosť o prijatie zmien na zlúčenie zmien do hlavnej vetvy. Vyberte položku Prispieť a v rozbaľovacej ponuke vyberte položku Otvoriť žiadosť o prijatie zmien.

  6. Na obrazovke Otvorenie žiadosti o prijatie zmien pridajte podľa potreby názov a popis, potom vyberte položku Vytvoriť žiadosť o prijatie zmien.

  7. Obrazovka sa aktualizuje a zobrazí novú žiadosť o prijatie zmien. Pri vytváraní žiadosti o prijatie zmien získate potvrdenie, že vaša vetva nemá žiadny konflikt s hlavnou vetvou. To znamená, že môžete zlúčiť zmeny do hlavnej vetvy automaticky. Vyberte položku Zlúčiť žiadosť o prijatie zmien a potom vyberte položku Potvrdiť zlúčenie. Ak chcete odstrániť zaniknutú vetvu, vyberte možnosť Odstrániť vetvu.

    Zobraziť vetvy

  8. Vráťte sa do predvolenej (hlavnej) vetvy a skontrolujte, či je tam dostupné riešenie.

Vytvorte znova použiteľný pracovný postup na vygenerovanie artefaktu zostavenia a import do výroby

V tejto časti vytvorte ďalší pracovný postup, ktorý:

  • Vytvorí spravované riešenie a zverejní ho ako artefakt GitHub
  • Importuje artefakt zostavy do produkčného prostredia
  1. Prejdite do časti Akcie a vyberte položku Nový pracovný postup.

    Vytvorte nový pracovný postup.

  2. Vyberte si možnosť nastaviť pracovný postup.

    Nastavte pracovný postup.

  3. Premenujte názov pracovného postupu na release-solution-to-prod-with-inputs. Skopírujte obsah zo súboru release-solution-to-prod-with-inputs.yml a prilepte ho na obrazovku Upraviť nový súbor .

    Premenujte a vložte kód.

  4. Potvrďte zmeny. Vyberte Spustiť potvrdenie a potom pridajte názov a popis (voliteľné). Potom vyberte Potvrdiť nový súbor.

    Potvrdiť zmeny.

Zavolajte opakovane použiteľný pracovný postup pri udalosti vydania

V tejto časti zavoláte opätovne použiteľný pracovný postup udalosti vydania.

  1. Prejdite do časti Akcie a vyberte položku Nový pracovný postup.

    Vytvorte nový pracovný postup.

  2. Vyberte nastaviť pracovný postup svojpomocne.

    Nastavte pracovný postup.

  3. Premenujte názov pracovného postupu na release-action-call. Skopírujte obsah zo súboru release-action-call.yml a prilepte ho na obrazovku Upraviť nový súbor .

    Premenujte a vložte kód.

  4. Aktualizujte nasledujúce premenné v novom súbore pracovného toku:

    • Aktualizujte <BUILD_ENVIRONMENT> adresu URL prostredia na vytváranie, ktoré používate na generovanie spravovaného riešenia. Napríklad: https://poweractionsbuild.crm.dynamics.com.
    • Aktualizujte <PROD_ENVIRONMENT> pomocou URL adresy produkčného prostredia, do ktoré nasadzujete. Napríklad: https://poweractionsprod.crm.dynamics.com.
    • Aktualizujte <APP_ID> pomocou ID aplikácie (klienta), ktoré nájdete v liste App registrations v službe Microsoft Azure Portal tak, že vyberiete registráciu, ktorú ste vytvorili skôr v tomto kurze.
    • Výberom registrácie, ktorú ste vytvorili skôr v tomto kurze, aktualizujte <TENANT_ID> svoje ID adresára (nájomníka), ktoré nájdete v liste App registrations v službe Microsoft Azure Portal.
  5. Potvrďte zmeny. Vyberte Spustiť potvrdenie a potom pridajte názov (voliteľné) a popis (voliteľné). Potom vyberte Potvrdiť nový súbor.

    Potvrdiť zmeny.

Otestujte pracovný postup uvoľnenia do výroby

Teraz ste pripravení otestovať posledný pracovný postup. Tento pracovný postup sa spustí pri nasadení nového vydania do produkcie.

  1. Prejdite do časti Vydania.

    Prejdite na vydania.

  2. Vyberte Koncept nového vydania.

  3. Pridajte značku vydania, názov a vyberte Zverejniť vydanie.

  4. Vyberte Akcie na zobrazenie bežiaceho pracovného postupu.

    Výberom zobrazíte pracovný postup.

  5. Vyberte prebiehajúci pracovný postup, aby ste zobrazili prebiehajúce akcie.

    Zobraziť pracovný postup.

  6. Počkajte na dokončenie každej akcie.

    Zobraziť pobočku.

  7. Po dokončení pracovného postupu sa prihláste do produkčného prostredia a overte, či je riešenie nasadené ako spravované riešenie.

Nasaďte aktualizáciu a skontrolujte zmeny pred produkčným vydaním

Otestujte proces od konca až po koniec a pred nasadením aplikácie do produkcie si pozrite, ako môžete zobraziť a overiť zmeny aplikácie.

  1. Prejdite do riešenia ALMLab vo vašom vývojárskom prostredí a vyberte položku Upraviť alebo vyberte zobrazovaný názov riešenia.

    Upraviť riešenie.

  2. Vyberte a zobrazte tabuľku Žiadosť o voľno.

    Pozrite si tabuľku.

  3. Vyberte položku + Pridať stĺpec a vytvorte nový stĺpec tak, ako je to znázornené na nasledujúcom obrázku.

    Pridanie stĺpca.

    Aktualizované hodnoty polí:**

    • Zobrazovaný názov: Schválené
    • Typ údajov: Áno/Nie
  4. Vyberte položku Hotovo.

  5. Vyberte Uložiť tabuľku. Pridanie stĺpca.

  6. Vráťte sa do svojho GitHub odkladacích priestorov Karta Akcie, vyberte položku Spustiť pracovný postup a vyberte tlačidlo Spustiť pracovný postup.

    Spustite pracovný postup.

  7. Po 5 – 10 sekundách sa spustí pracovný postup. Vyberte spustený pracovný postup na monitorovanie jeho priebehu.

    Vyberte pracovný postup.

    Pozrite si pracovný postup.

  8. Po dokončení pracovného postupu prejdite na novú vetvu výberom položiek Kód a Potom Vetvy.

    Prejdite na pobočku.

  9. Vyberte vetvu, ktorú ste vytvorili rozbalením položky Prispieť a vyberte možnosť Otvoriť žiadosť o prijatie zmien.

  10. Pridajte názov (voliteľné) a potom vyberte položku Vytvoriť žiadosť o prijatie zmien.

  11. Po aktualizácii obsahu vyberte kartu Súbory zmenené .

  12. Všimnite si, že zmeny riešenia sú zvýraznené zelenou farbou, čo naznačuje, že táto časť súboru bola pridaná v porovnaní s rovnakým súborom v hlavnej vetve.

  13. Prejdite späť na kartu Konverzácia . Vyberte položku Žiadosti o prijatie zmien a potom vyberte žiadosť o prijatie zmien, ktorú ste predtým vytvorili.

  14. Na stránke Žiadosť o prijatie zmien vyberte možnosť Squash a zlúčiť a zlúčte aktualizovaný súbor riešenia do svojej hlavnej vetvy. Môžete odstrániť aj to, ktoré je teraz zlúčené do hlavnej.

    Otvorte požiadavku na stiahnutie pre novú vetvu, zobrazte zmeny a zlúčte ju s predvolenou vetvou

  15. Postupujte podľa krokov uvedených v časti Otestovanie vydania do produkčného pracovného postupu a vytvorte nové vydanie a overte, či je aktualizované riešenie nasadené do vášho produkčného prostredia.

Blahoželáme, úspešne ste nastavili vzorový pracovný postup CI/CD pomocou GitHub akcií!

Pozrite tiež

Automatizujte svoj pracovný postup od nápad až po produkciu