Installation du framework web Django sur Ubuntu 20.04

Hark Labs2022-01-24 · 9 min read

Installation du framework web Django sur Ubuntu 20.04

Django est un framework web de haut niveau qui permet le développement rapide de sites web sécurisés et faciles à maintenir. C'est un framework gratuit et open-source écrit en Python. Django est également populaire pour d'autres fonctionnalités telles que la performance, la sécurité, l'évolutivité, la portabilité et la maintenabilité.

Ce guide va montrer comment installer Django et configurer une application web simple sur Ubuntu 20.04.

Django sur Ubuntu

Il existe plusieurs façons d'installer Django sur le système. Chaque méthode répond à un objectif différent.

Installation globale : Django est facilement disponible dans les dépôts de paquets officiels d'Ubuntu. Nous pouvons l'installer directement à l'aide du gestionnaire de paquets APT. Bien que la méthode d'installation soit simple, elle offre moins de flexibilité que d'autres méthodes. De plus, elle peut ne pas contenir la dernière version du framework.
Installation à l'aide de pip dans un environnement virtuel : En utilisant des outils comme venv et virtualenv, nous pouvons créer un environnement virtuel et y installer Django. L'avantage de cette approche est qu'elle n'affecte pas le système global. Elle permet également une personnalisation et des paquets par projet. C'est la méthode la plus pratique et recommandée pour travailler avec Django.
Installation de la version de développement de Django : Django est également disponible sur GitHub. La dernière version de développement aura les dernières fonctionnalités/corrections. Cependant, cela se fait au détriment de potentiels problèmes de performance et de stabilité.

Ce guide suppose que vous disposez d'un serveur Ubuntu correctement configuré. Si vous n’avez pas encore de serveur Ubuntu, vous pouvez suivre notre guide sur comment configurer votre propre serveur Ubuntu.

Installation de Django sur Ubuntu

1. Installation globale à l'aide du gestionnaire de paquets

Django est facilement disponible dans les dépôts de paquets officiels. Le processus d'installation est assez simple. Tout d'abord, mettez à jour l'index des paquets APT :

$ sudo apt update

1	$ sudo apt update

Ensuite, vérifiez la version de Python installée. Par défaut, Ubuntu 20.04 est livré avec Python 3.8 :

$ python3 -V

1	$ python3 -V

Now, we’re ready to install Django:

$ sudo apt install python3-django

1	$ sudo apt install python3-django

Nous pouvons vérifier si l'installation a réussi. Exécutez la commande suivante pour vérifier la version de Django :

$ django-admin --version

1	$ django-admin --version

Cela permet de vérifier que Django est correctement installé. Notez que la version de Django n'est pas la dernière version stable. Au moment de la rédaction de cet article, la dernière version disponible de Django est v3.2.5 (version LTS).

2. Installation de Django avec pip (dans un environnement virtuel)

C'est la méthode recommandée pour installer Django car elle offre le plus de flexibilité. Nous allons générer l'environnement virtuel en utilisant le module venv qui fait partie de la bibliothèque standard de Python 3. Il vous permet de créer des environnements virtuels Python et d'installer des paquets Python sans provoquer de modifications ailleurs dans le système. Vous pouvez avoir de nombreux environnements virtuels avec des configurations uniques.

Commençons. Tout d'abord, nous avons besoin des modules Python pip et venv :

$ sudo apt update
$ sudo apt install python3-pip python3-venv

1 2	$ sudo apt update $ sudo apt install python3-pip python3-venv

Les modules sont installés avec succès. Maintenant, nous allons créer un répertoire dédié pour l'environnement virtuel :

$ mkdir -pv ~/sample_project

1	$ mkdir -pv ~/sample_project

Ensuite, changez le répertoire actif pour le nouveau répertoire :

$ cd ~/sample_project

1	$ cd ~/sample_project

Maintenant, nous pouvons dire à venv de créer un environnement virtuel dans le répertoire. Quant au nom de l'environnement, il doit être descriptif :

$ python3 -m venv sample_project_env

1	$ python3 -m venv sample_project_env

Le module venv créera une copie de Python et de pip dans une structure de répertoires isolée au sein du répertoire du projet. Il contiendra un répertoire portant le nom sélectionné qui contient la hiérarchie de fichiers où tous les paquets sont installés.

Pour installer des paquets supplémentaires, nous devons activer l'environnement :

$ source sample_project_env/bin/activate

1	$ source sample_project_env/bin/activate

L'invite du shell devrait changer pour ressembler à ceci :

Dans l'environnement virtuel, nous pouvons maintenant installer Django :

$ pip install django

1	$ pip install django

Vérifiez si l'installation a réussi :

$ django-admin --version

1	$ django-admin --version

Pour quitter l'environnement virtuel, exécutez la commande suivante :

$ deactivate

1	$ deactivate

3. Installation de la version de développement de Django

La version de développement de Django est directement disponible sur GitHub. Nous utiliserons git pour la cloner et la déployer dans un environnement virtuel.

Tout d'abord, assurez-vous que les outils nécessaires sont installés. La commande suivante installera venv et pip (modules Python) et git:

$ sudo apt update && sudo apt install python3-pip python3-venv git

1	$ sudo apt update && sudo apt install python3-pip python3-venv git

Ensuite, clonez le dépôt Django. Il contiendra toutes les dernières fonctionnalités et corrections de bugs (au détriment de la stabilité). Nous le clonerons dans un répertoire ~/django-dev:

$ git clone git://github.com/django/django ~/django-dev

1	$ git clone git://github.com/django/django ~/django-dev

Changez le répertoire actuel pour le dépôt cloné :

$ cd ~/django-dev

1	$ cd ~/django-dev

Après cela, créez un environnement virtuel en utilisant le module venv de Python :

$ python3 -m venv sample_project_env

1	$ python3 -m venv sample_project_env

Ensuite, activez l'environnement virtuel :

$ source sample_project_env/bin/activate

1	$ source sample_project_env/bin/activate

Maintenant, nous pouvons installer le Django que nous avons cloné depuis GitHub. Ici, le drapeau -e fait référence au mode « modifiable » pour permettre l'installation à partir du contrôle de version :

$ pip install -e ~/django-dev

1	$ pip install -e ~/django-dev

Enfin, vérifiez l'installation :

$ django-admin --version

1	$ django-admin --version

Exemple de projet Django

Jusqu'à présent, nous avons montré comment installer Django sur le système. Maintenant, il est temps de mettre Django en action. Dans cette section, nous allons montrer comment créer un exemple de projet Django. L'exemple de projet sera créé dans un environnement virtuel.

Créez un répertoire pour l'exemple de projet :

$ mkdir -pv ~/django-test

1	$ mkdir -pv ~/django-test

Changez le répertoire actuel pour le répertoire du projet :

$ cd ~/django-test

1	$ cd ~/django-test

Ensuite, utilisez le module venv pour créer un environnement virtuel Python :

$ python3 -m venv dummy_env

1	$ python3 -m venv dummy_env

L'environnement virtuel est prêt. Activez l'environnement :

$ source dummy_env/bin/activate

1	$ source dummy_env/bin/activate

Nous pouvons installer Django dans l'environnement :

$ pip install django

1	$ pip install django

Nous pouvons utiliser django-admin pour construire la base du projet. Ici, l'exemple de projet sera nommé sampleproject. Le projet aura un répertoire dans le répertoire de l'environnement qui contient tous les fichiers nécessaires.

manage.py : Un script de gestion qui administre diverses tâches spécifiques à Django.
projet d'exemple : Un répertoire portant le nom du projet qui contient le code réel du projet.

Cependant, nous ne voulons pas d'un enchevêtrement de trop de répertoires imbriqués. Ainsi, dites à Django de placer les fichiers et les répertoires dans le répertoire actuel :

$ django-admin startproject sampleproject .

1	$ django-admin startproject sampleproject .

L'étape suivante consiste à migrer la base de données. Par défaut, Django utilise SQLite. Les migrations appliquent toutes les modifications apportées aux modèles Django au schéma de la base de données. Exécutez la commande suivante pour migrer la base de données :

$ python manage.py migrate

1	$ python manage.py migrate

Enfin, nous allons créer un utilisateur administrateur pour utiliser l'interface d'administration de Django. Exécutez la commande suivante :

$ python manage.py createsuperuser

1	$ python manage.py createsuperuser

Il vous sera demandé un nom d'utilisateur, une adresse e-mail et un mot de passe pour l'utilisateur.

ALLOWED_HOSTS dans les paramètres de Django

Pour tester l'application, nous devons modifier une certaine directive dans les paramètres de Django. Ouvrez le fichier settings.py dans un éditeur de texte :

$ nano ~/django-test/sampleproject/settings.py

1	$ nano ~/django-test/sampleproject/settings.py

Nous nous intéressons à la directive ALLOWED_HOSTS. Elle décrit une liste d'adresses ou de noms de domaine qui peuvent se connecter à l'instance Django. Toute requête d'hôte entrante provenant d'un hôte qui ne figure pas dans la liste lèvera une exception. Elle est requise par Django pour prévenir certaines classes de vulnérabilités de sécurité.

Entre les crochets, listez les adresses IP ou les noms de domaine associés au serveur Django. Chaque élément sera listé entre guillemets, séparé par une virgule (,). Voici à quoi ressemblerait la structure de la directive :

$ ALLOWED_HOSTS = ['<server_ip_or_domain>', '<server2_ip_or_doman>']

1	$ ALLOWED_HOSTS = ['<server_ip_or_domain>', '<server2_ip_or_doman>']

Enregistrez la liste et fermez l'éditeur.

Tester le serveur

Nous pouvons maintenant démarrer le serveur de déploiement Django. Il présentera un projet Django tout neuf. Notez qu'il ne doit être utilisé qu'à des fins de développement. Pour un déploiement complet, suivez le guide officiel de Django sur le déploiement.

Avant d'accéder au serveur de développement, assurez-vous que le pare-feu autorise l'accès au port 8000. Si vous suivez le guide de configuration du serveur Ubuntu, dites alors à UFW d'ouvrir le port 8000 pour la communication :

$ sudo ufw allow 8000

1	$ sudo ufw allow 8000

UFW est un pare-feu courant disponible sur toutes les principales distributions Linux. Voici un guide expliquant les différentes bases d'UFW. Le serveur de développement est maintenant prêt à fonctionner. Démarrez le serveur :

$ python manage.py runserver <server_ip>:8000

1	$ python manage.py runserver <server_ip>:8000

Ensuite, visitez l'adresse IP du serveur sur le port 8000 dans un navigateur web. Vous arriverez sur la page d'accueil de Django :

$ http://<server_ip>:8000

1	$ http://<server_ip>:8000

Pour accéder au panneau d'administration de Django, ajoutez /admin/ à la fin de l'URL :

$ http://<server_ip>:8000/admin/

1	$ http://<server_ip>:8000/admin/

Saisissez le nom d'utilisateur et le mot de passe de l'administrateur pour accéder à la section d'administration :

Vous pouvez arrêter le serveur en appuyant sur CTRL-C dans le terminal.

Dernières réflexions

Le projet Django offre une base structurelle pour concevoir un site plus complet. Il fournit les principaux outils nécessaires pour alimenter une application web. L'utilisation d'un framework web comme Django vous permet de développer votre projet plus rapidement et de consacrer plus de temps aux aspects uniques de votre application.

Bonne programmation !

Hark Labs

Auteur · CloudSigma

Preslav Dobrev est un designer créatif chez CloudSigma, axé sur une identité commerciale cohérente à travers des canaux marketing traditionnels et innovants. Il excelle à fusionner la vision artistique avec le marketing stratégique pour créer des récits de marque percutants.