mirror of
https://gitea.com/Lydanne/buildx.git
synced 2025-07-31 15:48:04 +08:00
Add descriptions and examples for buildx history commands
Signed-off-by: sarahsanders-docker <sarah.sanders@docker.com>
This commit is contained in:

committed by
Tonis Tiigi

parent
9a48aca461
commit
4dac5295a1
@@ -17,3 +17,48 @@ List build records
|
||||
|
||||
<!---MARKER_GEN_END-->
|
||||
|
||||
## Description
|
||||
|
||||
List completed builds recorded by the active builder. Each entry includes the
|
||||
build ID, name (if available), status, timestamp, and duration.
|
||||
|
||||
By default, only records for the current builder are shown. You can filter
|
||||
results using flags.
|
||||
|
||||
## Examples
|
||||
|
||||
### List all build records for the current builder
|
||||
|
||||
```console
|
||||
docker buildx history ls
|
||||
```
|
||||
|
||||
### List only failed builds
|
||||
|
||||
```console
|
||||
docker buildx history ls --filter status=error
|
||||
```
|
||||
|
||||
### List builds from the current directory
|
||||
|
||||
```console
|
||||
docker buildx history ls --local
|
||||
```
|
||||
|
||||
### Display full output without truncation
|
||||
|
||||
```console
|
||||
docker buildx history ls --no-trunc
|
||||
```
|
||||
|
||||
### Format output as JSON
|
||||
|
||||
```console
|
||||
docker buildx history ls --format json
|
||||
```
|
||||
|
||||
### Use a Go template to print name and durations
|
||||
|
||||
```console
|
||||
docker buildx history ls --format '{{.Name}} - {{.Duration}}'
|
||||
```
|
||||
|
Reference in New Issue
Block a user