← Cloudflare Pages / pages / configuration / git-integration

Integrace GitHub

Každý projekt Cloudflare Pages můžete propojit s repozitářem GitHub a Cloudflare bude automaticky nasazovat váš kód pokaždé, když do některé větve odešlete (push) změnu.

Integrace Cloudflare s GitHubem nabízí víc než jen automatická nasazení: umožňuje vám sledovat, spravovat a prohlížet náhledy nasazení přímo v GitHubu, takže máte přehled, aniž byste museli opustit svůj pracovní postup.

Pages ve výchozím nastavení nastaví vaši produkční prostředí do větve, kterou odešlete jako první. Pokud je to jiná větev než výchozí (např. main) představuje produkční větev vašeho projektu, přejděte do Nastavení > Builds > Řízení větví, změňte produkční větev kliknutím na Produkční větev rozbalovací nabídku a vyberte jakoukoli jinou větev.

Můžete také použít náhledová nasazení a prohlédněte si verze projektu ještě před sloučením do produkční větve a nasazením do produkce. V Pages můžete nastavit, které z vašich náhledových větví se automaticky nasazují pomocí ovládací prvky sestavení větví. Chcete-li provést konfiguraci, přejděte na Nastavení > Builds > Řízení větví a vyberte možnost v části Náhledová větev. Použijte Vlastní větve a určete větve, které chcete zahrnout do automatických preview nasazení nebo z nich vyloučit.

Pokaždé, když ve svém repozitáři na GitHubu otevřete nový pull request, Cloudflare Pages vytvoří jedinečnou náhledovou adresu URL, která se bude aktualizovat s každým dalším commitem do dané větve. Náhledové adresy URL se nevytvářejí pro pull requesty vytvořené z forků vašeho repozitáře. Více informací najdete v Náhledová nasazení.

Bez nutnosti jakékoli konfigurace můžete nasazení podle potřeby jednorázově přeskočit. Přidáním [CI Skip], [CI-Skip], [Skip CI], [Skip-CI], nebo [CF-Pages-Skip] příznak jako předponu v commit zprávě, Pages dané nasazení vynechá. Na velikosti písmen v předponách nezáleží.

Pokud máte k repozitáři připojený jeden nebo více projektů (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 následujícím příkladu můžete kliknutím na zelenou fajfku zobrazit výsledky kontroly.

Kontrolní běhy se ve vašem repozitáři zobrazí následovně.

Pokud se sestavení z libovolného důvodu přeskočí (například kvůli CI Skip, sledovaným cestám sestavení nebo ovládacím prvkům nasazení větví), nezobrazí se kontrolní běh ani stav commitu.

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

Projekty ze své firmy nebo vedlejšího projektu můžete nasadit na Cloudflare Pages jak z GitHub, tak z GitLab.

Při autorizaci přístupu Cloudflare Pages k účtu GitHub můžete zvolit přístup ke svému osobnímu účtu nebo k organizaci, jejímž jste členem na GitHubu. Aby bylo možné instalaci Cloudflare Pages do dané organizace přidat, musí mít váš uživatelský účet roli vlastníka nebo 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 Pages k vašemu repozitáři nebo účtu GitHub můžete odebrat v 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 zakážete nová sestavení pro projekty Workers a Pages, které byly připojené k daným repozitářům. Vaše předchozí nasazení ale bude Cloudflare Workers hostovat i nadále.

Pokud se zobrazují chyby, kdy Cloudflare Pages nemá přístup k vašemu repozitáři git, zkuste odinstalovat a znovu nainstalovat aplikaci GitHub přidruženou k instalaci Cloudflare Pages.

1. Přejděte na stránku nastavení instalace na GitHubu:
   • Přejděte na Settings > Builds pro projekt 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.