Llevar Django a producción con HestiaCP

Editado el 22 de Julio del 2023 a las 12:14:23 por Rafael Corro

En este artículo subiremos un proyecto en Django a un VPS con HestiaCP en Ubuntu 20.04 y usaremos el usuario "admin" de HestiaCP para esta prueba.

Primero actualizamos el servidor
# apt-get update && apt upgrade -y

Instalamos las librerias necesarias:
# apt install python3-pip python3-dev libmysqlclient-dev

Subimos el proyecto Django al que llamaremos "miproyectodjango" por FTP por ejemplo a /home/admin/web/midominio.com/public_html/ y accedemos a la carpeta:
# cd /home/admin/web/midominio.com/public_html/miproyectodjango/

Creando un entorno virtual

Ahora Instalamos y configuramos virtualenv:
# pip3 install virtualenv

Dentro de la carpeta del proyecto django, vamos a crear el entorno virtual al que llamaremos "mientornovirtual"
# virtualenv mientornovirtual

Lo activamos:
# source mientornovirtual/bin/activate

Y el prompt deberá cambiar así:
(mientornovirtual)root@host:~/miproyectodjango$.

Instalación de Django y Gunicorn dentro del  entorno virtual

Instalamos Django y Gunicorn con pip (no pip3)
# pip install django gunicorn

Migramos el esquema de la base de datos de nuestro proyecto Django:
# python3 manage.py makemigrations
# python3 manage.py migrate

Permitimos la conexión de nuestro dominio en setting.py
# nano miapp/setting.py

ALLOWED_HOST=['midominio.com']

Comprobamos que podemos abrir el proyecto
Permitimos el puerto 8000 desde nuestro panel HestiaCP 

Arrancamos la aplicación para comprobar que podemos acceder a ella:
# python3 manage.py runserver 0.0.0.0:8000

ponemos en el navegador: {ip del servidor o dominio}:8000 para ver que está corriendo. Es posible que no se pueda acceder a la carpeta static con lo que no mostrará el css del proyecto

Antes de salir del entorno virtual, nos aseguramos que  Gunicorn puede servir la aplicación:
(mientornovirtual) root@server:~/miproyectodjango# gunicorn --bind 0.0.0.0:8000 miappdjango.wsgi:application

Y podemos volver a cerrar el puerto 8000 en el panel HestiaCP

salimos del entorno virtual
(mientornovirtual) root@server:~/miproyectodjango# deactivate

Cambiamos el propietario de la carpeta mientornovirtual
root@host:~/miproyectodjango# chown -R  admin:admin mientornovirtual/

Creamos los archivos de socket y servicio de systemd para Gunicorn

# nano /etc/systemd/system/migunicorn.socket

[Unit]
Description=migunicorn socket

[Socket]
ListenStream=/home/admin/web/midominio.com/public_html/miproyectodjango/migunicorn.sock

[Install]
WantedBy=sockets.target

y a continuación el servicio:
# nano /etc/systemd/system/migunicorn.service

[Unit]
Description=migunicorn daemon
After=network.target

[Service]
User=admin
Group=www-data
WorkingDirectory=/home/admin/web/midominio.com/public_html/miproyectodjango
ExecStart=/home/admin/web/midominio.com/public_html/miproyectodjango/mientornovirtual/bin/gunicorn --workers 3 --bind unix:/home/admin/web/midominio.com/public_html/miproyectodjango/migunicorn.sock miproyectodjango.wsgi:application

[Install]
WantedBy=multi-user.target

Iniciamos el servicio de Gunicorn
# systemctl start migunicorn.socket
# sudo systemctl enable migunicorn.socket

Reiniciamos el servicio:
# systemctl daemon-reload
# service migunicorn --full-restart

Vemos el estado del socket y del servicio:
# systemctl status migunicorn

Creamos las plantillas para HestiaCP donde irá la configuración NGINX

# nano /usr/local/hestia/data/templates/web/nginx/django.tpl    

#=======================================================================#
# Default Web Domain Template #
# DO NOT MODIFY THIS FILE! CHANGES WILL BE LOST WHEN REBUILDING DOMAINS #
#=======================================================================#

server {
    listen      %ip%:%proxy_port%;
    server_name %domain_idn% %alias_idn%;

    include %home%/%user%/conf/web/%domain%/nginx.forcessl.conf*;
    location = /favicon.ico { access_log off; log_not_found off; }

    location /static/ {
         root %home%/%user%/web/%domain%/public_html/miproyectodjango/miappdjango;
    }

    location / {
         proxy_set_header Host $host;
         proxy_set_header X-Real-IP $remote_addr;
         proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
         proxy_set_header X-Forwarded-Proto $scheme;
         proxy_pass http://unix:%home%/%user%/web/%domain%/public_html/miproyectodjango/migunicorn.sock;
   }

   location ~ /\.ht {return 404;}
   location ~ /\.svn/ {return 404;}
   location ~ /\.git/ {return 404;}
   location ~ /\.hg/ {return 404;}
   location ~ /\.bzr/ {return 404;}

   include %home%/%user%/conf/web/%domain%/nginx.conf_*;
}

# nano /usr/local/hestia/data/templates/web/nginx/django.stpl

#=======================================================================#
# Default Web Domain Template #
# DO NOT MODIFY THIS FILE! CHANGES WILL BE LOST WHEN REBUILDING DOMAINS #
#=======================================================================#

server {
    listen %ip%:%proxy_ssl_port% ssl http2;
    server_name %domain_idn% %alias_idn%;
    ssl_certificate %ssl_pem%;
    ssl_certificate_key %ssl_key%;
    ssl_stapling on;
    ssl_stapling_verify on;
    error_log /var/log/%web_system%/domains/%domain%.error.log error;

    include %home%/%user%/conf/web/%domain%/nginx.hsts.conf*;


    location = /favicon.ico { access_log off; log_not_found off; }

    location /static/ {
        root %home%/%user%/web/%domain%/public_html/miproyectodjango/miappdjango;
    }

    location / {
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        #proxy_set_header X-Forwarded-For %proxy_add_x_forwarded_for%;
        #proxy_set_header X-Forwarded-Proto %scheme%;
        proxy_pass http://unix:%home%/%user%/web/%domain%/public_html/miproyectodjango/migunicorn.sock;
    }

    location ~ /\.ht {return 404;}
    location ~ /\.svn/ {return 404;}
    location ~ /\.git/ {return 404;}
    location ~ /\.hg/ {return 404;}
    location ~ /\.bzr/ {return 404;}

    include %home%/%user%/conf/web/%domain%/nginx.ssl.conf_*;
}

Por último editar el dominio en el panel HestiaCP y elegir la plantilla que hemos creado. Le damos a aplicar cambios y ya debería de mostrar la aplicación de nuestro proyecto en Django.

Si no funciona como esperamos podemo ver el log de nginx:
# tail -F /var/log/nginx/error.log

Para ver el estado de nginx
# systemctl status nginx

comprobar la página desde una terminal de otro equipo 
$ curl -l -k http://midominio.com

Espero que te sea de ayuda este artículo y si te ha gustado, no olvides dejar una valoración.