컨테이너 이미지 레이어로 인한 Docker 빌드 캐시 문제와 해결 가이드 AI 생성 이미지: 컨테이너 이미지 레이어로 인한 Docker 빌드 캐시 문제 문제 정의 — Docker 빌드 캐시가 기대만큼 작동하지 않는 이유 Docker 빌드 캐시는 Dockerfile의 각 명령이 생성하는 레이어와 그 레이어에 들어가는 입력(명령문, 파일 내용, 빌드 컨텍스트 등)을 기준으로 동작합니다. 그러나 레이어 단위의 불연속성 때문에 작은 변경이 이후 단계 전체의 캐시를 무효화할 수 있습니다. 예를 들어 COPY/ADD로 전달된 파일 하나가 바뀌면 뒤따르는 모든 RUN이 재실행됩니다. 또한 apt 업데이트나 빌드 시 생성되는 타임스탬프 같은 비결정적 출력이 있으면 캐시를 재활용하지 못합니다. 이런 현상은 컨테이너 이미지 레이어로 인한 Docker 빌드 캐시 문제의 전형적인 사례입니다. 실무 체크리스트: 캐시에 민감한 파일은 별도의 COPY로 분리하고, 명령 순서를 최적화하며, 비결정적 명령은 가능한 한 제거하거나 의도적으로 관리하세요. 빌드 지연: 캐시 미스가 잦아 전체 빌드 시간이 크게 늘어납니다. 불필요한 이미지 생성·푸시: 동일한 베이스에서 중간 이미지와 최종 이미지가 반복 생성되어 레지스트리에 불필요하게 푸시됩니다. 디스크·네트워크 비용 증가: 로컬에 중간 레이어가 쌓이고 레지스트리 업로드 트래픽이 증가합니다. 큰 빌드 컨텍스트·잘못된 명령 순서: 빌드 컨텍스트가 크거나 레이어 배치가 비효율적이면 캐시 무효화가 잦아집니다. 이미지 레이어와 캐시의 기본 동작 원리 Docker는 Dockerfile의 각 명령(INSTRUCTION)을 실행할 때마다 불변의 레이어를 쌓습니다. 캐시 적중 여부는 이전 레이어의 해시와 해당 명령·컨텍스트를 결합한 캐시 키로 판단합니다. RUN 명령은 실행 문자열, 이전 레이어 상태, 환경 변수와 파일시스템 변경사항을 사실상의 입력으로 삼습니다. COPY나 ADD는 복사되는 파일의 내용 해시(및 경로)...