Modification de Mise à jour Container Docker

= Mise à jour des containers Docker Compose =

Cette procédure décrit les étapes pour mettre à jour les images et containers gérés via Docker Compose.

__TOC__

== Prérequis ==

* Accès SSH ou terminal sur la machine hôte
* Droits suffisants pour exécuter les commandes <code>docker</code> et <code>docker compose</code>
* Connaissance du répertoire contenant le fichier <code>docker-compose.yml</code>

== Étape 1 — Se placer dans le bon répertoire ==

<syntaxhighlight lang="bash">
cd /chemin/vers/votre/projet
</syntaxhighlight>

{{Note|Remplacez <code>/chemin/vers/votre/projet</code> par le chemin réel contenant votre <code>docker-compose.yml</code>.}}

== Étape 2 — Sauvegarder les données persistantes (recommandé) ==

Avant toute mise à jour, assurez-vous que vos volumes sont sauvegardés si des données critiques y sont stockées.

<syntaxhighlight lang="bash">
# Lister les volumes utilisés
docker compose config --volumes

# Exemple de sauvegarde d'un volume nommé "db_data"
docker run --rm \
  -v db_data:/data \
  -v $(pwd)/backup:/backup \
  alpine tar czf /backup/db_data_$(date +%Y%m%d).tar.gz -C /data .
</syntaxhighlight>

== Étape 3 — Récupérer les nouvelles images ==

Téléchargez les dernières versions des images depuis les registres (Docker Hub, GHCR, etc.) :

<syntaxhighlight lang="bash">
docker compose pull
</syntaxhighlight>

Cette commande met à jour '''toutes''' les images déclarées dans le fichier Compose.

Pour ne mettre à jour qu'un seul service :

<syntaxhighlight lang="bash">
docker compose pull <nom_du_service>
</syntaxhighlight>

== Étape 4 — Recréer et redémarrer les containers ==

=== Méthode recommandée (avec arrêt propre) ===

<syntaxhighlight lang="bash">
docker compose up -d --remove-orphans
</syntaxhighlight>

; <code>-d</code> : Lance les containers en arrière-plan (mode ''detached'')
; <code>--remove-orphans</code> : Supprime les containers d'anciens services qui ne sont plus dans le fichier Compose

Docker Compose détecte automatiquement quelles images ont changé et ne recrée que les containers concernés.

=== Si vous souhaitez forcer la recréation de tous les containers ===

<syntaxhighlight lang="bash">
docker compose up -d --force-recreate
</syntaxhighlight>

== Étape 5 — Vérifier l'état des containers ==

<syntaxhighlight lang="bash">
docker compose ps
</syntaxhighlight>

Consultez les logs en cas de problème :

<syntaxhighlight lang="bash">
# Logs de tous les services
docker compose logs -f

# Logs d'un service spécifique
docker compose logs -f <nom_du_service>
</syntaxhighlight>

== Étape 6 — Nettoyer les anciennes images ==

Une fois la mise à jour vérifiée, supprimez les images obsolètes pour libérer de l'espace disque :

<syntaxhighlight lang="bash">
docker image prune -f
</syntaxhighlight>

{{Attention|Cette commande supprime toutes les images ''non utilisées''. Assurez-vous que vos nouveaux containers fonctionnent correctement avant de l'exécuter.}}

== Résumé des commandes ==

{| class="wikitable"
|-
! Étape !! Commande !! Description
|-
| 1 || <code>cd /chemin/projet</code> || Se positionner dans le répertoire
|-
| 2 || <code>docker compose pull</code> || Télécharger les nouvelles images
|-
| 3 || <code>docker compose up -d --remove-orphans</code> || Recréer les containers mis à jour
|-
| 4 || <code>docker compose ps</code> || Vérifier l'état
|-
| 5 || <code>docker compose logs -f</code> || Consulter les logs
|-
| 6 || <code>docker image prune -f</code> || Nettoyer les images obsolètes
|}

== Cas particuliers ==

=== Mise à jour avec rebuild d'une image locale ===

Si votre Compose utilise un <code>build:</code> (image construite localement depuis un Dockerfile) :

<syntaxhighlight lang="bash">
docker compose build --no-cache
docker compose up -d
</syntaxhighlight>

=== Rollback en cas de problème ===

Si la mise à jour provoque une régression, vous pouvez revenir à l'image précédente en spécifiant un tag dans votre <code>docker-compose.yml</code> :

<syntaxhighlight lang="yaml">
services:
  mon_service:
    image: mon_image:1.2.3   # Remplacer latest par un tag versionné
</syntaxhighlight>

Puis relancer :

<syntaxhighlight lang="bash">
docker compose up -d
</syntaxhighlight>

{{Conseil|Évitez le tag <code>latest</code> en production. Préférez des tags versionnés (<code>1.2.3</code>) pour maîtriser les mises à jour.}}

== Voir aussi ==

* [https://docs.docker.com/compose/reference/ Documentation officielle Docker Compose CLI]
* [https://docs.docker.com/compose/compose-file/ Référence du fichier Compose]