Empezar

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.

2 MIN DE LECTURA

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, o pip install . si hay un pyproject.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.py o por django en las dependencias.
  • El punto de entrada se lee de DJANGO_SETTINGS_MODULE en manage.py: <project>.wsgi:application.
  • Archivos estáticos: python manage.py collectstatic se 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.app a ALLOWED_HOSTS (por ejemplo, desde una variable) y define CSRF_TRUSTED_ORIGINS para 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:app

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

Bases 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.

¿Sigues con dudas?

Escríbenos por chat: la AI responde al momento y un ingeniero se une cuando hace falta, a cualquier hora del día.

Contactar con soporte