← Cloudflare Pages / pages / configuration

Konfigurace sestavení

Cloudflare Pages můžete sdělit, jak se má váš web sestavit a kde se budou nacházet jeho výstupní soubory.

Příkazy a adresáře sestavení

Měli byste zadat příkaz sestavení, kterým sdělíte Cloudflare Pages, jak sestavit vaši aplikaci. U projektů, které zde nejsou uvedeny, si přečtěte dokumentaci daného nástroje nebo frameworku a zvažte odeslání pull requestu, kterým je sem doplníte.

Adresář sestavení určuje, kam příkaz sestavení vašeho projektu ukládá sestavenou verzi vašeho webu Cloudflare Pages. Často se ve výchozím nastavení používá zavedený standard public, ale možná zjistíte, že je potřeba si jej přizpůsobit.

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é. Pages určuje, zda bylo sestavení úspěšné nebo neúspěšné, podle návratového kódu sestavovacího příkazu zadaného uživatelem. Jakýkoli nenulový návratový kód způsobí, že sestavení bude označeno jako neúspěšné. Návratový kód 0 způsobí, že sestavení Pages bude označeno jako úspěšné a assety se nahrají bez ohledu na to, zda se chybové protokoly zapisují do standardního chybového výstupu.

Adresář sestavení se vygeneruje pomocí příkazu sestavení. Každý framework má vlastní konvenci pojmenování, například výstupní adresář 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ů.

Přednastavení frameworků

Cloudflare udržuje seznam konfigurací sestavení pro oblíbené frameworky a nástroje. Tento seznam je dostupný při vytváření projektu. Níže najdete standardní příkazy a adresáře pro sestavení oblíbených frameworků a nástrojů.

Pokud nepoužíváte předvolbu, použijte exit 0 jako Příkaz sestavení.

Framework/nástroj	Příkaz sestavení	Adresář sestavení
React (Vite)	`npm run build`	`dist`
Gatsby	`npx gatsby build`	`public`
Next.js (statický export HTML)	`npx next build`	`out`
Nuxt.js	`npm run build`	`dist`
Qwik	`npm run build`	`dist`
Remix	`npm run build`	`build/client`
Svelte	`npm run build`	`public`
SvelteKit	`npm run build`	`.svelte-kit/cloudflare`
Vue	`npm run build`	`dist`
Analog	`npm run build`	`dist/analog/public`
Astro	`npm run build`	`dist`
Angular	`npm run build`	`dist/cloudflare`
Brunch	`npx brunch build --production`	`public`
Docusaurus	`npm run build`	`build`
Elder.js	`npm run build`	`public`
Eleventy	`npx @11ty/eleventy`	`_site`
Ember.js	`npx ember-cli build`	`dist`
GitBook	`npx gitbook-cli build`	`_book`
Gridsome	`npx gridsome build`	`dist`
Hugo	`hugo`	`public`
Jekyll	`jekyll build`	`_site`
MkDocs	`mkdocs build`	`site`
Pelican	`pelican content`	`output`
React Static	`react-static build`	`dist`
Slate	`./deploy.sh`	`build`
Umi	`npx umi build`	`dist`
VitePress	`npx vitepress build`	`.vitepress/dist`
Zola	`zola build`	`public`

Proměnné prostředí

Pokud váš projekt při sestavení webu využívá proměnné prostředí, můžete zadat vlastní proměnné prostředí:

V dashboardu Cloudflare přejděte na Workers & Pages stránce.
Přejděte na Workers & Pages ↗
Vyberte svůj projekt Pages.
Vyberte Nastavení > Proměnné prostředí.

Následující proměnné systémového prostředí se ve výchozím nastavení vkládají automaticky (lze je ale přepsat):

Proměnná prostředí	Vložená hodnota	Příklad případu použití
`CI`	`true`	Změna chování buildu při spuštění v CI oproti lokálnímu spuštění
`CF_PAGES`	`1`	Odlišné chování sestavení při spuštění na Pages a lokálně
`CF_PAGES_COMMIT_SHA`	`<sha1-hash-of-current-commit>`	Předávání aktuálního ID commitu do nástroje pro hlášení chyb, například Sentry
`CF_PAGES_BRANCH`	`<branch-name-of-current-deployment>`	Přizpůsobení sestavení podle větve, například vypnutí ladicího protokolování na `production`
`CF_PAGES_URL`	`<url-of-current-deployment>`	Umožnění nástrojům sestavení zjistit URL adresu, na které bude stránka nasazena