NodeJS + NestJS + PostgreSQL

NestJS é um framework de Node.js para construir aplicações do lado do servidor com uma arquitetura definida: módulos, controladores e provedores com injeção de dependências. Está escrito em TypeScript e é a opção habitual quando um projeto Node precisa de uma estrutura que escale com a equipe.

Este Stack o combina com PostgreSQL.

Serviços que inclui

Além da sua aplicação, o Stack levanta PostgreSQL, um nginx que recebe o tráfego na porta 80, um serviço de backups automáticos e o gerenciador de arquivos web.

Estrutura do projeto

.
├── app
│   ├── src
│   │   ├── app.controller.ts
│   │   ├── app.module.ts
│   │   ├── database.service.ts
│   │   └── main.ts
│   ├── package.json
│   └── tsconfig.json
├── backup
│   └── backup-runner.sh
├── nginx
│   └── default.conf
├── .env.example
├── app.Dockerfile
└── compose.yaml

Inicialização

Instale o Stack e inicie-o:

docker-deploy-stack --stack javascript/nestjs-postgres
cd /root/stack/javascript/nestjs-postgres
docker compose up -d

Depois substitua a aplicação de exemplo pela sua, via Git, por SFTP ou pelo gerenciador de arquivos web, seguindo como-implanto-uma-aplicacao-em-um-stack.md. Seu código fica na pasta app/.

Cada vez que atualizar o código, aplique as mudanças:

docker compose up -d --build

Configuração

Os valores editáveis estão no arquivo .env do Stack:

Depois de alterar, aplique as mudanças com docker compose up -d.

Comandos úteis

docker compose ps          # ver os contêineres que estão em execução
docker compose logs -f     # ver os logs em tempo real
docker compose restart     # reiniciar os serviços
docker compose down        # parar e remover os contêineres