Começar

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.

2 MIN DE LEITURA

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, ou pip install . para um pyproject.toml.
  • Servidor — Django e Flask rodam no gunicorn, FastAPI no uvicorn. Nós mesmos adicionamos o servidor à instalação.

Django

  • Reconhecido pelo manage.py ou por django nas dependências.
  • O ponto de entrada é lido de DJANGO_SETTINGS_MODULE no manage.py — <project>.wsgi:application.
  • Arquivos estáticos — python manage.py collectstatic roda 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.app em ALLOWED_HOSTS (por exemplo, a partir de uma variável) e defina CSRF_TRUSTED_ORIGINS para 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:app

Se 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 $PORT

Bancos 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á.

Ainda com dúvidas?

Fale com a gente no chat — a AI responde na hora e um engenheiro entra quando é preciso, a qualquer hora do dia.

Falar com o suporte