Docker Image를 여러 번 Build하는 환경에서는 Build Cache 관리가 성능에 큰 영향을 줍니다.

기본 Cache 기능만 사용하면 간단한 프로젝트에서는 문제가 없지만, 대규모 프로젝트나 CI/CD 환경에서는 더 세밀한 Cache 전략이 필요합니다.

예:

여러 개발자가 동시에 Build
GitHub Actions Runner 사용
Kubernetes 배포 환경
Multi-platform Image 생성
대규모 Dockerfile Build

일반적인 Build:

코드 변경

↓

Docker Build 실행

↓

Cache 확인

↓

변경 Layer Build

하지만 CI 환경에서는:

새로운 Runner 생성

↓

기존 Cache 없음

↓

전체 Build 실행

↓

시간 증가

이 문제가 발생합니다.

Docker Buildx Bake에서는 Cache 설정을 조합하여 Build 속도를 크게 향상시킬 수 있습니다.

예:

docker-bake.hcl

target "production" {

  cache-from = [

    "type=registry,ref=registry.company.com/app:cache"

  ]

  cache-to = [

    "type=registry,ref=registry.company.com/app:cache,mode=max"

  ]

}

실행:

docker buildx bake production --push

결과:

기존 Cache 가져오기

↓

변경 Layer만 Build

↓

새 Cache 저장

이번 글에서는 Docker Buildx Bake Cache 고급 설정부터 Registry Cache, CI/CD 최적화, Multi-platform Cache, 실무 운영 전략까지 자세히 알아보겠습니다.

Table of Contents

Docker Buildx Bake Cache 고급 설정이란?

Docker Build Cache는 Build 과정에서 생성되는 중간 결과물을 저장하는 기능입니다.

기본 Cache:

Dockerfile

↓

Layer 생성

↓

Cache 저장

↓

재사용

고급 Cache:

Registry Cache

+

CI Cache

+

Local Cache

↓

최적화된 Build

여러 Cache 저장소를 조합하여 빠른 Build 환경을 만들 수 있습니다.

Docker Buildx Bake Cache를 사용하는 이유

대규모 프로젝트에서는 Build 시간이 문제가 됩니다.

예:

Docker Build

10분 소요

↓

하루 50회 Build

↓

많은 시간 소비

Cache 최적화:

기존 Layer 재사용

↓

Build 시간 감소

↓

CI 비용 절감

장점:

Build 속도 향상
Runner 비용 감소
개발 생산성 증가
배포 속도 개선

Docker Buildx Bake Registry Cache 설정

가장 많이 사용하는 방식은 Registry Cache입니다.

예:

target "app" {

  cache-from = [

    "type=registry,ref=registry.company.com/app:cache"

  ]

  cache-to = [

    "type=registry,ref=registry.company.com/app:cache,mode=max"

  ]

}

구조:

Registry

↓

Cache Image

↓

다음 Build 사용

장점:

여러 서버 공유 가능
CI 환경 적합
안정적인 Cache 유지

Docker Buildx Bake Cache Mode 활용

Cache 저장 방식은 mode 옵션으로 조절합니다.

mode=min

cache-to = [

"type=registry,ref=app:cache,mode=min"

]

특징:

작은 Cache 크기
저장 공간 절약
기본적인 재사용

사용 환경:

저장 공간 제한 환경

mode=max

cache-to = [

"type=registry,ref=app:cache,mode=max"

]

특징:

모든 Build Layer 저장
높은 Cache 재사용률
빠른 재Build

사용 환경:

CI/CD
Production Build

비교:

설정	특징
mode=min	용량 절약
mode=max	속도 최적화

Docker Buildx Bake 여러 Cache 소스 사용하기

여러 Cache를 동시에 사용할 수 있습니다.

예:

target "app" {

  cache-from = [

    "type=registry,ref=company/app:cache",

    "type=local,src=./cache"

  ]

}

동작:

Registry Cache 확인

↓

Local Cache 확인

↓

사용 가능한 Cache 적용

더 높은 Cache 적중률을 얻을 수 있습니다.

Docker Buildx Bake GitHub Actions Cache 활용

GitHub Actions에서는 GHA Cache를 사용할 수 있습니다.

예:

target "production" {

  cache-from = [

    "type=gha"

  ]

  cache-to = [

    "type=gha,mode=max"

  ]

}

흐름:

GitHub Runner 실행

↓

Cache 다운로드

↓

Build 실행

↓

Cache 저장

CI 환경에서 매우 효과적입니다.

Docker Buildx Bake Multi-platform Cache 최적화

Multi-platform Build는 일반 Build보다 시간이 오래 걸립니다.

예:

target "app" {

  platforms = [

    "linux/amd64",

    "linux/arm64"

  ]

  cache-from = [

    "type=registry,ref=company/app:cache"

  ]

}

결과:

Cache

├── amd64 Layer

└── arm64 Layer

각 플랫폼 Build 시간을 줄일 수 있습니다.

Docker Buildx Bake Cache와 Dockerfile 최적화

Cache 효과를 높이려면 Dockerfile 구조도 중요합니다.

좋은 예:

FROM node:20

COPY package.json .

RUN npm install

COPY .

RUN npm build

변경 빈도가 낮은 작업을 먼저 실행합니다.

나쁜 예:

FROM node:20

COPY .

RUN npm install

코드 변경마다 Package 설치 Layer가 다시 실행됩니다.

Docker Buildx Bake Cache CI/CD 실무 설정

docker-bake.hcl:

target "production" {

  tags = [

    "registry.company.com/app:v1"

  ]

  cache-from = [

    "type=registry,ref=registry.company.com/app:cache"

  ]

  cache-to = [

    "type=registry,ref=registry.company.com/app:cache,mode=max"

  ]

  output = [

    "type=image,push=true"

  ]

}

실행:

docker buildx bake production

결과:

Cache 가져오기

↓

빠른 Build

↓

Image Push

↓

Cache 업데이트

Docker Buildx Bake Cache 실무 운영 전략

운영 환경에서는 Cache 정책이 필요합니다.

Docker Buildx Bake Cache 문제 해결

Cache가 적용되지 않는 경우

확인:

docker buildx du

Cache 사용량을 확인합니다.

확인 사항:

Cache 위치
Registry 권한
Dockerfile Layer 구조

Cache가 너무 커지는 경우

정리:

docker buildx prune

오래된 Cache를 제거합니다.

Build 결과가 예상과 다른 경우

Cache 제거 후 테스트:

docker buildx bake app --no-cache

Docker Buildx Bake Cache 사용 시 주의사항

첫 번째는 Cache와 Image 저장 위치를 분리하는 것이 좋습니다.

두 번째는 Production에서는 mode=max 활용을 권장합니다.

세 번째는 오래된 Cache 관리 정책이 필요합니다.

네 번째는 Secret 정보가 Cache에 포함되지 않는지 확인해야 합니다.

Best Practice

Docker Buildx Bake Cache 최적화 방법:

Registry Cache 사용
cache-from/cache-to 조합
mode=max 활용
CI Cache 연결
Dockerfile Layer 최적화
정기 Cache 정리

자주 묻는 질문

Docker Buildx Bake Cache는 왜 필요한가요?

반복 Build 시간을 줄이고 Docker Image 생성 속도를 향상시키기 위해 사용합니다.

가장 추천하는 Cache 방식은 무엇인가요?

CI/CD 환경에서는 Registry Cache 또는 GitHub Actions Cache 방식이 많이 사용됩니다.

Cache가 많으면 무조건 좋은가요?

아닙니다.

불필요한 Cache는 저장 공간을 차지하기 때문에 관리가 필요합니다.

Dockerfile도 Cache 성능에 영향을 주나요?

영향을 줍니다.

Layer 순서와 명령 위치에 따라 Cache 재사용률이 달라집니다.

마무리

Docker Buildx Bake Cache 고급 설정은 빠르고 안정적인 Docker Build 환경을 만드는 핵심 기술입니다.

Registry Cache, CI Cache, Multi-platform Cache를 적절히 조합하면 반복적인 Image Build 시간을 크게 줄일 수 있습니다.

특히 CI/CD Pipeline과 대규모 Container 환경에서는 Cache 전략을 설계하는 것이 Build 성능과 운영 비용을 결정하는 중요한 요소입니다.

Docker Buildx Bake Cache 고급 활용법 완벽 가이드! 빌드 속도 최적화하기