commande docker compose down
Référence des commandes Docker
docker compose downUtilisé pour arrêter et supprimerdocker compose uptous les conteneurs, réseaux et ressources associées qui ont été démarrés.
Lors de l'exécution dedocker compose upAprès le démarrage d'un ensemble de services, Docker crée automatiquement des conteneurs, des réseaux et même des volumes de données anonymes.
Si vous utilisez uniquementdocker compose stop, les conteneurs sont seulement mis en pause, mais ils occupent toujours de l'espace disque et conservent la configuration réseau ; lors du prochain démarrage, l'ancien état peut provoquer des conflits.
docker compose downEnsuite, il y a un nettoyage complet en un clic : arrêter les conteneurs, supprimer les conteneurs, supprimer les réseaux et restaurer l'environnement dans un état propre.
Le diagramme suivant montre la chaîne d'exécution complète de la commande down :
Si vous n'êtes pas sûr que l'environnement actuel soit propre, utilisez d'aborddocker compose psVérifiez les conteneurs en cours d'exécution, puis décidez si vous devez exécuter down.
Démarrage rapide
Utilisation la plus simple : dans un répertoire contenantdocker-compose.ymlExécutez dans le répertoire où se trouve le fichier :
# 进入 Compose 项目目录 cd ~/myproject # 一键停止并清理所有资源 docker compose down
Après l'exécution, le terminal affiche généralement quelque chose comme ce qui suit :
[+] Running 3/3 Container myproject-web-1 Removed 1.2s Container myproject-db-1 Removed 0.8s Network myproject_default Removed 0.3s
À ce stade :
- Tous les conteneurs démarrés par Compose ont été arrêtés et supprimés.
- Le réseau spécifique au projet a été supprimé.
- Volumes de donnéesConservés par défaut(pour éviter la suppression accidentelle de données)
Référence rapide des options de commande
Voici, pourdocker compose down, la liste complète des options prises en charge :
| Options | Abréviation | Description | Valeur par défaut |
|---|---|---|---|
| --volumes | -v | Supprime les volumes de données nommés définis dans le fichier Compose, ainsi que les volumes de données anonymes montés par les conteneurs. | Ne pas supprimer |
| --remove-orphans | Aucune | Supprimer les conteneurs orphelins correspondant aux services qui n'existent plus dans le fichier Compose. | Ne pas supprimer |
| --rmi <type> | Aucune | Supprimer les images utilisées par les services ; type est facultatif.all(Toutes) oulocal(uniquement construites localement) | Ne pas supprimer |
| --timeout | -t | Délai d'attente (en secondes) pour arrêter les conteneurs ; après le délai, forcer l'arrêt. | 10 |
| --dry-run | Aucune | Afficher uniquement les opérations qui seront effectuées, sans les exécuter réellement (v2.21+). | Ne pas activer |
Comportements par défaut qui méritent le plus d'attention :Les volumes de données ne sont pas supprimés par défautCela signifie que même si vous exécutez down, les données de la base de données restent dans le volume de données et seront restaurées la prochaine fois que vous exécuterez up. C'est un mécanisme de protection, mais si vous voulez vraiment nettoyer en profondeur, n'oubliez pas d'ajouter-v。
Utilisation détaillée
Utilisation de base : arrêter et nettoyer
Exécuter directement dans le répertoire du projet sans aucune option :
# 停止并删除容器和网络,保留数据卷 docker compose down
Cela équivaut à exécuter en séquence :
docker compose stop # 停止所有容器 docker compose rm -f # 强制删除所有容器 docker network rm <网络名> # 删除项目网络
Supprimez aussi les volumes de données : -v / --volumes
Lorsque vous devez nettoyer complètement l’environnement — y compris le contenu persistant tel que les données de base de données et les caches — ajoutez-v:
# 删除容器、网络以及 Compose 文件中定义的所有具名数据卷 docker compose down -v
Voici un exemple complet de comparaison pour aider à comprendre-vImpact :
Exemple
services:
web:
image: nginx
ports:
- "8080:80"
db:
image: mysql:8.0
environment:
MYSQL_ROOT_PASSWORD: example123
volumes:
- db_data:/var/lib/mysql # volumes nommés
volumes:
db_data: # définir les volumes nommés
# 不带 -v:db_data 数据卷保留,数据库中的数据不丢失 $ docker compose down [+] Running 3/3 Container test-web-1 Removed Container test-db-1 Removed Network test_default Removed # 带 -v:db_data 数据卷被删除,数据库数据永久丢失 $ docker compose down -v [+] Running 4/4 Container test-web-1 Removed Container test-db-1 Removed Volume test_db_data Removed Network test_default Removed
Exécution dans un environnement de productiondown -vAvant [de le faire], réfléchissez-y à deux fois—une fois qu'un volume de données est supprimé, les données sont irrécupérables. Il est recommandé de sauvegarder d'abord les données, ou de l'utiliser uniquement dans des environnements hors production.-v。
Nettoyer les conteneurs orphelins : --remove-orphans
Lorsque vous supprimez la définition d'un service de votre fichier docker-compose.yml, mais que le conteneur de ce service existe toujours, ces conteneurs sont appelés « conteneurs orphelins ».
Exemple
services:
app:
image: nginx
networks:
- shared_network # référence au réseau externe
networks:
shared_network:
external: true # réseau externe, down ne le supprimera pas
volumes:
shared_data:
external: true # volume externe, down -v ne le supprimera pas non plus
C'est raisonnable : les ressources externes peuvent être partagées par plusieurs projets Compose et ne doivent pas être nettoyées par un seul projet.
Ordre de démarrage des dépendances entre conteneurs
down arrête les conteneurs dans l'ordre inverse, c'est-à-dire qu'il arrête d'abord la partie dépendante, puis la partie dont elle dépend, à l'opposé de l'ordre de démarrage pendant up, ce qui garantit que les dépendances sont correctement libérées.
Compatibilité avec docker-compose (version héritée)
Si vous utilisez une version plus anciennedocker-compose(avec un trait d'union), le format de commande est :
$ docker-compose down -v
Le nouveau Docker Compose v2 intègre la fonctionnalité Compose dans la CLI Docker, et la commande devientdocker compose(séparés par un espace.) Les paramètres des deux sont exactement les mêmes, mais il est recommandé d'utiliser systématiquement le nouveau format.
FAQ
Q : Après avoir exécuté down, les conteneurs sont-ils toujours en cours d'exécution ?
Raison possible : ces conteneurs n'ont pas été créés par le fichier Compose actuel, mais ont été démarrés viadocker runou démarrés par d'autres fichiers Compose.
utilisezdocker pspour afficher les détails du conteneur afin de confirmer si le préfixe du nom du conteneur correspond au nom du projet Compose.
Q : L'espace disque n'est pas libéré après down -v ?
Vérifiez si les images inutilisées occupent de l'espace :
$ docker image ls # 查看镜像列表 $ docker image prune -a # 清理未使用的镜像
Docker ne nettoie pas automatiquement les images ; vous devez exécuter manuellementdocker image pruneou utiliserdown --rmi allpour nettoyer en même temps.
Q : Comment exécuter down en toute sécurité dans un script ?
Exemple
# Script de nettoyage sécurisé : confirmez d'abord que le projet est en cours d'exécution, puis exécutez down
PROJECT_DIR="/opt/example-app"
if [ -f "$PROJECT_DIR/docker-compose.yml" ]; then
cd "$PROJECT_DIR"
# Vérifiez d'abord avec ps s'il y a des services en cours d'exécution
if docker compose ps --status running | grep -q .; puis
echo "Arrêt du projet EXAMPLE..."
docker compose down --remove-orphans
echo "Nettoyage terminé"
else
echo "Le projet n'est pas en cours d'exécution, opération down ignorée"
fi
else
echo "Erreur : impossible de trouver le fichier docker-compose.yml"
exit 1
fi
Ce script effectue des vérifications de chemin de base et des évaluations d'état avant le nettoyage afin d'éviter des opérations accidentelles.
autres extensions