PPI · WEB IMAGE BUILD · 2026-11-18
코드만 고쳤는데
왜 Web 빌드가 다시 오래 걸릴까?
마지막 업데이트 2026-11-18
의존성 설치가 자주 일어나는 게 핵심은 아닙니다. 소스 코드가 바뀌면 그 다음 단계인 Next.js 컴파일 결과도 달라져야 해서, 빌드 캐시가 그 지점부터 다시 계산됩니다.
9분 24초2026-11-17 Web 이미지 빌드·push step
2분 34초로그에 기록된 Next.js build step
1분 55초이미지 레이어 export 구간
15초같은 SHA 재실행에서 이미지 build step
Docker 빌드 흐름을 빵 굽기에 비유하면
재료 목록(의존성)이 그대로면 장보기는 건너뛸 수 있지만, 반죽(앱 코드)이 바뀌면 굽기는 다시 해야 합니다.
1 · 재료 목록
package.json / lockfile
버전이 그대로면 설치 결과를 캐시에서 재사용할 수 있습니다.
대체로 캐시 적중2 · 소스 복사
COPY apps/web ./
코드 변경이 이미지 빌드 입력에 반영됩니다.
변경된 부분부터 재계산3 · 컴파일
pnpm run build
Next.js가 새 코드로 페이지와 서버 산출물을 생성합니다.
약 154초 관측4 · 이미지 조립
runtime 파일 복사·권한
빌드 결과를 실행용 컨테이너에 넣고 권한을 맞춥니다.
chown 약 49초5 · 업로드
GHCR에 이미지·캐시 push
새 이미지 레이어와 BuildKit 캐시를 registry로 전송합니다.
전송·export 시간 발생캐시가 있을 때와 없을 때
● 같은 SHA를 다시 빌드
입력과 결과가 같아 이전 이미지 layer를 그대로 사용
15초 · #438535, 이전 실행으로 캐시가 준비된 상태● 새 코드 SHA로 빌드
설치 layer가 남아도 앱 컴파일·결과 이미지 생성은 달라짐
9분 24초 · #440506, 이미지 build·push step15초 사례는 “새 코드도 15초에 빌드 가능”하다는 뜻이 아니라, 같은 입력의 전체 결과를 캐시에서 재사용할 수 있다는 예입니다.
먼저 해볼 개선: Next.js 컴파일 캐시 보존
- Next 빌드의 캐시 디렉터리인
.next/cache를 코드 변경 사이에 재사용하도록 BuildKit cache mount를 검토합니다. - 현재 workflow는 Buildx를 실행마다 새 이름의 builder로 설정하고 registry 캐시를 사용합니다. Cache mount만 추가하면 다음 실행에도 유지된다고 가정할 수 없으므로, self-hosted runner에서 builder 상태를 지속시키는 구성을 함께 검증해야 합니다.
- 코드만 바꾼 연속 빌드에서 Next build step 시간과 캐시 hit를 기록해 개선 전·후를 비교합니다. 절감 시간은 실제 측정 전에는 확정하지 않습니다.
의존성 설치를 다시 최적화하는 것보다 이 방향이 질문의 상황(의존성은 그대로, 코드만 변경)에 직접 맞습니다.
그 다음 후보: 이미지 자체를 가볍게
- 설정에는
output: "standalone"이 있지만, 현재 runner 단계는 두node_modules트리와 전체.next를 복사합니다. standalone 산출물로 필요한 파일만 담을 수 있는지 검증하면 이미지 전송량을 줄일 가능성이 있습니다. RUN chown -R app:nodejs /app은 관측 run에서 약 49초였습니다.COPY --chown등으로 대체할 수 있는지 실행 권한·런타임 동작을 확인하며 검토합니다.- 레이어 export는 약 115초, 캐시 export는 약 98초였지만 일부 시간이 겹칩니다. 캐시 모드를 단순히 낮추면 다음 빌드에서 필요한 중간 캐시를 잃을 수 있으므로, 크기와 cache hit를 함께 측정해야 합니다.
측정 근거와 코드 위치
- 2026-11-17 run #44050628896: Web build·push 564초. BuildKit 로그에서 Next build 154.4초, image layer export 115.4초, cache export 97.7초, runner 단계
chown약 49초. - 2026-11-16 run #43853543664: 같은 SHA 재실행의 build·push step 15초.
apps/web/Containerfile:8-35— 의존성 설치 이후 앱 소스를 복사하고 Next build 실행.apps/web/Containerfile:51-59— runtime 이미지 파일 복사와 recursive chown.apps/web/next.config.mjs:8-12— standalone output 설정..github/workflows/deploy-staging.yml:279-280, 365-370— Buildx 설정 및 registry cache 사용.
이 문서는 빌드 시간의 이해와 개선 후보를 설명합니다. workflow/Containerfile 변경은 아직 적용하지 않았으며, 개선 효과도 미측정입니다. 모든 시간은 해당 run의 로그 관측치이지 장기 평균이 아닙니다.