Jak využívat akce GitHubu pomocí 4D

Váš projekt je nyní v systému správy zdrojů. To znamená, že správa několika verzí softwaru, sledování změn a integrace oprav nebo nových funkcí je nyní mnohem jednodušší.

Proč nevyužít také kontinuální integraci?

Počínaje verzí 4D v19 můžete spustit kompilaci svého projektu pomocí příkazu. Díky tomu máte nyní k dispozici všechny stavební prvky potřebné k automatizaci integračního řetězce.

V tomto příspěvku na blogu najdete příklad automatizace pomocí správce GitHub a GitHub Actions.

Co je to akce GitHub?

Akce GitHub umožňují automatizovat úlohy. Jsou spouštěny událostmi, jako je například odeslání kódu.

Proč akce GitHub?

Automatizace pracovních postupů je v dnešním světě vývoje softwaru nutností. Vývojové týmy používají servery CI/CD k automatizaci procesů kontinuální integrace a nasazení (CI/CD) v životním cyklu softwaru.

Akce GitHub Actions umožňují uživatelům sestavovat, testovat a doručovat kód přímo z GitHubu bez použití externího serveru, jako je Jenkins nebo TeamCity. GitHub hostuje virtuální stroje v operačních systémech Linux, Windows a MacOS.

Jak používat GitHub Actions?

Je třeba vytvořit pracovní postup. Pracovní postup je automatizovaný postup, který přidáte do svého úložiště. Na kartě akce si můžete vybrat jeden z katalogu pracovních postupů nebo si vytvořit vlastní.

V tomto příkladu použijeme „jednoduchý pracovní postup“ navržený službou Github:

Tím se vytvořil skript ve složce „.github/workflows“ našeho úložiště. V tomto skriptu můžete definovat:

• spouštěcí událost: při push/pull/schedule
• operační systém virtuálního počítače:runs-on
• …

Další podrobnosti o syntaxi a možnostech naleznete v dokumentaci GitHub.

Dále změníme soubor README.md v našem úložišti, který spouští pracovní postup. Na kartě akce je změna viditelná, pracovní postup je ve frontě:

Voilà! Skript byl spuštěn.

Nyní máme přístup k informacím o operačním systému a použitém virtuálním počítači a kontrolujeme, zda odpovídá konfiguraci, kterou jsme požadovali.

Nyní jsou viditelné všechny protokoly našeho skriptu:

Konkrétní příklad

Nyní, když jsme si ukázali, jak vytvořit a nastavit akce GitHub, uvádíme pracovní postup vytvořený Ericem Marchandem.

Eric je jedním z vývojářů našeho týmu 4D pro iOS. Vytvořil několik akcí git pro vlastní potřebu, které používá na serveru GitLab pro naše soukromé repozitáře a na serveru GitHub pro veřejný repozitář.

Zde je příklad, jak zkompilovat projekt a publikovat verzi na GitHubu:

Nejprve máme projekt 4D se sdíleným kódem, který kompiluje další projekty předané v parametrech při spuštění (pomocí skriptu bash na běhovém systému macOS). Tento projekt převádí chyby kompilace do formátu protokolu GitHub. Ten je uložen v úložišti Github obsahujícím akce, jako je kompilace, generování vydání atd. Tyto akce pak lze použít v jakémkoli jiném projektu.

Zadruhé, abychom mohli projekt spustit, a tedy vyvolat akci, jako je kompilace, musíme spustit aplikaci 4D. Aplikace 4D je k dispozici ke stažení na serveru. Je třeba ji nainstalovat a spustit na serverech GitHub. Pro každý projekt je třeba přidat klíč SERVER_URL do parametru„Action Secret“ v úložišti.

Nakonec ve svých projektech vytvoříte pracovní postupy spouštěné požadavkem na stažení, který zavolá pracovní postup „build“ vašeho úložiště „centralizované akce“.

Najděte úložiště se základními a různými pracovními postupy a příklad jeho integrace do projektu.

Dejte nám vědět, co si o tom myslíte, a zapojte se do konverzace na fóru 4D!