Fai il deploy di Flask su Nodion

Deploy di Flask passo dopo passo

1. Aggiungi Gunicorn alle dipendenze Nodion avvia Gunicorn ma non lo installa, quindi elencalo accanto a Flask. Fissa la versione di Python in .python-version, perché un intervallo in pyproject.toml sceglie la release più recente. requirements.txt

   flask
   gunicorn

2. Tieni l'oggetto app in app.py Nodion prende il primo file tra app.py, application.py e wsgi.py che contiene Flask ed esegue gunicorn <file>:app con 3 worker sulla porta PORT impostata da Nodion. L'oggetto deve chiamarsi app. app.py

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

3. Usi un'app factory? Aggiungi una riga web Con create_app() non esiste un oggetto app a livello di modulo da trovare, quindi indica a Gunicorn in un Procfile di chiamare la factory. La riga sostituisce il comando di avvio predefinito. Procfile

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

4. Esegui le migrazioni a ogni deploy Con Flask-Migrate, una riga release: esegue flask db upgrade una volta per ogni build, dopo la build e prima che parta la nuova versione. Se fallisce, il deploy si ferma e la versione in esecuzione resta online. Procfile

   release: flask --app myapp db upgrade

5. Crea l'app e il database Crea un'applicazione dal tuo repository nella regione EU Central, poi un database PostgreSQL nella stessa regione e collegalo nella scheda Environment: al deploy successivo arriva come DATABASE_URL. Imposta la tua SECRET_KEY come variabile segreta, leggila con os.environ, poi fai push.

Da sapere

• DATABASE_URL e SQLAlchemyLa variabile DATABASE_URL di Nodion inizia con postgres://, che SQLAlchemy dalla 1.4 in poi non accetta. Sostituisci lo schema prima di passarla: postgresql:// per psycopg2, postgresql+psycopg:// per psycopg 3.
• Health checkIl traffico viene spostato non appena / risponde con 2xx o 3xx, quindi un redirect a una pagina di login va bene. Se / restituisce 401 o 404, aggiungi una route come /healthz e impostala come percorso dell'health check nelle impostazioni dell'app.
• Worker Celery e RQAggiungi al Procfile worker: celery -A myapp worker insieme a una riga esplicita web: gunicorn app:app --bind 0.0.0.0:$PORT --workers 3; senza una riga web:, la prima voce del Procfile diversa da release: diventa il comando predefinito. Poi, nella scheda Processes, aggiungi un processo chiamato worker senza porta. Valkey nella stessa regione ti fornisce REDIS_URL.

Cosa gestisce Nodion per te

• Deploy senza downtime Fai push sul tuo branch e Nodion crea una nuova release. Il traffico passa alle nuove istanze solo quando superano l'health check; una release fallita lascia attiva quella in esecuzione. Le app con un volume locale invece si riavviano, perché il disco appartiene a una sola istanza.
• Database accanto all'app PostgreSQL, pgvector, MySQL, Valkey e ClickHouse gestiti, nella stessa regione. I database collegati arrivano come DATABASE_URL, REDIS_URL o CLICKHOUSE_URL.
• Anteprime per ogni pull request Attiva le anteprime: ogni pull request del tuo repository riceve un'app dedicata, con un proprio URL e database nuovi e vuoti, creata automaticamente o manualmente. Le pull request dai fork e quelle dei bot vengono ignorate.
• Worker, cron job e scalabilità Esegui i worker come processi aggiuntivi della stessa app, pianifica i job nella scheda Cron e scala ogni processo fino a 16 istanze.
• Fase di release Con i buildpack, la riga release: del Procfile viene eseguita a ogni nuova build. Le app con Dockerfile, così come i redeploy e i rollback a un'immagine precedente, usano un comando di release impostato sull'app stessa, che ha anche la precedenza sulla riga del Procfile. Nei siti statici, la fase di release gira in un'immagine che contiene solo i file generati dalla build.
• Log e metriche Nella dashboard trovi log di build, release e runtime, oltre alle metriche di CPU, memoria, disco e rete per ogni istanza.
• Domini e HTTPS Un hostname predefinito con HTTPS dal primo deploy; i tuoi domini ricevono i certificati in automatico.

Per approfondire

• Alternative a Heroku con hosting UE: 5 opzioni a confronto Una piattaforma tedesca e cloud statunitensi con regioni nell'UE, a confronto per sede, regioni e database gestiti.
• Ambienti di anteprima spiegati: un'app per ogni pull request Una copia in esecuzione della tua app per ogni pull request: a cosa servono gli ambienti di anteprima, dove diventano complicati e come li gestisce Nodion.

Flask su Nodion: domande e risposte