왜 매 빌드마다 의존성을 다시 받는가
기본적인 Dockerfile은 RUN pip install이나 npm ci 같은 명령이 만든 결과물을 그 레이어의 파일 시스템 스냅샷으로만 남긴다. requirements.txt나 package-lock.json이 한 줄이라도 바뀌면 해당 레이어의 캐시가 무효화되고, 수백 MB에 달하는 패키지를 처음부터 다시 다운로드·컴파일한다. CI 러너처럼 매번 깨끗한 환경에서 도는 경우엔 레이어 캐시조차 없어 항상 풀 다운로드가 발생한다. 빌드 시간의 대부분이 실제 코드 컴파일이 아니라 네트워크와 압축 해제에 쓰인다.
cache mount의 동작 원리
BuildKit의 RUN --mount=type=cache는 특정 디렉터리를 레이어와 분리된 영속 캐시 볼륨에 마운트한다. 이 볼륨은 빌드가 끝나도 최종 이미지에 포함되지 않고, 다음 빌드에서 그대로 재사용된다. 즉 ~/.cache/pip나 node_modules/.cache 같은 패키지 매니저의 캐시 디렉터리를 여기에 연결하면, lock 파일이 바뀌어 레이어가 다시 실행되더라도 이미 받아둔 wheel·tarball은 로컬에서 즉시 꺼내 쓴다.
Python 예시
핵심은 pip이 기본 캐시로 쓰는 경로를 mount 대상으로 지정하고, 재현성을 위해 PIP_CACHE_DIR을 명시하는 것이다.
# syntax=docker/dockerfile:1.7
FROM python:3.12-slim
WORKDIR /app
COPY requirements.txt .
RUN --mount=type=cache,target=/root/.cache/pip \
pip install -r requirements.txt
COPY . .
CMD ["python", "-m", "app"]
# syntax 지시자와 BuildKit 활성화(DOCKER_BUILDKIT=1 또는 최신 docker buildx)가 전제 조건이다. 이제 requirements.txt에 패키지를 추가해도 기존 것들은 캐시에서 바로 설치된다.
Node.js와 시스템 패키지
같은 패턴을 npm과 apt에도 적용할 수 있다. 다만 apt는 기본적으로 캐시를 지우도록 설정돼 있어 docker-clean 설정을 우회해야 한다.
RUN --mount=type=cache,target=/root/.npm \
npm ci
RUN --mount=type=cache,target=/var/cache/apt,sharing=locked \
--mount=type=cache,target=/var/lib/apt,sharing=locked \
rm -f /etc/apt/apt.conf.d/docker-clean && \
apt-get update && apt-get install -y --no-install-recommends build-essential
sharing=locked는 여러 빌드가 동시에 같은 캐시에 쓸 때 apt 락 충돌을 막는다.
레이어 캐시와의 차이
| 구분 | 레이어 캐시 | cache mount |
|---|---|---|
| 무효화 단위 | 레이어 전체 | 없음(내용 기반 재사용) |
| lock 변경 시 | 전부 재실행 | 바뀐 패키지만 다운로드 |
| 최종 이미지 포함 | 포함 | 미포함 |
| CI 공유 | 레지스트리 필요 | 백엔드 캐시 export 필요 |
둘은 대체재가 아니라 보완재다. COPY requirements.txt를 소스 복사보다 앞에 두는 레이어 순서 최적화는 그대로 유지하고, 그 위에 cache mount를 얹는다.
CI에서의 주의점
cache mount 볼륨은 빌드 호스트 로컬에 저장된다. GitHub Actions처럼 매번 새 러너를 쓰면 로컬 볼륨이 사라지므로 효과가 없다. 이때는 buildx의 캐시 export 기능으로 cache mount 내용까지 외부에 저장해야 한다.
docker buildx build \
--cache-to type=gha,mode=max \
--cache-from type=gha \
-t myapp:latest .
mode=max여야 중간 스테이지의 cache mount까지 export된다. 다만 export/import 자체에 시간과 스토리지 비용이 들기 때문에, 캐시 크기가 수 GB로 커지면 오히려 느려질 수 있어 실측이 필요하다.
정리
cache mount는 "의존성 설치 결과"가 아니라 "다운로드한 원본"을 재사용한다. lock 파일이 자주 바뀌는 프로젝트, 네이티브 컴파일이 많은 프로젝트에서 효과가 크다. 로컬 개발과 자체 호스팅 러너에서는 설정만으로 즉시 이득을 보고, 일회성 CI 러너에서는 캐시 백엔드 export를 함께 구성해야 실제 시간이 줄어든다.