Poznámka
Na prístup k tejto stránke sa vyžaduje oprávnenie. Môžete sa skúsiť prihlásiť alebo zmeniť adresáre.
Na prístup k tejto stránke sa vyžaduje oprávnenie. Môžete skúsiť zmeniť adresáre.
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
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).
Po vytvorení konta vytvorte odkladací priestor výberom položky Vytvoriť odkladací priestor alebo Nový.
Môže sa vám zobraziť nasledujúca alternatívna vstupná obrazovka:
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.
Vytvorenie nového tajného kľúča pre autentifikáciu hlavného poskytovateľa služby
Prejdite do odkladacieho priestoru a vyberte položku Nastavenia. Rozbaľte položku Secrets (Tajné kódy) a potom vyberte položku Actions (Akcie).
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.
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
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 .
Zobrazí sa nový súbor YAML so základným pracovným postupom, ktorý vám pomôže začať pracovať s GitHub akciami.
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.
Aktualizujte
<ENVIRONMENTURL>s adresou URL vývojového prostredia, z ktorého chcete exportovať (napríklad:https://poweractionsdev.crm.dynamics.com).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.
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.
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.
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
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é.
Po 5 – 10 sekundách sa spustí pracovný postup. Spustením pracovného postupu môžete monitorovať priebeh.
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.Vyberte vetvu, ktorú akcia vytvorila.
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.Na obrazovke Otvorenie žiadosti o prijatie zmien pridajte podľa potreby názov a popis, potom vyberte položku Vytvoriť žiadosť o prijatie zmien.
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.
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
Prejdite do časti Akcie a vyberte položku Nový pracovný postup.
Vyberte si možnosť nastaviť pracovný postup.
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 .
Potvrďte zmeny. Vyberte Spustiť potvrdenie a potom pridajte názov a popis (voliteľné). Potom vyberte Potvrdiť nový súbor.
Zavolajte opakovane použiteľný pracovný postup pri udalosti vydania
V tejto časti zavoláte opätovne použiteľný pracovný postup udalosti vydania.
Prejdite do časti Akcie a vyberte položku Nový pracovný postup.
Vyberte nastaviť pracovný postup svojpomocne.
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 .
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.
- Aktualizujte
Potvrďte zmeny. Vyberte Spustiť potvrdenie a potom pridajte názov (voliteľné) a popis (voliteľné). Potom vyberte Potvrdiť nový súbor.
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.
Prejdite do časti Vydania.
Vyberte Koncept nového vydania.
Pridajte značku vydania, názov a vyberte Zverejniť vydanie.
Vyberte Akcie na zobrazenie bežiaceho pracovného postupu.
Vyberte prebiehajúci pracovný postup, aby ste zobrazili prebiehajúce akcie.
Počkajte na dokončenie každej akcie.
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.
Prejdite do riešenia ALMLab vo vašom vývojárskom prostredí a vyberte položku Upraviť alebo vyberte zobrazovaný názov riešenia.
Vyberte a zobrazte tabuľku Žiadosť o voľno.
Vyberte položku + Pridať stĺpec a vytvorte nový stĺpec tak, ako je to znázornené na nasledujúcom obrázku.
Aktualizované hodnoty polí:**
- Zobrazovaný názov: Schválené
- Typ údajov: Áno/Nie
Vyberte položku Hotovo.
Vyberte Uložiť tabuľku.
Vráťte sa do svojho GitHub odkladacích priestorov Karta Akcie, vyberte položku Spustiť pracovný postup a vyberte tlačidlo Spustiť pracovný postup.
Po 5 – 10 sekundách sa spustí pracovný postup. Vyberte spustený pracovný postup na monitorovanie jeho priebehu.
Po dokončení pracovného postupu prejdite na novú vetvu výberom položiek Kód a Potom Vetvy.
Vyberte vetvu, ktorú ste vytvorili rozbalením položky Prispieť a vyberte možnosť Otvoriť žiadosť o prijatie zmien.
Pridajte názov (voliteľné) a potom vyberte položku Vytvoriť žiadosť o prijatie zmien.
Po aktualizácii obsahu vyberte kartu Súbory zmenené .
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.
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.
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.
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í!