INTEGRITY Dokumentace

← Cloudflare Pages / pages / get-started

Integrace Git

V tomto průvodci se seznámíte s Cloudflare Pages a nasadíte svůj první web na platformu Pages pomocí integrace s Git. Integrace s Git umožňuje automatické sestavení a nasazení při každém odeslání změny do vašeho připojeného GitHub nebo GitLab repozitáře.

Připojte poskytovatele Git k Pages

Pages nabízí podporu pro GitHub ↗ a GitLab ↗. Chcete-li vytvořit svůj první projekt Pages:

  1. V dashboardu Cloudflare přejděte na Workers & Pages stránce.

    Přejděte na Workers & Pages ↗

  2. Vyberte Vytvoření aplikace > Pages > Připojte se ke Gitu.

Budete vyzváni k přihlášení pomocí preferovaného poskytovatele Git. To umožní Cloudflare Pages nasazovat vaše projekty a aktualizovat vaše PR pomocí náhledová nasazení.

Vyberte svůj repozitář GitHub

Můžete vybrat projekt GitHub z vašeho osobního účtu nebo organizace, které jste udělili přístup Pages. Díky tomu můžete zvolit repozitář GitHub pro nasazení pomocí Pages. Podporovány jsou soukromé i veřejné repozitáře.

Vyberte svůj repozitář GitLab

Pokud používáte GitLab, můžete vybrat projekt ze svého osobního účtu nebo ze skupiny GitLab, jejímž jste členem. Díky tomu si můžete zvolit repozitář GitLab, který chcete nasadit pomocí Pages. Podporovány jsou soukromé i veřejné repozitáře.

Nastavte nasazení

Jakmile vyberete Git repozitář, vyberte Nainstalovat a autorizovat a Zahájit nastavení. Nasazení pak můžete přizpůsobit v Nastavení sestavení a nasazení.

Váš název projektu se použije k vygenerování hostname vašeho projektu. Ve výchozím nastavení odpovídá názvu vašeho projektu Git.

Produkční větev udává větev, kterou má Cloudflare Pages použít k nasazení produkční verze vašeho webu. U většiny projektů je to main nebo master větev. Všechny ostatní větve, které nejsou vaší produkční větví, se použijí pro náhledová nasazení.

Stránka Nastavení sestavení a nasazení s vyplněnými poli Project name a Production branch

Nastavte možnosti sestavení

V závislosti na frameworku, nástroji nebo projektu, který nasazujete do Cloudflare Pages, budete muset zadat příkaz pro sestavení a výstupní adresář sestavení a řekněte Cloudflare Pages, jak má web nasadit. Obsah tohoto adresáře se do Cloudflare Pages nahraje jako obsah vašeho webu.

Dashboard nabízí řadu předvoleb pro konkrétní frameworky. Tyto předvolby obsahují výchozí hodnoty příkazu sestavení a výstupního adresáře sestavení pro zvolený framework. Pokud si nejste jisti, jaké hodnoty jsou pro tuto část správné, přečtěte si Konfigurace sestavení. Pokud nepotřebujete krok sestavení, ponechte Příkaz sestavení pole prázdné.

Pole nastavení sestavení, která je potřeba vyplnit

Cloudflare Pages začíná pracovat z kořenového adresáře vašeho repozitáře. Celý proces sestavení, včetně instalačních kroků, začíná právě z tohoto místa. Pokud to chcete změnit, zadejte nové umístění kořenového adresáře pomocí Root directory (advanced) > Cesta .

Pole Root directory k vyplnění

Vysvětlení konfigurace sestavení

Příkaz sestavení poskytuje váš framework. Framework Gatsby například používá gatsby build jako build command. Pokud pracujete bez frameworku, ponechte Příkaz sestavení pole prázdné.

Výstupní adresář sestavení se vygeneruje pomocí příkazu sestavení. Každý framework má vlastní konvenci pojmenování, například adresář výstupu sestavení se nazývá /public pro řadu frameworků.

Kořenový adresář je místo, kde se nachází obsah vašeho webu. Pokud není zadán, Cloudflare předpokládá, že kořenovým adresářem je váš propojený repozitář Git. Kořenový adresář je třeba zadat v případech, jako jsou monorepa, kde se v jednom repozitáři může nacházet více projektů.

Viz Konfigurace sestavení s dalšími informacemi.

Proměnné prostředí

Proměnné prostředí jsou běžný způsob, jak předat konfiguraci do sestavovacího procesu. Při nastavování projektu můžete zadat libovolný počet dvojic klíč a hodnota jako proměnné prostředí. Ty pak můžete dále upravit poté, co se projekt poprvé úspěšně sestaví.

Viz průvodce frameworkem Hexo s dalšími informacemi o nastavení proměnné prostředí pro verzi Node.js.

Jakmile vyberete Přednastavení frameworku nebo toto pole ponechte prázdné, pokud pracujete bez frameworku, nastavili jste Root directory (advanced), a přizpůsobili jste si Environment variables (optional), jste připraveni nasadit projekt.

Vaše první nasazení

Jakmile dokončíte nastavení konfigurace sestavení, vyberte Save and Deploy. Protokoly sestavení projektu se budou zobrazovat postupně, jak Cloudflare Pages instaluje závislosti projektu, sestavuje ho a nasazuje do globální sítě Cloudflare.

Podrobnosti o nasazení v Cloudflare dashboardu

Jakmile bude nasazení projektu dokončeno, obdržíte jedinečnou URL adresu, na které si prohlédnete nasazený web.

Správa webu

Po prvním nasazení vyberte Continue to project a zobrazte konfiguraci projektu v dashboardu Cloudflare Pages. Na této stránce vidíte aktuální stav nasazení projektu, produkční URL adresu a přidružený commit i všechna předchozí nasazení.

Dashboard webu se zobrazenými prostředími a nasazeními

Odstranění projektu

Chcete-li odstranit svůj projekt Pages:

  1. V dashboardu Cloudflare přejděte na Workers & Pages stránce.

    Přejděte na Workers & Pages ↗

  2. Vyberte projekt Pages > Nastavení > Odstranění projektu.

Pokročilá nastavení projektu

V Nastavení sekci můžete nakonfigurovat pokročilá nastavení, například změnit název projektu, aktualizovat konfiguraci Git nebo upravit příkaz sestavení, adresář sestavení či proměnné prostředí.