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 référentiels officiels d'Ubuntu et peuvent être installés à l'aide du gestionnaire de packages apt . 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.

Le but 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 sur une base par projet sans vous soucier que cela affectera 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

La sortie devrait ressembler à ceci:

Python 3.6.6

À partir de Python 3.6, la méthode recommandée pour créer un environnement virtuel consiste à utiliser le module venv . Pour installer le package python3-venv qui fournit le module venv 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 accéder au répertoire dans lequel 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 accédez-y:

mkdir my_django_app cd 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, le gestionnaire de packages Pip, la bibliothèque Python standard et d'autres fichiers de prise en charge. 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 script d' activate :

source venv/bin/activate

Une fois activé, le répertoire bin de l'environnement virtuel sera ajouté au début de la variable $PATH . 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 gestionnaire de packages Python pip 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 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 l'utilitaire de ligne de commande django-admin :

django-admin startproject mydjangoapp

La commande ci-dessus créera un répertoire mydjangoapp dans votre répertoire actuel.

tree mydjangoapp/

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

À l'intérieur de 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 et 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 le répertoire mydjangoapp :

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 MySQL Database.

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

python manage.py migrate

La sortie 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 pour 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 administrateur.

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 du script manage.py suivi de l'option runserver :

python manage.py runserver

Vous verrez la sortie suivante:

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 et ajouter l'adresse IP du serveur dans la liste ALLOWED_HOSTS .

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

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

Désactiver 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

Conclusion

Vous avez appris à créer un environnement virtuel Python et à installer Django sur votre machine Ubuntu 18.04. Pour créer des environnements de développement Django supplémentaires, répétez les étapes décrites dans ce didacticiel.

python ubuntu