← Cloudflare Workers / workers / ci-cd / builds / git-integration

Integrace GitHub

Cloudflare umožňuje propojit váš repozitář GitHub s vaším Cloudflare Workerem a při každém push změny automaticky nasadí váš kód.

Integrace Cloudflare s GitHubem nedělá jen automatické buildy a nasazení. Umožňuje také sledovat buildy přímo v GitHubu, takže máte přehled a nemusíte opouštět svůj pracovní postup.

Pokud je commit součástí pull requestu, Cloudflare k němu automaticky přidá komentář se stavem sestavení.

A URL náhledu bude k dispozici pro všechna sestavení, která provádějí wrangler versions upload. To se hodí zejména při kontrole pull requestu, protože můžete porovnat změny v kódu s aktualizovanou verzí Workeru.

Historie komentářů ukazuje všechna sestavení dokončená dříve, dokud byl PR otevřený.

Pokud máte jeden nebo více Workers propojených s repozitářem (tedy monorepo), můžete stav jednotlivých sestavení zkontrolovat v GitHubu přes Kontrolní běhy GitHub ↗.

Kontroly zobrazíte výběrem ikony stavu vedle commitu ve vašem repozitáři GitHub. V příkladu níže můžete vybrat zelenou fajfku a zobrazit tak výsledky dané kontroly.

Check runs se ve vašem repozitáři zobrazí následujícím způsobem. Můžete vybrat Podrobnosti pro zobrazení buildu (Build ID) a projektu (Script) přiřazeného ke každé kontrole.

Mějte na paměti, že při použití sledované cesty sestavení, check run vygenerují pouze projekty, které spustí build.

Projekty ze svého firemního nebo vedlejšího projektu na GitHubu můžete nasadit do Cloudflare Workers pomocí Cloudflare Workers & Pages GitHub App ↗.

Při udělování oprávnění Cloudflare Workers k přístupu k účtu GitHub můžete zvolit přístup ke svému osobnímu účtu nebo k organizaci, jejímž jste na GitHubu členem.

Chcete-li přidat instalaci Cloudflare Workers do organizace, musí mít váš uživatelský účet roli vlastníka nebo jinou odpovídající roli v rámci organizace (tedy roli GitHub Apps Manager). Více informací o těchto rolích najdete na Dokumentace GitHubu ↗.

Přístup Cloudflare Workers k vašemu repozitáři nebo účtu GitHub můžete odebrat na stránce Stránka Applications ↗ na GitHubu (pokud jste členem organizace, vyberte Switch settings context pro přístup k nastavení vaší organizace na GitHubu). Aplikace GitHub se jmenuje Cloudflare Workers and Pages a je sdílená mezi projekty Workers a Pages.

Chcete-li odebrat přístup k jednotlivému repozitáři GitHub, přejděte na Přístup k repozitáři. Vyberte Pouze vybraná úložiště možnost a nakonfigurujte, ke kterým repozitářům chcete Cloudflare umožnit přístup.

Chcete-li odebrat přístup Cloudflare Workers a Pages k celému svému účtu Git, přejděte na Odinstalujte „Cloudflare Workers and Pages“, pak vyberte Odinstalovat. Odebráním přístupu aplikaci Cloudflare Workers and Pages zrušíte přístup Cloudflare k všechny repozitáře z daného účtu GitHub. Pokud chcete pouze vypnout automatické buildy a nasazení, postupujte podle Zakázat Build instrukce.

Mějte na paměti, že odebráním přístupu ke GitHubu se zakážou nová sestavení projektů Workers a Pages, které byly s těmito repozitáři propojeny, ačkoli vaše dosavadní nasazení zůstanou i nadále hostována na Cloudflare Workers.

Pokud narazíte na problémy s integrací Git, jedním z možných kroků řešení potíží je odinstalovat a znovu nainstalovat aplikaci GitHub nebo GitLab přidruženou k instalaci Cloudflare Pages. Postup pro každého poskytovatele Git najdete níže.

1. Přejděte na stránku nastavení instalace na GitHubu:
   • Přejděte na Settings > Builds pro projekt Workers nebo Pages a vyberte Správa v části Git Repository.
   • Alternativně můžete tyto odkazy navštívit, najít instalaci Cloudflare Workers and Pages a vybrat Konfigurovat:

2. Na stránce nastavení GitHub App pro Cloudflare Workers and Pages přejděte na Odinstalujte „Cloudflare Workers and Pages“ a vyberte Odinstalovat.
3. Vraťte se zpět na Workers & Pages přehled ↗ stránce vyberte Vytvoření aplikace > Pages > Připojte se ke Gitu.
4. Vyberte + Add account a vyberte účet GitHub, který chcete přidat, a poté vyberte Nainstalovat a autorizovat.
5. Měli byste být přesměrováni na stránku pro vytvoření projektu, kde bude v seznamu účtů váš GitHub účet nebo organizace.
6. Zkuste vytvořit nové nasazení projektu, které dříve selhávalo.