Comment installer la page d'état du cache sur le serveur Ubuntu 24.04

Ce tutoriel existe pour ces versions d'OS

Ubuntu 24.04 (Noble Numbat)
Ubuntu 18.04 (Castor Bionic)

Sur cette page

Conditions préalables
Installation du moteur Docker
Configurer l'utilisateur pour exécuter Docker
Installer Cachet avec Docker
Configurer Nginx comme proxy inverse
Sécuriser le cachet avec HTTPS
Installation du cache
Conclusion

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

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

Conditions préalables

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 pointait vers l'adresse IP du serveur.

Installation du moteur Docker

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

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

sudo apt install ca-certificates curl

Exécutez maintenant la commande suivante pour ajouter la clé GPG pour le référentiel 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 l'index de votre package Ubuntu et installez Docker Engine avec la commande apt suivante. Saisissez 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 doit ê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 un résultat similaire ci-dessous :

Configurer 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 username

Connectez-vous maintenant avec votre utilisateur et exécutez la commande docker pour vérifier votre configuration.

su - username
docker run hello-world

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

Installer 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, créer des images et reconfigurer le conteneur pour Cachet, puis exécuter Cachet en tant que conteneur.

Téléchargez la version Cachet docker dans le répertoire cachet-docker et accédez-y.

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

Modifiez le docker-compose.yml à l'aide de l'éditeur nano.

nano docker-compose.yml

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

ports:
 - 8000:8000

Enregistrez le fichier et quittez.

Exécutez maintenant la commande docker ci-dessous pour créer 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 celle-ci :

La première fois que vous exécuterez Cahet, il générera une nouvelle APP_KEY comme celle-ci : copiez l'APP_KEY et appuyez sur Ctrl+c pour terminer les conteneurs Cachet.

Ensuite, modifiez à nouveau le fichier docker-compose.yml et remplacez APP_KEY comme suit :

APP_KEY=base64:6ltZ62B69p6oxIVeQtf9jpX5BFvgUXU2qk5eXpw3OIQ=

Enregistrez le fichier et quittez.

Exécutez maintenant 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 s'exécute sur le port 8000.

Configurer Nginx comme proxy inverse

Dans ce guide, vous exécuterez Cachet avec Nginx comme proxy inverse. Alors maintenant, vous allez installer Nginx et un nouveau bloc serveur pour un proxy inverse. Assurez-vous que votre nom de domaine est prêt et qu'il pointe vers l'adresse IP du serveur.

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

sudo apt install nginx

Une fois l'installation terminée, créez un nouveau fichier de bloc du 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 modifier le 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;
 }
}

Une fois terminé, enregistrez le fichier et quittez l'éditeur.

Exécutez maintenant la commande ci-dessous pour activer le fichier de blocage du serveur cachet.conf/et vérifiez votre syntaxe Nginx. Si vous avez la syntaxe appropriée, vous verrez une sortie test - réussi - la syntaxe est 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 est en cours d'exécution.

sudo systemctl restart nginx
sudo systemctl status nginx

Vous pouvez voir ci-dessous que le service Nginx s'exécute en tant que proxy inverse pour l'installation de Cachet.

Sécuriser le cachet avec HTTPS

À ce stade, Cachet s'exécute dans un conteneur et vous avez configuré Nginx comme proxy inverse pour celui-ci. Pour sécuriser Cachet, vous générerez des certificats SSL et implémenterez HTTPS via Certbot et Letsencrypt.

Installez le plugin Certbot et Certbot Nginx à l'aide de la commande apt suivante. Appuyez sur Y pour confirmer l'installation.

sudo apt install certbot python3-certbot-nginx

Exécutez maintenant la commande certbot ci-dessous pour générer des certificats SSL et sécuriser le cachet avec HTTPS. Assurez-vous de modifier 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 Cachet devra être sécurisée avec HTTPS.

Installation du cache

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 file d'attente 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 Cachet.

Une fois l'installation terminée, vous verrez une sortie Le cachet a été configuré avec succès. Puis cliquez sur Aller au tableau de bord pour accéder au cachet.

Saisissez votre utilisateur administrateur et votre mot de passe, puis cliquez sur Connexion.

Si vous disposez des informations d'identification correctes, vous verrez le tableau de bord Cachet comme suit :

Conclusion

Félicitations! Vous avez terminé l'installation de la page d'état du Cachet sur un serveur Ubuntu 24.04 avec Docker. Vous avez configuré Nginx comme proxy inverse pour Cachet et sécurisé Cachet avec HTTPS via Certbot et Letsencrypt. Vous pouvez désormais ajouter et surveiller vos sites Web ou services avec Cachet et configurer des notifications supplémentaires avec des adresses e-mail, etc.