← Cloudflare Pages / pages / configuration / git-integration

Integrace GitLab

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

Integrace Cloudflare s GitLabem nabízí víc než jen automatická nasazení: umožňuje vám sledovat, spravovat a prohlížet náhledy nasazení přímo v GitLabu, 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.

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 GitLabu přes Stav commitu GitLab ↗.

Stavy zobrazíte výběrem ikony stavu vedle commitu, nebo na stránce Sestavit > Pipelines ve vašem repozitáři GitLab. V příkladu níže můžete kliknutím na zelené zaškrtnutí zobrazit výsledky kontroly.

Kontrolní běhy se ve vašem repozitáři zobrazí následovně. Kliknutím na jeden ze stavů zobrazíte URL náhledu pro dané nasazení.

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 GitLabu můžete nasadit do Cloudflare Workers pomocí aplikace Cloudflare Pages.

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

Když autorizujete přístup Cloudflare Pages k vašemu účtu GitLab, automaticky tím Cloudflare Pages udělíte přístup i k organizacím, skupinám a jmenným prostorům, ke kterým má váš účet GitLab přístup. Správu přístupu k těmto organizacím a skupinám zajišťuje GitLab.

Přístup Cloudflare Workers k vašemu účtu GitLab můžete odebrat na stránce stránka Authorized Applications ↗ na GitLabu. Najděte aplikace s názvem Cloudflare Workers a vyberte Odvolat a odeberte přístup.

Mějte na paměti, že aplikace Cloudflare Workers pro GitLab je sdílená mezi projekty Workers a Pages. Odebráním přístupu ke GitLabu zakážete nová sestavení pro Workers i Pages, ale vaše předchozí nasazení bude Cloudflare Pages hostovat i nadále.

Pokud narazíte na problémy související s integrací Git, jedním z možných kroků řešení potíží je odinstalovat a znovu nainstalovat aplikaci GitHub nebo GitLab spojenou s instalací Cloudflare Pages.

1. Stránku s nastavením aplikace na GitLabu najdete zde: https://gitlab.com/-/profile/applications ↗
2. Vyberte Odvolat tlačítko ve vaší instalaci Cloudflare Pages, pokud existuje.
3. Vraťte se zpět na Workers & Pages přehledové stránce na https://dash.cloudflare.com/[YOUR_ACCOUNT_ID]/workers-and-pages. Vyberte Vytvoření aplikace > Pages > Připojte se ke Gitu.
4. Vyberte GitLab kartu nahoře a vyberte + Add account a vyberte účet GitLab, který chcete přidat, a poté vyberte Autorizovat v modálním okně s názvem "Authorize Cloudflare Pages to use your account?".
5. Budete přesměrováni na stránku vytvoření projektu s vaším účtem nebo organizací GitLab v seznamu účtů.
6. Zkuste vytvořit nové nasazení projektu, které dříve selhávalo.