docker/buildx
1
0
Fork 0
mirror of https://gitea.com/Lydanne/buildx.git synced 2026-01-18 20:04:21 +08:00
Code Issues Packages Projects Releases 1 Wiki Activity

feedback + updated examples + added links for h3 headings

Browse Source 
Signed-off-by: sarahsanders-docker <sarah.sanders@docker.com>
This commit is contained in:
sarahsanders-docker
2025-04-22 12:14:51 -04:00
committed by Tonis Tiigi
parent 4dac5295a1
commit 23ce21c341
10 changed files with 300 additions and 58 deletions
Download Patch File Download Diff File Expand all files Collapse all files

46
docs/reference/buildx_history_logs.md
View File

@@ -16,32 +16,60 @@ Print the logs of a build
## Description
Print the logs for a completed build. The output appears in the same format as `--progress=plain`, showing the full logs for each step without multiplexing.
Print the logs for a completed build. The output appears in the same format as
`--progress=plain`, showing the full logs for each step.
By default, this shows logs for the most recent build on the current builder.
You can also specify an earlier build using an offset. For example:
- `^1` shows logs for the build before the most recent
- `^2` shows logs for the build two steps back
## Examples
### Print logs for the most recent build
### <a name="print-logs-recent-build"></a> Print logs for the most recent build
```console
docker buildx history logs
$ docker buildx history logs
#1 [internal] load build definition from Dockerfile
#1 transferring dockerfile: 31B done
#1 DONE 0.0s
#2 [internal] load .dockerignore
#2 transferring context: 2B done
#2 DONE 0.0s
...
```
### Print logs for a specific build
By default, this shows logs for the most recent build on the current builder.
### <a name="print-logs-specific-build"></a> Print logs for a specific build
To print logs for a specific build, use a build ID or offset:
```console
docker buildx history logs mybuild
# Using a build ID
docker buildx history logs qu2gsuo8ejqrwdfii23xkkckt
# Or using a relative offset
docker buildx history logs ^1
```
### Print logs in JSON format
### <a name="print-logs-json"></a> Print logs in JSON format
```console
docker buildx history logs mybuild --progress rawjson
$ docker buildx history logs ^1 --progress rawjson
{"id":"buildx_step_1","status":"START","timestamp":"2024-05-01T12:34:56.789Z","detail":"[internal] load build definition from Dockerfile"}
{"id":"buildx_step_1","status":"COMPLETE","timestamp":"2024-05-01T12:34:57.001Z","duration":212000000}
...
```
### Print logs in TTY format
### <a name="print-logs-tty"></a> Print logs in TTY format
```console
docker buildx history logs mybuild --progress tty
# Using a build ID
docker buildx history logs qu2gsuo8ejqrwdfii23xkkckt --progress tty
# Or using a relative offset
docker buildx history logs ^1 --progress tty
```