Dans ce tutoriel, nous allons vous montrer comment installer Wagtail sur un VPS Debian 9.
Wagtail est un framework d'application Web gratuit, open source et basé sur Python. En plus de cela, Wagtail est également un CMS populaire qui utilise le framework Django. Il dispose d'un ensemble de composants utiles qui aident les développeurs à créer leurs applications rapidement et facilement.
Wagtail est construit et entretenu par des développeurs expérimentés et est utilisé par certaines des plus grandes entreprises et gouvernements du monde. L'installation de Wagtail sur Debian 9 est une tâche facile si vous suivez attentivement les étapes ci-dessous. Pour ce tutoriel, nous allons installer Wagtail en utilisant pip dans un environnement virtuel. Commençons par l'installation.
Prérequis
- Un VPS Debian 9
- Accès SSH avec privilèges root (ou accès à un compte administrateur avec privilèges sudo)
Étape 1 :Connectez-vous via SSH et mettez à jour le système
Connectez-vous à votre VPS Debian 9.
ssh root@IP_Address -p Port_number
Vous pouvez vérifier si vous avez la bonne version de Debian installée sur votre serveur avec la commande suivante :
# lsb_release -a
Vous devriez obtenir ce résultat :
Distributor ID: Debian Description: Debian GNU/Linux 9.9 (Stretch) Release: 9.9 Codename: stretch
Ensuite, exécutez la commande suivante pour vous assurer que tous les packages installés sur le serveur sont mis à jour vers leurs dernières versions disponibles :
# apt update && apt upgrade
Avec cela à l'écart, nous pouvons commencer à installer les packages dont nous aurons besoin.
Étape 2 :Installer Python et pip
Pour procéder à l'installation de Wagtail, nous devons d'abord installer Python 3. Cela peut être fait en entrant cette commande suivante. Cela installe également le gestionnaire de packages "pip" pour Python, ainsi que le package d'environnement virtuel pour Python :
# apt install python3 python3-pip python3-venv
Nous devons maintenant créer un environnement virtuel.
Étape 3 :Créer un environnement virtuel
Nous allons maintenant installer un environnement virtuel via un utilisateur système. Si vous n'avez pas d'utilisateur système autre que le compte root, veuillez d'abord créer un compte, puis l'ajouter à la liste des "sudoers". Veuillez consulter ce tutoriel pour voir comment cela peut être fait. Exécutez cette commande suivante pour installer "virtualenv" à l'aide de pip3.
# pip3 install virtualenv
Une fois l'environnement virtuel installé, vous pouvez procéder à la création de l'environnement virtuel Wagtail. Nous l'appelons "wagtailvenv", mais vous pouvez l'appeler comme vous voulez.
# su - rh $ virtualenv wagtailvenv
La commande créera un environnement virtuel dans /home/rh/wagtailvenv .
Étape 4 :Installez Wagtail dans virtualenv
Alors que nous sommes toujours connectés en tant qu'utilisateur "rh", nous allons maintenant installer Wagtail sur l'environnement virtuel que nous avons créé précédemment :
$ source ~/wagtailvenv/bin/activate
Comme vous pouvez le voir à l'écran, l'invite de votre terminal SSH est devenue l'invite de l'environnement virtuel :
Vous êtes maintenant dans l'environnement virtuel - procédons à l'installation de Wagtail.
(wagtailvenv) rh@rose:~$ pip install wagtail
Faites attention à la commande - même si nous utilisons Python 3 dans l'environnement virtuel Python, veuillez utiliser la commande 'pip' au lieu de 'pip3'. En effet, l'outil d'environnement virtuel est toujours nommé pip, quelle que soit la version de Python que nous utilisons.
Étape 5 :Créer un projet Wagtail
Wagtail a maintenant été installé sous l'utilisateur "rh". Maintenant, créons un exemple de projet :
(wagtailvenv) rh@rose:~$:~$ cd ~ (wagtailvenv) rh@rose:~$:~$ wagtail start newproject
La commande créera un projet nommé "newproject", et cela créera également un répertoire "newproject" dans /home/rh/ .
Ensuite, exécutez les commandes suivantes pour démarrer le nouveau projet.
(wagtailvenv) rh@rose:~$:~$ cd newproject (wagtailvenv) rh@rose:~$:~$ python manage.py migrate (wagtailvenv) rh@rose:~$:~$ python manage.py createsuperuser (wagtailvenv) rh@rose:~$:~$ python manage.py runserver 0.0.0.0:8000
Lors de la création du superutilisateur, il vous sera demandé un mot de passe et une adresse e-mail - veuillez fournir les informations d'identification.
Maintenant, ouvrez votre navigateur Web préféré et accédez à votre adresse IP :8000. Dans cet exemple, nous avons installé Wagtail sur 192.168.1.231, nous devons donc aller sur http://192.168.1.231:8000 pour voir l'interface web. Voici à quoi cela ressemble :
Vous pouvez accéder à la page d'administration de Wagtail sur http://192.168.1.231:8000/admin – utilisez les informations d'identification que vous avez choisies lors de la création du superutilisateur Wagtail à l'étape précédente.
Étape 6 :Installez Gunicorn
Pour mieux gérer l'application Wagtail, nous devons installer Gunicorn. Gunicorn est un serveur HTTP python "Web Server Gateway Interface" (WGSI). Il s'agit d'un modèle de travail pré-fork, porté à partir du projet Ruby's Unicorn. Le serveur Gunicorn est largement compatible avec un certain nombre de frameworks Web, peut être implémenté simplement, consomme peu de ressources serveur et est assez rapide. Installez-le en exécutant ces commandes :
(wagtailvenv) rh@rose:~$ pip install gunicorn (wagtailvenv) rh@rose:~$ cd ~/newproject (wagtailvenv) rh@rose:~$ python manage.py collectstatic (wagtailvenv) rh@rose:~$ deactivate (wagtailvenv) rh@rose:~$ exit
Ce que nous allons faire maintenant, c'est faire de Gunicorn un service système, de cette façon nous pouvons le démarrer et l'arrêter à volonté en utilisant "systemctl". Maintenant, créez ce fichier à l'aide de votre éditeur de texte préféré et assurez-vous que le contenu de votre fichier de configuration correspond au contenu de cet exemple. Bien entendu, n'oubliez pas de remplacer le nom d'utilisateur par le nom de votre compte administrateur :
# nano /etc/systemd/system/gunicorn.service
[Unit] Description=gunicorn daemon After=network.target [Service] User=rh Group=www-data WorkingDirectory=/home/rh/newproject ExecStart=/home/rh/wagtailvenv/bin/gunicorn --access-logfile - --workers 3 --bind unix:/home/rh/newproject.sock newproject.wsgi:application [Install] WantedBy=multi-user.target
Une fois les modifications effectuées, enregistrez et quittez le fichier, puis rechargez tous les démons afin que le nouveau fichier de configuration soit reconnu :
# systemctl daemon-reload
Maintenant, nous pouvons démarrer/arrêter/redémarrer l'application Wagtail en utilisant la commande systemctl :
# systemctl start gunicorn
Si vous voulez l'exécuter au démarrage, nous devrons l'activer :
# systemctl enable gunicorn
Étape 7 :Installer Nginx
Gunicorn a été configuré avec succès. Cependant, si vous souhaitez accéder à l'application en utilisant votre nom de domaine et ne pas avoir besoin du numéro de port, nous devons installer et configurer un serveur Web. Pour ce didacticiel, nous allons installer et configurer Nginx pour passer le proxy à gunicorn.
# apt install nginx
Créons un fichier de bloc de serveur Nginx. assurez-vous de remplacer votredomaine.com par votre nom de domaine actuel. Créez ce fichier à l'aide de votre éditeur de texte préféré et ajoutez-y ce contenu :
# nano /etc/nginx/sites-enabled/yourdomain.com.conf
server {
listen 80;
server_name yourdomain.com;
location = /favicon.ico { access_log off; log_not_found off; }
location /static/ {
root /home/rh/newproject;
}
location / {
proxy_set_header Host $http_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_pass http://unix:/home/rh/newproject.sock;
}
}
Enregistrez et quittez une fois terminé. Ensuite, vérifiez s'il y a des erreurs en utilisant la première commande. S'il n'y en a pas, vous pouvez alors démarrer Nginx. Nous vous recommandons également d'activer Nginx pour qu'il démarre également au démarrage :
# nginx -t # systemctl start nginx # systemctl enable nginx
Pour autoriser Nginx à accéder à votre application Wagtail, nous devons ajouter l'utilisateur Nginx au groupe d'utilisateurs qui exécute Wagtail :
# usermod -aG www-data rh
Ensuite, nous devons également modifier les autorisations de répertoire du répertoire personnel de l'utilisateur Wagtail :
# chmod 710 /home/rh
Redémarrez ensuite Nginx pour accepter les modifications :
# systemctl restart nginx
Voilà, vous devriez pouvoir accéder à votre application Wagtail sur http://yourdomain.com maintenant.
Bien sûr, vous n'êtes pas obligé d'installer Wagtail sur Debian 9 si vous utilisez l'un de nos services d'hébergement Debian géré, auquel cas vous pouvez simplement demander à nos administrateurs Linux experts d'installer Wagtail sur votre VPS Debian pour vous. Ils sont disponibles 24h/24 et 7j/7 et prendront immédiatement en charge votre demande.
PS. Si vous avez aimé cet article sur l'installation de Wagtail sur Debian 9, partagez-le avec vos amis sur les réseaux sociaux à l'aide des boutons ci-dessous ou laissez simplement une réponse dans les sections de commentaires. Merci.