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 step

15초 사례는 “새 코드도 15초에 빌드 가능”하다는 뜻이 아니라, 같은 입력의 전체 결과를 캐시에서 재사용할 수 있다는 예입니다.

먼저 해볼 개선: Next.js 컴파일 캐시 보존

  1. Next 빌드의 캐시 디렉터리인 .next/cache를 코드 변경 사이에 재사용하도록 BuildKit cache mount를 검토합니다.
  2. 현재 workflow는 Buildx를 실행마다 새 이름의 builder로 설정하고 registry 캐시를 사용합니다. Cache mount만 추가하면 다음 실행에도 유지된다고 가정할 수 없으므로, self-hosted runner에서 builder 상태를 지속시키는 구성을 함께 검증해야 합니다.
  3. 코드만 바꾼 연속 빌드에서 Next build step 시간과 캐시 hit를 기록해 개선 전·후를 비교합니다. 절감 시간은 실제 측정 전에는 확정하지 않습니다.

의존성 설치를 다시 최적화하는 것보다 이 방향이 질문의 상황(의존성은 그대로, 코드만 변경)에 직접 맞습니다.

그 다음 후보: 이미지 자체를 가볍게

측정 근거와 코드 위치

이 문서는 빌드 시간의 이해와 개선 후보를 설명합니다. workflow/Containerfile 변경은 아직 적용하지 않았으며, 개선 효과도 미측정입니다. 모든 시간은 해당 run의 로그 관측치이지 장기 평균이 아닙니다.