Comment installer la page de statut Cachet sur un serveur Ubuntu 24.04

Cachet est un système de page de statut open-source écrit en PHP. Il vous permet de surveiller les temps d’arrêt et les pannes de votre infrastructure. Cachet fournit une API JSO, des rapports, des métriques, plusieurs méthodes de notification et une authentification à deux facteurs.

Dans ce tutoriel, vous apprendrez à installer et à exécuter Cachet sur un serveur Ubuntu 24.04 avec Docker. Vous installerez également et configurerez Nginx en tant que proxy inverse et sécuriserez Cachet avec HTTPS via Certbot et Letsencrypt.

Prérequis

Pour compléter ce guide, assurez-vous d’avoir :

• Un serveur Ubuntu 24.04.
• Un utilisateur non-root avec des privilèges d’administrateur.
• Un nom de domaine pointé vers l’adresse IP du serveur.

Installation de Docker Engine

Dans ce guide, vous exécuterez Cachet en tant que conteneur en utilisant Docker. Vous installerez ensuite Docker Engine sur votre système Ubuntu.

Tout d’abord, exécutez la commande ci-dessous pour installer les paquets ca-certificates et curl.

sudo apt install ca-certificates curl

Maintenant, exécutez la commande suivante pour ajouter la clé GPG pour le dépôt Docker.

sudo install -m 0755 -d /etc/apt/keyrings  
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc  
sudo chmod a+r /etc/apt/keyrings/docker.asc

Ajoutez le dépôt Docker avec ce qui suit :

echo  
“deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu  
(. /etc/os-release && echo "VERSION_CODENAME") stable" |  
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Ensuite, mettez à jour votre index de paquets Ubuntu et installez Docker Engine avec la commande apt suivante. Entrez Y pour confirmer l’installation.

sudo apt update  
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Après l’installation, le service docker devrait être en cours d’exécution et activé sur votre système Ubuntu.

Exécutez la commande ci-dessous pour vérifier le service Docker.

sudo systemctl is-enabled docker  
sudo systemctl status docker

Vous verrez une sortie similaire ci-dessous :

Configuration de l’utilisateur pour exécuter Docker

Après avoir installé Docker, vous devez ajouter votre utilisateur au groupe docker. Cela vous permet d’exécuter le conteneur en tant qu’utilisateur non-root.

Pour ajouter votre utilisateur au groupe docker, exécutez la commande ci-dessous. Changez le nom d’utilisateur avec votre utilisateur.

sudo usermod -aG docker nom_utilisateur

Maintenant, connectez-vous avec votre utilisateur et exécutez la commande docker pour vérifier votre configuration.

su - nom_utilisateur  
docker run hello-world

Si votre configuration est réussie, vous verrez le message Hello World de Docker.

Installation de Cachet avec Docker

Maintenant que vous avez installé Docker Engine et configuré votre utilisateur, vous allez télécharger le projet Cachet, configurer le fichier docker-compose.yml, construire des images et reconfigurer le conteneur pour Cachet, puis exécuter Cachet en tant que conteneur.

Téléchargez la version docker de Cachet dans le répertoire cachet-docker et déplacez-vous dedans.

git clone https://github.com/cachethq/Docker.git cachet-docker  
cd cachet-docker

Éditez le docker-compose.yml en utilisant l’éditeur nano.

nano docker-compose.yml

Changez le port par défaut en 8000 pour le conteneur et l’hôte Docker.

ports:  
 - 8000:8000

Enregistrez le fichier et quittez.

Maintenant, exécutez la commande docker ci-dessous pour construire l’image Cachet et démarrer le conteneur Cachet.

docker compose build  
docker compose up

Pendant le processus de construction, vous verrez ce qui suit :

Lors du démarrage du conteneur Cachet, vous obtiendrez une sortie comme suit :

La première fois que vous exécutez Cachet, il générera une nouvelle APP_KEY comme suit - Copiez l’APP_KEY et appuyez sur Ctrl+c pour terminer les conteneurs Cachet.

Ensuite, éditez à nouveau le fichier docker-compose.yml et remplacez l’APP_KEY comme suit :

APP_KEY=base64:6ltZ62B69p6oxIVeQtf9jpX5BFvgUXU2qk5eXpw3OIQ=

Enregistrez le fichier et quittez.

Maintenant, exécutez la commande docker ci-dessous pour supprimer les anciens conteneurs et les nouveaux conteneurs Cachet.

docker compose down  
docker compose up -d

Enfin, exécutez la commande suivante pour vérifier les conteneurs ou services en cours d’exécution.

docker compose ps

Vous pouvez voir ci-dessous que le conteneur Cachet fonctionne sur le port 8000.

Configuration de Nginx en tant que proxy inverse

Dans ce guide, vous exécuterez Cachet avec Nginx en tant que proxy inverse. Vous allez donc installer Nginx et un nouveau bloc serveur pour un proxy inverse. Assurez-vous que vous avez votre nom de domaine prêt et pointé vers l’adresse IP du serveur.

Pour installer le serveur web Nginx, exécutez la commande apt suivante. Entrez Y pour procéder à l’installation.

sudo apt install nginx

Après l’installation, créez un nouveau fichier de bloc serveur Nginx /etc/nginx/sites-available/cachet.conf avec l’éditeur nano.

sudo nano /etc/nginx/sites-available/cachet.conf

Collez la configuration suivante et assurez-vous de changer status.howtoforge.local avec votre nom de domaine.

server {  
 listen 80;  
 server_name status.howtoforge.local;  
 location / {  
 proxy_pass http://127.0.0.1:8000;  
 proxy_set_header Host $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;  
 }  
}

Lorsque vous avez terminé, enregistrez le fichier et quittez l’éditeur.

Maintenant, exécutez la commande ci-dessous pour activer le fichier de bloc serveur cachet.conf et vérifier votre syntaxe Nginx. Si vous avez une syntaxe correcte, vous verrez une sortie test - réussi - syntaxe ok.

sudo ln -s /etc/nginx/sites-available/cachet.conf /etc/nginx/sites-enabled/  
sudo nginx -t

Enfin, exécutez la commande systemctl ci-dessous pour redémarrer le service Nginx et appliquer vos modifications. Ensuite, vérifiez l’état du service Nginx pour vous assurer qu’il fonctionne.

sudo systemctl restart nginx  
sudo systemctl status nginx

Vous pouvez voir ci-dessous que le service Nginx fonctionne en tant que proxy inverse pour l’installation de Cachet.

Sécurisation de Cachet avec HTTPS

À ce stade, Cachet fonctionne dans un conteneur, et vous avez configuré Nginx en tant que proxy inverse pour lui. Pour sécuriser Cachet, vous allez générer des certificats SSL et mettre en œuvre HTTPS via Certbot et Letsencrypt.

Installez Certbot et le plugin Certbot Nginx en utilisant la commande apt suivante. Appuyez sur Y pour confirmer l’installation.

sudo apt install certbot python3-certbot-nginx

Maintenant, exécutez la commande certbot ci-dessous pour générer des certificats SSL et sécuriser Cachet avec HTTPS. Assurez-vous de changer le nom de domaine et l’adresse e-mail avec vos informations.

sudo certbot --nginx

Une fois le processus terminé, vos certificats SSL seront disponibles dans le répertoire /etc/letsencrypt/live/domain.com et votre installation de Cachet devrait être sécurisée avec HTTPS.

Installation de Cachet

Visitez votre nom de domaine Cachet tel que https://status.howtoforge.local/ en utilisant votre navigateur web préféré. Vous verrez l’assistant d’installation.

Dans la section Configuration de l’environnement, sélectionnez le Cache, la Queue et la Session par défaut comme Base de données et entrez vos détails SMTP.

Créez votre première page de statut et cliquez sur Suivant pour continuer.

Entrez le nouvel utilisateur administrateur, l’adresse e-mail et le mot de passe pour votre installation de Cachet.

Après la fin de l’installation, vous verrez une sortie Cachet a été configuré avec succès. Et ensuite cliquez sur Aller au tableau de bord pour accéder à Cachet.

Entrez votre utilisateur admin et mot de passe, puis cliquez sur Connexion.

Si vous avez les bonnes informations d’identification, vous verrez le tableau de bord Cachet comme suit :

Conclusion

Félicitations ! Vous avez terminé l’installation de la page de statut Cachet sur un serveur Ubuntu 24.04 avec Docker. Vous avez configuré Nginx en tant que proxy inverse pour Cachet et sécurisé Cachet avec HTTPS via Certbot et Letsencrypt. Vous pouvez maintenant ajouter et surveiller vos sites web ou services avec Cachet et configurer des notifications supplémentaires avec des adresses e-mail, etc.