Dans ce tutoriel nous allons voir comment installer sur notre machine locale Ubuntu 20.04 un projet Python3 – Django.

Les pré-requis

Installation des éléments nécessaires pour Python 3

Ubuntu 20.04 de son nom Focal Fossa est livré avec la version 3.8.2 de python sur la commande python3, cependant il nous faut installer pip, le gestionnaire de paquets Python ainsi que git à travers la commande suivante à exécuter en root :

apt install python3-pip git

Vérifions la bonne installation avec les 2 commandes suivantes :

python3 --version
# Python 3.8.2
pip3 --version
# pip 20.0.2 from /usr/lib/python3/dist-packages/pip (python 3.8)
git --version
# git version 2.25.1

Si vous obtenez une sortie similaire, tout c’est bien passé.

Maintenant nous allons installer le paquet pip virtualenv qui permet de séparer les environnements d’exécutions de vos différentes applications Python 3, avec la commande suivante, en tant qu’utilisateur :

pip3 install virtualenv

A ce moment là, il se peut que vous ayez un warning vous indiquant que le script est dans tel dossier et que celui-ci n’est pas dans la variable PATH.

Pour cela il faut éditer le fichier ~/.bashrc et injecter en fin de fichier la ligne suivante : PATH=$PATH:"CHEMIN_INDIQUE_DANS_LE_WARNING"

Puis appliquer les changements de ce fichier .bashrc en lançant la commande : source ~/.bashrc

Récupérons le code source de l’application

Pour cela en tant qu’utilisateur lancer la commande suivante dans votre dossier de travail : git clone https://gitlab.com/julienanne/django-deploy-production-example

Créons un environnement virtuel Pyhton3 pour notre projet Django

Entrer dans le dossier cd django-deploy-production-example/ et lancer la commande suivante en utilisateur afin de créer un environnement :

virtualenv monenv

Nous venons de créer un nouvel environnement pour notre projet il nous faut maintenant l’activer avec la commande :

source ./monenv/bin/activate

Ce qui devrait avoir pour effet de précéder votre prompt de terminal avec (monenv) cela indique que nous sommes dans l’environnement virtuel python3 se nommant « monenv ».

A partir de ce moment là vous n’aurez plus besoin de faire la commande pip3 pour accéder au gestionnaire de paquets Python3 mais simplement pip car virtualenv ayant été installé avec pip3, la commande pip dans un environnement virtualenv représente maintenant pip3.

Installons les dépendances Python de notre application Django

Pour cela rien de plus simple vu que nous avons figé les dépendances avec la méthode présentée dans ce tutoriel nous avons un fichier requirements.txt contenant tous les noms et les versions des packages pip à installer, il ne nous reste donc qu’à taper la commande suivante à la racine du projet en utilisateur :

pip install -r requirements.txt

Et vous verrez les différents packages s’installer automatiquement. Pour vérifier un petit pip list vous permettra de visualiser le résultat.

S’il n’y a pas de fichier requirements.txt dans votre projet il vous faut aller sur l’environnement où a été créé le projet afin de retrouver toutes les dépendances nécessaires ou suivre les différentes erreurs que vous trouverez lors de vos tests (c’est beaucoup moins marrant).

Lançons notre application afin de vérifier que tout est opérationnel

Pour lancer notre application rien de plus simple, il faut exécuter la commande suivante à la racine du projet : ./manage.py runserver

Pour vérifier que tout est ok il faut se rendre à l’url http://127.0.0.1:8000/, vous devriez voir le texte « Hello, world …. »

Ok donc à ce moment là nous avons un projet qui tourne sur notre poste de développement, vous pouvez donc maintenant le faire évoluer… Passons à la suite. Rendez-vous sur le sommaire du tutoriel pour continuer votre lecture.

Image par Jiradet Inrungruang de Pixabay