Saltar al contenido principal
Gunicorn es un servidor HTTP WSGI para Python que ejecuta Flask, Django y otras aplicaciones WSGI en producción. Esta guía muestra cómo iniciar tu aplicación con Gunicorn, ajustarla a la RAM de tu plan y ejecutarla en Square Cloud.

​
Instalar Gunicorn

Instala Gunicorn en tu máquina:
Agrega también gunicorn a tu requirements.txt, para que Square Cloud lo instale junto con tus demás dependencias:
requirements.txt

​
Uso básico

Para ejecutar una aplicación con Gunicorn, necesitas una aplicación WSGI, como una hecha con Flask o Django, y necesitas conocer el nombre del módulo y el nombre de la variable que contiene el objeto de la aplicación WSGI. Por ejemplo, si tienes una aplicación Flask en un archivo llamado app.py y la instancia de Flask se llama app, puedes ejecutarla con Gunicorn usando el siguiente comando:
En este comando:
  • python -m gunicorn ejecuta Gunicorn como un módulo de Python.
  • --bind 0.0.0.0:80 le indica a Gunicorn que escuche en todas las interfaces de red en el puerto 80.
  • app:app especifica el nombre del módulo (app) y el nombre de la variable (app) que contiene el objeto de la aplicación WSGI.
Para Django, apunta Gunicorn al módulo wsgi.py que Django crea dentro del paquete de tu proyecto (reemplaza myproject por el nombre de tu proyecto):

​
Opciones adicionales

Gunicorn proporciona varias opciones para personalizar su comportamiento. Estas son las más comunes; la referencia oficial de ajustes de Gunicorn las lista todas.

​
Workers

  • --workers <number>
Esta opción establece el número de procesos worker para manejar las peticiones. Cada worker es un proceso separado con su propia copia de tu aplicación en memoria, así que en Square Cloud el límite suele ser la RAM, no la CPU. Empieza con 2 workers y agrega más solo después de aumentar MEMORY. Si tu aplicación se detiene con LACK_OF_RAM, reduce el número de workers.
No calcules los workers con multiprocessing.cpu_count() ni con la fórmula (2 x $num_cores) + 1: dentro de un contenedor, el número de núcleos puede ser el de la máquina host, lo que inicia decenas de workers y agota tu RAM.

​
Name

  • --name <name>
  • -n <name>
Esta opción establece el nombre del proceso para Gunicorn.

​
Worker class

  • --worker-class <class>
  • -k <class>
Esta opción establece el tipo de worker a usar. El valor predeterminado es sync, pero también puedes usar gevent, eventlet, tornado u otro tipo de worker.

​
Archivo de configuración

También puedes definir las opciones de Gunicorn en un archivo de configuración de Python. Gunicorn carga automáticamente un archivo llamado gunicorn.conf.py del directorio donde se ejecuta, que en Square Cloud es la raíz de tu proyecto. Para cualquier otro nombre de archivo, pásalo con -c <file>.
gunicorn.conf.py
Con este archivo en tu proyecto, el comando de inicio ya no necesita la opción --bind.

​
Ejecutarlo en Square Cloud

Crea un archivo squarecloud.app en la raíz de tu proyecto y pon el comando de Gunicorn en su campo START, para que Square Cloud inicie tu aplicación con Gunicorn en lugar del python app.py predeterminado:
Gunicorn debe hacer bind en 0.0.0.0:80: Square Cloud entrega el tráfico de tu subdominio al puerto 80 de tu aplicación. Square Cloud también define la variable de entorno PORT como 80, y Gunicorn la lee: sin la opción --bind, escucha en 0.0.0.0:$PORT cuando PORT está definida.
Para Django, usa myproject.wsgi:application en START y el manage.py de tu proyecto como MAIN. Los tutoriales de Flask y Django cubren el deploy completo.

​
Próximos pasos

Flask

Haz deploy de una aplicación Flask detrás de Gunicorn.

Django

Haz deploy de un proyecto Django detrás de Gunicorn.

La app no inicia

Soluciona EADDRINUSE, LACK_OF_RAM y otros fallos de inicio.

​
¿Te gustó este artículo?

  • Creamos este contenido con mucho cuidado para ofrecer la mejor ayuda posible. Si este artículo te ayudó de alguna manera, ¡apoya nuestro trabajo! Los desarrolladores ya calificaron a Square Cloud con 4.9/5 en 402 reseñas en Google y Trustpilot: ¡deja la tuya también! Nos ayuda a entender qué es lo que más te importa.

Google Reviews

Deja tu reseña en Google Reviews.

Trustpilot

Deja tu reseña en Trustpilot.