Fazer deploy de um app Nest

Você pode encontrar o guia passo a passo para fazer deploy aqui.

Build da aplicação

A Hostman utiliza o seguinte ambiente ao fazer o build de um app Nest:

• Node.js: 20, 22 ou 24
• npm
• yarn

O app sempre é buildado a partir da raiz do repositório, então certifique-se de colocar o package.json lá. Se o arquivo estiver em um subdiretório (ex.: landing), será necessário ajustar o comando de build. Por exemplo:

npm run --prefix landing build

Se o projeto tiver package.json e usar yarn, executamos:

apt remove -y cmdtest yarn
npm install --global yarn
cd /<DIRETÓRIO> && yarn install --check-files

Nos outros casos em que o package.json estiver presente:

cd /<DIRETÓRIO> && npm install

<DIRETÓRIO> é o caminho até o diretório com o package.json. Na maioria dos casos, é a raiz do projeto.

Rodando a aplicação

O comando de start padrão é:

npm run start:prod

Certifique-se de que o comando start:prod está definido na seção scripts do package.json. Por exemplo:

"scripts": {
  "start:prod": "node dist/main.js"
}

Troubleshooting

Deploy falhou

Se houver problemas no deploy, primeiro confira o log de deploy. Ele ajuda a identificar em qual etapa ocorreu o erro.

Na maioria dos casos, os problemas estão relacionados ao comando de start. Certifique-se de que todos os módulos necessários estão listados no package.json.

Please add build instructions to your script section in package.json

O problema é que o comando npm run build acessa o arquivo package.json, e se o valor da diretiva build não estiver especificado, ocorre um erro.

Para corrigir isso, adicione as diretivas necessárias na seção scripts do package.json. Leia mais sobre o uso de scripts aqui.