# docker image prune **Descripción:** Elimina imágenes no utilizadas **Uso:** `docker image prune [OPTIONS]` ## Descripción Elimina todas las imágenes huérfanas (dangling). Si se especifica `-a`, también elimina todas las imágenes que no estén referenciadas por ningún contenedor. ## Opciones | Opción | Predeterminado | Descripción | | ------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | `-a`, `--all` | | Elimina todas las imágenes no utilizadas, no solo las huérfanas | | `--filter` | | Proporciona valores de filtro (por ejemplo, `until=`) | | `-f`, `--force` | | No solicita confirmación | ## Ejemplos Ejemplo de salida: ```console $ docker image prune -a WARNING! This will remove all images without at least one container associated to them. Are you sure you want to continue? [y/N] y Deleted Images: untagged: alpine:latest untagged: alpine@sha256:3dcdb92d7432d56604d4545cbd324b14e647b313626d99b889d0626de158f73a deleted: sha256:4e38e38c8ce0b8d9041a9c4fefe786631d1416225e13b0bfe8cfa2321aec4bba deleted: sha256:4fe15f8d0ae69e169824f25f1d4da3015a48feeeeebb265cd2e328e15c6a869f untagged: alpine:3.3 untagged: alpine@sha256:4fa633f4feff6a8f02acfc7424efd5cb3e76686ed3218abf4ca0fa4a2a358423 untagged: my-jq:latest deleted: sha256:ae67841be6d008a374eff7c2a974cde3934ffe9536a7dc7ce589585eddd83aff deleted: sha256:34f6f1261650bc341eb122313372adc4512b4fceddc2a7ecbb84f0958ce5ad65 deleted: sha256:cf4194e8d8db1cb2d117df33f2c75c0369c3a26d96725efb978cc69e046b87e7 untagged: my-curl:latest deleted: sha256:b2789dd875bf427de7f9f6ae001940073b3201409b14aba7e5db71f408b8569e deleted: sha256:96daac0cb203226438989926fc34dd024f365a9a8616b93e168d303cfe4cb5e9 deleted: sha256:5cbd97a14241c9cd83250d6b6fc0649833c4a3e84099b968dd4ba403e609945e deleted: sha256:a0971c4015c1e898c60bf95781c6730a05b5d8a2ae6827f53837e6c9d38efdec deleted: sha256:d8359ca3b681cc5396a4e790088441673ed3ce90ebc04de388bfcd31a0716b06 deleted: sha256:83fc9ba8fb70e1da31dfcc3c88d093831dbd4be38b34af998df37e8ac538260c deleted: sha256:ae7041a4cc625a9c8e6955452f7afe602b401f662671cea3613f08f3d9343b35 deleted: sha256:35e0f43a37755b832f0bbea91a2360b025ee351d7309dae0d9737bc96b6d0809 deleted: sha256:0af941dd29f00e4510195dd00b19671bc591e29d1495630e7e0f7c44c1e6a8c0 deleted: sha256:9fc896fc2013da84f84e45b3096053eb084417b42e6b35ea0cce5a3529705eac deleted: sha256:47cf20d8c26c46fff71be614d9f54997edacfe8d46d51769706e5aba94b16f2b deleted: sha256:2c675ee9ed53425e31a13e3390bf3f539bf8637000e4bcfbb85ee03ef4d910a1 Total reclaimed space: 16.43 MB ### Filtrar (--filter) {#filter} El formato de la opción de filtrado (`--filter`) es "clave=valor". Si hay más de un filtro, pasa múltiples opciones (por ejemplo, `--filter "foo=bar" --filter "bif=baz"`). Cuando se proporcionan varios filtros, se combinan de la siguiente manera: - Los filtros con **diferentes claves** se combinan utilizando la lógica AND. Una imagen debe cumplir todas las condiciones del filtro para ser eliminada. - Los filtros con la **misma clave** se combinan utilizando la lógica OR. Una imagen se elimina si coincide con cualquiera de los valores de esa clave. Por ejemplo, `--filter "label=foo" --filter "until=24h"` elimina imágenes que tienen la etiqueta `foo` **y** que fueron creadas hace más de 24 horas. Por el contrario, `--filter "label=foo" --filter "label=bar"` elimina imágenes que tienen la etiqueta `foo` **o** `bar`. Los filtros actualmente soportados son: * until (``) - solo elimina imágenes creadas antes de la marca de tiempo provista * label (`label=`, `label==`, `label!=` o `label!==`) - solo elimina imágenes con (o sin, si se usa `label!=...`) las etiquetas especificadas. El filtro `until` puede ser marcas de tiempo Unix, marcas de tiempo formateadas como fechas o cadenas de duración de Go soportadas por [ParseDuration](https://pkg.go.dev/time#ParseDuration) (por ejemplo, `10m`, `1h30m`) calculadas con respecto a la hora del demonio. Los formatos soportados para marcas de tiempo con formato de fecha incluyen RFC3339Nano, RFC3339, `2006-01-02T15:04:05`, `2006-01-02T15:04:05.999999999`, `2006-01-02T07:00` y `2006-01-02`. Se utilizará la zona horaria local del demonio si no proporcionas un desplazamiento de zona horaria `Z` o `+-00:00` al final de la marca de tiempo. Al proporcionar marcas de tiempo Unix, ingresa segundos[.nanosegundos], donde segundos es el número de segundos transcurridos desde el 1 de enero de 1970 (medianoche UTC/GMT), sin contar los segundos intercalares (también conocido como época Unix o tiempo Unix), y el campo opcional .nanosegundos es una fracción de segundo de no más de nueve dígitos de longitud. El filtro `label` acepta dos formatos. Uno es `label=...` (`label=` o `label==`), que elimina las imágenes con las etiquetas especificadas. El otro formato es `label!=...` (`label!=` o `label!==`), que elimina las imágenes sin las etiquetas especificadas. > [!NOTE] > **Predecir qué se eliminará** > > Si estás utilizando un filtrado positivo (comprobando la existencia de una etiqueta o > que una etiqueta tenga un valor específico), puedes usar `docker image ls` con la > misma sintaxis de filtrado para ver qué imágenes coinciden con tu filtro. > > Sin embargo, si estás utilizando un filtrado negativo (comprobando la ausencia de una > etiqueta o que una etiqueta no tenga un valor específico), este tipo de filtro > no funciona con `docker image ls`, por lo que no puedes predecir fácilmente qué imágenes > se eliminarán. Además, el mensaje de confirmación de `docker image prune` > siempre advierte que se eliminarán todas las imágenes huérfanas, incluso si estás utilizando > `--filter`. El siguiente ejemplo elimina las imágenes creadas antes de `2017-01-04T00:00:00`: ```console $ docker images --format 'table {{.Repository}}\t{{.Tag}}\t{{.ID}}\t{{.CreatedAt}}\t{{.Size}}' REPOSITORY TAG IMAGE ID CREATED AT SIZE foo latest 2f287ac753da 2017-01-04 13:42:23 -0800 PST 3.98 MB alpine latest 88e169ea8f46 2016-12-27 10:17:25 -0800 PST 3.98 MB busybox latest e02e811dd08f 2016-10-07 14:03:58 -0700 PDT 1.09 MB $ docker image prune -a --force --filter "until=2017-01-04T00:00:00" Deleted Images: untagged: alpine:latest untagged: alpine@sha256:dfbd4a3a8ebca874ebd2474f044a0b33600d4523d03b0df76e5c5986cb02d7e8 untagged: busybox:latest untagged: busybox@sha256:29f5d56d12684887bdfa50dcd29fc31eea4aaf4ad3bec43daf19026a7ce69912 deleted: sha256:e02e811dd08fd49e7f6032625495118e63f597eb150403d02e3238af1df240ba deleted: sha256:e88b3f82283bc59d5e0df427c824e9f95557e661fcb0ea15fb0fb6f97760f9d9 Total reclaimed space: 1.093 MB $ docker images --format 'table {{.Repository}}\t{{.Tag}}\t{{.ID}}\t{{.CreatedAt}}\t{{.Size}}' REPOSITORY TAG IMAGE ID CREATED AT SIZE foo latest 2f287ac753da 2017-01-04 13:42:23 -0800 PST 3.98 MB ``` El siguiente ejemplo elimina las imágenes creadas hace más de 10 días (`240h`): ```console $ docker images REPOSITORY TAG IMAGE ID CREATED SIZE foo latest 2f287ac753da 14 seconds ago 3.98 MB alpine latest 88e169ea8f46 8 days ago 3.98 MB debian jessie 7b0a06c805e8 2 months ago 123 MB busybox latest e02e811dd08f 2 months ago 1.09 MB golang 1.7.0 138c2e655421 4 months ago 670 MB $ docker image prune -a --force --filter "until=240h" Deleted Images: untagged: golang:1.7.0 untagged: golang@sha256:6765038c2b8f407fd6e3ecea043b44580c229ccfa2a13f6d85866cf2b4a9628e deleted: sha256:138c2e6554219de65614d88c15521bfb2da674cbb0bf840de161f89ff4264b96 deleted: sha256:ec353c2e1a673f456c4b78906d0d77f9d9456cfb5229b78c6a960bfb7496b76a deleted: sha256:fe22765feaf3907526b4921c73ea6643ff9e334497c9b7e177972cf22f68ee93 deleted: sha256:ff845959c80148421a5c3ae11cc0e6c115f950c89bc949646be55ed18d6a2912 deleted: sha256:a4320831346648c03db64149eafc83092e2b34ab50ca6e8c13112388f25899a7 deleted: sha256:4c76020202ee1d9709e703b7c6de367b325139e74eebd6b55b30a63c196abaf3 deleted: sha256:d7afd92fb07236c8a2045715a86b7d5f0066cef025018cd3ca9a45498c51d1d6 deleted: sha256:9e63c5bce4585dd7038d830a1f1f4e44cb1a1515b00e620ac718e934b484c938 untagged: debian:jessie untagged: debian@sha256:c1af755d300d0c65bb1194d24bce561d70c98a54fb5ce5b1693beb4f7988272f deleted: sha256:7b0a06c805e8f23807fb8856621c60851727e85c7bcb751012c813f122734c8d deleted: sha256:f96222d75c5563900bc4dd852179b720a0885de8f7a0619ba0ac76e92542bbc8 Total reclaimed space: 792.6 MB $ docker images REPOSITORY TAG IMAGE ID CREATED SIZE foo latest 2f287ac753da About a minute ago 3.98 MB alpine latest 88e169ea8f46 8 days ago 3.98 MB busybox latest e02e811dd08f 2 months ago 1.09 MB El siguiente ejemplo elimina las imágenes con la etiqueta `deprecated`: ```console $ docker image prune --filter="label=deprecated" ``` El siguiente ejemplo elimina las imágenes con la etiqueta `maintainer` establecida en `john`: ```console $ docker image prune --filter="label=maintainer=john" ``` Este ejemplo elimina las imágenes que no tienen la etiqueta `maintainer`: ```console $ docker image prune --filter="label!=maintainer" ``` Este ejemplo elimina las imágenes que tienen una etiqueta `maintainer` no establecida en `john`: ```console $ docker image prune --filter="label!=maintainer=john" ``` > [!NOTE] > Se te pedirá confirmación antes de que `prune` elimine algo, > pero no se te mostrará una lista de lo que potencialmente se eliminará. > Además, `docker image ls` no admite filtrado negativo, por lo que es > difícil predecir qué imágenes se eliminarán realmente.