TOC

Comment installer le framework Web Django sur Debian 8

introduction

Django est un framework Web Python complet pour développer des applications et des sites Web dynamiques. En utilisant Django, vous pouvez créer rapidement des applications Web Python et vous appuyer sur le framework pour faire beaucoup de travail.

Dans ce guide, nous allons vous montrer comment faire fonctionner Django sur un serveur Debian 8. Après l’installation, nous vous montrerons comment démarrer un nouveau projet à utiliser comme base pour votre site.

Conditions préalables

Avant de commencer, vous devriez avoir un utilisateur non root avec les privilèges + sudo + disponibles sur votre serveur Debian 8. Pour le configurer, suivez notre Debian 8 Guide de configuration du serveur.

Lorsque vous êtes prêt à continuer, lisez ci-dessous pour décider de la méthode d’installation la mieux adaptée à votre situation.

Méthodes d’installation disponibles

Vous pouvez installer Django de différentes manières en fonction de vos besoins et de la manière dont vous souhaitez configurer votre environnement de développement. Celles-ci présentent des avantages différents et une méthode peut se prêter mieux à votre situation spécifique que d’autres.

Certaines des différentes méthodes sont ci-dessous:

  • * link: # global-install-from-packages [Installation globale à partir de paquets] *: Les référentiels Debian officiels contiennent des paquets Django qui peuvent être installés facilement avec le gestionnaire de paquets conventionnel + apt +. C’est très simple, mais pas aussi flexible que d’autres méthodes. En outre, la version contenue dans les référentiels peut être en retard par rapport aux versions officielles disponibles dans le projet.

  • * link: # global-install-through-pip [Installation globale via pip] *: L’outil + pip + est un gestionnaire de paquets pour les paquets Python. Si vous installez + pip +, vous pouvez facilement installer Django au niveau système pour pouvoir être utilisé par n’importe quel utilisateur. Cela devrait toujours contenir la dernière version stable. Même dans ce cas, les installations mondiales sont intrinsèquement moins flexibles.

  • * link: # virtualenv-install-through-pip [Installation via pip dans un Virtualenv] *: Le package + virtualenv + de Python vous permet de créer des environnements autonomes pour divers projets. En utilisant cette technologie, vous pouvez installer Django dans un répertoire de projet sans affecter les packages au niveau du système. Cela vous permet de fournir facilement des personnalisations et des packages par projet. Les environnements virtuels ajoutent un léger surcoût mental et de processus par rapport à une installation accessible globalement, mais offrent le plus de flexibilité.

  • * link: # development-version-install-through-git [Version de développement Installer via git] *: Si vous souhaitez installer la dernière version de développement à la place de la version stable, vous devrez acquérir le code depuis le + git + repo. Cela peut être nécessaire pour obtenir les dernières fonctionnalités / corrections et peut être effectué globalement ou localement. Les versions de développement n’ont cependant pas les mêmes garanties de stabilité.

En tenant compte des mises en garde et des qualités ci-dessus, choisissez la méthode d’installation qui répond le mieux à vos besoins en vous servant des instructions ci-dessous. Ensuite, assurez-vous de consulter la section sur le lien: # créer-un-exemple-projet [créer un exemple de projet] pour apprendre à démarrer.

Installation globale à partir de packages

Si vous souhaitez installer Django en utilisant les référentiels Debian, le processus est très simple.

Commencez par mettre à jour votre index de paquet local avec + apt +:

sudo apt-get update

Ensuite, sélectionnez la version Python que vous souhaitez utiliser avec Django. Pour * Python 2 *, tapez:

sudo apt-get install python-django

Si, au contraire, vous souhaitez utiliser * Python 3 * avec Django, tapez:

sudo apt-get install python3-django

Vous pouvez vérifier que l’installation a réussi en tapant:

django-admin --version
Output1.7.11

Cela signifie que le logiciel a été installé avec succès. Vous remarquerez peut-être aussi que la version de Django n’est pas la dernière version stable. Pour en savoir un peu plus sur l’utilisation du logiciel, passez à l’aventure sur https://www.digitalocean.com/community/tutorials/how-to-install-the-django-web-framework-on-debian-8#creating. -a-sample-project [comment créer un exemple de projet].

Installation globale via pip

Si vous souhaitez installer la dernière version de Django de manière globale, une meilleure option consiste à utiliser + pip +, le gestionnaire de paquets Python. Premièrement, nous devons installer le gestionnaire de paquets + pip +. Actualisez votre index de paquetage + apt +:

sudo apt-get update

Maintenant, vous pouvez installer les packages appropriés et terminer l’installation. Les packages et les commandes dont vous avez besoin dépendent de la version de Python que vous prévoyez d’utiliser avec vos projets.

Python 2

Si vous prévoyez d’utiliser Python 2, installez + pip +, le gestionnaire de packages Python, à l’aide de la commande suivante:

sudo apt-get install python-pip

Maintenant que vous avez le + pip +, vous pouvez facilement installer Django en tapant:

sudo pip install django

Vous pouvez vérifier que l’installation a réussi en tapant:

django-admin --version
Output1.10.4

Comme vous pouvez le constater, la version disponible via + pip + est plus à jour que celle des référentiels Debian (la vôtre sera probablement différente de celle ci-dessus).

Python 3

Si vous envisagez d’utiliser * Python3 *, installez + pip en utilisant cette commande:

sudo apt-get install python3-pip

Ensuite, nous pouvons utiliser le gestionnaire de paquets + pip + pour installer Django en tapant:

sudo pip3 install django

Pour vérifier que l’installation s’est terminée correctement, tapez:

django-admin --version
Output1.10.4

La version installée via + pip + devrait être la dernière version stable (la version spécifique peut être différente de celle présentée ci-dessus).

Virtualenv Installer via pip

Le moyen le plus flexible d’installer Django sur votre système est probablement l’outil + virtualenv +. Cet outil vous permet de créer des environnements Python virtuels dans lesquels vous pouvez installer les packages Python de votre choix sans affecter le reste du système. Cela vous permet de sélectionner des packages Python projet par projet, indépendamment des conflits avec les exigences d’autres projets.

Nous allons commencer par installer + pip + à partir des dépôts Debian. Actualisez votre index de paquet local avant de commencer:

sudo apt-get update

Les packages et les commandes nécessaires à l’installation de Django diffèrent selon la version de Python que vous souhaitez utiliser pour vos projets. Suivez les instructions ci-dessous pour la version de Python que vous prévoyez d’utiliser.

Python 2

La première étape consiste à installer + pip + globalement. Lorsque vous utilisez Python 2, la commande à effectuer est la suivante:

sudo apt-get install python-pip

Une fois que + pip + est installé, vous pouvez l’utiliser pour installer le paquet + virtualenv + en tapant:

sudo pip install virtualenv

Désormais, chaque fois que vous démarrez un nouveau projet, vous pouvez créer un environnement virtuel pour celui-ci. Commencez par créer et déplacer dans un nouveau répertoire de projet:

mkdir ~/
cd ~/

Maintenant, créez un environnement virtuel dans le répertoire du projet en tapant:

virtualenv

Cela installera une version autonome de Python, ainsi que + pip +, dans une structure de répertoires isolée dans le répertoire de votre projet. Nous avons choisi d’appeler notre environnement virtuel ++, mais vous pouvez le nommer de manière descriptive. Un répertoire sera créé avec le nom que vous sélectionnez, qui contiendra la hiérarchie de fichiers où vos packages seront installés.

Pour installer des packages dans l’environnement isolé, vous devez l’activer en tapant:

cd ~/
source /bin/activate

Votre invite devrait changer pour indiquer que vous vous trouvez maintenant dans votre environnement virtuel. Cela ressemblera à quelque chose comme + () nom_utilisateur @ nom_hôte: ~ / nom_projet $ +.

Dans votre nouvel environnement, vous pouvez utiliser + pip + pour installer Django. Vous n’avez pas besoin d’utiliser + sudo + puisque vous installez localement:

pip install django

Vous pouvez vérifier l’installation en tapant:

django-admin --version
Output1.10.4

Comme vous pouvez le constater, Django a été installé dans l’environnement virtuel.

Python 3

La première étape consiste à installer + pip + globalement. Pour ce faire avec Python 3, tapez:

sudo apt-get install python3-pip

Ensuite, utilisez le gestionnaire de paquetages que vous venez d’installer pour installer le paquet Python + virtualenv +:

sudo pip3 install virtualenv

Créez ensuite un environnement virtuel pour contenir les packages de votre nouveau projet. Commencez par créer et déplacer dans un nouveau répertoire de projet:

mkdir ~/
cd ~/

Créez un environnement virtuel dans le répertoire du projet en tapant:

virtualenv

Cela installera une version autonome de Python, ainsi que + pip +, dans une structure de répertoires isolée dans le répertoire de votre projet. Un répertoire sera créé avec le nom passé en argument. Nous avons choisi «++» ici. Ce répertoire contiendra la hiérarchie de fichiers où vos packages seront installés.

Avant d’installer des packages dans l’environnement virtuel, vous devez l’activer en tapant:

cd ~/
source /bin/activate

Votre invite de commande doit maintenant porter le nom de votre environnement virtuel. Cela ressemblera à quelque chose comme + () nom_utilisateur @ nom_hôte: ~ / nom_projet $ +.

Dans votre nouvel environnement, utilisez + pip + pour installer Django. Notez que même si nous utilisons Python 3, la commande within de l’environnement virtuel est + pip + (pas + + pip3 +). Notez également que vous n’avez pas besoin d’utiliser + sudo + puisque vous installez localement:

pip install django

Vous pouvez vérifier l’installation en tapant:

django-admin --version
Output1.10.4

Comme vous pouvez le constater, Django a été installé dans l’environnement virtuel.

Version de développement Installer via git

Si vous avez besoin d’une version de développement de Django, vous devrez télécharger et installer Django à partir du référentiel + git + du projet.

Pour ce faire, vous allez d’abord installer + git + sur votre système avec + apt +. Nous aurons également besoin de + pip +, qui est utilisé pour installer à partir du code source téléchargé. Les noms de paquet et les commandes dépendent de la version de Python que vous prévoyez d’utiliser avec Django.

Python 2

Si vous utilisez Python 2, vous pouvez mettre à jour votre index de package et installer les packages nécessaires en tapant:

sudo apt-get update
sudo apt-get install git python-pip

Une fois que vous avez + git +, vous pouvez cloner le référentiel Django. Entre les versions, ce référentiel aura plus de fonctionnalités mises à jour et de corrections de bugs aux dépens de la stabilité. Vous pouvez cloner le référentiel dans un répertoire appelé + django-dev + dans votre répertoire personnel en tapant:

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

Une fois le référentiel cloné, vous pouvez l’installer à l’aide de + pip +. Nous allons utiliser l’option + -e + pour installer en mode «éditable», nécessaire lors de l’installation à partir du contrôle de version. Si vous utilisez la version 2 de Python, tapez:

sudo pip install -e ~/django-dev

Vous pouvez vérifier que l’installation a réussi en tapant:

django-admin --version
Output1.11.dev20161220175814

Gardez à l’esprit que vous pouvez combiner cette stratégie avec + virtualenv + si vous souhaitez installer une version de développement de Django dans un seul environnement.

Python 3

Si vous utilisez * Python 3 *, mettez à jour votre index de paquet et installez + git + et + pip + en tapant:

sudo apt-get update
sudo apt-get install git python3-pip

Ensuite, vous pouvez cloner le référentiel Django dans un répertoire appelé + django-dev + dans votre répertoire personnel en tapant:

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

Vous pouvez installer Django directement à partir du répertoire + git + avec + pip +. L’option + -e + nous permet d’installer en mode «éditable», nécessaire lors de l’installation à partir de référentiels de contrôle de version:

sudo pip3 install -e ~/django-dev

Vous pouvez vérifier que l’installation a réussi en tapant:

django-admin --version
Output1.11.dev20161220175814

Si vous souhaitez installer la version de développement dans un environnement isolé, vous pouvez combiner cette stratégie avec la stratégie + virtualenv +.

Création d’un exemple de projet

Une fois que Django est installé, nous pouvons vous montrer comment démarrer un projet.

Créer les bases du projet

Utilisez la commande + django-admin + pour créer un projet. Cela créera un répertoire appelé «» dans votre répertoire actuel. Dans ce nouveau répertoire, un script de gestion sera créé et un autre répertoire appelé `` sera créé avec le code réel.

Pour créer la structure de répertoires complète (répertoire de projet parent, script de gestion et répertoire de projet interne), tapez:

django-admin startproject
cd

Pour amorcer la base de données (SQLite est utilisé par défaut), tapez:

./manage.py migrate

Ensuite, créez un utilisateur administratif en tapant:

./manage.py createsuperuser

Vous serez invité à sélectionner un nom d’utilisateur, une adresse e-mail et un mot de passe pour l’utilisateur.

Modification de ALLOWED_HOSTS dans les paramètres Django

Avant de pouvoir tester votre application, vous devez modifier l’une des directives dans les paramètres Django.

Ouvrez le fichier de paramètres en tapant:

nano ~///settings.py

À l’intérieur, localisez la directive + ALLOWED_HOSTS +. Ceci définit une liste blanche d’adresses ou de noms de domaines pouvant être utilisés pour se connecter à l’instance de Django. Toute demande entrante avec un en-tête * Host * qui ne figure pas dans cette liste déclenchera une exception. Django exige que vous définissiez cela pour empêcher une certaine classe de vulnérabilité de sécurité.

Entre les crochets, répertoriez les adresses IP ou les noms de domaine associés à votre serveur Django. Chaque élément doit être répertorié * entre guillemets * avec des entrées * séparées par une virgule *. Si vous souhaitez répondre aux demandes d’un domaine et de tout sous-domaine, ajoutez une période au début de l’entrée. Dans l’extrait de code ci-dessous, quelques exemples commentés sont utilisés pour illustrer la manière correcte de formater les entrées:

~ / monprojet / monprojet / settings.py

. . .
# The simplest case: just add the domain name(s) and IP addresses of your Django server
# ALLOWED_HOSTS = [ 'example.com', '203.0.113.5']
# To respond to 'example.com' and any subdomains, start the domain with a dot
# ALLOWED_HOSTS = ['.example.com', '203.0.113.5']
ALLOWED_HOSTS = ['', '', ]

Lorsque vous avez terminé, enregistrez et fermez le fichier.

Test avec votre serveur de développement

Ensuite, démarrez le serveur de développement Django pour voir à quoi ressemble un nouveau projet Django. Vous ne devriez utiliser ceci qu’à des fins de développement.

Démarrez le serveur de développement en tapant:

~//manage.py runserver 0.0.0.0:8000

Visitez l’adresse IP de votre serveur suivie de «+: 8000 +» dans votre navigateur Web.

http://:8000

Vous devriez voir quelque chose qui ressemble à ceci:

image: https: //assets.digitalocean.com/articles/django_1404/django_default.png [Page publique de Django]

Maintenant, ajoutez + / admin + à la fin de votre URL pour accéder à la page de connexion de l’administrateur:

:8000/admin

image: https: //assets.digitalocean.com/articles/django_1404/django_admin_login.png [Connexion à l’administrateur Django]

Si vous entrez le nom d’utilisateur et le mot de passe de l’administrateur que vous venez de créer, vous devriez être dirigé vers la section admin du site:

image: https: //assets.digitalocean.com/articles/django_1404/django_admin_page.png [page d’administration Django]

Lorsque vous avez fini de parcourir le site par défaut, vous pouvez arrêter le serveur de développement en tapant + CTRL-C + dans votre terminal.

Le projet Django que vous avez créé fournit la base structurelle pour la conception d’un site plus complet. Consultez la https://docs.djangoproject.com [documentation Django] pour plus d’informations sur la création de vos applications et la personnalisation de votre site.

Conclusion

Django devrait maintenant être installé sur votre serveur Debian 8, fournissant les principaux outils dont vous avez besoin pour créer de puissantes applications Web. Vous devez également savoir comment démarrer un nouveau projet et lancer le serveur de développeur. Exploiter un environnement Web complet tel que Django peut accélérer le développement, vous permettant de vous concentrer uniquement sur les aspects uniques de vos applications.

Related