So installieren Sie die Cachet-Statusseite auf einem Ubuntu 24.04-Server

Cachet ist ein Open-Source-Statusseitensystem, das in PHP geschrieben ist. Es ermöglicht Ihnen, Ausfallzeiten und Systemfehler in Ihrer Infrastruktur zu überwachen. Cachet bietet eine JSO-API, sogar Berichte, Metriken, mehrere Benachrichtigungsmethoden und Zwei-Faktor-Authentifizierung.

In diesem Tutorial lernen Sie, wie Sie Cachet auf einem Ubuntu 24.04-Server mit Docker installieren und ausführen. Sie installieren und richten auch Nginx als Reverse-Proxy ein und sichern Cachet mit HTTPS über Certbot und Letsencrypt.

Voraussetzungen

Um diese Anleitung abzuschließen, stellen Sie sicher, dass Sie:

• Einen Ubuntu 24.04-Server.
• Einen Nicht-Root-Benutzer mit Administratorrechten.
• Einen Domainnamen, der auf die Server-IP-Adresse verweist.

Docker-Engine installieren

In dieser Anleitung führen Sie Cachet als Container mit Docker aus. Sie installieren dann die Docker-Engine auf Ihrem Ubuntu-System.

Zuerst führen Sie den folgenden Befehl aus, um die Pakete ca-certificates und curl zu installieren.

sudo apt install ca-certificates curl

Führen Sie nun den folgenden Befehl aus, um den GPG-Schlüssel für das Docker-Repository hinzuzufügen.

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

Fügen Sie das Docker-Repository mit folgendem hinzu:

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

Als Nächstes aktualisieren Sie Ihr Ubuntu-Paket-Index und installieren die Docker-Engine mit dem folgenden apt-Befehl. Geben Sie Y ein, um die Installation zu bestätigen.

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

Nach der Installation sollte der Docker-Dienst auf Ihrem Ubuntu-System ausgeführt und aktiviert sein.

Führen Sie den folgenden Befehl aus, um den Docker-Dienst zu überprüfen.

sudo systemctl is-enabled docker  
sudo systemctl status docker

Sie sehen eine ähnliche Ausgabe:

Benutzer einrichten, um Docker auszuführen

Nach der Installation von Docker müssen Sie Ihren Benutzer zur Docker-Gruppe hinzufügen. Dadurch können Sie den Container als Nicht-Root-Benutzer ausführen.

Um Ihren Benutzer zur Docker-Gruppe hinzuzufügen, führen Sie den folgenden Befehl aus. Ändern Sie den Benutzernamen mit Ihrem Benutzer.

sudo usermod -aG docker username

Melden Sie sich nun mit Ihrem Benutzer an und führen Sie den Docker-Befehl aus, um Ihre Konfiguration zu überprüfen.

su - username  
docker run hello-world

Wenn Ihre Konfiguration erfolgreich ist, sehen Sie die Hello World-Nachricht von Docker.

Cachet mit Docker installieren

Jetzt, da Sie die Docker-Engine installiert und Ihren Benutzer konfiguriert haben, laden Sie das Cachet-Projekt herunter, richten die docker-compose.yml-Datei ein, erstellen Bilder und konfigurieren den Container für Cachet neu und führen dann Cachet als Container aus.

Laden Sie die Docker-Version von Cachet in das Verzeichnis cachet-docker herunter und wechseln Sie in dieses Verzeichnis.

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

Bearbeiten Sie die docker-compose.yml mit dem Nano-Editor.

nano docker-compose.yml

Ändern Sie den Standardport auf 8000 für sowohl den Container als auch den Docker-Host.

ports:  
 - 8000:8000

Speichern Sie die Datei und beenden Sie.

Führen Sie nun den Docker-Befehl aus, um das Cachet-Image zu erstellen und den Cachet-Container zu starten.

docker compose build  
docker compose up

Während des Build-Prozesses sehen Sie Folgendes:

Beim Starten des Cachet-Containers erhalten Sie eine Ausgabe wie die folgende:

Beim ersten Ausführen von Cachet wird ein neuer APP_KEY generiert, der wie folgt aussieht - Kopieren Sie den APP_KEY und drücken Sie Strg+c, um die Cachet-Container zu beenden.

Bearbeiten Sie nun die docker-compose.yml-Datei erneut und ersetzen Sie den APP_KEY wie folgt:

APP_KEY=base64:6ltZ62B69p6oxIVeQtf9jpX5BFvgUXU2qk5eXpw3OIQ=

Speichern Sie die Datei und beenden Sie.

Führen Sie nun den Docker-Befehl aus, um alte Container und neue Cachet-Container zu löschen.

docker compose down  
docker compose up -d

Führen Sie schließlich den folgenden Befehl aus, um die laufenden Container oder Dienste zu überprüfen.

docker compose ps

Sie können unten sehen, dass der Cachet-Container auf Port 8000 läuft.

Nginx als Reverse-Proxy einrichten

In dieser Anleitung führen Sie Cachet mit Nginx als Reverse-Proxy aus. Sie installieren jetzt Nginx und einen neuen Serverblock für einen Reverse-Proxy. Stellen Sie sicher, dass Sie Ihren Domainnamen bereit haben und auf die Server-IP-Adresse verweisen.

Um den Nginx-Webserver zu installieren, führen Sie den folgenden apt-Befehl aus. Geben Sie Y ein, um mit der Installation fortzufahren.

sudo apt install nginx

Nachdem die Installation abgeschlossen ist, erstellen Sie eine neue Nginx-Serverblockdatei /etc/nginx/sites-available/cachet.conf mit dem Nano-Editor.

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

Fügen Sie die folgende Konfiguration ein und stellen Sie sicher, dass Sie status.howtoforge.local mit Ihrem Domainnamen ändern.

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;  
 }  
}

Wenn Sie fertig sind, speichern Sie die Datei und beenden Sie den Editor.

Führen Sie nun den folgenden Befehl aus, um die Serverblockdatei cachet.conf zu aktivieren und Ihre Nginx-Syntax zu überprüfen. Wenn Sie eine korrekte Syntax haben, sehen Sie eine Ausgabe test - erfolgreich - Syntax ist ok.

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

Führen Sie schließlich den systemctl-Befehl aus, um den Nginx-Dienst neu zu starten und Ihre Änderungen anzuwenden. Überprüfen Sie dann den Nginx-Dienststatus, um sicherzustellen, dass er läuft.

sudo systemctl restart nginx  
sudo systemctl status nginx

Sie können unten sehen, dass der Nginx-Dienst als Reverse-Proxy für die Cachet-Installation läuft.

Cachet mit HTTPS sichern

An diesem Punkt läuft Cachet in einem Container, und Sie haben Nginx als Reverse-Proxy dafür konfiguriert. Um Cachet zu sichern, generieren Sie SSL-Zertifikate und implementieren HTTPS über Certbot und Letsencrypt.

Installieren Sie Certbot und das Certbot Nginx-Plugin mit dem folgenden apt-Befehl. Drücken Sie Y, um die Installation zu bestätigen.

sudo apt install certbot python3-certbot-nginx

Führen Sie nun den Certbot-Befehl aus, um SSL-Zertifikate zu generieren und Cachet mit HTTPS zu sichern. Stellen Sie sicher, dass Sie den Domainnamen und die E-Mail-Adresse mit Ihren Informationen ändern.

sudo certbot --nginx

Sobald der Prozess abgeschlossen ist, sind Ihre SSL-Zertifikate im Verzeichnis /etc/letsencrypt/live/domain.com verfügbar und Ihre Cachet-Installation sollte mit HTTPS gesichert sein.

Cachet installieren

Besuchen Sie Ihren Cachet-Domainnamen wie https://status.howtoforge.local/ mit Ihrem bevorzugten Webbrowser. Sie sehen den Installationsassistenten.

Im Abschnitt Umgebungssetup wählen Sie den Standard-Cache, die Warteschlange und die Sitzung als Datenbank aus und geben Sie Ihre SMTP-Daten ein.

Erstellen Sie Ihre erste Statusseite und klicken Sie auf Weiter, um fortzufahren.

Geben Sie den neuen Administratorbenutzer, die E-Mail-Adresse und das Passwort für Ihre Cachet-Installation ein.

Nachdem die Installation abgeschlossen ist, sehen Sie eine Ausgabe Cachet wurde erfolgreich konfiguriert. Klicken Sie dann auf Zum Dashboard gehen, um auf Cachet zuzugreifen.

Geben Sie Ihren Admin-Benutzer und Ihr Passwort ein und klicken Sie auf Anmelden.

Wenn Sie die richtigen Anmeldeinformationen haben, sehen Sie das Cachet-Dashboard wie folgt:

Fazit

Herzlichen Glückwunsch! Sie haben die Installation der Cachet-Statusseite auf einem Ubuntu 24.04-Server mit Docker abgeschlossen. Sie haben Nginx als Reverse-Proxy für Cachet konfiguriert und Cachet mit HTTPS über Certbot und Letsencrypt gesichert. Sie können jetzt Ihre Websites oder Dienste mit Cachet hinzufügen und überwachen und zusätzliche Benachrichtigungen mit E-Mail-Adressen usw. einrichten.