Python + FastAPI + PostgreSQL + Redis
FastAPI é um framework moderno para construir APIs em Python. Valida os dados de entrada e saída a partir das anotações de tipo, gera documentação interativa OpenAPI automaticamente e roda sobre ASGI, então suporta código assíncrono de forma nativa.
Este Stack acompanha com PostgreSQL e Redis: a combinação típica para uma API que persiste dados e precisa de cache ou tarefas em segundo plano.
Serviços incluídos
Além da sua aplicação, o Stack sobe PostgreSQL, Redis, 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
│ ├── main.py
│ └── requirements.txt
├── backup
│ └── backup-runner.sh
├── nginx
│ └── default.conf
├── .env.example
├── app.Dockerfile
└── compose.yaml
Primeira execução
Instale o Stack e inicie-o:
docker-deploy-stack --stack python/fastapi-postgres-redis
cd /root/stack/python/fastapi-postgres-redis
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-despliego-una-aplicacion-en-un-stack.md. Seu código vai na pasta app/.
Cada vez que atualizar o código, aplique as alterações:
docker compose up -d --build
Configuração
Os valores editáveis estão no arquivo .env do Stack:
| Variável | Padrão | Para que serve |
|---|---|---|
APP_PORT |
80 |
Porta pública do Stack. |
APP_ENV |
development |
Ambiente da aplicação. |
DB_NAME |
fastapi |
Nome do banco de dados. |
DB_USER |
fastapi |
Usuário do banco de dados. |
BACKUP_ENABLED |
1 |
Backups automáticos: 1 ativados, 0 desativados. |
BACKUP_INTERVAL_SECONDS |
86400 |
Intervalo em segundos entre backups. |
BACKUP_RETENTION_DAYS |
7 |
Quantos dias os backups são mantidos. |
POSTGRES_VERSION |
16-alpine |
Versão da imagem correspondente. |
REDIS_VERSION |
7-alpine |
Versão da imagem correspondente. |
Depois de alterar, aplique as alterações 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 ao vivo
docker compose restart # reiniciar os serviços
docker compose down # parar e remover os contêineres