Как задать версию Node.js, Python, Go или Ruby

Когда lizardpack собирает ваш проект, Lizard (lizard.build) берёт версию рантайма из файлов проекта: .nvmrc или engines.node для Node.js, .python-version или requires-python для Python, строку go в go.mod для Go и .ruby-version или строку ruby в Gemfile для Ruby. Чтобы сменить версию, поправьте этот файл и запустите деплой заново. Если такого файла нет, Lizard использует Node.js 22, Python 3.13, Go 1.24 или Ruby 3.4.

Статус тестов: 2026-10-12 мы проверили каждое правило на этой странице, запустив на тестовых проектах планировщик сборки lizardpack, который используют сборщики Lizard.

Где Lizard ищет версию

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

Эти файлы учитываются, только когда Dockerfile пишет lizardpack. См. когда Lizard игнорирует файлы версий.

Смена версии Node.js

echo 24 > .nvmrc
lizard up --service web

Для GitHub-сервиса вместо этого закоммитьте файл и сделайте push. Правила:

• Пишите число: 24, v24 и 24.1.0 выбирают Node.js 24. Строки, которые начинаются с #, Lizard пропускает.
• Значения lts/* и node в .nvmrc Lizard пропускает и переходит к следующему файлу. Другие псевдонимы, например lts/iron, он берёт как есть, и сборка падает.
• .nvmrc имеет приоритет над engines.node.
• engines.node даёт нижнюю версию своего диапазона: >=18 собирается на Node.js 18, а ^20.11.0 использует Node.js 20. Диапазон с ||, например 18 || 20, ломает сборку.

Смена версии Python

echo 3.12 > .python-version
lizard up --service web

• В .python-version должен быть номер версии, например 3.12 или 3.12.4. Строки, которые начинаются с #, Lizard пропускает. Другие значения, например pypy3.10, он тоже пропускает и переходит к следующему файлу.
• requires-python = ">=3.11" собирается на Python 3.11, нижней версии диапазона.
• Диапазон с верхней границей, например ">=3.11,<3.14", даёт имя образа, которого не существует, и сборка падает. Добавьте файл .python-version: у него приоритет.
• runtime.txt не читается.

Смена версии Go

go mod edit -go=1.25
lizard up --service api

Lizard читает только строку go. Строку toolchain он не читает.

Смена версии Ruby

echo 3.4.1 > .ruby-version
lizard up --service web

Укажите только номер версии. rails new записывает ruby-3.4.1, а Lizard не убирает префикс ruby-, поэтому сборка падает. Строка в Gemfile вроде ruby "~> 3.3.0" собирается на Ruby 3.3. Приложение Rails, которое сохранило сгенерированный Dockerfile, берёт версию из этого файла; см. Развёртывание приложения Rails.

Когда Lizard игнорирует файлы версий

• Ваш собственный Dockerfile. Версию определяет его строка FROM, например FROM node:24-slim. См. Развёртывание Docker-контейнера из Dockerfile.
• Команда сборки или запуска у сервиса. Тогда Lizard пишет Dockerfile из команд на фиксированном образе: node:22-alpine, python:3.13-slim или golang:1.24-alpine, в зависимости от первого слова команды. Чтобы вернуться к файлам версий, очистите обе команды:

lizard service set web --set buildCommand= --set startCommand=

Очистка buildCommand у работающего сервиса сама запускает пересборку. Проверьте lizard events, прежде чем выполнять lizard redeploy, чтобы не поставить в очередь вторую сборку. См. порядок выбора сборки.

Как узнать, какую версию использовала сборка

lizard logs --build --service web

В логе сборки указан базовый образ, например node:24-slim или python:3.12-slim. Чтобы проверить версию во время выполнения, выводите её при запуске приложения, например process.version в Node.js или sys.version в Python, и читайте lizard logs --service web.

См. также

• Конвейер сборки
• Развёртывание приложения Node.js
• Развёртывание приложения Go
• Развёртывание приложения Streamlit
• Развёртывание FastAPI
• Развёртывание Django

Обновлено 12 октября 2026 г.