Skip to content

Commit f208c6c

Browse files
github-actions[bot]dvdksn
authored andcommitted
docs: address issue #23757
This change was automatically generated by the documentation agent team in response to issue #23757. 🤖 Generated with cagent Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
1 parent 83154a1 commit f208c6c

2 files changed

Lines changed: 18 additions & 0 deletions

File tree

_vale/config/vocabularies/Docker/accept.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
(?i)[A-Z]{2,}'?s
22
jq
3+
zstd
4+
Zstandard
35
untracked
46
ripgrep
57
exfiltration

content/manuals/build/exporters/_index.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -252,6 +252,22 @@ the previous compression algorithm.
252252
> The `gzip` and `estargz` compression methods use the [`compress/gzip` package](https://pkg.go.dev/compress/gzip),
253253
> while `zstd` uses the [`github.com/klauspost/compress/zstd` package](https://github.com/klauspost/compress/tree/master/zstd).
254254
255+
#### zstd compression levels
256+
257+
When you specify `compression=zstd`, the `compression-level` parameter accepts
258+
values from 0 to 22. BuildKit maps these values to four internal compression
259+
levels:
260+
261+
| compression-level | Internal level | Approximate zstd level | Description |
262+
| ----------------- | -------------- | ---------------------- | ------------------------------------- |
263+
| 0-2 | Fastest | ~1 | Fastest compression, larger file size |
264+
| 3-6 (default) | Default | ~3 | Balanced compression and speed |
265+
| 7-8 | Better | ~7 | Better compression, slower |
266+
| 9-22 | Best | ~11 | Best compression, slowest |
267+
268+
For example, setting `compression-level=5` and `compression-level=6` produces
269+
the same compression output, since both map to the "Default" internal level.
270+
255271
### OCI media types
256272

257273
The `image`, `registry`, `oci` and `docker` exporters create container images.

0 commit comments

Comments
 (0)