Começar

Aplicações Python: Django, Flask e FastAPI.

Como os projetos Django, Flask e FastAPI são detetados e arrancados, que ponto de entrada procuramos, ficheiros estáticos, migrações e como correr 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 arrancamo-los com um servidor de produção — não precisa de o adicionar.

Como é compilado e executado

  • Python 3.11.
  • Dependências — pip install -r requirements.txt, ou pip install . para um pyproject.toml.
  • Servidor — o Django e o Flask correm em gunicorn, o FastAPI em uvicorn. Somos nós que acrescentamos 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.
  • Ficheiros estáticos — python manage.py collectstatic corre durante a compilação. Sirva-os a partir da aplicação com o WhiteNoise (adicione-o ao middleware) ou a partir do armazenamento de objetos.
  • Migrações — o comando de lançamento recomendado é python manage.py migrate --noinput. Corre em cada publicação, antes de a nova versão receber visitantes; se falhar, a versão atual continua a funcionar.
  • Acrescente o seu domínio e o endereço rivervo.app a ALLOWED_HOSTS (por exemplo, a partir de uma variável) e defina CSRF_TRUSTED_ORIGINS para os formulários em HTTPS.

Flask e FastAPI

Procuramos o ficheiro que cria a aplicação — app.py, main.py, wsgi.py, application.py ou server.py — e a variável onde 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 aplicação for criada noutro sítio (uma application factory, um pacote), defina Definições → Definições de compilação → Comando de arranque, por exemplo:

gunicorn "myproject:create_app()" --bind 0.0.0.0:$PORT
uvicorn myproject.api:app --host 0.0.0.0 --port $PORT

Bases de dados

Adicione PostgreSQL ou MySQL ao projeto e leia DATABASE_URL — com dj-database-url no Django, ou diretamente com o SQLAlchemy. Consulte Bases de dados.

Celery e outros workers

Adicione o Valkey ao projeto e aponte o Celery para REDIS_URL. Corra o worker:

  • no separador Processos, como worker em segundo plano — celery -A myproject worker -l info;
  • ou como serviço worker em segundo plano separado, com os seus próprios recursos;
  • 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.

Consulte Serviços de um projeto.

Ficheiros que sobrevivem a uma publicação

Cada publicação parte de uma cópia nova do seu repositório. Os ficheiros que a aplicação escreve em /data mantêm-se entre publicações e têm backup diário; tudo o que for escrito noutro sítio desaparece na publicação seguinte. Para os uploads dos utilizadores, use o armazenamento de objetos (no Django, django-storages com as variáveis S3_*).

Outros projetos Python

Um projeto Python que não use nenhuma destas frameworks precisa de um Dockerfile próprio no repositório; nesse caso compilamos com ele, tal como está.

Ainda com dúvidas?

Fale connosco por chat — a AI responde de imediato e um engenheiro entra quando for preciso, a qualquer hora.

Contactar o suporte