Vai al contenuto principale
Gunicorn è un server HTTP WSGI per Python che esegue in produzione Flask, Django e altre applicazioni WSGI. Questa guida mostra come avviare la tua applicazione con Gunicorn, regolarlo sulla RAM del tuo piano ed eseguirlo su Square Cloud.

​
Installare Gunicorn

Installa Gunicorn sulla tua macchina:
Aggiungi gunicorn anche al tuo requirements.txt, così Square Cloud lo installa insieme alle altre dipendenze:
requirements.txt

​
Utilizzo di base

Per eseguire un’applicazione con Gunicorn, ti serve un’applicazione WSGI, come una creata con Flask o Django, e devi conoscere il nome del modulo e il nome della variabile che contiene l’oggetto dell’applicazione WSGI. Per esempio, se hai un’applicazione Flask in un file chiamato app.py e l’istanza Flask si chiama app, puoi eseguirla con Gunicorn usando il seguente comando:
In questo comando:
  • python -m gunicorn esegue Gunicorn come modulo Python.
  • --bind 0.0.0.0:80 indica a Gunicorn di ascoltare su tutte le interfacce di rete sulla porta 80.
  • app:app specifica il nome del modulo (app) e il nome della variabile (app) che contiene l’oggetto dell’applicazione WSGI.
Per Django, punta Gunicorn al modulo wsgi.py che Django crea all’interno del package del tuo progetto (sostituisci myproject con il nome del tuo progetto):

​
Opzioni aggiuntive

Gunicorn offre diverse opzioni per personalizzare il suo comportamento. Queste sono le più comuni; il riferimento ufficiale delle impostazioni di Gunicorn le elenca tutte.

​
Workers

  • --workers <number>
Questa opzione imposta il numero di processi worker per la gestione delle richieste. Ogni worker è un processo separato con la propria copia della tua applicazione in memoria, quindi su Square Cloud il limite di solito è la RAM, non la CPU. Inizia con 2 worker e aggiungine altri solo dopo aver aumentato MEMORY. Se la tua applicazione si arresta con LACK_OF_RAM, riduci il numero di worker.
Non dimensionare i worker con multiprocessing.cpu_count() o con la formula (2 x $num_cores) + 1: all’interno di un container, il numero di core può essere quello della macchina host, il che avvia decine di worker ed esaurisce la tua RAM.

​
Nome

  • --name <name>
  • -n <name>
Questa opzione imposta il nome del processo per Gunicorn.

​
Worker class

  • --worker-class <class>
  • -k <class>
Questa opzione imposta il tipo di worker da utilizzare. Il valore predefinito è sync, ma puoi anche usare gevent, eventlet, tornado o altri tipi di worker.

​
File di configurazione

Puoi anche impostare le opzioni di Gunicorn in un file di configurazione Python. Gunicorn carica automaticamente un file chiamato gunicorn.conf.py dalla directory in cui viene eseguito, che su Square Cloud è la radice del tuo progetto. Per qualsiasi altro nome di file, passalo con -c <file>.
gunicorn.conf.py
Con questo file nel tuo progetto, il comando di avvio non ha più bisogno dell’opzione --bind.

​
Eseguirlo su Square Cloud

Crea un file squarecloud.app nella radice del tuo progetto e inserisci il comando di Gunicorn nel suo campo START, così Square Cloud avvia la tua applicazione con Gunicorn invece del predefinito python app.py:
Gunicorn deve fare il bind su 0.0.0.0:80: Square Cloud consegna il traffico del tuo sottodominio alla porta 80 della tua applicazione. Square Cloud imposta anche la variabile d’ambiente PORT a 80, e Gunicorn la legge: senza l’opzione --bind, ascolta su 0.0.0.0:$PORT quando PORT è impostata.
Per Django, usa myproject.wsgi:application in START e il manage.py del tuo progetto come MAIN. I tutorial di Flask e Django coprono il deploy completo.

​
Prossimi passi

Flask

Fai il deploy di un’applicazione Flask dietro Gunicorn.

Django

Fai il deploy di un progetto Django dietro Gunicorn.

L'app non si avvia

Risolvi EADDRINUSE, LACK_OF_RAM e altri errori di avvio.

​
Ti è piaciuto questo articolo?

  • Abbiamo creato questo contenuto con grande cura per offrirti il miglior aiuto possibile. Gli sviluppatori hanno già valutato Square Cloud 4,9/5 su 402 recensioni su Google e Trustpilot: lascia anche tu la tua! Ci aiuta a capire cosa conta di più per te.

Google Reviews

Lascia la tua recensione su Google Reviews.

Trustpilot

Lascia la tua recensione su Trustpilot.