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.
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, oupip install .para umpyproject.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.pyou pordjangonas dependências. - O ponto de entrada é lido de
DJANGO_SETTINGS_MODULEnomanage.py—<project>.wsgi:application. - Ficheiros estáticos —
python manage.py collectstaticcorre 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.appaALLOWED_HOSTS(por exemplo, a partir de uma variável) e definaCSRF_TRUSTED_ORIGINSpara 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:appSe 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 $PORTBases 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á.