로컬 캐시

로컬 캐시 (Local cache)

local 캐시 스토어는 캐시를 파일시스템의 디렉터리에 파일로 저장하는 간단한 캐시 옵션이에요. 기본 디렉터리 구조에는 OCI 이미지 레이아웃을 사용해요. 그냥 테스트하거나, 공유 스토리지 솔루션을 스스로 관리하는 유연성을 원할 때 local 캐시가 좋은 선택이에요.

출처: 문서

본문

시놉시스 (Synopsis)

$ 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 .

지정한 디렉터리에 캐시가 없으면 캐시 import 단계는 실패하지만 빌드는 계속 진행돼요.

캐시 버전 관리 (Cache versioning)

캐시 디렉터리는 매니페스트와 캐시 데이터를 저장해요. 같은 디렉터리에 여러 캐시를 유지하려면 다른 태그를 사용해요:

$ docker buildx build --cache-to type=local,dest=path/to/local/dir,tag=v1 .
$ docker buildx build --cache-to type=local,dest=path/to/local/dir,tag=v2 .

같은 태그로 다른 캐시를 내보내면 그 태그가 새 매니페스트를 가리키도록 업데이트돼요. 다른 태그가 참조하는 매니페스트는 변경되지 않아요.

태그를 지정해 캐시를 가져와요:

$ docker buildx build --cache-from type=local,src=path/to/local/dir,tag=v1 .

특정 매니페스트가 필요할 때는 digest로 지정할 수도 있어요:

$ docker buildx build \
  --cache-from type=local,src=path/to/local/dir,digest=sha256:<DIGEST> .

이렇게 하면 원하는 특정 캐시 스냅샷을 정확히 가져올 수 있어요.

더 알아보기 (Learn more)