Aplicações Python: Django, Flask e FastAPI.
Como os projetos Django, Flask e FastAPI são detectados e iniciados, qual ponto de entrada procuramos, arquivos estáticos, migrations e como rodar o Celery.
Um repositório com requirements.txt, pyproject.toml, Pipfile ou manage.py é um projeto Python. Reconhecemos Django, Flask e FastAPI e os iniciamos com um servidor de produção — você não precisa adicionar um.
Como é feito o build e como roda
- Python 3.11.
- Dependências —
pip install -r requirements.txt, oupip install .para umpyproject.toml. - Servidor — Django e Flask rodam no gunicorn, FastAPI no uvicorn. Nós mesmos adicionamos o servidor à instalação.
Django
- Reconhecido pelo
manage.pyou pordjangonas dependências. - O ponto de entrada é lido de
DJANGO_SETTINGS_MODULEnomanage.py—<project>.wsgi:application. - Arquivos estáticos —
python manage.py collectstaticroda durante o build. Sirva os arquivos pela própria aplicação com o WhiteNoise (adicione-o ao middleware) ou pelo armazenamento de objetos. - Migrations — o comando de release recomendado é
python manage.py migrate --noinput. Ele roda em cada deploy, antes de a nova versão receber visitantes; se falhar, a versão atual continua rodando. - Adicione o seu domínio e o endereço
rivervo.appemALLOWED_HOSTS(por exemplo, a partir de uma variável) e definaCSRF_TRUSTED_ORIGINSpara formulários em HTTPS.
Flask e FastAPI
Procuramos o arquivo que cria a aplicação — app.py, main.py, wsgi.py, application.py ou server.py — e a variável em que ela fica guardada:
# app.py
from flask import Flask
app = Flask(__name__) # → started as app:app# main.py
from fastapi import FastAPI
app = FastAPI() # → started as main:appSe a sua aplicação é criada em outro lugar (uma application factory, um pacote), defina Configurações → Configurações de build → Comando de início, por exemplo:
gunicorn "myproject:create_app()" --bind 0.0.0.0:$PORT
uvicorn myproject.api:app --host 0.0.0.0 --port $PORTBancos de dados
Adicione PostgreSQL ou MySQL ao projeto e leia DATABASE_URL — com dj-database-url no Django ou direto com o SQLAlchemy. Veja Bancos de dados.
Celery e outros workers
Adicione Valkey ao projeto e aponte o Celery para REDIS_URL. Rode o worker:
- na aba Processos, como worker em segundo plano —
celery -A myproject worker -l info; - ou como um serviço separado do tipo worker em segundo plano, com recursos próprios;
- o Celery beat como mais um worker em segundo plano —
celery -A myproject beat -l info— ou um comando periódico como comando agendado ou tarefa agendada.
Veja Serviços de um projeto.
Arquivos que sobrevivem a um deploy
Cada deploy começa de uma cópia nova do seu repositório. Os arquivos que a aplicação grava em /data são mantidos entre deploys e têm backup diário; o que for gravado em outro lugar some no deploy seguinte. Para uploads de usuários, use o armazenamento de objetos (no Django, django-storages com as variáveis S3_*).
Outros projetos Python
Um projeto Python que não usa nenhum desses frameworks precisa de um Dockerfile próprio no repositório; aí fazemos o build com ele, do jeito que está.