Comment installer Django sur Ubuntu 18.04

Django est un framework Web Python de haut niveau gratuit et open source conçu pour aider les développeurs à créer des applications Web sécurisées, évolutives et maintenables.

Il existe différentes méthodes pour installer Django, selon vos besoins. Il peut être installé à l'échelle du système ou dans un environnement virtuel Python à l'aide de pip.

Les packages Django sont également inclus dans les dépôts officiels d'Ubuntu et peuvent être installés à l'aide de apt directeur chargé d'emballage. C'est la méthode la plus simple pour installer Django sur Ubuntu 18.04, mais pas aussi flexible que l'installation dans un environnement virtuel. De plus, la version incluse dans les référentiels est toujours en retard sur la dernière version de Django.

L'objectif principal des environnements virtuels Python est de créer un environnement isolé pour différents projets Python. De cette façon, vous pouvez avoir plusieurs environnements Django différents sur un seul ordinateur et installer une version spécifique d'un module par projet sans craindre que cela n'affecte vos autres installations Django. Si vous installez Django dans l'environnement global, vous ne pouvez installer qu'une seule version de Django sur votre ordinateur.

Installer Django sur Ubuntu 18.04 #

Les sections suivantes fournissent des instructions étape par étape sur la façon d'installer Django dans un environnement virtuel Python sur Ubuntu 18.04.

Installer Python 3 et venv #

Ubuntu 18.04 est livré avec Python 3.6 par défaut. Vous pouvez vérifier que Python 3 est installé sur votre système en tapant :

python3 -V

Le résultat devrait ressembler à ceci :

Python 3.6.6

À partir de Python 3.6, la méthode recommandée pour créer un environnement virtuel est d'utiliser le venv module. Pour installer le python3-venv package qui fournit le venv module exécutez la commande suivante :

sudo apt install python3-venv

Une fois le module installé, nous sommes prêts à créer un environnement virtuel pour notre application Django.

Création d'un environnement virtuel #

Commencez par naviguer vers le répertoire où vous souhaitez stocker vos environnements virtuels Python 3. Il peut s'agir de votre répertoire personnel ou de tout autre répertoire dans lequel votre utilisateur dispose d'autorisations de lecture et d'écriture.

Créez un nouveau répertoire pour votre application Django et naviguez-y :

mkdir my_django_appcd my_django_app

Une fois dans le répertoire, exécutez la commande suivante pour créer votre nouvel environnement virtuel :

python3 -m venv venv

La commande ci-dessus crée un répertoire appelé venv , qui contient une copie du binaire Python, du gestionnaire de packages Pip, de la bibliothèque Python standard et d'autres fichiers de support. Vous pouvez utiliser le nom de votre choix pour l'environnement virtuel.

Pour commencer à utiliser cet environnement virtuel, vous devez l'activer en exécutant le activate script :

source venv/bin/activate

Une fois activé, le répertoire bin de l'environnement virtuel sera ajouté au début du $PATH variable. L'invite de votre shell changera également et affichera le nom de l'environnement virtuel que vous utilisez actuellement. Dans notre cas, c'est venv .

Installer Django #

Maintenant que l'environnement virtuel est activé, vous pouvez utiliser le pip du gestionnaire de packages Python pour installer Django :

pip install django

Dans l'environnement virtuel, vous pouvez utiliser la commande pip au lieu de pip3 et python au lieu de python3 .

Pour vérifier l'installation, utilisez la commande suivante qui imprimera la version de Django :

python -m django --version

Au moment de la rédaction de cet article, la dernière version officielle de Django est la 2.1.2

2.1.2

Votre version de Django peut différer de la version présentée ici.

Création d'un projet Django #

Pour créer un nouveau projet Django nommé mydjangoapp utilisez le django-admin utilitaire de ligne de commande :

django-admin startproject mydjangoapp

La commande ci-dessus va créer un mydjangoapp répertoire dans votre répertoire courant.

tree  mydjangoapp/

mydjangoapp/
|-- manage.py
`-- mydjangoapp
    |-- __init__.py
    |-- settings.py
    |-- urls.py
    `-- wsgi.py

Dans ce répertoire, vous trouverez le script principal de gestion des projets nommé manage.py et un autre répertoire comprenant la configuration de la base de données, Django et les paramètres spécifiques à l'application.

Migrons la base de données et créons un utilisateur administratif.

Commencez par naviguer vers mydjangoapp répertoire :

cd mydjangoapp

Par défaut, Django utilise une base de données SQLite. Pour les applications de production, vous pouvez utiliser PostgreSQL, MariaDB, Oracle ou MySQLDatabase.

Exécutez la commande suivante pour migrer la base de données :

python manage.py migrate

Le résultat ressemblera à ceci :

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 sessions.0001_initial... OK

Une fois la base de données migrée, créez un utilisateur administratif afin de pouvoir utiliser l'interface d'administration de Django :

python manage.py createsuperuser

La commande vous demandera un nom d'utilisateur, une adresse e-mail et un mot de passe pour votre utilisateur administratif.

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

Test du serveur de développement #

Démarrez le serveur Web de développement à l'aide de manage.py script suivi du runserver choix :

python manage.py runserver

Vous verrez le résultat suivant :

Performing system checks...

System check identified no issues (0 silenced).
October 20, 2018 - 11:16:28
Django version 2.1.2, using settings 'mydjangoapp.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

Si vous avez installé Django sur une machine virtuelle et que vous souhaitez accéder au serveur de développement Django, vous devrez modifier le fichier settings.py fichier et ajoutez l'adresse IP du serveur dans le ALLOWED_HOSTS liste.

Ouvrez http://127.0.0.1:8000 dans votre navigateur Web et la page d'accueil par défaut de Django vous sera présentée :

Vous pouvez accéder à l'interface d'administration de Django, en ajoutant /admin/ à la fin de l'URL (http://127.0.0.1:8000/admin/ ). Cela vous amènera à l'écran de connexion de l'administrateur :

Entrez votre nom d'utilisateur et votre mot de passe et vous serez redirigé vers la page d'administration de Django :

Pour arrêter le serveur de développement tapez CTRL-C dans votre terminal.

Désactivation de l'environnement virtuel #

Une fois que vous avez terminé votre travail, désactivez l'environnement en tapant deactivate et vous reviendrez à votre shell normal.

deactivate