← Cloudflare Pages / pages / configuration

Image sestavení

Prostředí pro sestavení Cloudflare Pages podporuje širokou škálu jazyků, například Ruby, Node.js, Python, PHP a Go.

Pokud potřebujete použít konkrétní verze jazyka (například Node.js nebo Ruby) můžete zadat poskytnutím přidružené proměnné prostředí v konfiguraci sestavení, nebo nastavením příslušného souboru ve svém zdrojovém kódu.

V následujících tabulkách si prohlédněte předinstalované verze jazyků a nástrojů obsažených v buildovacím image Cloudflare Pages a proměnné prostředí a/nebo soubory dostupné pro přepsání předinstalované verze:

Chcete-li použít konkrétní verzi frameworku, uveďte ji v konfiguračním souboru správce balíčků daného projektu. Pokud používáte například Gatsby, váš package.json by měl obsahovat následující:

"dependencies": {
	"gatsby": "^5.13.7",
}

Jakmile se spustí vaše sestavení, pokud ještě není v mezipaměti, nainstaluje se verze 5.13.7 Gatsby pomocí npm install.

Chcete-li v systému sestavení přepsat výchozí verze jazyků a nástrojů, můžete požadovanou verzi nastavit buď pomocí proměnných prostředí, nebo přidáním souborů do projektu.

Chcete-li nastavit verzi pomocí proměnných prostředí, můžete:

1. Název proměnné prostředí pro daný jazyk nebo nástroj najdete v tato tabulka.
2. Proměnnou prostředí přidejte na dashboardu tak, že přejdete do Nastavení > Proměnné prostředí ve svém projektu Pages, nebo přidejte proměnnou prostředí přes Wrangler.

Nebo pokud chcete nastavit verzi přidáním souboru do projektu, můžete:

1. Název souboru pro daný jazyk nebo nástroj najdete v tato tabulka.
2. Zadaný název souboru přidejte do kořenového adresáře projektu a jako obsah souboru zadejte požadované číslo verze.

Pokud jste se dříve spoléhali na výchozí verzi Node.js v sestavovacím systému v1, při přechodu na v2 musíte určit, že potřebujete Node.js 12.18.0 nastavením NODE_VERSION = 12.18.0 proměnnou prostředí nebo přidáním .node-version nebo .nvmrc soubor do vašeho projektu s 12.18.0 přidán jako obsah souboru.

Můžete přidat následující proměnnou prostředí, čímž vypnete automatickou instalaci závislostí, a místo ní spustit vlastní instalační příkaz.

Systém sestavení v3 aktualizuje výchozí nástroje, knihovny a jazyky na jejich LTS verze, platné k květnu 2025.

Chcete-li přejít na tuto novou verzi, nakonfigurujte nastavení projektu Pages v dashboardu:

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

   Přejděte na Workers & Pages ↗

2. Vyberte svůj projekt Pages.

3. Přejděte na Deployments > Všechna nasazení > a vyberte nejnovější verzi.

Pokud jste se dříve spoléhali na výchozí verze jazyků nebo nástrojů v systému sestavení, může sestavení při migraci na v3 selhat. Chcete-li to opravit, musíte zadat verzi, kterou chcete použít, pomocí přepsání výchozí verze.

Při použití build systému v3 nejsou v současné době podporovány tyto funkce:

• Zadávání verzí Node.js pomocí kódových názvů (například hydrogen nebo lts/hydrogen).
• Detekce verze Yarn z yarn.lock verzi souboru.
• Detekce verze pnpm na základě pnpm-lock.yaml verzi souboru.
• Detekce Node.js a správců balíčků z package.json -> "engines".
• pipenv a Pipfile podpora.

Sestavení Cloudflare Pages probíhají v gVisor ↗ kontejner.

Pokud aktuálně používáte image sestavení v1 nebo v2, váš projekt bude automaticky přesunut na v3:

• sestavovací image v1: Pokud používáte sestavovací image Pages v1, váš projekt bude automaticky přesunut na v3 dne 15. září 2026.
• sestavovací image v2: Pokud používáte sestavovací image Pages v2, váš projekt bude automaticky přesunut na v3 dne 23. února 2027.

Před datem ukončení podpory obdržíte 6měsíční upozornění prostřednictvím Cloudflare Changelog ↗, oznámení na dashboardu a e-mailem.

Sestavovací image v3 bude od nynějška průběžně dostávat aktualizace předinstalovaného softwaru podle níže uvedených zásad. Verze sestavovacího image se dále měnit nebude.

Předinstalovaný software (jazyky a nástroje) bude aktualizován před dosažením konce podpory (EOL). Tyto aktualizace se použijí pouze v případě, že jste výchozí verze byla přepsána.

• Aktualizace vedlejší verze: Může být bez upozornění aktualizováno na nejnovější dostupnou minor verzi. U nástrojů, které nedodržují sémantické verzování (například Bun nebo Hugo), budou aktualizace, jež mohou obsahovat změny nekompatibilní se zpětnou verzí, oznámeny 3 měsíce předem.
• Aktualizace hlavních verzí: Aktualizováno na další stabilní verzi s dlouhodobou podporou (LTS), a to s předstihem 3 měsíců.

Jak budete informováni (u změn vyžadujících oznámení):

• Cloudflare Changelog ↗
• Oznámení v dashboardu pro projekty, které obdrží aktualizaci
• E-mailová oznámení pro vlastníky projektu

Chcete-li zachovat konkrétní verzi a vyhnout se automatickým aktualizacím, přepsat výchozí verzi.

Chcete-li se vyhnout neočekávaným chybám sestavení:

• Sledujte oznámení prostřednictvím Cloudflare Changelog ↗, oznámení v dashboardu a e-mail
• Plán migrace kdy dostáváte oznámení o aktualizacích
• Připnout konkrétní verze kritického předinstalovaného softwaru pomocí přepisování výchozích verzí