Cómo eliminar imágenes Docker

como-eliminar-imagenes-docker
como-eliminar-imagenes-docker

Saber cómo eliminar imágenes Docker te ayuda a recuperar espacio sin borrar contenedores, volúmenes o imágenes que todavía necesitas. La clave es distinguir imagen, contenedor y caché antes de ejecutar comandos destructivos.

En esta lección vas a usar docker image rm y docker image prune de forma segura. Además, verás qué hacer cuando Docker bloquea el borrado porque una imagen sigue referenciada por un contenedor.

👉 Y recuerda, si quieres aprender más de Linux, visita el curso de Linux gratis.

🐳 Si quieres aprender más de Docker, visita el curso de Docker gratis.

Cómo eliminar imágenes Docker

Eliminar una imagen no elimina automáticamente contenedores ni volúmenes. Docker solo borra la imagen local si no está protegida por referencias activas o si antes limpias los contenedores que dependen de ella.

ConceptoQué representaComando típico
ImagenPlantilla local con capas.docker image rm
ContenedorInstancia creada desde una imagen.docker rm
VolumenDatos persistentes.docker volume rm
Caché/buildCapas usadas para construir.docker builder prune

Revisar antes de borrar

Primero mira qué imágenes ocupan espacio y si hay contenedores asociados. Así evitas borrar a ciegas o forzar una operación que corta un laboratorio activo.

docker image ls
docker system df
docker ps -a --filter ancestor=nginx:alpine
  • docker image ls muestra repositorio, tag, ID y tamaño.
  • docker system df resume espacio usado por imágenes, contenedores, volúmenes y caché.
  • docker ps -a –filter ancestor=… ayuda a localizar contenedores creados desde una imagen.

Borrar una imagen concreta

Para una imagen concreta, usa nombre:tag o IMAGE ID. Si la imagen está en uso por un contenedor, Docker avisará y no la eliminará hasta que resuelvas esa referencia.

docker pull nginx:alpine
docker image ls nginx
docker image rm nginx:alpine

Cuando Docker bloquea el borrado

Si aparece un conflicto, normalmente hay un contenedor detenido o en ejecución que todavía referencia esa imagen. En ese caso, decide si quieres conservar el contenedor o eliminarlo primero.

docker run -d --name imagen-demo nginx:alpine
docker image rm nginx:alpine
# Si realmente quieres borrar todo el laboratorio:
docker rm -f imagen-demo
docker image rm nginx:alpine

Limpiar imágenes no usadas

Cuando el objetivo es recuperar espacio, prune puede ser útil. Sin embargo, no lo ejecutes por costumbre en máquinas compartidas: revisa antes qué se considera no usado.

docker image prune
docker image prune -a
docker image prune -a --filter "until=24h"
  • docker image prune borra imágenes dangling por defecto.
  • docker image prune -a borra imágenes no usadas por contenedores.
  • –filter permite acotar por antigüedad y reduce el riesgo.
  • -f evita confirmación, así que úsalo solo en automatizaciones controladas.

Errores comunes

  • Confundir borrar imagen con borrar contenedor.
  • Usar docker image prune -a sin revisar el host.
  • Eliminar tags sin entender que una misma imagen puede tener varias etiquetas.
  • Forzar el borrado sin guardar evidencia del laboratorio.
  • Esperar que se borren volúmenes al eliminar imágenes.
  • No revisar el espacio con docker system df antes y después.

Lecciones relacionadas del curso Docker

Documentación oficial y recursos

Dominar cómo eliminar imágenes Docker te permite limpiar tu entorno sin romper contenedores ni perder datos persistentes. Revisa primero, borra después y usa prune solo cuando entiendas su alcance.

En producción o en máquinas compartidas, documenta qué vas a eliminar y evita comandos forzados salvo que formen parte de una automatización revisada.

Comentarios

No hay comentarios aún. ¿Por qué no comienzas el debate?

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *