diff --git a/_vale/config/vocabularies/Docker/accept.txt b/_vale/config/vocabularies/Docker/accept.txt index cdbf04825fac..4efe0d69af47 100644 --- a/_vale/config/vocabularies/Docker/accept.txt +++ b/_vale/config/vocabularies/Docker/accept.txt @@ -1,5 +1,7 @@ (?i)[A-Z]{2,}'?s jq +zstd +Zstandard untracked ripgrep exfiltration diff --git a/content/manuals/build/exporters/_index.md b/content/manuals/build/exporters/_index.md index 67ddf0df668a..1d601b469560 100644 --- a/content/manuals/build/exporters/_index.md +++ b/content/manuals/build/exporters/_index.md @@ -252,6 +252,22 @@ the previous compression algorithm. > The `gzip` and `estargz` compression methods use the [`compress/gzip` package](https://pkg.go.dev/compress/gzip), > while `zstd` uses the [`github.com/klauspost/compress/zstd` package](https://github.com/klauspost/compress/tree/master/zstd). +#### zstd compression levels + +When you specify `compression=zstd`, the `compression-level` parameter accepts +values from 0 to 22. BuildKit maps these values to four internal compression +levels: + +| compression-level | Internal level | Approximate zstd level | Description | +| ----------------- | -------------- | ---------------------- | ------------------------------------- | +| 0-2 | Fastest | ~1 | Fastest compression, larger file size | +| 3-6 (default) | Default | ~3 | Balanced compression and speed | +| 7-8 | Better | ~7 | Better compression, slower | +| 9-22 | Best | ~11 | Best compression, slowest | + +For example, setting `compression-level=5` and `compression-level=6` produces +the same compression output, since both map to the "Default" internal level. + ### OCI media types The `image`, `registry`, `oci` and `docker` exporters create container images.