5.1 Comando docker compose down
El comando docker compose down
se usa para detener y eliminar todos los recursos creados con el comando docker compose up
. Esto incluye detener contenedores, eliminar redes y volúmenes (si está indicado), así como eliminar imágenes (opcionalmente). En esta lección, analizaremos en detalle el uso del comando docker compose down
, sus parámetros principales y mejores prácticas.
Funciones principales del comando docker compose down
- Detener contenedores: todos los contenedores lanzados con
docker compose up
serán detenidos. - Eliminar contenedores: los contenedores detenidos serán eliminados.
- Eliminar redes: las redes creadas por Docker Compose para habilitar la interacción entre contenedores serán eliminadas.
- Eliminar volúmenes: opcionalmente, puedes eliminar los volúmenes que usan los contenedores.
- Eliminar imágenes: opcionalmente, puedes eliminar las imágenes utilizadas para crear contenedores.
Sintaxis del comando docker compose down
docker compose down [options]
Donde:
-
[options]
: parámetros adicionales para configurar el comportamiento del comando. Por ejemplo:-
--volumes
: elimina los volúmenes usados por los contenedores. -
--rmi all
: elimina todas las imágenes asociadas con el proyecto. -
--rmi local
: elimina solo las imágenes locales que no se descargaron del registro.
-
5.2 Ejemplos del comando docker compose down
Ejemplos de cómo usar el comando docker compose down
:
1. Detener y eliminar todos los recursos
Para detener y eliminar todos los recursos creados por el comando docker compose up
, usa el comando:
docker compose down
2. Eliminar volúmenes
Para eliminar los volúmenes que están siendo utilizados por los contenedores, añade la opción --volumes
:
docker compose down --volumes
3. Eliminar imágenes
Para eliminar las imágenes utilizadas para crear los contenedores, añade la opción --rmi
con uno de los siguientes valores:
all
: eliminar todas las imágenes usadas por el proyecto.local
: eliminar solo las imágenes creadas localmente.
docker compose down --rmi all
5.3 Parámetros del comando docker compose down
Parámetros útiles del comando docker compose down
:
1. Parámetros -v
, --volumes
Los parámetros -v
y --volumes
eliminan todos los volúmenes creados y usados por los servicios. Úsalos con cuidado, ya que esto llevará a la eliminación de todos los datos almacenados en esos volúmenes.
docker compose down --volumes
2. Parámetro --rmi
El parámetro --rmi
elimina las imágenes usadas para crear contenedores. Se admiten los siguientes valores:
all
: elimina todas las imágenes usadas por el proyecto.local
: elimina solo las imágenes construidas localmente.
docker compose down --rmi all
3. Parámetro --remove-orphans
El parámetro --remove-orphans
elimina los contenedores que no están definidos en el archivo actual compose.yaml
, pero que fueron creados por ejecuciones anteriores de Docker Compose.
docker compose down --remove-orphans
5.4 Recomendaciones prácticas
1. Usa el parámetro --volumes
con cuidado
Eliminar volúmenes con la opción --volumes
resultará en la pérdida de todos los datos almacenados en esos volúmenes. Asegúrate de que realmente quieres eliminar esos datos antes de usar esta opción.
2. Limpiar imágenes innecesarias
Usar el parámetro --rmi all
es útil para limpiar todas las imágenes y liberar espacio en disco. Sin embargo, ten cuidado de no eliminar imágenes que puedas necesitar en el futuro.
3. Automatización de limpieza
Puedes incluir el comando docker compose down
en scripts de automatización o pipelines de CI/CD para limpiar automáticamente los recursos después de completar pruebas o despliegues.
GO TO FULL VERSION