Cachet est un beau et puissant système de page d'état open source écrit en PHP qui vous permet de mieux communiquer les temps d'arrêt et les pannes du système pour vos clients, vos équipes et vos actionnaires. L'application vous offre de nombreuses fonctionnalités, dont les plus notables sont :une API JSON puissante, des rapports d'incidents, des métriques, une prise en charge de la démarque pour les messages d'incident, des notifications d'abonnés par e-mail, une authentification à deux facteurs. Dans ce didacticiel, nous allons installer le système de page d'état Cachet en utilisant PHP, Nginx, MySQL et Composer sur Ubuntu 18.04 LTS.
Exigences
- Version PHP 7.1 ou ultérieure
- Serveur HTTP avec support PHP (par exemple :Nginx, Apache, Caddy)
- Compositeur
- Une base de données compatible :MySQL, PostgreSQL ou SQLite
- Git
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.1 LTS
Configurez le fuseau horaire :
sudo dpkg-reconfigure tzdata
Mettez à jour les packages de votre système d'exploitation (logiciels). Il s'agit d'une première étape importante car elle garantit que vous disposez des dernières mises à jour et correctifs de sécurité pour les packages logiciels par défaut de votre système d'exploitation :
sudo apt update && sudo apt upgrade -y
Installez certains packages 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
Étape 1 - Installer PHP
Installez PHP, ainsi que les extensions PHP nécessaires :
sudo apt install -y php7.2 php7.2-cli php7.2-fpm php7.2-common php7.2-xml php7.2-gd php7.2-zip php7.2-mbstring php7.2-mysql php7.2-pgsql php7.2-sqlite3 php7.2-opcache php-apcu
Pour afficher PHP compilé en modules, vous pouvez exécuter :
php -m
ctype
curl
exif
fileinfo
. . .
. . .
Vérifier la version PHP :
php --version
# PHP 7.2.10-0ubuntu0.18.04.1 (cli) (built: Sep 13 2018 13:45:02) ( NTS )
# Copyright (c) 1997-2018 The PHP Group
# Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
# with Zend OPcache v7.2.10-0ubuntu0.18.04.1, Copyright (c) 1999-2018, by Zend Technologies
Le service PHP-FPM est automatiquement démarré et activé au redémarrage sur le système Ubuntu 18.04, il n'est donc pas nécessaire de le démarrer et de l'activer manuellement. Nous pouvons passer à l'étape suivante, qui est l'installation et la configuration de la base de données.
Étape 2 – Installer MySQL et créer une base de données pour Cachet
Cachet prend en charge les bases de données MySQL, MariaDB, PostgreSQL et SQLite. Dans ce didacticiel, nous utiliserons MySQL comme serveur de base de données.
Installez le serveur de base de données MySQL :
sudo apt install -y mysql-server
Vérifiez la version de MySQL :
mysql --version
# mysql Ver 14.14 Distrib 5.7.25, for Linux (x86_64) using EditLine wrapper
Exécutez l'mysql_secure installation
script pour améliorer la sécurité MySQL et définir le mot de passe pour MySQL root
utilisateur :
sudo mysql_secure_installation
Répondez à chacune des questions :
Would you like to setup VALIDATE PASSWORD plugin? N
New password: your_secure_password
Re-enter new password: your_secure_password
Remove anonymous users? [Y/n] Y
Disallow root login remotely? [Y/n] Y
Remove test database and access to it? [Y/n] Y
Reload privilege tables now? [Y/n] Y
Connectez-vous au shell MySQL en tant qu'utilisateur root :
sudo mysql -u root -p
# Enter password
Créez une base de données MySQL vide et un utilisateur pour Cachet et mémorisez les informations d'identification :
mysql> CREATE DATABASE dbname;
mysql> GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
mysql> FLUSH PRIVILEGES;
Quitter MySQL :
mysql> exit
Remplacez dbname
, username
et password
avec vos propres noms.
Étape 3 - Installez le client Acme.sh et obtenez le certificat Let's Encrypt (facultatif)
Sécuriser votre site Web avec HTTPS n'est pas nécessaire, mais c'est une bonne pratique pour sécuriser le trafic de votre site. Afin d'obtenir un certificat TLS de Let's Encrypt, nous utiliserons le client acme.sh. Acme.sh est un logiciel shell UNIX pur permettant d'obtenir des certificats TLS de Let's Encrypt sans aucune 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
Obtenir RSA et ECC/ECDSA certificats 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 voulez de faux certificats pour les tests, vous pouvez ajouter le --staging
indicateur aux commandes ci-dessus.
Après avoir exécuté les commandes ci-dessus, vos certificats et les clés sera dans :
- Pour RSA :
/home/username/example.com
répertoire. - Pour ECC/ECDSA :
/home/username/example.com_ecc
répertoire.
Pour répertorier vos certificats émis, vous pouvez exécuter :
acme.sh --list
Créez un répertoire pour stocker vos certificats. Nous utiliserons le /etc/letsencrypt
répertoire.
mkdir -p /etc/letsecnrypt/example.com
sudo 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 normal :
exit
Étape 4 – Installer et configurer NGINX
Cachet peut fonctionner correctement avec de nombreux serveurs Web. Dans ce tutoriel, nous avons sélectionné Nginx. Si vous préférez le serveur Web Apache à Nginx, consultez https://docs.cachethq.io/docs/installing-cachet#section-running-cachet-on-apache pour en savoir plus.
Installez Nginx :
sudo apt install -y nginx
Vérifiez la version de Nginx :
sudo nginx -v
# nginx version: nginx/1.14.0 (Ubuntu)
Configurez Nginx pour Cachet en exécutant :
sudo vim /etc/nginx/sites-available/cachet.conf
Et remplissez le fichier avec la configuration suivante :
server {
listen 80;
listen [::]:80;
listen 443 ssl;
listen [::]:443 ssl;
server_name status.example.com;
root /var/www/cachet/public;
index index.php;
ssl_certificate /etc/letsencrypt/status.example.com/fullchain.cer;
ssl_certificate_key /etc/letsencrypt/status.example.com/status.example.com.key;
ssl_certificate /etc/letsencrypt/status.example.com_ecc/fullchain.cer;
ssl_certificate_key /etc/letsencrypt/status.example.com_ecc/status.example.com.key;
location / {
try_files $uri /index.php$is_args$args;
}
location ~ \.php$ {
include fastcgi_params;
fastcgi_pass unix:/var/run/php/php7.2-fpm.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_index index.php;
fastcgi_keep_conn on;
}
}
Activez le nouveau cachet.conf
configuration en liant le fichier au sites-enabled
répertoire :
sudo ln -s /etc/nginx/sites-available/cachet.conf /etc/nginx/sites-enabled/
Tester la configuration NGINX :
sudo nginx -t
Recharger Nginx :
sudo systemctl reload nginx.service
Étape 5 - Installer Composer
Installez Composer, le gestionnaire de dépendances PHP globalement :
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === '48e3236262b34d30969dca3c37281b3b4bbe3221bda826ac6a9a62d6444cdb0dcd0615698a5cbe587c3f0fe57a54d8f5') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"
sudo mv composer.phar /usr/local/bin/composer
Vérifier la version de Composer :
composer --version
# Composer version 1.8.3 2019-01-30 08:31:33
Étape 6 - Installer Cachet
Créez un répertoire racine de document dans lequel Cachet doit résider :
sudo mkdir -p /var/www/cachet
Changer le propriétaire du /var/www/cachet
répertoire vers {jour_user}
:
sudo chown -R {your_user}:{your_user} /var/www/cachet
REMARQUE : Remplace {jour_user}
avec votre nom d'utilisateur non root créé initialement.
Accédez au répertoire racine du document :
cd /var/www/cachet
Téléchargez le code source du Cachet avec Git :
git clone -b 2.4 --single-branch https://github.com/cachethq/Cachet.git .
Copiez .env.example
vers .env
déposer et configurer la base de données et APP_URL
paramètres dans .env
fichier :
cp .env.example .env
vim .env
Installez les dépendances Cachet avec Composer :
composer install --no-dev -o
Configurez la clé d'application en exécutant :
php artisan key:generate
Installer Cachet :
php artisan cachet:install
Changer le propriétaire du /var/www/cachet
répertoire vers www-data:
sudo chown -R www-data:www-data /var/www/cachet
Ouvrez votre site dans un navigateur Web et suivez les instructions à l'écran pour terminer l'installation de Cachet.
Étape 7 - Terminez la configuration du cachet
Sélectionnez les pilotes de cache et de session et configurez les options de messagerie :
Configurez les paramètres généraux du site comme le nom du site, le domaine du site, le fuseau horaire et la langue :
Créez un compte d'utilisateur administrateur :
Après cela, vous devriez recevoir un message indiquant que Cachet a été configuré avec succès. Vous pouvez ouvrir le tableau de bord Cachet en appuyant sur le bouton "Aller au tableau de bord":
L'installation et la configuration du cachet sont terminées.
Pour accéder au tableau de bord Cachet, ajoutez /dashboard
à l'URL de votre site Web.
Liens
- https://cachethq.io/
- https://github.com/CachetHQ/Cachet