Quand faut-il rebuild une image ?

Une image Docker est construite à partir d’un Dockerfile.

Il faut reconstruire l’image dès qu’un élément intégré dans l’image elle-même change.

Rebuild nécessaire si modification de :

#

• Dockerfile
• requirements.txt ou pyproject.toml
• dépendances système (apt install, etc.)
• fichiers copiés avant le code applicatif
• configuration incluse via COPY

Commande :

docker compose build

Pour un service spécifique :

docker compose build api

Rebuild non nécessaire si :

#

• le code est monté via un volume (./src:/app/src)
• un fichier bindé est modifié
• seule la configuration externe change (.env)

Dans ce cas :

docker compose up -d

suffit pour relancer les conteneurs.

Point clé

#

Modifier un fichier ne signifie pas automatiquement qu’un rebuild est requis.

La question à se poser :

Ce changement est-il intégré dans l’image ou simplement monté au runtime ?

Si le changement est intégré au moment du build → rebuild. Sinon → simple redémarrage.