Passer au contenu principal

Mettre à jour le logiciel du site

Cette page documente comment mettre à jour le logiciel utilisé pour le site de FIC.

Contexte

L'outil utilisé comme socle du site est le logiciel Bookstack. Il est écrit en PHP.
Il est hébergé sur un serveur chez notre hébergeur Le Pic.

La dernière version de Bookstack se trouve sur cette page Github.
La version actuellement utilisée se trouve dans l'entête des pages "Préférences" :Doc - version bookstack.png

Procédure de mise à jour

Documentation officielle : https://www.bookstackapp.com/docs/admin/updates/

Se connecter au serveur en SSH

Seules les personnes autorisées ont les accès pour se connecter au serveur.
Si vous souhaiter aider à ces actions, contactez Pierre pour avoir un accès.

Ci-dessous un extrait de fichier ~/.ssh/config reprenant toutes les informations de connexion :

## PIC: ssh fic-pic
Host fic-pic
Hostname sftp.le-pic.org
User fic-st2
Port 2200
IdentityFile ~/.ssh/id_rsa_fic

Pour se connecter avec cette configuration, tapez donc ssh fic-pic

Effectuer une sauvegarde

Pour les mises à jour de versions importantes, il est pertinent de faire une sauvegarde préalable. Cette opération n'est pas nécessaire pour des plus petites mises à jour.

Documentation officielle : https://www.bookstackapp.com/docs/admin/backup-restore/

Base de données

Une sauvegarde de la base est effectuée automatiquement chaque nuit.
Elle se trouve dans /home/fic-st2/db/fic_st2.sql.gz.

Vous pouvez compter sur celle-ci, mais si vous souhaitez une version en temps réel effectuez la procédure suivante :

source /home/fic-st2/src/BookStack/.env
mysqldump -h$DB_HOST -u$DB_USERNAME -p$DB_PASSWORD --lock-tables=false --skip-lock-tables $DB_DATABASE > ~/2022-11-12-mysqldump.backup.sql 
Fichiers

Sauvegarder les fichiers dans une archive … au cas où.

cd ~/src/BookStack/
tar -czvf ~/2022-11-12-bookstack-files-backup.tar.gz .env public/uploads storage/uploads

Mettre à jour le code

cd ~/src/BookStack/
git pull origin release
composer install --no-dev
php artisan migrate

Effectuer les dernières tâches

php artisan cache:clear
php artisan config:clear
php artisan view:clear

Regarder également sur https://www.bookstackapp.com/docs/admin/updates/#version-specific-instructions si des actions spécifiques ne seraient pas nécessaires.

Puis s'assurer que tout va bien en naviguant sur le site par acquis de conscience !