[Infra/Docker] Docker Multi-stage Build로 이미지 용량 대폭 줄이기

Об этом предложении

도커(Docker)로 애플리케이션을 빌드하고 배포할 때 가장 흔하게 겪는 골칫거리 중 하나는 천정부지로 치솟는 도커 이미지 용량 입니다. 예를 들어 Go나 Java, Node.js 같은 언어로 애플리케이션을 만들 때, 소스코드를 컴파일하고 빌드하는 데 필요한 무거운 도구들(GCC, Maven, Node 빌드 패키지 등)을 이미지에 그대로 담으면 최종 이미지 용량이 수 GB를 훌쩍 넘어가기 일쑤입니다. 보안상 취약점도 늘어나고 레지스트리에 푸시/풀할 때 네트워크 자원도 낭비됩니다. 이 문제를 해결해 주는 핵심 기술이 바로 Multi-stage Build입니다. 1. 전통적인 방식의 문제점 (Sigle-stage Build) 기존에는 애플리케이션을 빌드하기 위해 하나의 거대한 Dockerfile 을 작성했습니다. FROM golang:1.22 WORKDIR /app COPY . . # 빌드 도구가 포함된 무거운 환경에서 컴파일 진행 RUN go build -o myapp . CMD ["./myapp"] 이 방식의 치명적인 단점은 빌드에만 필요하고 실행할 때는 필요 없는 수백 MB의 Go 컴파일러와 소스코드들이 최종 이미지 안에 고스란히 남아있게 된다 는 점입니다. 오직 실행 파일( myapp ) 하나만 있으면 되는데도 말입니다. 2. Multi-stage Build란? (개념과 구조) 멀티 스테이지 빌드는 하나의 Dockerfile 안에 여러 개의 FROM 문 을 사용하여 빌드 단계(Stage)를 명확하게 분리하는 기법입니다. 첫 번째 스테이지 (Builder) : 빌드 도구가 가득 잔뜩 들어있는 무거운 환경에서 소스코드를 컴파일하여 실행 파일을 만듭니다. 두 번째 스테이지 (Final/Runtime) : 오직 실행에 필요한 최소한의 런타임 환경(예 : 가벼운 Apline Linux 등)만 구성하고, 첫 번째 스테이지에서 만들어진 결과물( --from=builder )만 쏙 뽑아옵니다. 결과적으로 빌드 도구들은 최종 이미지에 포함되지에 포함되지 않으므로 이미지 용량이 수 GB에서 수십 MB 수준으로 획기적으로 줄어듭니다. 3. 실전 예시 코드 (Dockerfile 작성법) 실제로 Go 언어 애플리케이션을 멀티 스테이지 빌드로 작성한 Dockerfile 예시입니다. # --- [1단계: 빌드 스테이지] --- # 빌드에 필요한 모든 무거운 도구가 있는 이미지를 사용하고 'builder'라는 별칭을 붙입니다. FROM golang:1.22 AS builder WORKDIR /app COPY . . # 실행 파일(myapp)로 컴파일 RUN CGO_ENABLED=0 GOOS=linux go build -o myapp . # --- [2단계: 최종 런타임 스테이지] --- # 보안이 뛰어나고 용량이 매우 작은 알파인(Alpine) 리눅스를 베이스로 사용합니다. FROM alpine:latest WORKDIR /root/ # 핵심: 이전 스테이지(builder)에서 생성된 바이너리 파일만 복사해 옵니다! COPY --from=builder /app/myapp . EXPOSE 8080 CMD ["./myapp"] 4. 멀티 스테이지 빌드의 장점 획기적인 용량 절감 : 수 GB에 달하던 이미지를 10~50MB 내외로 다이어트할 수 있습니다. 보안성 향상 : 프로덕션 서버(운영 환경)에 컴파일러나 소스코드가 존재하지 않으므로 해커에게 탈취당할 공격 표면(Attack Surface)이 대폭 줄어듭니다. Dockerfile 관리 편의성 : 빌드용 Dockerfile과 배포용 Dockerfile을 따로 관리할 필요 없이, 파일 하나로 깔끔하게 통합 관리할 수 있습니다. 🎯 마무리 멀티 스테이지 빌드는 도커를 활용한 CI/CD 파이프라인 구축 시 선택이 아닌 필수 인 모범 사례(Best Practice)입니다. 빌드 도구와 런타임 환경을 분리하는 이 간단한 전략 하나만으로도 인프라 비용과 배포 시간을 크게 아낄 수 있습니다.

Детали предложения

Провайдер

velog

Источник

velog-rss

Балл

54.4

Уверенность

49%