docker buildx prune

Descripción

Limpia la caché de construcción del builder seleccionado.

Opciones

Ejemplos

Incluir imágenes internas/frontend (--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)

Puedes controlar detalladamente qué registros de caché eliminar utilizando la bandera --filter.

El formato del filtro tiene la forma <clave><operador><valor>, 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:

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)

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)

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)

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)

Igual que buildx --builder.