🔄 Mettre à jour un conteneur Docker avec Docker Compose (Guide général)

Ce guide explique comment mettre à jour un conteneur Docker sur un serveur Linux (Debian, Ubuntu, etc.) en utilisant Docker Compose, de manière simple et sécurisée.

🧰 Prérequis

Un serveur Linux
Docker et Docker Compose installés
Un ou plusieurs conteneurs gérés avec Docker Compose
Accès SSH au serveur
Accès à l’hyperviseur (Proxmox, ESXi, Hyper-V…) pour la sauvegarde

⚠️ Étape essentielle : Sauvegarde avant mise à jour

Avant toute mise à jour, il est fortement recommandé de faire une sauvegarde complète.

📸 Snapshot de la machine virtuelle (recommandé)

Si Docker est installé dans une machine virtuelle, effectuez un snapshot de la VM :

Proxmox : Snapshot → Créer
ESXi : Snapshots → Take Snapshot
Hyper-V : Point de contrôle

💡 Le snapshot permet de revenir instantanément en arrière en cas de problème après la mise à jour.

📁 1. Se placer dans le dossier du conteneur

Connectez-vous au serveur puis placez-vous dans le dossier contenant le fichier docker-compose.yml :

cd /chemin/vers/le/conteneur

🔍 2. Vérifier l’état et la version du conteneur

Avant la mise à jour, vérifiez que le conteneur fonctionne correctement :

docker compose ps

Cette commande affiche les conteneurs actifs et leur état.

⚙️ 3. Vérifier le fichier `docker-compose.yml` (IMPORTANT)

Pour qu’une mise à jour fonctionne, l’image Docker doit pointer vers une version mise à jour.

Dans le fichier docker-compose.yml, vérifiez que l’image utilise :

latest
release
ou une version valide

Exemple :

image: nom_image:latest

👉 Si l’image est figée sur une version précise, Docker ne téléchargera pas de mise à jour.

⬇️ 4. Télécharger les nouvelles images Docker

Téléchargez les nouvelles versions des images :

docker compose pull

Docker va récupérer les images les plus récentes depuis le registre.

🔁 5. Redémarrer les conteneurs Docker

Arrêtez puis relancez les conteneurs avec les nouvelles images :

docker compose down
docker compose up -d

Les services redémarrent en arrière-plan.

📜 6. Vérifier le bon fonctionnement

Consultez les logs pour vérifier qu’aucune erreur ne survient :

docker compose logs -f

Puis testez l’application via votre navigateur ou client habituel.

🧹 (Optionnel) Nettoyage des anciennes images

Après confirmation que tout fonctionne correctement :

docker image prune

✅ Conclusion

Mettre à jour un conteneur Docker avec Docker Compose est une opération simple, à condition de :

effectuer une sauvegarde (snapshot VM) avant la mise à jour
vérifier le fichier docker-compose.yml
utiliser les commandes adaptées
contrôler les logs après redémarrage

Cette méthode permet des mises à jour rapides, propres et réversibles 🚀