本機快取

local 快取存放區是一個簡單的快取選項，它使用 OCI 映像檔佈局

$ docker buildx build --push -t <registry>/<image> \
  --cache-to type=local,dest=path/to/local/dir[,parameters...] \
  --cache-from type=local,src=path/to/local/dir .

下表描述您可以傳遞至 --cache-to 和 --cache-from 的可用 CSV 參數。

名稱	選項	類型	預設值	說明
`src`	`cache-from`	字串		匯入快取的本機目錄路徑。
`digest`	`cache-from`	字串		要匯入的資訊清單的摘要，請參閱快取版本控制。
`dest`	`cache-to`	字串		匯出快取的本機目錄路徑。
`mode`	`cache-to`	`min`、`max`	`min`	要匯出的快取層，請參閱快取模式。
`oci-mediatypes`	`cache-to`	`true`、`false`	`true`	在匯出的資訊清單中使用 OCI 媒體類型，請參閱 OCI 媒體類型。
`image-manifest`	`cache-to`	`true`、`false`	`false`	使用 OCI 媒體類型時，為快取映像檔產生映像檔資訊清單，而不是映像檔索引，請參閱 OCI 媒體類型。
`compression`	`cache-to`	`gzip`、`estargz`、`zstd`	`gzip`	壓縮類型，請參閱快取壓縮。
`compression-level`	`cache-to`	`0..22`		壓縮等級，請參閱快取壓縮。
`force-compression`	`cache-to`	`true`、`false`	`false`	強制套用壓縮，請參閱快取壓縮。
`ignore-error`	`cache-to`	布林值	`false`	忽略快取匯出失敗所造成的錯誤。

如果 src 快取不存在，則快取匯入步驟將會失敗，但建置會繼續進行。

快取版本控制

本節說明版本控制如何在本機檔案系統上的快取中運作，以及如何使用 digest 參數來使用舊版本的快取。

如果您手動檢查快取目錄，您可以看到產生的 OCI 映像檔佈局

$ ls cache
blobs  index.json  ingest
$ cat cache/index.json | jq
{
  "schemaVersion": 2,
  "manifests": [
    {
      "mediaType": "application/vnd.oci.image.index.v1+json",
      "digest": "sha256:6982c70595cb91769f61cd1e064cf5f41d5357387bab6b18c0164c5f98c1f707",
      "size": 1560,
      "annotations": {
        "org.opencontainers.image.ref.name": "latest"
      }
    }
  ]
}

與其他快取類型一樣，本機快取在匯出時會被取代，方法是取代 index.json 檔案的內容。但是，先前的快取仍可在 blobs 目錄中使用。這些舊的快取可透過摘要定址，並無限期保留。因此，本機快取的大小將會持續增長（請參閱 moby/buildkit#1896

$ docker buildx build --push -t <registry>/<image> \
  --cache-to type=local,dest=path/to/local/dir \
  --cache-from type=local,ref=path/to/local/dir,digest=sha256:6982c70595cb91769f61cd1e064cf5f41d5357387bab6b18c0164c5f98c1f707 .

本機快取

快取版本控制

進一步閱讀