buildx/docs/reference/buildx_prune.md
Jonathan A. Sternberg 64c5139ab6
hack: generate vtproto files for buildx
Integrates vtproto into buildx. The generated files dockerfile has been
modified to copy the buildkit equivalent file to ensure files are laid
out in the appropriate way for imports.

An import has also been included to change the grpc codec to the version
in buildkit that supports vtproto. This will allow buildx to utilize the
speed and memory improvements from that.

Also updates the gc control options for prune.

Signed-off-by: Jonathan A. Sternberg <jonathan.sternberg@docker.com>
2024-10-08 13:35:06 -05:00

2.1 KiB

buildx prune

docker buildx prune

Remove build cache

Options

Name Type Default Description
-a, --all bool Include internal/frontend images
--builder string Override the configured builder instance
-D, --debug bool Enable debug logging
--filter filter Provide filter values (e.g., until=24h)
-f, --force bool Do not prompt for confirmation
--max-used-space bytes 0 Maximum amount of disk space allowed to keep for cache
--min-free-space bytes 0 Target amount of free disk space after pruning
--reserved-space bytes 0 Amount of disk space always allowed to keep for cache
--verbose bool Provide a more verbose output

Description

Clears the build cache of the selected builder.

You can finely control what cache data is kept using:

  • The --filter=until=<duration> flag to keep images that have been used in the last <duration> time.

    <duration> is a duration string, e.g. 24h or 2h30m, with allowable units of (h)ours, (m)inutes and (s)econds.

  • The --keep-storage=<size> flag to keep <size> bytes of data in the cache.

    <size> is a human-readable memory string, e.g. 128mb, 2gb, etc. Units are case-insensitive.

  • The --all flag to allow clearing internal helper images and frontend images set using the #syntax= directive or the BUILDKIT_SYNTAX build argument.

Examples

Override the configured builder instance (--builder)

Same as buildx --builder.