Docker Buildx Bake는 Build 속도를 높이기 위해 Cache 기능을 적극적으로 활용합니다.

Cache는 이전에 생성한 Build Layer를 재사용하여 빠르게 Image를 생성할 수 있도록 도와줍니다.

예:

기존 Build

↓

Layer Cache 저장

↓

다음 Build

↓

변경 없는 Layer 재사용

하지만 특정 상황에서는 Cache를 사용하지 않고 완전히 새로운 Build가 필요할 수 있습니다.

예:

• 최신 Package 다시 설치
• Cache 오류 해결
• Clean Build 테스트
• Production 배포 전 검증
• Dependency 업데이트 확인

일반적인 Build:

Dockerfile

↓

기존 Cache 확인

↓

재사용 가능한 Layer 사용

↓

Build 완료

No-Cache Build:

Dockerfile

↓

Cache 무시

↓

모든 Layer 새롭게 실행

↓

새로운 Image 생성

Docker Buildx Bake에서는 --no-cache 옵션을 사용하여 Cache 없이 Build할 수 있습니다.

예:

docker buildx bake production --no-cache

결과:

기존 Cache 무시

↓

Dockerfile 전체 실행

↓

새로운 Image Build

이번 글에서는 Docker Buildx Bake No-Cache의 개념부터 사용 방법, Cache 문제 해결, CI/CD 활용, 실무 운영 전략까지 자세히 알아보겠습니다.

Docker Buildx Bake No-Cache란 무엇인가?

Docker Buildx Bake No-Cache는 기존 Build Cache를 사용하지 않고 새로운 Image를 생성하는 방식입니다.

기본 Build:

Build 시작

↓

Cache 확인

↓

사용 가능한 Layer 재사용

↓

Build 완료

No-Cache Build:

Build 시작

↓

Cache 확인하지 않음

↓

모든 명령 다시 실행

↓

새 Image 생성

즉, 이전 Build 결과를 완전히 무시하고 처음부터 Build하는 기능입니다.

Docker Buildx Bake No-Cache가 필요한 이유

Cache는 대부분의 경우 유용하지만 문제가 발생할 수 있습니다.

예:

npm Package 변경

↓

기존 Cache 사용

↓

변경 내용 미반영

또는:

Base Image 업데이트

↓

오래된 Layer 사용

↓

최신 환경 미적용

No-Cache 사용:

Cache 제거

↓

모든 단계 재실행

↓

최신 상태 Build

장점:

• Cache 오류 해결
• 최신 Dependency 반영
• 깨끗한 Build 환경 생성
• 문제 원인 확인

Docker Buildx Bake No-Cache 기본 사용법

전체 Build:

docker buildx bake --no-cache

특정 Target:

docker buildx bake production --no-cache

동작:

Target 선택

↓

Cache 비활성화

↓

전체 Layer Build

Docker Buildx Bake No-Cache와 일반 Build 비교

Cache 사용:

FROM ubuntu

↓

Cache 사용

↓

RUN 명령 생략

↓

빠른 Build

No-Cache:

FROM ubuntu

↓

Image 확인

↓

RUN 실행

↓

COPY 실행

↓

전체 Build

비교:

방식	특징
Cache Build	빠른 Build
No-Cache Build	새롭게 검증 가능

Docker Buildx Bake No-Cache Dockerfile 예제

Dockerfile:

FROM node:20

WORKDIR /app

COPY package.json .

RUN npm install

COPY . .

RUN npm build

일반 Build:

docker buildx bake app

Cache 적용:

npm install Layer 재사용

No-Cache:

docker buildx bake app --no-cache

결과:

npm install 다시 실행

↓

npm build 다시 실행

Docker Buildx Bake No-Cache와 Pull 함께 사용하기

최신 Base Image까지 확인하려면 함께 사용할 수 있습니다.

명령어:

docker buildx bake production \
--pull \
--no-cache

동작:

최신 Base Image 확인

↓

Cache 제거

↓

완전히 새로운 Build

사용 환경:

• 보안 업데이트
• Release Build
• 문제 분석

Docker Buildx Bake No-Cache CI/CD 활용

CI/CD에서는 특정 상황에서 No-Cache Build가 필요합니다.

예:

Release 생성

↓

Clean Build 실행

↓

Production Image 생성

GitHub Actions:

- name: Clean Build

  run: |

    docker buildx bake production --no-cache --push

활용:

• Release Pipeline
• 보안 Build
• 테스트 환경 검증

Docker Buildx Bake No-Cache Cache 오류 해결

Cache 문제 예:

코드 변경

↓

Build 실행

↓

이전 결과 사용

↓

문제 발생

해결:

docker buildx bake app --no-cache

결과:

기존 Layer 무시

↓

새로운 Layer 생성

Docker Buildx Bake No-Cache와 Cache 삭제 차이

두 기능은 비슷해 보이지만 차이가 있습니다.

No-Cache:

현재 Build에서만 Cache 사용 안 함

Cache 삭제:

docker buildx prune

결과:

저장된 Cache 자체 제거

비교:

기능	영향
–no-cache	현재 Build만 적용
prune	Cache 데이터 삭제

Docker Buildx Bake No-Cache 실무 예제

프로젝트:

project/

├── Dockerfile

├── docker-bake.hcl

└── app/

docker-bake.hcl:

target "production" {

  tags = [

    "registry.company.com/app:v2"

  ]

}

일반 Build:

docker buildx bake production

Clean Build:

docker buildx bake production --no-cache

Release Build:

docker buildx bake production \
--pull \
--no-cache \
--push

결과:

최신 Base Image

↓

새로운 Layer Build

↓

Registry Push

Docker Buildx Bake No-Cache 확인 방법

Build 로그 확인:

docker buildx bake app --no-cache

확인:

CACHED 표시 없음

↓

모든 단계 실행

Cache 사용 확인:

docker buildx du

현재 Cache 상태를 확인합니다.

Docker Buildx Bake No-Cache 문제 해결

Build 시간이 너무 오래 걸리는 경우

원인:

모든 Layer 재생성

해결:

• 일반 Build 사용
• 필요한 경우만 No-Cache 사용

최신 코드가 반영되지 않는 경우

사용:

docker buildx bake app --no-cache

새롭게 Build합니다.

Cache 오류가 계속 발생하는 경우

정리:

docker buildx prune

Cache를 제거합니다.

Docker Buildx Bake No-Cache 사용 시 주의사항

첫 번째는 매번 No-Cache Build를 사용하는 것은 권장하지 않습니다.

두 번째는 Build 시간이 크게 증가할 수 있습니다.

세 번째는 Release 또는 문제 해결 목적에 사용하는 것이 좋습니다.

네 번째는 Cache와 No-Cache 사용 기준을 정하는 것이 좋습니다.

Best Practice

Docker Buildx Bake No-Cache 활용 방법:

• 오류 분석 시 사용
• Release Build 활용
• 최신 Dependency 확인
• 보안 업데이트 적용
• Clean Build 테스트
• 필요한 경우만 실행

자주 묻는 질문

Docker Buildx Bake No-Cache는 무엇인가요?

기존 Build Cache를 사용하지 않고 새롭게 Build하는 기능입니다.

항상 No-Cache를 사용해야 하나요?

아닙니다.

일반 개발 Build에서는 Cache 사용이 효율적입니다.

Cache 삭제와 같은 기능인가요?

아닙니다.

No-Cache는 현재 Build에서만 Cache를 무시합니다.

Production에서도 사용할 수 있나요?

가능합니다.

Release Image 생성이나 보안 검증 Build에서 활용합니다.

마무리

Docker Buildx Bake No-Cache는 Cache 문제를 해결하고 완전히 새로운 Docker Image를 생성해야 할 때 사용하는 중요한 기능입니다.

평소에는 Cache를 활용하여 빠른 Build 환경을 유지하고, Release Build나 오류 분석 상황에서는 No-Cache 옵션을 활용하는 방식이 가장 효율적입니다.

특히 Production 환경에서는 --pull과 --no-cache를 함께 사용하면 최신 Base Image 기반의 깨끗한 Build를 수행할 수 있습니다.