Amazon S3 快取

限制級

這是一項實驗性功能。介面和行為不穩定，可能會在未來的版本中變更。

s3 快取儲存會將您產生的建構快取上傳到 Amazon S3 檔案儲存服務。

概要

$ 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 儲存貯體的名稱。
`名稱`	`cache-to`、`cache-from`	字串		快取映像檔的名稱。
`端點 URL`	`cache-to`、`cache-from`	字串		S3 儲存貯體的端點。
`Blob 前綴`	`cache-to`、`cache-from`	字串		要加在 Blob 檔案名前面的前綴。
`上傳平行處理`	`cache-to`	整數	`4`	平行層上傳的數量。
`觸控更新`	`cache-to`	時間	`24 小時`	更新未變更快取層時間戳記的間隔。
`資訊清單前綴`	`cache-to`、`cache-from`	字串		要加在資訊清單檔案名前面的前綴。
`使用路徑樣式`	`cache-to`、`cache-from`	布林值	`false`	當 `true` 時，在 URL 中使用 `bucket`，而不是主機名稱。
`存取金鑰 ID`	`cache-to`、`cache-from`	字串		請參閱驗證。
`秘密存取金鑰`	`cache-to`、`cache-from`	字串		請參閱驗證。
`工作階段權杖`	`cache-to`、`cache-from`	字串		請參閱驗證。
`模式`	`cache-to`	`min`、`max`	`min`	要匯出的快取層，請參閱快取模式。
`忽略錯誤`	`cache-to`	布林值	`false`	忽略快取匯出失敗引起的錯誤。

驗證

Buildx 可以重複使用現有的 AWS 憑證（使用憑證檔案或環境變數設定），以便將快取推送和提取到 S3。或者，您可以使用 access_key_id、secret_access_key 和 session_token 屬性直接在 CLI 上指定憑證。

請參閱 AWS Go SDK，指定憑證

如需快取的簡介，請參閱 Docker 建構快取。

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