Kurz: Automatizace nasazení řešení pomocí akcí GitHubu pro Microsoft Power Platform

Článek
03/27/2023

V tomto kurzu se dozvíte, jak:

Vytvořit nové úložiště GitHubu
Vytvořit dva pracovní postupy GitHubu pomocí akcí GitHubu pro Microsoft Power Platform

Pracovní postupy mohou automaticky exportovat vaši aplikaci (jako nespravované řešení) z vývojového prostředí, vygenerovat artefakt sestavení (spravované řešení) a nasadit aplikaci do provozního prostředí. Tento kurz používá řešení ALMLab, které jste sestavili, a prostředí, která jste vytvořili v předchozích kurzech.

Související kurzy: Začínáme a Vytvoření modelem řízené aplikace.

Vytvoření účtu GitHubu

Přejděte na https://github.com a klikněte na Sign up (Přihlásit se) nebo Start a free trial (Zahájit použití bezplatné zkušební verze) (nebo se přihlaste, pokud máte stávající účet).
Po vytvoření účtu vytvořte úložiště výběrem Create repository (Vytvoření úložiště) nebo New (Nové).

Zobrazí se následující alternativní cílová obrazovka:
Vytvořte nové úložiště a pojmenujte jej „poweractionslab“. Ujistěte se, že jste vybrali Přidat soubor README pro inicializaci úložiště a zvolte Vytvořit úložiště.

Vytvoření nového tajného kódu pro ověřování instančního objektu

Přejděte do svého úložiště a klikněte na Nastavení, rozbalte položku Tajemství a poté klikněte na Akce.
Na stránce Tajné kódy pojmenujte tajný kód „PowerPlatformSPN“. Použijte tajný kód klienta z registrace aplikace vytvořené v Microsoft Entra, zadejte jej do pole Hodnota a poté vyberte možnost Přidat tajný kód. Na tajný klíč klienta bude odkazováno v souborech YML použitých k definování pracovních toků GitHub později v tomto cvičení.

Tajný klíč klienta je nyní bezpečně uložen jako tajný kód GitHub.

Vytvoření pracovního postupu pro export a rozbalení souboru řešení do nové větve

Klikněte na Akce a klikněte na nastavit pracovní postup sami nebo klikněte na Konfigurovat v políčku Jednoduchý pracovní postup v části doporučeno pro toto úložiště.
Tím se spustí nový soubor YAML se základním pracovním postupem, který vám pomůže začít s akcemi GitHubu.
Odstraňte předem vytvořený obsah, vložte obsah ze souboru export-and-branch-solution-with-spn-auth.yml a poté přejmenujte soubor na „export-and-branch-solution“.yml.
Nahraďte <ENVIRONMENTURL> adresou URL vývojového prostředí, ze kterého chcete exportovat (například: https://poweractionsdev.crm.dynamics.com).
Aktualizujte <APPID> a <TENANT ID> na své hodnoty.
- Pokud používáte přihlašovací údaje, vložte soubor export-and-branch-solution.yml místo obsahu souboru export-and-branch-solution-with-spn-auth.yml. Nahraďte <USERNAME> uživatelským jménem, které používáte pro připojení k prostředí.
Tip

Pokud neznáte GitHub Actions a chcete se dozvědět více, podívejte se na oficiální dokumentaci na adrese https://docs.github.com/en/actions.
Nyní jste připraveni potvrdit provedené změny. Vybrat Zahájit potvrzení, zadejte Create export yml do pole názvu a poté přidejte popis (volitelný). Dále klikněte na Commit new file (Potvrdit nový soubor).

Gratulujeme, právě jste vytvořili svůj první pracovní postup GitHubu pomocí následujících akcí:

Kdo jsem: Zajišťuje, že se můžete úspěšně připojit k prostředí, ze kterého exportujete.
Exportovat řešení: Exportuje soubor řešení z vašeho vývojového prostředí.
Rozbalit řešení: Soubor řešení exportovaný ze serveru je komprimovaný (zip) soubor s konsolidovanými konfiguračními soubory. Tyto počáteční soubory nejsou vhodné pro správu zdrojového kódu, protože nejsou strukturovány tak, aby systémy správy zdrojového kódu mohly správně rozlišovat jednotlivé soubory a zachycovat změny, které chcete potvrdit. Soubory řešení musíte „rozbalit“, aby správě zdrojového kódu umožňovaly ukládání a zpracování.
Řešení větve: Vytvoří novou větev pro uložení exportovaného řešení.

Testování exportu a rozbalení pracovního postupu

Dále otestujte spuštění pracovního postupu. Přejděte na Actions (Akce), Run workflow (Spustit pracovní postup) a vyberte Run workflow (Spustit pracovní postup). Pokud máte jiný název řešení než „ALMLab“, změňte hodnotu tady, ale ostatní hodnoty nechte tak, jak jsou.
Po 5–10 sekundách se pracovní tok spustí a vy můžete vybrat běžící pracovní postup pro sledování průběhu.
Po dokončení pracovního postupu ověřte, že byla vytvořena nová větev s rozbaleným řešením ve složce solutions/ALMLab. Přejděte na kartu Kód a rozbalte větve rozbalovací nabídka.
Vyberte větev, která byla vytvořena akcí.
Ověřte, zda byla složka solutions/ALMLab vytvořena v nové větvi, a poté vytvořte požadavek na sloučení změn do hlavní větve. Klikněte na Přispět a v plovoucí nabídce klikněte na Otevřít požadavek na stažení.
Na obrazovce Otevřít požadavek na sloučení změn přidejte název a popis podle potřeby a poté klikněte na Vytvořit požadavek na sloučení změn.
Obrazovka se aktualizuje a zobrazí nově vytvořený požadavek na sloučení změn. Po vytvoření požadavku na sloučení změn bude poskytnuto potvrzení, že naše pobočka není v konfliktu s hlavní větví. Toto potvrzení znamená, že změny mohou být automaticky sloučeny do hlavní větve. Klikněte na Požadavek na sloučení a poté klikněte na Potvrdit sloučení. Volitelně klikněte na možnost Odstranit větev k vymazání již nefunkční větve.
Přejděte zpět do výchozí (hlavní) větve a ověřte, že řešení je nyní k dispozici také tam.

Vytvoření znovu použitelného pracovního postupu pro generování artefaktu sestavení a import do produkce

V této části vytvoříme další pracovní postup, který:

Vytvoří spravované řešení a publikuje jej jako artefakt GitHubu
Importuje artefakt sestavení do provozního prostředí

Přejděte na Akce a vyberte Nový pracovní postup.
Zvolte setup a workflow yourself (Sám nastavím pracovní postup).
Přejmenujte název pracovního postupu na „release-solution-to-prod-with-inputs“ a zkopírujte obsah ze souboru release-solution-to-prod-with-inputs.yml a vložte ho na obrazovku Upravit nový soubor.
Potvrďte změny. Vyberte Spustit potvrzení a poté přidejte název a popis (volitelně). Dále vyberte Potvrdit nový soubor.

Zavolání opakovaně použitelného pracovního postupu při události vydání

V této části zavoláme opakovaně použitelný pracovní postup na události vydání.

Přejděte na Akce a vyberte Nový pracovní postup.
Vyberte Nastavit pracovní postup samostatně.
Přejmenujte název pracovního postupu na „release-action-call“ a zkopírujte obsah ze souboru release-action-call.yml a vložte ho na obrazovku Upravit nový soubor.
Aktualizujte následující proměnné v novém souboru pracovního postupu:
- Nahraďte <BUILD_ENVIRONMENT> adresou URL pro prostředí sestavení, které používáte ke generování spravovaného řešení. Například: https://poweractionsbuild.crm.dynamics.com.
- Nahraďte <PROD_ENVIRONMENT> adresou URL provozního prostředí, do kterého nasazujete. Například: https://poweractionsprod.crm.dynamics.com.
- Nahraďte <APP_ID> za ID aplikace (klienta), které lze nalézt v listu registrace aplikací portálu Microsoft Azure kliknutím na registraci vytvořenou dříve v tomto kurzu.
- Nahraďte <TENANT_ID> za ID adresáře (tenanta), které lze nalézt v listu registrace aplikací portálu Microsoft Azure kliknutím na registraci vytvořenou dříve v tomto kurzu.
Potvrďte změny. Vyberte Spustit potvrzení a poté přidejte název (volitelně) a popis (volitelně). Dále vyberte Potvrdit nový soubor.

Testování pracovního postupu pro uvolnění do provozního prostředí

Nyní jste připraveni otestovat poslední pracovní postup. Tento pracovní postup se aktivuje při nasazení nové verze do provozního prostředí.

Přejde na Verze.
Vyberte Navrhnout novou verzi.
Přidejte značku a název verze a vyberte Publikovat verzi.
Volbou Akce zobrazte spuštěný pracovní postup.
Výběrem spuštěného pracovního postupu zobrazte akce, které běží.
Počkejte na dokončení jednotlivých akcí.
Po dokončení pracovního postupu se přihlaste do provozního prostředí a ověřte, že řešení bylo nasazeno jako spravované řešení.

Nasazení aktualizace a kontrola změn před uvolněním do provozního prostředí

Nyní otestujeme celý proces a poté uvidíme, jak můžeme zobrazit a ověřit změny aplikace před jejím nasazením do provozního prostředí.

Přejděte na řešení ALMLab ve svém vývojovém prostředí a vyberte Upravit nebo klikněte na zobrazovaný název řešení.
Vyberte a zobrazte kartu Žádost o volno.
Klikněte na + Přidat sloupec a vytvořte nový sloupec, jak je znázorněno na obrázku níže.

Aktualizované hodnoty polí:**
- zobrazované jméno: Schváleno
- Typ dat: Ano/Ne
Klikněte na tlačítko Hotovo.
Klikněte na Uložit tabulku
Přejděte zpět na kartu Akce úložišť GitHub, vyberte Spustit pracovní postup a vyberte tlačítko Spustit pracovní postup.
Po 5–10 sekundách se pracovní tok spustí a vy můžete kliknout na běžící pracovní postup pro sledování průběhu.
Po dokončení pracovního postupu přejděte do nové větve výběrem Code (Kód) a pak Branches (Větve).
Vyberte větev, která byla vytvořena, rozbalením možnosti přispět a klikněte na Otevřít požadavek na sloučení.
Přidejte název (volitelné) a poté klikněte na Vytvořit požadavek na sloučení.
Po aktualizaci obsahu klepněte na kartu Soubory změněny.
Všimněte si, že změny řešení jsou zvýrazněny zeleně, což znamená, že tato část souboru byla přidána ve srovnání se stejným souborem v hlavní větvi.
Přejděte zpět na kartu Konverzace. Vyberte Požadavky na sloužení a poté vyberte dříve vytvořený požadavek na sloučení.
Na stránce Požadavek na sloučení vyberte Sloučení squash, chcete-li sloučit aktualizovaný soubor řešení do vaší hlavní větve, volitelně odstranit tu, která je nyní sloučena do hlavní.
Postupujte podle pokynů v části Testování pracovního postupu pro uvolnění do provozního prostředí k vytvoření nového uvolnění a ověření, že aktualizované řešení bylo nasazeno do provozního prostředí.