diff --git a/commands/prune.go b/commands/prune.go index 9011d66d..d8ae9b43 100644 --- a/commands/prune.go +++ b/commands/prune.go @@ -138,7 +138,7 @@ func pruneCmd(dockerCli command.Cli, rootOpts *rootOptions) *cobra.Command { } flags := cmd.Flags() - flags.BoolVarP(&options.all, "all", "a", false, "Remove all unused images, not just dangling ones") + flags.BoolVarP(&options.all, "all", "a", false, "Include internal/frontend images") flags.Var(&options.filter, "filter", `Provide filter values (e.g., "until=24h")`) flags.Var(&options.keepStorage, "keep-storage", "Amount of disk space to keep for cache") flags.BoolVar(&options.verbose, "verbose", false, "Provide a more verbose output") diff --git a/docs/reference/buildx_prune.md b/docs/reference/buildx_prune.md index c547ef1a..a865ec6a 100644 --- a/docs/reference/buildx_prune.md +++ b/docs/reference/buildx_prune.md @@ -11,7 +11,7 @@ Remove build cache | Name | Type | Default | Description | | --- | --- | --- | --- | -| `-a`, `--all` | | | Remove all unused images, not just dangling ones | +| `-a`, `--all` | | | Include internal/frontend images | | [`--builder`](#builder) | `string` | | Override the configured builder instance | | `--filter` | `filter` | | Provide filter values (e.g., `until=24h`) | | `-f`, `--force` | | | Do not prompt for confirmation | @@ -21,6 +21,26 @@ Remove build cache +## Description + +Clears the build cache of the selected builder. + +You can finely control what cache data is kept using: + +- The `--filter=until=` flag to keep images that have been used in + the last `` time. + + `` is a duration string, e.g. `24h` or `2h30m`, with allowable + units of `(h)ours`, `(m)inutes` and `(s)econds`. + +- The `--keep-storage=` flag to keep `` bytes of data in the cache. + + `` 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)