mirror of
https://gitea.com/Lydanne/buildx.git
synced 2025-05-18 00:47:48 +08:00

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>
52 lines
2.1 KiB
Markdown
52 lines
2.1 KiB
Markdown
# buildx prune
|
|
|
|
```text
|
|
docker buildx prune
|
|
```
|
|
|
|
<!---MARKER_GEN_START-->
|
|
Remove build cache
|
|
|
|
### Options
|
|
|
|
| Name | Type | Default | Description |
|
|
|:------------------------|:---------|:--------|:-------------------------------------------------------|
|
|
| `-a`, `--all` | `bool` | | Include internal/frontend images |
|
|
| [`--builder`](#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 |
|
|
|
|
|
|
<!---MARKER_GEN_END-->
|
|
|
|
## 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
|
|
|
|
### <a name="builder"></a> Override the configured builder instance (--builder)
|
|
|
|
Same as [`buildx --builder`](buildx.md#builder).
|