Cómo instalar el marco de aplicación web Django en Debian 10

Django es un marco de aplicación web de código abierto que te ayuda a desarrollar sitios web y aplicaciones dinámicas. Es seguro, rápido y estable, lo que te permite crear un sitio web complejo con menos código. Hay varias formas de instalar Django en tu sistema. Puedes instalarlo utilizando el repositorio de Debian, usando PIP o desde el repositorio de Git. Puedes elegir cualquier método dependiendo de tus necesidades. Django te permite crear un proyecto en entornos virtuales de Python. De esta manera, puedes crear múltiples entornos de Django en un solo sistema.

En este tutorial, aprenderemos cómo instalar el marco web Django con PIP en Debian 10. También aprenderemos cómo crear una aplicación Django y conectarla con una base de datos.

Requisitos previos

• Un servidor que ejecute Debian 10.
• Una contraseña de root configurada en tu servidor.

Empezando

Antes de comenzar, actualiza tu sistema con la última versión. Puedes hacerlo ejecutando el siguiente comando:

apt-get update -y  
 apt-get upgrade -y

Una vez que tu sistema esté actualizado, reinícialo para aplicar los cambios.

Instalar Django

Django está escrito en el lenguaje Python. Por lo tanto, necesitarás instalar las dependencias de Python en tu sistema para poder instalar Django. Puedes instalar todas ellas con el siguiente comando:

apt-get install python3 python3-pip tree -y

Después de instalar todos los paquetes, puedes verificar la versión instalada de PIP con el siguiente comando:

pip3 -V

Deberías obtener la siguiente salida:

pip 18.1 from /usr/lib/python3/dist-packages/pip (python 3.7)

Ahora, puedes proceder a instalar Django usando el comando PIP como se muestra a continuación:

pip3 install Django

Una vez que se haya completado la instalación, verifica la versión de Django usando el siguiente comando:

django-admin --version

Deberías ver la siguiente salida:

3.0.2

En este punto, Django ha sido instalado en tu servidor. Ahora puedes proceder al siguiente paso.

Crear un proyecto Django

Ahora comencemos a crear un proyecto Django de ejemplo. Primero, cambia el directorio a /opt donde deseas crear un proyecto Django:

cd /opt

A continuación, ejecuta el siguiente comando para crear un nuevo proyecto Django llamado Dproject:

django-admin startproject Dproject

Una vez que se haya creado el proyecto, puedes ver la estructura de directorios de este proyecto con el siguiente comando:

tree

Deberías obtener la siguiente salida:

.
??? Dproject
    ??? Dproject
    ?   ??? asgi.py
    ?   ??? __init__.py
    ?   ??? settings.py
    ?   ??? urls.py
    ?   ??? wsgi.py
    ??? manage.py

A continuación, cambia el directorio a Dproject y migra los cambios pendientes con el siguiente comando:

cd Dproject  
 python3 manage.py migrate

Una vez que la migración se haya completado con éxito, deberías ver la siguiente salida:

Operations to perform:
  Apply all migrations: admin, auth, contenttypes, sessions
Running migrations:
  Applying contenttypes.0001_initial... OK
  Applying auth.0001_initial... OK
  Applying admin.0001_initial... OK
  Applying admin.0002_logentry_remove_auto_add... OK
  Applying admin.0003_logentry_add_action_flag_choices... OK
  Applying contenttypes.0002_remove_content_type_name... OK
  Applying auth.0002_alter_permission_name_max_length... OK
  Applying auth.0003_alter_user_email_max_length... OK
  Applying auth.0004_alter_user_username_opts... OK
  Applying auth.0005_alter_user_last_login_null... OK
  Applying auth.0006_require_contenttypes_0002... OK
  Applying auth.0007_alter_validators_add_error_messages... OK
  Applying auth.0008_alter_user_username_max_length... OK
  Applying auth.0009_alter_user_last_name_max_length... OK
  Applying auth.0010_alter_group_name_max_length... OK
  Applying auth.0011_update_proxy_permissions... OK
  Applying sessions.0001_initial... OK

En este punto, se ha creado un nuevo proyecto Django dentro del directorio /opt.

Crear un superusuario para Django

A continuación, necesitarás crear un superusuario para que Django acceda a la interfaz de administración de Django. Puedes crearlo con el siguiente comando:

python3 manage.py createsuperuser

Proporciona tu nombre de usuario deseado, dirección de correo electrónico y contraseña como se muestra a continuación:

Username (leave blank to use 'root'): admin
Email address: [email protected]
Password: 
Password (again): 
Superuser created successfully.

Iniciar el servidor Django

Por defecto, Django no es accesible desde el sistema remoto. Por lo tanto, necesitarás configurar Django y definir la IP de tu servidor. Puedes hacerlo editando el archivo settings.py.

nano /opt/Dproject/Dproject/settings.py

Cambia la siguiente línea:

ALLOWED_HOSTS = ['your-server-ip']

Guarda y cierra el archivo cuando hayas terminado. A continuación, inicia el servidor Django con el siguiente comando:

cd /opt/Django  
 python3 manage.py runserver 0.0.0.0:8000

Una vez que el servidor se haya iniciado con éxito, deberías obtener la siguiente salida:

Watching for file changes with StatReloader
Performing system checks...

System check identified no issues (0 silenced).
January 07, 2020 - 13:01:23
Django version 3.0.2, using settings 'Dproject.settings'
Starting development server at http://0.0.0.0:8000/
Quit the server with CONTROL-C.

Acceder a la aplicación Django

En este punto, la aplicación Django se ha iniciado y está escuchando en el puerto 8000. Para acceder a ella, abre tu navegador web y escribe la URL http://your-server-ip:8000. Deberías ver la aplicación Django en la siguiente pantalla:

Para acceder a la interfaz de administración de Django, abre tu navegador web y escribe la URL http://your-server-ip:8000/admin. Serás redirigido a la página de inicio de sesión de Django:

Proporciona tu nombre de usuario de administrador de Django, contraseña y haz clic en el botón Iniciar sesión. Deberías ver la interfaz de administración de Django en la siguiente pantalla:

Instalar el conector de base de datos MariaDB

A continuación, necesitarás instalar el conector de base de datos MariaDB y otros paquetes de desarrollo para poder conectar Django con la base de datos MariaDB. Puedes instalar todos ellos utilizando el siguiente comando:

apt-get install mariadb-server python3-dev libmariadb-dev libmariadbclient-dev -y

Una vez que se hayan instalado todos los paquetes, puedes instalar la biblioteca mysqlclient usando el comando PIP como se muestra a continuación:

pip3 install mysqlclient

Una vez instalado, inicia sesión en el shell de MariaDB con el siguiente comando:

mysql

A continuación, establece la contraseña de root para MariaDB con el siguiente comando.

MariaDB [(none)]> SET PASSWORD FOR 'root'@'localhost' = PASSWORD("newpassword");

A continuación, crea una base de datos para Django con el siguiente comando:

MariaDB [(none)]> create database testdb;

Puedes ver la base de datos creada anteriormente usando el siguiente comando:

MariaDB [(none)]> show databases;

Deberías obtener la siguiente salida:

+--------------------+
| Database           |
+--------------------+
| information_schema |
| mysql              |
| performance_schema |
| testdb             |
+--------------------+

A continuación, limpia los privilegios y sal del shell de MariaDB con el siguiente comando:

MariaDB [(none)]> flush privileges;  
 MariaDB [(none)]> exit;

Configurar Django para la conexión con MariaDB

A continuación, necesitarás definir las credenciales de la base de datos MariaDB en Django. Puedes definirlo editando el archivo settings.py:

nano /opt/Dproject/Dproject/settings.py

Encuentra las siguientes líneas:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
    }
}

Y reemplázalas con las siguientes líneas:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'OPTIONS': {
        'read_default_file': '/etc/mysql/mariadb.conf.d/50-client.cnf',
        },
    }
}

Guarda y cierra el archivo cuando hayas terminado. Luego, edita el archivo de credenciales del cliente de MariaDB como se muestra a continuación:

nano /etc/mysql/mariadb.conf.d/50-client.cnf

Define tus credenciales de base de datos MariaDB como se muestra a continuación:

[client]
database = testdb 
user = root   
password = newpassword
default-character-set = utf8

Guarda y cierra el archivo y luego reinicia el servicio de MariaDB para implementar los cambios:

systemctl restart mariadb

A continuación, cambia el directorio al proyecto Django y migra los nuevos cambios con el siguiente comando:

cd /opt/Dproject  
 python3 manage.py migrate

Una vez que la migración se haya completado con éxito, puedes proceder al siguiente paso.

Probar la conexión de MariaDB

En este punto, Django está configurado para conectar la base de datos MariaDB. Es hora de probarlo.

Para hacerlo, inicia el servidor Django con el siguiente comando:

cd /opt/Django  
 python3 manage.py runserver 0.0.0.0:8000

Una vez que el servidor Django se haya iniciado con éxito, deberías obtener la siguiente salida:

Watching for file changes with StatReloader
Performing system checks...

System check identified no issues (0 silenced).
January 07, 2020 - 13:30:49
Django version 3.0.2, using settings 'Dproject.settings'
Starting development server at http://0.0.0.0:8000/
Quit the server with CONTROL-C.

Ahora puedes acceder a tu aplicación Django usando la URL http://your-server-ip:8000. Deberías ver tu aplicación Django en la siguiente pantalla:

Después de probar, puedes detener el servidor Django en cualquier momento presionando CTRL + C en tu terminal.

Conclusión

¡Felicidades! has instalado con éxito Django y lo has conectado con la base de datos MariaDB en el servidor Debian 10. Ahora puedes comenzar a desarrollar tu aplicación web y aplicar migraciones en tu aplicación Django. No dudes en preguntarme si tienes alguna pregunta.