# docker buildx du **Descripción:** Uso de disco **Uso:** `docker buildx du` ## Descripción Uso de disco ## Opciones | Opción | Predeterminado | Descripción | | ------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | `--filter` | | Proporciona valores de filtro | | `--format` | | Formatea la salida | | `--timeout` | `20s` | Sobrescribe el tiempo de espera (timeout) predeterminado para cargar el estado del builder | | `--verbose` | | Atajo para `--format=pretty` | ## Ejemplos ### Mostrar el uso de disco El comando `docker buildx du` muestra el uso de disco para el builder seleccionado actualmente. ```console $ docker buildx du ID RECLAIMABLE SIZE LAST ACCESSED 12wgll9os87pazzft8lt0yztp* true 1.704GB 13 days ago iupsv3it5ubh92aweb7c1wojc* true 1.297GB 36 minutes ago ek4ve8h4obyv5kld6vicmtqyn true 811.7MB 13 days ago isovrfnmkelzhtdx942w9vjcb* true 811.7MB 13 days ago 0jty7mjrndi1yo7xkv1baralh true 810.5MB 13 days ago jyzkefmsysqiaakgwmjgxjpcz* true 810.5MB 13 days ago z8w1y95jn93gvj92jtaj6uhwk true 318MB 2 weeks ago rz2zgfcwlfxsxd7d41w2sz2tt true 8.224kB* 43 hours ago n5bkzpewmk2eiu6hn9tzx18jd true 8.224kB* 43 hours ago ao94g6vtbzdl6k5zgdmrmnwpt true 8.224kB* 43 hours ago 2pyjep7njm0wh39vcingxb97i true 8.224kB* 43 hours ago Shared: 115.5MB Private: 10.25GB Reclaimable: 10.36GB Total: 10.36GB ``` Si `RECLAIMABLE` es false, el comando `docker buildx du prune` no eliminará el registro, incluso si utilizas `--all`. Esto se debe a que el registro está siendo utilizado activamente por algún componente del builder. Los asteriscos (*) en el formato de salida predeterminado indican lo siguiente: - Un asterisco junto a un ID (`zu7m6evdpebh5h8kfkpw9dlf2*`) indica que el registro es mutable. El tamaño del registro puede cambiar, o bien otra construcción puede tomar posesión de él y cambiarlo o realizar commits en él. Si ejecutas de nuevo el comando `du`, es posible que este elemento ya no esté o que su tamaño sea diferente. - Un asterisco junto a un tamaño (`8.288kB*`) indica que el registro está compartido. El almacenamiento del registro se comparte con algún otro recurso, normalmente una imagen. Si realizas una limpieza (prune) de dicho registro, perderás la caché de construcción pero solo se eliminarán los metadatos, ya que la imagen aún necesita las capas de almacenamiento reales. ### Proporcionar valores de filtro (--filter) {#filter} Igual que [`buildx prune --filter`](/reference/cli/docker/buildx/prune/#filter). ### Formatear la salida (--format) {#format} Las opciones de formato (`--format`) imprimen con un formato amigable la salida de la información de uso utilizando una plantilla de Go. Los marcadores de posición válidos para la plantilla de Go son: * `.ID` * `.Parents` * `.CreatedAt` * `.Mutable` * `.Reclaimable` * `.Shared` * `.Size` * `.Description` * `.UsageCount` * `.LastUsedAt` * `.Type` Al usar la opción `--format`, el comando `du` producirá los datos exactamente como lo declara la plantilla o, si se usa la directiva `table`, también incluirá los encabezados de las columnas. El formato `pretty` es útil para inspeccionar los registros de uso de disco con más detalle. Muestra los estados mutable y compartido de forma más clara, así como información adicional sobre la capa correspondiente: ```console $ docker buildx du --format=pretty ... ID: 6wqu0v6hjdwvhh8yjozrepaof Parents: - bqx15bcewecz4wcg14b7iodvp Created at: 2025-06-12 15:44:02.715795569 +0000 UTC Mutable: false Reclaimable: true Shared: true Size: 1.653GB Description: [build-base 4/4] COPY . . Usage count: 1 Last used: 2 months ago Type: regular Shared: 35.57GB Private: 97.94GB Reclaimable: 131.5GB Total: 133.5GB ``` El siguiente ejemplo utiliza una plantilla sin encabezados y muestra las entradas de `ID` y `Size` separadas por dos puntos (`:`): ```console $ docker buildx du --format "{{.ID}}: {{.Size}}" 6wqu0v6hjdwvhh8yjozrepaof: 1.653GB 4m8061kctvjyh9qleus8rgpgx: 1.723GB fcm9mlz2641u8r5eicjqdhy1l: 1.841GB z2qu1swvo3afzd9mhihi3l5k0: 1.873GB nmi6asc00aa3ja6xnt6o7wbrr: 2.027GB 0qlam41jxqsq6i27yqllgxed3: 2.495GB 3w9qhzzskq5jc262snfu90bfz: 2.617GB ``` El siguiente ejemplo utiliza una plantilla de tipo `table` y muestra el `ID` y la `Description`: ```console $ docker buildx du --format "table {{.ID}} {{.Description}}" ID DESCRIPTION 03bbhchaib8cygqs68um6hfnl [binaries-linux 2/5] LINK COPY --link --from=binfmt-filter /out/ / 2h8un0tyg57oj64xvbas6mzea [cni-plugins-export 2/4] LINK COPY --link --from=cni-plugins /opt/cni/bin/loopback /buildkit-cni-loopback evckox33t07ob9dmollhn4h4j [cni-plugins-export 3/4] LINK COPY --link --from=cni-plugins /opt/cni/bin/host-local /buildkit-cni-host-local jlxzwcw6xaomxj8irerow9bhb [binaries-linux 4/5] LINK COPY --link --from=buildctl /usr/bin/buildctl / ov2oetgebkhpsw39rv1sbh5w1 [buildkit-linux 1/1] LINK COPY --link --from=binaries / /usr/bin/ ruoczhyq25n5v9ld7n231zalx [binaries-linux 3/5] LINK COPY --link --from=cni-plugins-export-squashed / / ax7cov6kizxi9ufvcwsef4occ* local source for context ``` También se admite la salida JSON, que se imprimirá como JSON delimitado por nuevas líneas (NDJSON): ```console $ docker buildx du --format=json {"CreatedAt":"2025-07-29T12:36:01Z","Description":"pulled from docker.io/library/rust:1.85.1-bookworm@sha256:e51d0265072d2d9d5d320f6a44dde6b9ef13653b035098febd68cce8fa7c0bc4","ID":"ic1gfidvev5nciupzz53alel4","LastUsedAt":"2025-07-29T12:36:01Z","Mutable":false,"Parents":["hmpdhm4sjrfpmae4xm2y3m0ra"],"Reclaimable":true,"Shared":false,"Size":"829889526","Type":"regular","UsageCount":1} {"CreatedAt":"2025-08-05T09:24:09Z","Description":"pulled from docker.io/library/node:22@sha256:3218f0d1b9e4b63def322e9ae362d581fbeac1ef21b51fc502ef91386667ce92","ID":"jsw7fx09l5zsda3bri1z4mwk5","LastUsedAt":"2025-08-05T09:24:09Z","Mutable":false,"Parents":["098jsj5ebbv1w47ikqigeuurs"],"Reclaimable":true,"Shared":true,"Size":"829898832","Type":"regular","UsageCount":1} ``` Puedes usar `jq` para formatear la salida JSON: ```console $ docker buildx du --format=json | jq . { "CreatedAt": "2025-07-29T12:36:01Z", "Description": "pulled from docker.io/library/rust:1.85.1-bookworm@sha256:e51d0265072d2d9d5d320f6a44dde6b9ef13653b035098febd68cce8fa7c0bc4", "ID": "ic1gfidvev5nciupzz53alel4", "LastUsedAt": "2025-07-29T12:36:01Z", "Mutable": false, "Parents": [ "hmpdhm4sjrfpmae4xm2y3m0ra" ], "Reclaimable": true, "Shared": false, "Size": "829889526", "Type": "regular", "UsageCount": 1 } { "CreatedAt": "2025-08-05T09:24:09Z", "Description": "pulled from docker.io/library/node:22@sha256:3218f0d1b9e4b63def322e9ae362d581fbeac1ef21b51fc502ef91386667ce92", "ID": "jsw7fx09l5zsda3bri1z4mwk5", "LastUsedAt": "2025-08-05T09:24:09Z", "Mutable": false, "Parents": [ "098jsj5ebbv1w47ikqigeuurs" ], "Reclaimable": true, "Shared": true, "Size": "829898832", "Type": "regular", "UsageCount": 1 } ``` ### Usar salida detallada (--verbose) {#verbose} Atajo para [`--format=pretty`](#format): ```console $ docker buildx du --verbose ... ID: 6wqu0v6hjdwvhh8yjozrepaof Parents: - bqx15bcewecz4wcg14b7iodvp Created at: 2025-06-12 15:44:02.715795569 +0000 UTC Mutable: false Reclaimable: true Shared: true Size: 1.653GB Description: [build-base 4/4] COPY . . Usage count: 1 Last used: 2 months ago Type: regular Shared: 35.57GB Private: 97.94GB Reclaimable: 131.5GB Total: 133.5GB ``` ### Sobrescribir la instancia del builder configurada (--builder) {#builder} Utiliza la bandera `--builder` para inspeccionar el uso de disco de un builder en particular. ```console $ docker buildx du --builder mybuilder ID RECLAIMABLE SIZE LAST ACCESSED g41agepgdczekxg2mtw0dujsv* true 1.312GB 47 hours ago e6ycrsa0bn9akigqgzu0sc6kr true 318MB 47 hours ago our9zg4ndly65ze1ccczdksiz true 204.9MB 45 hours ago b7xv3xpxnwupc81tc9ya3mgq6* true 120.6MB 47 hours ago zihgye15ss6vum3wmck9egdoy* true 79.81MB 2 days ago aaydharssv1ug98yhuwclkfrh* true 79.81MB 2 days ago ta1r4vmnjug5dhub76as4kkol* true 74.51MB 47 hours ago murma9f83j9h8miifbq68udjf* true 74.51MB 47 hours ago 47f961866a49g5y8myz80ixw1* true 74.51MB 47 hours ago tzh99xtzlaf6txllh3cobag8t true 74.49MB 47 hours ago ld6laoeuo1kwapysu6afwqybl* true 59.89MB 47 hours ago yitxizi5kaplpyomqpos2cryp* true 59.83MB 47 hours ago iy8aa4b7qjn0qmy9wiga9cj8w true 33.65MB 47 hours ago mci7okeijyp8aqqk16j80dy09 true 19.86MB 47 hours ago lqvj091he652slxdla4wom3pz true 14.08MB 47 hours ago fkt31oiv793nd26h42llsjcw7* true 11.87MB 2 days ago uj802yxtvkcjysnjb4kgwvn2v true 11.68MB 45 hours ago Reclaimable: 2.627GB Total: 2.627GB ```