개요
컨테이너 빌드가 느린 원인은 거의 언제나 레이어 순서 문제입니다. 의존성을 설치하기 전에 전체 소스 트리를 COPY하면 커밋할 때마다 의존성 레이어가 무효화되며, 빌드 하드웨어를 아무리 빠르게 바꿔도 이 문제는 해결되지 않습니다.
과제
CI 파이프라인은 서비스당 20분을 넘길 만큼 길어졌고, 개발자들은 대기 시간을 피하려고 변경 사항을 몰아서 반영하고 있었습니다. Dockerfile은 의존성을 설치하기 전에 저장소 전체를 복사했고, .dockerignore가 없어 빌드 컨텍스트에 git 이력과 node_modules까지 포함되었습니다. 단일 스테이지 빌드여서 컴파일러와 빌드 도구가 런타임 이미지에 그대로 들어갔고, 아무것도 고정하지 않아 빌드 재현성도 없었습니다.
환경
CI에서 빌드되어 Kubernetes에 배포되고, 여러 리전에서 이미지를 가져오는 수십 개의 컨테이너화된 서비스.
접근 방식
AceMQ는 캐시 안정성을 중심으로 Dockerfile을 재구성했습니다. 의존성 매니페스트를 소스보다 먼저 복사해 설치하고, 멀티 스테이지 빌드로 빌드 도구와 런타임을 분리했습니다. 또한 레지스트리 기반 공유 빌드 캐시를 활성화해 CI 에이전트가 매번 처음부터 시작하지 않고 서로의 작업 결과를 활용하도록 했습니다.
해결책
- 의존성 설치가 소스 복사보다 먼저 이루어져 일반적인 커밋에도 캐시가 유지되도록 레이어 순서 재배치
- .dockerignore 파일을 추가해 빌드 컨텍스트 크기를 대폭 축소
- 단일 스테이지 빌드를 멀티 스테이지로 전환해 컴파일러와 빌드 도구를 런타임 이미지에서 제외
- CI 에이전트가 캐시를 공유하도록 레지스트리 기반 BuildKit 캐시 내보내기 및 가져오기 활성화
- 재현 가능한 빌드를 위해 베이스 이미지를 다이제스트로 고정하고 의존성 버전 고정
- CI에서 검사하는 서비스별 이미지 크기 예산 수립
성과
일반적인 서비스의 파이프라인 시간이 대략 절반으로 줄었고, 빌드 도구를 제거한 뒤 런타임 이미지 크기도 크게 줄었습니다. 그 결과 이미지 풀 시간과 스캐너가 보고하는 취약점 노출 범위도 함께 감소했습니다.