Comment installer le système de page d’état Cachet sur Ubuntu 18.04 LTS

Cachetest un magnifique et puissant système de pages d’état open source écrit en PHP qui te permet de mieux communiquer les temps d’arrêt et les pannes de système à tes clients, tes équipes et tes actionnaires. L’application te fournit de nombreuses fonctionnalités, dont les plus notables sont : une puissante API JSON, desrapports d’incidents, des métriques,laprise en charge de markdown pour les messages d’incidents, desnotifications aux abonnés par e-mail, uneauthentificationà deux facteurs. Dans ce tutoriel, nous allons installer le système de pages d’état Cachet en utilisant PHP, Nginx, MySQL et Composer sur Ubuntu 18.04 LTS.

Exigences

  • PHP version 7.1 ou supérieure
  • Serveur HTTP avec prise en charge de PHP (par exemple : Nginx, Apache, Caddy)
  • Composer
  • Unebase de données prise en charge : MySQL, PostgreSQL ou SQLite
  • Git

Conditions préalables

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

Étapes initiales

Vérifie ta version d’Ubuntu :

lsb_release -ds
# Ubuntu 18.04.1 LTS

Configure le fuseau horaire :

sudo dpkg-reconfigure tzdata

Mets à jour les paquets (logiciels) de ton système d’exploitation. C’est une première étape importante car elle permet de s’assurer que tu disposes des dernières mises à jour et des derniers correctifs de sécurité pour les paquets logiciels par défaut de ton système d’exploitation :

sudo apt update && sudo apt upgrade -y

Installe certains paquets essentiels qui sont 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

Installe 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, tu peux exécuter :

php -m

ctype
curl
exif
fileinfo
. . .
. . .

Vérifier la version de 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 lancé et activé au redémarrage sur le système Ubuntu 18.04, il n’est donc pas nécessaire de le lancer 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 – Installe MySQL et crée une base de données pour Cachet

Cachet prend en charge les bases de données MySQL, MariaDB,PostgreSQL et SQLite. Dans ce tutoriel, nous utiliserons MySQL comme serveur de base de données.

Installe le serveur de base de données MySQL :

sudo apt install -y mysql-server

Vérifie la version de MySQL :

mysql --version
# mysql  Ver 14.14 Distrib 5.7.25, for Linux (x86_64) using  EditLine wrapper

Exécutemysql_secure installationscript pour améliorer la sécurité de MySQL et définir le mot de passe pour MySQLroot utilisateur :

sudo mysql_secure_installation

Réponds à 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

Connecte-toi au shell MySQL en tant qu'utilisateur root :

sudo mysql -u root -p
# Enter password

Crée une base de données MySQL vide et un utilisateur pour Cachet et mémorise les informations d'identification :

mysql> CREATE DATABASE dbname;
mysql> GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
mysql> FLUSH PRIVILEGES;

Quitte MySQL :

mysql> exit

Remplacedbname,usernameetpasswordpar tes propres noms.

Étape 3 - Installe le client Acme.sh et obtiens le certificat Let's Encrypt (facultatif)

Il n'est pas nécessaire de sécuriser ton site Web avec HTTPS, mais c'est une bonne pratique pour sécuriser le trafic de ton site. Pour obtenir le certificat TLS de Let's Encrypt, nous allons utiliser le client acme.sh. Acme.sh est un logiciel shell UNIX pur pour obtenir des certificats TLS de Let's Encrypt sans aucune dépendance.

Télécharge et installe 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érifie la version d'acme.sh :

acme.sh --version
# v2.8.0

Obtiens des certificatsRSAetECC/ECDSApour ton 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 tu veux de faux certificats pour les tester, tu peux ajouter le drapeau--stagingaux commandes ci-dessus.

Après avoir exécuté les commandes ci-dessus, tescertificats et tesclés seront dans :

  • PourRSA:/home/username/example.comrépertoire.
  • PourECC/ECDSA:/home/username/example.com_eccrépertoire.

Pour répertorier tes certs émis, tu peux exécuter :

acme.sh --list

Crée un répertoire pour stocker tes certs. Nous utiliserons le répertoire/etc/letsencrypt.

mkdir -p /etc/letsecnrypt/example.com
sudo mkdir -p /etc/letsencrypt/example.com_ecc

Installe/copie les certificats dans/etc/letsencryptrépertoire.

# 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, quitte l'utilisateur root et retourne à l'utilisateur normal sudo :

exit

Étape 4 - Installer et configurer NGINX

Cachet peut fonctionner correctement avec de nombreux serveurs Web. Dans ce tutoriel, nous avons choisi Nginx.Si tu préfères le serveur Web Apache à Nginx, visitehttps://docs.cachethq.io/docs/installing-cachet#section-running-cachet-on-apache pour en savoir plus.

Installe Nginx :

sudo apt install -y nginx

Vérifie la version de Nginx :

sudo nginx -v
# nginx version: nginx/1.14.0 (Ubuntu)

Configure Nginx pour Cachet en exécutant :

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

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

}

Active la nouvellecachet.confconfiguration en liant le fichier ausites-enabledrépertoire :

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

Teste la configuration de NGINX :

sudo nginx -t

Recharge Nginx :

sudo systemctl reload nginx.service

Étape 5 - Installer Composer

Installe Composer, le gestionnaire de dépendances de PHP de manière globale :

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érifie la version de Composer :

composer --version
# Composer version 1.8.3 2019-01-30 08:31:33

Étape 6 - Installer Cachet

Crée un répertoire racine de document dans lequel Cachet doit résider :

sudo mkdir -p /var/www/cachet

Change la propriété du répertoire/var/www/cacheten{jour_user}:

sudo chown -R {your_user}:{your_user} /var/www/cachet

REMARQUE:Remplace {jour_user}par ton nom d'utilisateur non-root créé initialement.

Navigue dans le répertoire racine du document :

cd /var/www/cachet

Télécharge le code source de Cachet avec Git:

git clone -b 2.4 --single-branch https://github.com/cachethq/Cachet.git .

Copie.env.exampleà.envet configure la base de données etAPP_URLparamètres dans.envfichier :

cp .env.example .env
vim .env

Installe les dépendances de Cachet avec Composer :

composer install --no-dev -o

Configure la clé d'application en exécutant :

php artisan key:generate

Installe Cachet :

php artisan cachet:install

Change la propriété du/var/www/cachetàwww-data:

sudo chown -R www-data:www-data /var/www/cachet

Ouvre ton site dans un navigateur Web et suis les instructions à l'écran pour terminer l'installation de Cachet.

Étape 7 - Termine l'installation de Cachet

Sélectionne les pilotes de cache et de session et configure les options de messagerie :

Termine la mise en place du cachet

Configure les paramètres généraux du site comme le nom du site, le domaine du site, le fuseau horaire et la langue :

Paramètres généraux de Cachet

Crée un compte d'utilisateur administratif :

Ajoute un compte administrateur

Après cela, tu devrais recevoir un message indiquant que Cachet a été configuré avec succès. Tu peux ouvrir le tableau de bord de Cachet en cliquant sur le bouton "Aller au tableau de bord" :

Cachet a été installé avec succès

L'installation et la configuration de Cachet sont terminées.

Pour accéder au tableau de bord de Cachet, ajoute/dashboardà l'URL de ton site Web.

Cachet Dashboard

Vous aimerez aussi...