← Cloudflare Workers / workers / ci-cd / builds
Image sestavení
Workers Builds používají build image s podporou řady jazyků a nástrojů, jako jsou Node.js, Python, PHP, Ruby a Go.
Podporované nástroje
Workers Builds podporují řadu runtime prostředí, jazyků a nástrojů. Sestavení použijí výchozí verze uvedené níže, pokud není zjištěna nebo zadána vlastní verze. Můžete přepsat výchozí verze pomocí proměnných prostředí nebo verzovacích souborů. Všechny verze lze přepsat.
Runtime
| Nástroj | Výchozí verze | Proměnná prostředí | Soubor |
|---|---|---|---|
| Go | 1.24.3 | GO_VERSION |
|
| Node.js | 24.18.0 | NODE_VERSION |
.nvmrc, .node-version |
| Python | 3.13.3 | PYTHON_VERSION |
.python-version, runtime.txt |
| Ruby | 3.4.4 | RUBY_VERSION |
.ruby-version |
Build image má předinstalovaný Node.js 22.23.2 a 24.18.0.
Nástroje a jazyky
| Nástroj | Výchozí verze | Proměnná prostředí |
|---|---|---|
| Bun | 1.2.15 | BUN_VERSION |
| Hugo | extended_0.147.7 | HUGO_VERSION |
| npm | 10.9.2 | |
| yarn | 4.9.1 | YARN_VERSION |
| pnpm | 10.11.1 | PNPM_VERSION |
| pip | 25.1.1 | |
| gem | 3.6.9 | |
| poetry | 2.1.3 | |
| pipx | 1.7.1 | |
| bundler | 2.6.9 |
Pokročilá nastavení
Přepisování výchozích verzí
Pokud potřebujete přepsat konkrétní verze jazyka nebo nástroje v rámci image můžete zadat jako proměnná prostředí pro sestavení, nebo nastavte příslušný soubor ve svém zdrojovém kódu, jak je uvedeno výše.
Chcete-li nastavit verzi pomocí proměnných prostředí sestavení, můžete:
- Najděte název proměnné prostředí pro daný jazyk nebo nástroj a požadovanou verzi (např.
NODE_VERSION = 22) - Přidejte a uložte proměnnou prostředí v dashboardu na stránce Nastavení > Sestavit > Proměnné a tajné klíče sestavení ve vašem projektu Workers
Nebo pokud chcete nastavit verzi přidáním souboru do projektu, můžete:
- Najděte název souboru pro daný jazyk nebo nástroj (např.
.nvmrc) - Přidejte do kořenového adresáře soubor se zadaným názvem a jako jeho obsah nastavte požadované číslo verze. Pokud je například číslo verze 22, měl by soubor obsahovat '22'.
Přeskočit instalaci závislostí
Následující proměnnou sestavení můžete přidat, chcete-li zakázat automatickou instalaci závislostí a místo ní spustit vlastní instalační příkaz.
| Proměnná sestavení | Hodnota |
|---|---|
SKIP_DEPENDENCY_INSTALL |
1 nebo true |
Předinstalované balíčky
V následující tabulce si prohlédněte předinstalované balíčky v build image. Balíčky jsou nainstalovány pomocí apt, správce balíčků pro linuxové distribuce.
curl |
libbz2-dev |
libreadline-dev |
git |
libc++1 |
libssl-dev |
git-lfs |
libdb-dev |
libvips-dev |
unzip |
libgdbm-dev |
libyaml-dev |
autoconf |
libgdbm6 |
tzdata |
build-essential |
libgbm1 |
wget |
bzip2 |
libgmp-dev |
zlib1g-dev |
gnupg |
liblzma-dev |
zstd |
libffi-dev |
libncurses5-dev |
Prostředí buildu
Workers Builds se spouští v následujícím prostředí:
| Prostředí buildu | Ubuntu 24.04 |
| Architektura | x86_64 |
Zásady image buildu
Aktualizace předinstalovaného softwaru
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.
Osvědčené postupy
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
- Připnout konkrétní verze kritického předinstalovaného softwaru pomocí přepisování výchozích verzí