멀티 스테이지 빌드로 이미지 경량화하기

불필요하게 큰 이미지는 푸시하고 가져오고 시작하는 데 오래 걸리며, 수정해야 할 항목도 많습니다. 다단계 빌드는 실제로 필요한 항목만 제공합니다.

한 단계에서 빌드하고, 깨끗한 두 번째 단계에서 실행합니다. 빌드 도구는 남겨 두므로 최종 이미지가 작게 유지됩니다.

FROM 줄에 AS builder를 추가해 단계에 이름을 붙입니다. 나중에 이 이름을 참조해 해당 단계에서 파일을 가져올 수 있습니다.

빌더에서 알려진 경로에 종속 항목을 설치합니다. --user 옵션을 사용하면 모든 항목이 복사하기 쉬운 하나의 폴더 아래에 정리됩니다.

실제로 실행되는 항목을 위한 새롭고 작은 단계를 엽니다. 이 단계에는 빌더에 필요했던 컴파일러나 캐시가 없습니다.

COPY --from=builder를 사용해 설치된 패키지만 실행 단계로 가져옵니다. 용량이 큰 빌드 계층은 남겨 둡니다.

애플리케이션 소스도 작은 단계에 복사합니다. 이제 최종 이미지에는 코드와 실행에 필요한 종속 항목만 들어 있습니다.

사용자 설치 패키지는 .local 아래에 있으므로 이를 PATH에 추가합니다. 그렇지 않으면 실행 단계에서 설치된 명령을 찾을 수 없습니다.

Docker는 이미지에 최종 단계만 보관합니다. 앞선 단계의 모든 항목은 명시적으로 복사하지 않는 한 버려집니다.

가장 작고 안전한 결과를 원한다면 셸이나 패키지 관리자가 없는 distroless 기본 이미지를 사용하십시오. 노출 영역이 작을수록 악용할 대상도 줄어듭니다.

docker images로 크기가 얼마나 줄었는지 확인합니다. 1GB가 넘는 이미지가 수백 MB로 줄어드는 일은 흔하며 그만한 가치가 있습니다.

빌드와 실행을 분리하고, COPY --from으로 결과물만 복사하고, PATH를 수정해 이미지 크기를 줄였습니다. 가볍고 빠릅니다. ✅