GitHub Actions에서 Docker 빌드 캐시 미작동 문제 해결: build-push-action 활용법

카카오웹툰은 Amazon ECR 배포 과정에서 GitHub Actions를 사용했으나, 변경 사항이 없어도 빌드 시간이 단축되지 않는 문제를 겪었다. 이는 GitHub Actions의 러너가 매번 새로운 가상 환경에서 실행되어 기존 Docker 레이어 캐시를 재사용하지 못하기 때문이다.

문제 원인: 클린 환경과 캐시 부재

로컬에서는 동일한 코드로 재빌드 시 Docker 캐시가 작동해 빌드 시간이 53초에서 1.2초로 단축되지만, GitHub Actions에서는 매번 npm install 등 모든 단계가 다시 실행된다. GitHub이 제공하는 기본 캐싱 기능은 Docker 레이어까지 커버하지 못해 CI 파이프라인의 비효율이 발생했다.

해결책: docker/build-push-action 활용

도커 공식 액션인 docker/build-push-action과 BuildKit을 활용하면 GitHub Actions의 캐시 API를 직접 사용할 수 있다. 워크플로우에 cache-from: type=gha와 cache-to: type=gha, mode=max를 설정하면 빌드 결과가 GitHub 저장소에 캐시되어 다음 실행 시 재사용된다.

효과 및 주의사항

적용 결과, 동일한 코드로 재배포 시 빌드 시간이 약 1분 단축되었다. 특히 시간이 많이 소요되는 RUN npm install 단계가 캐시되면서 성능이 개선되었다. 다만 type=gha 방식은 아직 실험 단계이므로, 반복 작업이 많은 대규모 프로젝트에서 효과적으로 활용할 수 있다.