← Cloudflare Pages / pages / configuration

Образ сборки

Среда сборки Cloudflare Pages широко поддерживает разные языки, такие как Ruby, Node.js, Python, PHP и Go.

Если вам нужно использовать конкретная версия языка (например, Node.js или Ruby), вы можете указать её, добавив соответствующую переменную окружения в конфигурацию сборки или создав нужный файл в исходном коде.

В следующих таблицах приведены предустановленные версии языков и инструментов, включённых в образ сборки Cloudflare Pages, а также переменные окружения и/или файлы, доступные для переопределение предустановленной версии:

Чтобы использовать определённую версию фреймворка, укажите её в конфигурационном файле менеджера пакетов проекта. Например, если вы используете Gatsby, ваш package.json должен включать следующее:

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

Когда запускается сборка, если ещё не кешируется, версия Gatsby 5.13.7 будет установлена с помощью npm install.

Чтобы переопределить версии языков и инструментов, используемые системой сборки по умолчанию, задайте нужную версию через переменные окружения или добавьте соответствующие файлы в проект.

Чтобы задать версию через переменные окружения:

1. Найдите имя переменной окружения для нужного языка или инструмента в эта таблица.
2. Переменную окружения добавьте в панели управления, перейдя в Настройки > Переменные окружения в вашем проекте Pages, или добавить переменную окружения через Wrangler.

Или, чтобы задать версию, добавив файл в проект, можно:

1. Найдите имя файла для нужного языка или инструмента в эта таблица.
2. Добавьте указанное имя файла в корневой каталог проекта, а в качестве содержимого файла укажите нужный номер версии.

Например, если раньше вы полагались на версию Node.js по умолчанию в системе сборки v1, при переходе на v2 нужно явно указать версию Node.js 12.18.0 задав NODE_VERSION = 12.18.0 переменную окружения либо добавив .node-version или .nvmrc файл в проект с помощью 12.18.0 добавлено в файл в качестве содержимого.

Чтобы отключить автоматическую установку зависимостей и вместо этого выполнить собственную команду установки, добавьте следующую переменную окружения.

Система сборки v3 обновляет инструменты, библиотеки и языки по умолчанию до LTS версий по состоянию на май 2025 года.

Чтобы перейти на эту новую версию, настройте параметры проекта Pages в dashboard:

1. На панели управления Cloudflare перейдите к разделу Workers & Pages страницу.

   Перейдите в Workers & Pages ↗

2. Выберите свой проект Pages.

3. Перейдите в Развёртывания > Все деплои > и выберите последнюю версию.

Если раньше вы полагались на версии языков или инструментов в системе сборки по умолчанию, при переходе на v3 сборка может завершиться ошибкой. Чтобы это исправить, укажите нужную версию с помощью переопределение версии по умолчанию.

При использовании системы сборки v3 в настоящее время не поддерживаются следующие функции:

• Указание версий Node.js через кодовые имена (например, hydrogen или lts/hydrogen).
• Определение версии Yarn из yarn.lock версии файла.
• Определение версии pnpm на основе pnpm-lock.yaml версии файла.
• Определение Node.js и менеджеров пакетов из package.json -> "engines".
• pipenv и Pipfile поддержка.

Сборки Cloudflare Pages выполняются в gVisor ↗ контейнер.

Если сейчас вы используете образ сборки v1 или v2, ваш проект будет автоматически перенесен на v3:

• образ сборки v1: Если вы используете образ сборки Pages v1, ваш проект будет автоматически переведён на v3 15 сентября 2026 года.
• образ сборки v2: Если вы используете образ сборки Pages v2, ваш проект будет автоматически переведён на v3 23 февраля 2027 года.

О прекращении поддержки вы получите уведомление за 6 месяцев до даты прекращения через Cloudflare Changelog ↗, уведомления в дашборде и электронная почта.

Начиная с этого момента образ сборки v3 будет получать поэтапные обновления предустановленного программного обеспечения согласно приведенной ниже политике. Дальнейших изменений версии образа сборки не будет.

Предустановленное ПО (языки и инструменты) будет обновляться до достижения конца срока поддержки (EOL). Эти обновления применяются, только если вы не версия по умолчанию переопределена.

• Обновления минорных версий: Может обновляться до последней доступной минорной версии без предупреждения. Для инструментов, не следующих семантическому версионированию (например, Bun или Hugo), об обновлениях, которые могут содержать критические изменения, будет сообщено за 3 месяца.
• Обновления мажорных версий: Обновляется до следующей стабильной версии с долгосрочной поддержкой (LTS) с уведомлением за 3 месяца.

Как вы будете уведомлены (для изменений, требующих уведомления):

• Cloudflare Changelog ↗
• Уведомления Dashboard для проектов, которые получат обновление
• Уведомления по электронной почте владельцам проекта

Чтобы сохранить определённую версию и избежать автоматических обновлений, переопределить версию по умолчанию.

Чтобы избежать неожиданных сбоев сборки:

• Отслеживайте объявления через Cloudflare Changelog ↗, уведомления в дашборде и электронную почту
• План миграции когда вы получаете уведомления об обновлениях
• Закрепить конкретные версии критически важного предустановленного ПО с помощью переопределение версий по умолчанию