Nuit Blanche
· 2 min de lecture

Mettre à jour Ghost 5 vers Ghost 6 (en self-hosting Docker)

Mettre à jour Ghost 5 vers Ghost 6 (en self-hosting Docker)

En bref

Comment s'est passée la mise à jour de Ghost 5 vers 6 sur une installation Docker : quoi sauvegarder d'abord, les étapes, et comment revenir en arrière si ça casse.

Une nouvelle version de Ghost est sortie il y a quelques mois, et il était enfin temps de mettre à jour ! En parcourant le dépôt GitHub de Ghost, j’ai remarqué que le fichier compose avait été modifié. Comme je fais tourner Ghost en self-hosting sur Docker, l’occasion était idéale pour passer à la nouvelle version.

Étape 1 : tout sauvegarder

Comme j’utilise des volumes Docker pour la persistance, j’ai simplement sauvegardé tout le répertoire Ghost de mon serveur, qui contient l’ensemble des volumes :

Terminal window
# Create a timestamped backup of the entire Ghost directory with volumes
tar -czf ghost-backup-$(date +%Y%m%d).tar.gz /path/to/ghost/

Cette approche capture :

  • Le volume de la base de données avec toutes les données MySQL/MariaDB
  • Le volume de contenu avec les images, les thèmes et la configuration
  • Le fichier docker-compose.yml lui-même
  • Tout fichier d’environnement ou configuration additionnelle

Simple, efficace, et tout ce qu’il faut pour une restauration complète tient dans une seule archive.

Étape 2 : modifier le fichier compose

La mise à jour en elle-même a été remarquablement simple. Dans mon fichier docker-compose.yml, il suffisait de changer le tag de l’image :

# Before
image: ghost:5-alpine


# After
image: ghost:6-alpine

Étape 3 : déployer en GitOps

Comme j’utilise un workflow GitOps pour mon infrastructure :

Terminal window
git add docker-compose.yml
git commit -m "feat: upgrade Ghost from v5 to v6"
git push

Mon runner CI/CD récupère les changements automatiquement et gère le déploiement. La magie opère dans l’ombre, et en quelques minutes…

Étape 4 : vérification

Une fois le déploiement terminé, j’ai vérifié :

  • Le panneau d’administration Ghost affichait la version 6.x ✓
  • Tous les articles et le contenu intacts ✓
  • La compatibilité du thème fonctionnelle ✓

Panneau d'administration Ghost affichant la mise à jour vers la version 6 Mise à jour de Ghost vers la version 6

Et si quelque chose tourne mal ?

Ma mise à jour s’est bien passée, mais il faut toujours être prêt à revenir en arrière :

Terminal window
# Stop the containers
docker-compose down


# Restore from backup if needed
tar -xzf ghost-backup-YYYYMMDD.tar.gz -C /


# Revert the image tag in docker-compose.yml
image: ghost:5-alpine


# Bring everything back up
docker-compose up -d

Conclusion

Mettre à jour Ghost de la version 5 à la 6 en self-hosting avec Docker est étonnamment simple. Si vous êtes encore sur Ghost 5 et que vous tournez sous Docker, il n’y a vraiment aucune raison d’attendre. Retenez juste l’essentiel : sauvegardez vos volumes, changez le tag de l’image, déployez, et profitez !

À la prochaine !
Yacine

Articles liés