Amazon S3 快取

可用性：實驗性

s3 快取儲存將生成的構建快取上傳到 Amazon S3 檔案儲存服務或其他 S3 相容服務，如 MinIO。

預設的 docker 驅動程式不支援此快取儲存後端。要使用此功能，請使用不同的驅動程式建立新的構建器。有關更多資訊，請參閱構建驅動程式。

概要

$ docker buildx build --push -t <user>/<image> \
  --cache-to type=s3,region=<region>,bucket=<bucket>,name=<cache-image>[,parameters...] \
  --cache-from type=s3,region=<region>,bucket=<bucket>,name=<cache-image> .

下表描述了您可以傳遞給 --cache-to 和 --cache-from 的可用 CSV 引數。

名稱	選項	型別	預設值	描述
`地區`	`cache-to`,`cache-from`	字串		必需。地理位置。
`桶`	`cache-to`,`cache-from`	字串		必需。S3 桶的名稱。
`name`	`cache-to`,`cache-from`	字串		快取映象的名稱。
`endpoint_url`	`cache-to`,`cache-from`	字串		S3 桶的端點。
`blobs_prefix`	`cache-to`,`cache-from`	字串		要新增到 blob 檔名字首。
`upload_parallelism`	`cache-to`	整數	`4`	並行層上傳的數量。
`touch_refresh`	`cache-to`	時間	`24 小時`	更新未更改快取層時間戳的間隔。
`manifests_prefix`	`cache-to`,`cache-from`	字串		要新增到清單檔名字首。
`use_path_style`	`cache-to`,`cache-from`	布林值	`false`	當為 `true` 時，在 URL 中使用 `bucket` 而不是主機名。
`access_key_id`	`cache-to`,`cache-from`	字串		請參閱身份驗證。
`secret_access_key`	`cache-to`,`cache-from`	字串		請參閱身份驗證。
`session_token`	`cache-to`,`cache-from`	字串		請參閱身份驗證。
`mode`	`cache-to`	`min`,`max`	`min`	要匯出的快取層，請參閱快取模式。
`ignore-error`	`cache-to`	布林值	`false`	忽略因快取匯出失敗導致的錯誤。

身份驗證

Buildx 可以重用現有的 AWS 憑據（透過憑據檔案或環境變數配置），用於向 S3 推送和拉取快取。或者，您可以使用 access_key_id、secret_access_key 和 session_token 屬性直接在 CLI 上指定憑據。

有關使用環境變數和憑據檔案進行身份驗證的詳細資訊，請參閱 AWS Go SDK，指定憑據。

進一步閱讀

有關快取的介紹，請參閱 Docker 構建快取。

有關 s3 快取後端的更多資訊，請參閱 BuildKit README。