diff --git a/content/manuals/build/cache/backends/s3.md b/content/manuals/build/cache/backends/s3.md index 0e5f390d4c4..ddf490982bc 100644 --- a/content/manuals/build/cache/backends/s3.md +++ b/content/manuals/build/cache/backends/s3.md @@ -30,20 +30,22 @@ $ docker buildx build --push -t / \ The following table describes the available CSV parameters that you can pass to `--cache-to` and `--cache-from`. -| Name | Option | Type | Default | Description | -| ------------------- | ----------------------- | ----------- | ------- | ---------------------------------------------------------- | -| `region` | `cache-to`,`cache-from` | String | | Required. Geographic location. | -| `bucket` | `cache-to`,`cache-from` | String | | Required. Name of the S3 bucket. | -| `name` | `cache-to`,`cache-from` | String | | Name of the cache image. | -| `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. | -| `manifests_prefix` | `cache-to`,`cache-from` | String | | Prefix to prepend on manifest filenames. | -| `use_path_style` | `cache-to`,`cache-from` | Boolean | `false` | When `true`, uses `bucket` in the URL instead of hostname. | -| `access_key_id` | `cache-to`,`cache-from` | String | | See [authentication][1]. | -| `secret_access_key` | `cache-to`,`cache-from` | String | | See [authentication][1]. | -| `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. | +| Name | Option | Type | Default | Description | +| -------------------- | ----------------------- | ----------- | ------- | -------------------------------------------------------------- | +| `region` | `cache-to`,`cache-from` | String | | Required. Geographic location. | +| `bucket` | `cache-to`,`cache-from` | String | | Required. Name of the S3 bucket. | +| `name` | `cache-to`,`cache-from` | String | | Name of the cache image. | +| `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. | +| `upload_parallelism` | `cache-to` | Integer | `4` | Number of parallel layer uploads. | +| `touch_refresh` | `cache-to` | Time | `24h` | Interval for updating the timestamp of unchanged cache layers. | +| `manifests_prefix` | `cache-to`,`cache-from` | String | | Prefix to prepend on manifest filenames. | +| `use_path_style` | `cache-to`,`cache-from` | Boolean | `false` | When `true`, uses `bucket` in the URL instead of hostname. | +| `access_key_id` | `cache-to`,`cache-from` | String | | See [authentication][1]. | +| `secret_access_key` | `cache-to`,`cache-from` | String | | See [authentication][1]. | +| `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 [2]: _index.md#cache-mode