Руководства по фреймворкам
Разверните приложение на фреймворке на Lizard из исходного кода. Выберите свой фреймворк и режим рендеринга ниже, подготовьте его production-сборку, затем разверните с помощью Lizard CLI или подключите репозиторий GitHub. Серверные приложения запускают процесс; статические сайты отдают сгенерированные файлы через nginx.
Выберите фреймворк
Эти настройки описывают стандартную структуру проектов в связанных руководствах. Команды подразумевают npm для JavaScript-проектов. Пользовательские пути вывода, адаптеры и переопределения сборки могут изменить результат.
| Фреймворк | Сборка | Среда выполнения или вывод | Порт сервиса |
|---|---|---|---|
| Next.js | npm run build | next start через скрипт start | 3000 |
| Статический экспорт Next.js | npm run build | out/ через Dockerfile | 80 |
| React с Vite | npm run build | dist/ | 80 |
| Vue с Vite | npm run build | dist/ | 80 |
| Astro | npm run build | dist/ или автономный Node-адаптер | 80 статический; 3000 сервер |
| Nuxt | npm run build | node .output/server/index.mjs | 3000 |
| SvelteKit | npm run build | node build с adapter-node | 3000 |
| FastAPI | Установка Python-зависимостей | uvicorn main:app --host 0.0.0.0 --port 8000 | 8000 |
| Django | Установка Python-зависимостей | Gunicorn с вашим WSGI-модулем | 8000 |
| Docusaurus | npm run build | build/ | 80 |
| VitePress | npm run docs:build | docs/.vitepress/dist/ в этом руководстве | 80 |
| Hugo | hugo --minify | public/ | 80 |
Подготовка проекта
Выполняйте команды из директории приложения. Закоммитьте исходные файлы, конфигурацию и lockfile пакетов. Исключите .env, локальные зависимости и локальные артефакты сборки из загрузки. Node-проекты могут выбрать мажорную версию Node в .nvmrc; текущее значение по умолчанию — 22. Это выбирает мажорную версию, а не конкретный патч-релиз.
Установите Lizard CLI и войдите один раз:
npm install -g @lizard-build/cli
lizard loginВ каждом руководстве используется новый проект и сервис с именем web или api. Создайте этот сервис с помощью lizard add --service web (или api) перед первым вызовом lizard up --service. up --service выбирает существующий сервис; он не создает отсутствующий именованный сервис. Для существующего проекта проверьте lizard status --json и lizard ps --json перед развертыванием. Порт должен совпадать с процессом внутри контейнера, который должен слушать на 0.0.0.0.
Lizard CLI 0.3.95 исключает метаданные архивов macOS при загрузке. Настройка COPYFILE_DISABLE не нужна. Обновите старые версии CLI перед использованием этих руководств.
Выбор GitHub или локального источника
Команды в руководствах используют lizard up для загрузки текущей папки. Эта команда меняет существующий сервис на загрузку исходного кода. Чтобы сохранить git push to deploy, подключите GitHub и используйте настройки сборки из руководства в репозитории. Настройте порт сервиса из таблицы.
Согласованность настроек сборки
В этих руководствах используется определение через lizardpack, если не требуется Dockerfile. Существующие buildCommand или startCommand имеют приоритет над определением и Dockerfile репозитория. Проверьте порядок решений о сборке перед сменой метода сборки. Задайте скрипты в package.json, когда об этом сказано в руководстве; добавление CLI-переопределения — это другой путь сборки.
Проверка релиза
Читайте логи сборки, логи рантайма и активный URL. Проверьте внутренний маршрут, отсутствующий маршрут и любые API или form action. Процесс, открывший свой порт, может все равно отдавать сломанную страницу. Для сгенерированных сайтов используйте статические маршруты и 404, чтобы не возвращать главную страницу с HTTP 200 для любого неизвестного URL.
Поддержка рантайма не подразумевает общие кэши, постоянные локальные файлы или каждую версию фреймворка. См. ограничения, хранилище и восстановление и известные проблемы, когда ваше приложение полагается на эти функции.
См. проверенные версии и результаты в облаке для проверок развертывания от 9 сентября 2026 года и их ограничений.