Aplicaciones Python: Django, Flask y FastAPI.
Cómo se detectan y se inician los proyectos Django, Flask y FastAPI, qué punto de entrada buscamos, los archivos estáticos, las migraciones y cómo ejecutar Celery.
Un repositorio con requirements.txt, pyproject.toml, Pipfile o manage.py es un proyecto Python. Reconocemos Django, Flask y FastAPI y los iniciamos con un servidor de producción: no tienes que añadirlo tú.
Cómo se compila y se ejecuta
- Python 3.11.
- Dependencias:
pip install -r requirements.txt, opip install .si hay unpyproject.toml. - Servidor: Django y Flask se ejecutan con gunicorn y FastAPI con uvicorn. Nosotros añadimos el servidor a la instalación.
Django
- Se reconoce por
manage.pyo pordjangoen las dependencias. - El punto de entrada se lee de
DJANGO_SETTINGS_MODULEenmanage.py:<project>.wsgi:application. - Archivos estáticos:
python manage.py collectstaticse ejecuta durante la compilación. Sírvelos desde la aplicación con WhiteNoise (añádelo a tu middleware) o desde el almacenamiento de objetos. - Migraciones: el comando de release recomendado es
python manage.py migrate --noinput. Se ejecuta en cada despliegue antes de que la nueva versión reciba visitantes; si falla, la versión actual sigue funcionando. - Añade tu dominio y la dirección
rivervo.appaALLOWED_HOSTS(por ejemplo, desde una variable) y defineCSRF_TRUSTED_ORIGINSpara los formularios con HTTPS.
Flask y FastAPI
Buscamos el archivo que crea la aplicación —app.py, main.py, wsgi.py, application.py o server.py— y la variable en la que se guarda:
# app.py
from flask import Flask
app = Flask(__name__) # → started as app:app# main.py
from fastapi import FastAPI
app = FastAPI() # → started as main:appSi tu aplicación se crea en otro sitio (una factoría de aplicaciones, un paquete), define Ajustes → Ajustes de compilación → Comando de inicio, por ejemplo:
gunicorn "myproject:create_app()" --bind 0.0.0.0:$PORT
uvicorn myproject.api:app --host 0.0.0.0 --port $PORTBases de datos
Añade PostgreSQL o MySQL al proyecto y lee DATABASE_URL: con dj-database-url en Django, o directamente con SQLAlchemy. Consulta Bases de datos.
Celery y otros workers
Añade Valkey al proyecto y apunta Celery a REDIS_URL. Ejecuta el worker:
- en la pestaña Procesos, como worker en segundo plano:
celery -A myproject worker -l info; - o como un servicio worker en segundo plano aparte, con sus propios recursos;
- Celery beat como un worker en segundo plano más —
celery -A myproject beat -l info— o un comando periódico como comando programado o tarea programada.
Consulta Servicios de un proyecto.
Archivos que sobreviven a un despliegue
Cada despliegue empieza desde una copia limpia de tu repositorio. Los archivos que tu aplicación escribe en /data se conservan entre despliegues y se copian a diario; todo lo que se escriba en otro sitio desaparece con el siguiente despliegue. Para las subidas de los usuarios, usa el almacenamiento de objetos (en Django, django-storages con las variables S3_*).
Otros proyectos Python
Un proyecto Python que no use ninguno de estos frameworks necesita su propio Dockerfile en el repositorio; entonces compilamos con él tal cual.