# docker buildx prune **Descripción:** Elimina la caché de construcción **Uso:** `docker buildx prune` ## Descripción Limpia la caché de construcción del builder seleccionado. ## Opciones | Opción | Predeterminado | Descripción | | ------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | `-a`, `--all` | | Incluye imágenes internas y de frontend | | `--filter` | | Proporciona valores de filtro | | `-f`, `--force` | | No solicita confirmación | | `--max-used-space` | | Cantidad máxima de espacio en disco permitida para conservar en la caché | | `--min-free-space` | | Cantidad de destino de espacio libre en disco después de la limpieza | | `--reserved-space` | | Cantidad de espacio en disco siempre permitida para conservar en la caché | | `--timeout` | `20s` | Sobrescribe el tiempo de espera (timeout) predeterminado para cargar el estado del builder | | `--verbose` | | Proporciona una salida más detallada | ## Ejemplos ### Incluir imágenes internas/frontend (--all) {#all} La bandera `--all` permite limpiar las imágenes auxiliares internas y las imágenes de frontend establecidas mediante la directiva `#syntax=` o el argumento de construcción `BUILDKIT_SYNTAX`. ### Proporcionar valores de filtro (--filter) {#filter} Puedes controlar detalladamente qué registros de caché eliminar utilizando la bandera `--filter`. El formato del filtro tiene la forma ``, conocidos como selectores. Todos los selectores deben coincidir con el objeto de destino para que el filtro sea verdadero. Definimos los operadores `=` para igualdad, `!=` para desigualdad y `~=` para expresiones regulares. Las claves de filtro válidas son: - bandera `until` para conservar registros que se hayan utilizado en el último período de tiempo. El valor es una cadena de duración, por ejemplo, `24h` o `2h30m`, con unidades permitidas de horas (`h`), minutos (`m`) y segundos (`s`). - bandera `id` para apuntar a un ID de imagen específico. - bandera `parents` para apuntar a los registros que son padres del ID de imagen especificado. Los múltiples ID de padres se separan con un punto y coma (`;`). - bandera `description` para apuntar a registros cuya descripción contenga la subcadena especificada. - bandera `inuse` para apuntar a registros que están en uso activo y, por lo tanto, no son reclamables. - bandera `mutable` para apuntar a registros que son mutables. - bandera `immutable` para apuntar a registros que son inmutables. - bandera `shared` para apuntar a registros que se comparten con otros recursos, típicamente imágenes. - bandera `private` para apuntar a registros que no están compartidos. - bandera `type` para apuntar a registros por tipo. Los tipos válidos son: - `internal` - `frontend` - `source.local` - `source.git.checkout` - `exec.cachemount` - `regular` Ejemplos: ```console docker buildx prune --filter "until=24h" docker buildx prune --filter "description~=golang" docker buildx prune --filter "parents=dpetmoi6n0yqanxjqrbnofz9n;kgoj0q6g57i35gdyrv546alz7" docker buildx prune --filter "type=source.local" docker buildx prune --filter "type!=exec.cachemount" ``` > [!NOTE] > Las múltiples banderas `--filter` se combinan con un operador lógico AND. ### Cantidad máxima de espacio en disco permitida para conservar en la caché (--max-used-space) {#max-used-space} La bandera `--max-used-space` permite establecer una cantidad máxima de espacio en disco que puede utilizar la caché de construcción. Si la caché está utilizando más espacio en disco que este valor, los registros de caché menos utilizados recientemente se eliminarán hasta que el espacio total utilizado sea menor o igual al valor especificado. El valor se especifica en bytes. Puedes usar una cadena de memoria legible por humanos, por ejemplo, `128mb`, `2gb`, etc. Las unidades no distinguen entre mayúsculas y minúsculas. ### Cantidad de destino de espacio libre en disco después de la limpieza (--min-free-space) {#min-free-space} La bandera `--min-free-space` permite establecer una cantidad de destino de espacio libre en disco que debería estar disponible después de la limpieza. Si el espacio en disco disponible es menor que este valor, los registros de caché menos utilizados recientemente se eliminarán hasta que el espacio libre disponible sea mayor o igual al valor especificado. El valor se especifica en bytes. Puedes usar una cadena de memoria legible por humanos, por ejemplo, `128mb`, `2gb`, etc. Las unidades no distinguen entre mayúsculas y minúsculas. ### Cantidad de espacio en disco siempre permitida para conservar en la caché (--reserved-space) {#reserved-space} La bandera `--reserved-space` permite establecer una cantidad de espacio en disco que siempre se debe conservar para la caché de construcción. Si el espacio en disco disponible es menor que este valor, los registros de caché menos utilizados recientemente se eliminarán hasta que el espacio libre disponible sea mayor o igual al valor especificado. El valor se especifica en bytes. Puedes usar una cadena de memoria legible por humanos, por ejemplo, `128mb`, `2gb`, etc. Las unidades no distinguen entre mayúsculas y minúsculas. ### Sobrescribir la instancia del builder configurada (--builder) {#builder} Igual que [`buildx --builder`](/reference/cli/docker/buildx/#builder).