Пример Fastify-приложения для деплоя доступен в нашем Гитхабе.
Сборка приложения
При сборке приложения используется следующая среда:
- Node.js: 16, 18, 20 или 22
- npm
- yarn
Сборка приложения всегда выполняется в корне репозитория, поэтому файл package.json должен быть размещён именно там. Если он находится в подкаталоге (например, landing), команду сборки необходимо изменить. Например:
npm run --prefix landing build
Если в проекте есть файл package.json и используется yarn, выполняются следующие команды:
apt remove -y cmdtest yarn
npm install --global yarn
cd /<DIRECTORY> && yarn install --check-files
Во всех остальных случаях при наличии package.json:
cd /<DIRECTORY> && npm install
<DIRECTORY> — путь к каталогу, в котором находится package.json. В большинстве случаев это корень проекта.
Для запуска по умолчанию используется команда:
npm run start
Убедитесь, что в разделе scripts вашего package.json определена команда start. Пример:
"scripts": {
"start": "fastify start -l info app.js"
}
Устранение неполадок
Не удается выполнить развертывание
Если с развертыванием возникают проблемы, в первую очередь проверьте лог деплоя. Вы сможете определить, в какой момент что-то пошло не так.
Зачастую проблемы связаны с командой запуска. Убедитесь, что все модули, необходимые для запуска приложения, присутствуют в файле package.json.
Please add build instruction to your script section in package.json
Проблема связана с тем, что команда сборки обращается к файлу package.json, и если значение директивы build не указано, возникает ошибка.
Чтобы ее устранить, следует добавить необходимые директивы в секцию scripts файла package.json. Подробнее об использовании scripts — здесь.