docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #20782 from dvdksn/buildkit-016-s3-cache-opts 

build(s3-cache): new/updated cache opt descriptions
This commit is contained in:
David Karlsson 2024-09-10 20:59:28 +02:00 committed by GitHub
parent 12bd4ff28b e37be22807
commit 8f60bd2bc0
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 16 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
content/manuals/build/cache/backends/s3.md vendored
View File

@ -30,20 +30,22 @@ $ docker buildx build --push -t <user>/<image> \
The following table describes the available CSV parameters that you can pass to The following table describes the available CSV parameters that you can pass to
`--cache-to` and `--cache-from`. `--cache-to` and `--cache-from`.
| Name | Option | Type | Default | Description | | Name | Option | Type | Default | Description |
| ------------------- | ----------------------- | ----------- | ------- | ---------------------------------------------------------- | | -------------------- | ----------------------- | ----------- | ------- | -------------------------------------------------------------- |
| `region` | `cache-to`,`cache-from` | String | | Required. Geographic location. | | `region` | `cache-to`,`cache-from` | String | | Required. Geographic location. |
| `bucket` | `cache-to`,`cache-from` | String | | Required. Name of the S3 bucket. | | `bucket` | `cache-to`,`cache-from` | String | | Required. Name of the S3 bucket. |
| `name` | `cache-to`,`cache-from` | String | | Name of the cache image. | | `name` | `cache-to`,`cache-from` | String | | Name of the cache image. |
| `endpoint_url` | `cache-to`,`cache-from` | String | | Endpoint of the S3 bucket. | | `endpoint_url` | `cache-to`,`cache-from` | String | | Endpoint of the S3 bucket. |
| `blobs_prefix` | `cache-to`,`cache-from` | String | | Prefix to prepend to blob filenames. | | `blobs_prefix` | `cache-to`,`cache-from` | String | | Prefix to prepend to blob filenames. |
| `manifests_prefix` | `cache-to`,`cache-from` | String | | Prefix to prepend on manifest filenames. | | `upload_parallelism` | `cache-to` | Integer | `4` | Number of parallel layer uploads. |
| `use_path_style` | `cache-to`,`cache-from` | Boolean | `false` | When `true`, uses `bucket` in the URL instead of hostname. | | `touch_refresh` | `cache-to` | Time | `24h` | Interval for updating the timestamp of unchanged cache layers. |
| `access_key_id` | `cache-to`,`cache-from` | String | | See [authentication][1]. | | `manifests_prefix` | `cache-to`,`cache-from` | String | | Prefix to prepend on manifest filenames. |
| `secret_access_key` | `cache-to`,`cache-from` | String | | See [authentication][1]. | | `use_path_style` | `cache-to`,`cache-from` | Boolean | `false` | When `true`, uses `bucket` in the URL instead of hostname. |
| `session_token` | `cache-to`,`cache-from` | String | | See [authentication][1]. | | `access_key_id` | `cache-to`,`cache-from` | String | | See [authentication][1]. |
| `mode` | `cache-to` | `min`,`max` | `min` | Cache layers to export, see [cache mode][2]. | | `secret_access_key` | `cache-to`,`cache-from` | String | | See [authentication][1]. |
| `ignore-error` | `cache-to` | Boolean | `false` | Ignore errors caused by failed cache exports. | | `session_token` | `cache-to`,`cache-from` | String | | See [authentication][1]. |
| `mode` | `cache-to` | `min`,`max` | `min` | Cache layers to export, see [cache mode][2]. |
| `ignore-error` | `cache-to` | Boolean | `false` | Ignore errors caused by failed cache exports. |
[1]: #authentication [1]: #authentication
[2]: _index.md#cache-mode [2]: _index.md#cache-mode