Sdílet prostřednictvím


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

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

  1. 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).

    Vytvoření účtu

  2. Po vytvoření účtu vytvořte úložiště výběrem Create repository (Vytvoření úložiště) nebo New (Nové).

    Vytvoření úložiště

    Zobrazí se následující alternativní cílová obrazovka:

    Vytvoření nového úložiště

  3. 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ě.

    Inicializace úložiště.

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

  1. Přejděte do svého úložiště a klikněte na Nastavení, rozbalte položku Tajemství a poté klikněte na Akce.

  2. 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í.

    Vytvoření tajného kódu instančního objektu

    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

  1. 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ě.

    Nastavení pracovního postupu.

  2. Tím se spustí nový soubor YAML se základním pracovním postupem, který vám pomůže začít s akcemi GitHubu.

    Ukázkový soubor YML

  3. 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.

    Přejmenování a nahrazení obsahu.

  4. Nahraďte <ENVIRONMENTURL> adresou URL vývojového prostředí, ze kterého chcete exportovat (například: https://poweractionsdev.crm.dynamics.com).

  5. 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í.

      Přejmenování a nahrazení obsahu

    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.

  6. 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).

    Spuštění potvrzení.

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

  1. 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.

    Spusštění pracovního postupu.

  2. Po 5–10 sekundách se pracovní tok spustí a vy můžete vybrat běžící pracovní postup pro sledování průběhu.

    Zobrazení pracovního postupu pomocí kliknutí.

    Výběr a zobrazení pracovního postupu.

  3. 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.

  4. Vyberte větev, která byla vytvořena akcí.

  5. 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í.

  6. 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.

  7. 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.

    Zobrazení větví

  8. 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í
  1. Přejděte na Akce a vyberte Nový pracovní postup.

    Vytvoření nového pracovního postupu.

  2. Zvolte setup a workflow yourself (Sám nastavím pracovní postup).

    Nastavení pracovního postupu.

  3. 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.

    Přejmenujte a vložte kód.

  4. Potvrďte změny. Vyberte Spustit potvrzení a poté přidejte název a popis (volitelně). Dále vyberte Potvrdit nový soubor.

    Potvrzení změn.

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í.

  1. Přejděte na Akce a vyberte Nový pracovní postup.

    Vytvoření nového pracovního postupu.

  2. Vyberte Nastavit pracovní postup samostatně.

    Nastavení pracovního postupu.

  3. 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.

    Přejmenujte a vložte kód.

  4. Aktualizujte následující proměnné v novém souboru pracovního postupu:

  5. Potvrďte změny. Vyberte Spustit potvrzení a poté přidejte název (volitelně) a popis (volitelně). Dále vyberte Potvrdit nový soubor.

    Potvrzení změn.

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í.

  1. Přejde na Verze.

    Přechod k verzím.

  2. Vyberte Navrhnout novou verzi.

  3. Přidejte značku a název verze a vyberte Publikovat verzi.

  4. Volbou Akce zobrazte spuštěný pracovní postup.

    Výběr pracovního postupu k zobrazení.

  5. Výběrem spuštěného pracovního postupu zobrazte akce, které běží.

    Zobrazení pracovního postupu.

  6. Počkejte na dokončení jednotlivých akcí.

    Zobrazení větve.

  7. 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í.

  1. 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í.

    Úprava řešení.

  2. Vyberte a zobrazte kartu Žádost o volno.

    Zobrazit tabulku.

  3. Klikněte na + Přidat sloupec a vytvořte nový sloupec, jak je znázorněno na obrázku níže.

    Přidejte sloupec.

    Aktualizované hodnoty polí:**

    • zobrazované jméno: Schváleno
    • Typ dat: Ano/Ne
  4. Klikněte na tlačítko Hotovo.

  5. Klikněte na Uložit tabulkuPřidejte sloupec.

  6. Přejděte zpět na kartu Akce úložišť GitHub, vyberte Spustit pracovní postup a vyberte tlačítko Spustit pracovní postup.

    Spuštění pracovního postupu.

  7. 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.

    Výběr pracovního postupu.

    Zobrazení pracovního postupu.

  8. Po dokončení pracovního postupu přejděte do nové větve výběrem Code (Kód) a pak Branches (Větve).

    Přechod na větev.

  9. 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í.

  10. Přidejte název (volitelné) a poté klikněte na Vytvořit požadavek na sloučení.

  11. Po aktualizaci obsahu klepněte na kartu Soubory změněny.

  12. 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.

  13. 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í.

  14. 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í.

    Otevřete požadavek na sloučení pro novou větev, zobrazte změny a slučte do výchozí větve

  15. 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í.

Gratulujeme, úspěšně jste nastavili ukázkový pracovní postup CI/CD pomocí akcí GitHubu!

Viz také

Automatizujte svůj pracovní postup od nápad až po produkci