Despliega Flask en Nodion

Despliega Flask paso a paso

1. Añade Gunicorn a tus dependencias Nodion arranca Gunicorn, pero no lo instala, así que inclúyelo junto a Flask. Fija la versión de Python en .python-version, porque un rango en pyproject.toml elige la versión más reciente. requirements.txt

   flask
   gunicorn

2. Deja el objeto app en app.py Nodion toma el primero de app.py, application.py y wsgi.py que contenga Flask y ejecuta gunicorn <archivo>:app con 3 workers en el PORT que define. El objeto tiene que llamarse app. app.py

   from flask import Flask
   
   app = Flask(__name__)
   
   
   @app.get("/")
   def index():
       return "Hello from Frankfurt"

3. ¿Usas una app factory? Añade una línea web Con create_app() no hay ningún app a nivel de módulo que encontrar, así que indica a Gunicorn en un Procfile que llame a la factory. La línea sustituye al comando de inicio por defecto. Procfile

   web: gunicorn "myapp:create_app()" --bind 0.0.0.0:$PORT --workers 3

4. Ejecuta las migraciones en cada despliegue Con Flask-Migrate, una línea release: ejecuta flask db upgrade una vez por build, después de la build y antes de que arranque la nueva versión. Si falla, el despliegue se detiene y la versión en ejecución sigue activa. Procfile

   release: flask --app myapp db upgrade

5. Crea la app y la base de datos Crea una aplicación desde tu repositorio en la región EU Central, después una base de datos PostgreSQL en la misma región, y vincúlala en la pestaña Environment: la app recibe DATABASE_URL en el siguiente despliegue. Define tu SECRET_KEY como variable secreta, léela con os.environ y haz push.

A tener en cuenta

• DATABASE_URL y SQLAlchemyLa DATABASE_URL de Nodion empieza por postgres://, que SQLAlchemy 1.4 y posteriores no aceptan. Cambia el esquema antes de pasarla: postgresql:// para psycopg2, postgresql+psycopg:// para psycopg 3.
• Health checkEl tráfico pasa a la nueva versión en cuanto / responde con 2xx o 3xx, así que una redirección a una página de login vale. Si / devuelve 401 o 404, añade una ruta como /healthz y configúrala como ruta del health check en los ajustes de la app.
• Workers de Celery y RQAñade al Procfile worker: celery -A myapp worker junto con una línea web: gunicorn app:app --bind 0.0.0.0:$PORT --workers 3 explícita; sin una línea web:, la primera entrada del Procfile que no sea release: pasa a ser el comando por defecto. Después, en la pestaña Processes, añade un proceso llamado worker sin puerto. Valkey en la misma región te da REDIS_URL.

Lo que Nodion gestiona por ti

• Despliegues sin downtime Haz push a tu rama y Nodion construye una nueva release. El tráfico pasa a las nuevas instancias cuando superan el health check; si una release falla, la que está en marcha sigue activa. En cambio, las apps con un volumen local se reinician porque el disco pertenece a una sola instancia.
• Bases de datos junto a la app PostgreSQL, pgvector, MySQL, Valkey y ClickHouse gestionados en la misma región. Al vincular una base de datos, sus datos de conexión llegan como DATABASE_URL, REDIS_URL o CLICKHOUSE_URL.
• Previews por pull request Activa las previews: cada pull request de tu repositorio tendrá su propia app, con URL y bases de datos nuevas y vacías. Puedes crearla automáticamente o a mano. Se omiten las pull requests de forks y bots.
• Workers, cron jobs y escalado Ejecuta workers como procesos adicionales de la misma app, programa tareas en la pestaña Cron y escala cada proceso hasta 16 instancias.
• Paso de release Con buildpacks, una línea release: del Procfile se ejecuta con cada nueva build. Las apps con Dockerfile, así como los redeploys o rollbacks a una imagen anterior, usan un comando de release definido en la propia app, que además tiene prioridad sobre la línea del Procfile. En los sitios estáticos, el paso de release se ejecuta en una imagen que solo contiene los archivos generados por la build.
• Logs y métricas Logs de build, release y runtime, además de métricas de CPU, memoria, disco y red de cada instancia, en el dashboard.
• Dominios y HTTPS Un nombre de host predeterminado con HTTPS desde el primer despliegue; tus propios dominios reciben certificados automáticamente.

Para seguir leyendo

• Alternativas a Heroku con hosting en la UE: 5 opciones Una plataforma alemana y clouds estadounidenses con regiones en la UE, comparados por sede, regiones y bases de datos gestionadas.
• Entornos de preview: una app para cada pull request Una copia en ejecución de tu app para cada pull request: para qué sirven los entornos de preview, dónde se complican y cómo los gestiona Nodion.

Flask en Nodion: preguntas y respuestas