Installer Automad CMS avec Nginx et SSL Let's Encrypt sur Ubuntu 18.04

Automad est un système de gestion de contenu (CMS) open-source basé sur des fichiers et un moteur de templates écrit en PHP. Tout le contenu est stocké dans des fichiers texte lisibles par l’homme au lieu d’une base de données. Un site Automad est donc entièrement portable, facile à installer et peut être contrôlé par version en utilisant Git ou Mercurial. Il offre néanmoins des fonctionnalités de base de données comme la recherche et le tagging. Le moteur de templates intégré permet même aux développeurs et designers inexpérimentés de créer de beaux thèmes et templates. Dans ce tutoriel, nous allons passer par l’installation et la configuration d’Automad CMS sur un système Ubuntu 18.04 LTS en utilisant NGINX comme serveur web.

Exigences

Les exigences pour installer et exécuter Automad CMS sont les suivantes :

• Version PHP 5.4 ou supérieure.
• Logiciel de serveur web comme Nginx ou Apache.

Prérequis

• Un système d’exploitation Ubuntu 18.04 LTS.
• Un utilisateur non-root avec des privilèges sudo.

Étapes initiales

Vérifiez votre version d’Ubuntu :

lsb_release -ds  
# Ubuntu 18.04.2 LTS

Configurez le fuseau horaire :

sudo dpkg-reconfigure tzdata

Mettez à jour les paquets de votre système d’exploitation (logiciel). C’est une première étape essentielle car cela garantit que vous avez les dernières mises à jour et correctifs de sécurité pour les paquets logiciels par défaut de votre système d’exploitation :

sudo apt update && sudo apt upgrade -y

Installez quelques paquets essentiels nécessaires à l’administration de base du système d’exploitation Ubuntu :

sudo apt install -y curl wget vim git unzip socat bash-completion apt-transport-https

Étape 1 - Installer PHP et les extensions PHP nécessaires

Installez PHP, ainsi que les extensions PHP requises :

sudo apt install -y php7.2 php7.2-cli php7.2-fpm php7.2-common php7.2-mbstring php7.2-xmlrpc php7.2-soap php7.2-gd php7.2-xml php7.2-curl php7.2-zip

Pour afficher les modules PHP compilés, vous pouvez exécuter :

php -m  
  ctype  
  curl  
  exif  
  fileinfo  
  . . .  
  . . .

Vérifiez la version :

php --version  
  # PHP 7.2.19-0ubuntu0.18.04.1 (cli) (built: Jun 4 2019 14:48:12) ( NTS )  
  # Copyright (c) 1997-2018 The PHP Group  
  # Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies  
  # with Zend OPcache v7.2.19-0ubuntu0.18.04.1, Copyright (c) 1999-2018, by Zend Technologies

Le service PHP-FPM est automatiquement démarré et activé au démarrage sur le système Ubuntu 18.04, donc il n’est pas nécessaire de le démarrer et de l’activer manuellement. Nous pouvons passer à l’étape suivante.

Étape 2 - Installer le client acme.sh et obtenir le certificat Let’s Encrypt (optionnel)

Sécuriser votre forum avec HTTPS n’est pas nécessaire, mais c’est une bonne pratique de sécuriser le trafic de votre site. Pour obtenir un certificat TLS de Let’s Encrypt, nous utiliserons le client acme.sh. Acme.sh est un logiciel shell UNIX simple pour obtenir des certificats TLS de Let’s Encrypt avec zéro dépendance.

Téléchargez et installez acme.sh :

sudo su - root  
git clone https://github.com/Neilpang/acme.sh.git  
cd acme.sh   
./acme.sh --install --accountemail [email protected]  
source ~/.bashrc  
cd ~

Vérifiez la version d’acme.sh :

acme.sh --version  
# v2.8.0

Obtenez des certificats RSA et ECC/ECDSA pour votre domaine/nom d’hôte : ``` # RSA 2048 acme.sh --issue --standalone -d example.com --keylength 2048 # ECDSA acme.sh --issue --standalone -d example.com --keylength ec-256 ``` Si vous souhaitez des certificats factices pour les tests, vous pouvez ajouter le drapeau–stagingaux commandes ci-dessus. Après avoir exécuté les commandes ci-dessus, vos *certificats* et *clés* seront dans : - Pour RSA : le répertoire/home/username/example.com. - Pour ECC/ECDSA : le répertoire/home/username/example.com_ecc. Pour lister vos certificats émis, vous pouvez exécuter : ``` acme.sh --list ``` Créez un répertoire pour stocker vos certificats. Nous utiliserons le répertoire/etc/letsencrypt. ```mkdir -p /etc/letsecnrypt/example.comsudo mkdir -p /etc/letsencrypt/example.com_ecc``` Installez/copiez les certificats dans le répertoire /etc/letsencrypt. ``` # RSA acme.sh --install-cert -d example.com --cert-file /etc/letsencrypt/example.com/cert.pem --key-file /etc/letsencrypt/example.com/private.key --fullchain-file /etc/letsencrypt/example.com/fullchain.pem --reloadcmd "sudo systemctl reload nginx.service" # ECC/ECDSA acme.sh --install-cert -d example.com --ecc --cert-file /etc/letsencrypt/example.com_ecc/cert.pem --key-file /etc/letsencrypt/example.com_ecc/private.key --fullchain-file /etc/letsencrypt/example.com_ecc/fullchain.pem --reloadcmd "sudo systemctl reload nginx.service" ``` Tous les certificats seront automatiquement renouvelés tous les 60 jours. Après avoir obtenu les certificats, quittez l'utilisateur root et revenez à l'utilisateur sudo régulier : ``` exit ``` ## Étape 3 - Installer et configurer NGINX Téléchargez et installez NGINX depuis le dépôt Ubuntu : ``` sudo apt install -y nginx ``` Vérifiez la version de NGINX : ``` sudo nginx -v # nginx version: nginx/1.14.0 (Ubuntu) ``` Exécutezsudo vim /etc/nginx/sites-available/automad.confet remplissez le fichier avec la configuration suivante : ``` server { listen [::]:443 ssl http2; listen 443 ssl http2; listen [::]:80; listen 80; # RSA ssl_certificate /etc/letsencrypt/example.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/example.com/private.key; # ECC ssl_certificate /etc/letsencrypt/example.com_ecc/fullchain.pem; ssl_certificate_key /etc/letsencrypt/example.com_ecc/private.key; server_name example.com; root /var/www/automad; index index.php index.html; client_max_body_size 100M; location / { try_files $uri $uri/ /index.php$is_args$args; } location ~ \.php$ { fastcgi_index index.php; fastcgi_pass unix:/var/run/php/php7.2-fpm.sock; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } } ``` Activez la nouvelle configurationautomad.confen liant le fichier au répertoiresites-enabled: ``` sudo ln -s /etc/nginx/sites-available/automad.conf /etc/nginx/sites-enabled/ ``` Vérifiez la configuration de NGINX pour les erreurs de syntaxe : ``` sudo nginx -t ``` Rechargez Nginx : ``` sudo systemctl reload nginx.service ``` ## Étape 4 - Installer Automad CMS Créez un répertoire racine de documents pour Automad : ``` sudo mkdir -p /var/www/automad ``` Naviguez vers le répertoire racine des documents : ``` cd /var/www/automad ``` En utilisantcurl, téléchargez la dernière version d'Automad CMS. N'oubliez pas de mettre à jour les numéros de version s'il y a une version plus récente : ``` sudo curl -O -J -L https://automad.org/download ``` Décompressez l'archive zip : ``` sudo unzip marcantondahmen-automad-6fff2a0456dc.zip ``` Déplacez tous les fichiers Automad vers le répertoire racine des documents et supprimez l'archive zip téléchargée : ``` sudo mv marcantondahmen-automad-6fff2a0456dc/* . && sudo mv marcantondahmen-automad-6fff2a0456dc/.* . sudo rm marcantondahmen-automad-6fff2a0456dc.zip sudo rmdir marcantondahmen-automad-6fff2a0456dc ``` Changez la propriété du répertoire/var/www/automadàwww-data:``` sudo chown -R www-data:www-data /var/www/automad ``` ## Étape 5 - Terminer l'installation d'Automad Comme dernière étape, créez un compte utilisateur pour utiliser l'interface utilisateur basée sur le navigateur appelée le Dashboard. Par conséquent, naviguez vershttps://example.com/dashboard` et suivez les instructions. Avant de pouvoir utiliser le tableau de bord Automad, vous devrez créer un compte : Créez un compte utilisateur en utilisant le formulaire et téléchargez le fichier généré sur votre ordinateur. Après cela, vous devrez déplacer le fichier téléchargé vers le répertoire “/config” dans le répertoire d’installation d’Automad. Après cela, vous pouvez vous connecter au tableau de bord Automad : À la fin, l’interface d’administration d’Automad sera affichée : C’est tout. L’installation d’Automad est terminée. ## Liens - https://automad.org/ - https://bitbucket.org/marcantondahmen/automad/