Comment installer le framework d'application Web Django sur Debian 10

Django est un framework d’application Web open-source qui vous aide à développer des sites Web et des applications dynamiques. Il est sécurisé, rapide et stable, ce qui vous permet de créer un site Web complexe avec moins de code. Il existe plusieurs façons d’installer Django sur votre système. Vous pouvez l’installer en utilisant le dépôt Debian, en utilisant PIP ou à partir du dépôt Git. Vous pouvez choisir n’importe quelle méthode en fonction de vos besoins. Django vous permet de créer un projet dans des environnements virtuels Python. De cette manière, vous pouvez créer plusieurs environnements Django sur un seul système.

Dans ce tutoriel, nous allons apprendre à installer le framework Web Django avec PIP sur Debian 10. Nous allons également apprendre à créer une application Django et à la connecter à une base de données.

Prérequis

• Un serveur exécutant Debian 10.
• Un mot de passe root configuré sur votre serveur.

Commencer

Avant de commencer, mettez à jour votre système avec la dernière version. Vous pouvez le faire en exécutant la commande suivante :

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

Une fois votre système mis à jour, redémarrez-le pour appliquer les modifications.

Installer Django

Django est écrit dans le langage Python. Vous devrez donc installer les dépendances Python sur votre système afin d’installer Django. Vous pouvez toutes les installer avec la commande suivante :

apt-get install python3 python3-pip tree -y

Après avoir installé tous les paquets, vous pouvez vérifier la version installée de PIP avec la commande suivante :

pip3 -V

Vous devriez obtenir la sortie suivante :

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

Maintenant, vous pouvez procéder à l’installation de Django en utilisant la commande PIP comme indiqué ci-dessous :

pip3 install Django

Une fois l’installation terminée, vérifiez la version de Django en utilisant la commande suivante :

django-admin --version

Vous devriez voir la sortie suivante :

3.0.2

À ce stade, Django a été installé sur votre serveur. Vous pouvez maintenant passer à l’étape suivante.

Créer un projet Django

Maintenant, commençons à créer un projet Django d’exemple. Tout d’abord, changez le répertoire vers /opt où vous souhaitez créer un projet Django :

cd /opt

Ensuite, exécutez la commande suivante pour créer un nouveau projet Django appelé Dproject :

django-admin startproject Dproject

Une fois le projet créé, vous pouvez voir la structure du répertoire de ce projet avec la commande suivante :

tree

Vous devriez obtenir la sortie suivante :

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

Ensuite, changez le répertoire vers Dproject et migrez les modifications en attente avec la commande suivante :

cd Dproject  
python3 manage.py migrate

Une fois la migration terminée avec succès, vous devriez voir la sortie suivante :

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

À ce stade, un nouveau projet Django a été créé dans le répertoire /opt.

Créer un super utilisateur pour Django

Ensuite, vous devrez créer un superutilisateur pour Django afin d’accéder à l’interface d’administration de Django. Vous pouvez le créer avec la commande suivante :

python3 manage.py createsuperuser

Fournissez votre nom d’utilisateur, adresse e-mail et mot de passe souhaités comme indiqué ci-dessous :

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

Démarrer le serveur Django

Par défaut, Django n’est pas accessible depuis le système distant. Vous devrez donc configurer Django et définir l’IP de votre serveur. Vous pouvez le faire en modifiant le fichier settings.py.

nano /opt/Dproject/Dproject/settings.py

Changez la ligne suivante :

ALLOWED_HOSTS = ['your-server-ip']

Enregistrez et fermez le fichier lorsque vous avez terminé. Ensuite, démarrez le serveur Django avec la commande suivante :

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

Une fois le serveur démarré avec succès, vous devriez obtenir la sortie suivante :

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.

Accéder à l’application Django

À ce stade, l’application Django est démarrée et écoute sur le port 8000. Pour y accéder, ouvrez votre navigateur Web et tapez l’URL http://your-server-ip:8000. Vous devriez voir l’application Django à l’écran suivant :

Pour accéder à l’interface d’administration de Django, ouvrez votre navigateur Web et tapez l’URL http://your-server-ip:8000/admin. Vous serez redirigé vers la page de connexion de Django :

Fournissez votre nom d’utilisateur admin Django, mot de passe et cliquez sur le bouton Log in. Vous devriez voir l’interface d’administration de Django à l’écran suivant :

Installer le connecteur de base de données MariaDB

Ensuite, vous devrez installer le connecteur de base de données MariaDB et d’autres paquets de développement afin de connecter Django à la base de données MariaDB. Vous pouvez tous les installer en utilisant la commande suivante :

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

Une fois tous les paquets installés, vous pouvez installer la bibliothèque mysqlclient en utilisant la commande PIP comme indiqué ci-dessous :

pip3 install mysqlclient

Une fois installé, connectez-vous à l’interface de commande MariaDB avec la commande suivante :

mysql

Ensuite, définissez le mot de passe root pour MariaDB avec la commande suivante.

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

Ensuite, créez une base de données pour Django avec la commande suivante :

MariaDB [(none)]> create database testdb;

Vous pouvez voir la base de données créée ci-dessus en utilisant la commande suivante :

MariaDB [(none)]> show databases;

Vous devriez obtenir la sortie suivante :

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

Ensuite, videz les privilèges et quittez l’interface de commande MariaDB avec la commande suivante :

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

Configurer Django pour la connexion MariaDB

Ensuite, vous devrez définir les informations d’identification de la base de données MariaDB dans Django. Vous pouvez le définir en modifiant le fichier settings.py :

nano /opt/Dproject/Dproject/settings.py

Trouvez les lignes suivantes :

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

Et remplacez-les par les lignes suivantes :

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

Enregistrez et fermez le fichier lorsque vous avez terminé. Ensuite, modifiez le fichier d’informations d’identification du client MariaDB comme indiqué ci-dessous :

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

Définissez vos informations d’identification de base de données MariaDB comme indiqué ci-dessous :

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

Enregistrez et fermez le fichier, puis redémarrez le service MariaDB pour appliquer les modifications :

systemctl restart mariadb

Ensuite, changez le répertoire vers le projet Django et migrez les nouvelles modifications avec la commande suivante :

cd /opt/Dproject  
python3 manage.py migrate

Une fois la migration terminée avec succès, vous pouvez passer à l’étape suivante.

Tester la connexion MariaDB

À ce stade, Django est configuré pour se connecter à la base de données MariaDB. Il est temps de le tester.

Pour ce faire, démarrez le serveur Django avec la commande suivante :

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

Une fois le serveur Django démarré avec succès, vous devriez obtenir la sortie suivante :

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.

Vous pouvez maintenant accéder à votre application Django en utilisant l’URL http://your-server-ip:8000. Vous devriez voir votre application Django à l’écran suivant :

Après le test, vous pouvez arrêter le serveur Django à tout moment en appuyant sur CTRL + C dans votre terminal.

Conclusion

Félicitations ! vous avez réussi à installer Django et à le connecter à la base de données MariaDB sur le serveur Debian 10. Vous pouvez maintenant commencer à développer votre application Web et à appliquer des migrations dans votre application Django. N’hésitez pas à me poser des questions si vous en avez.