Dockerfile 빌드 속도를 높이는 방법? 10가지 실용적인 최적화 팁

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# ❌ 잘못된 예: 코드 수정 시마다 의존성을 다시 설치
FROM node:18-alpine
WORKDIR /app
COPY . .                          # 코드는 자주 변경됨
RUN npm ci --production           # 의존성은 거의 변경되지 않음
CMD ["node", "server.js"]

# ✅ 올바른 예: 의존성 변경 시에만 다시 설치
FROM node:18-alpine
WORKDIR /app
COPY package.json package-lock.json ./  # 의존성 정의 (거의 변경되지 않음)
RUN npm ci --production                  # 의존성 설치 (거의 변경되지 않음)
COPY . .                                 # 코드 (자주 변경됨)
CMD ["node", "server.js"]

1
2

# 캐시 적중 여부 확인
docker build -t myapp . 2>&1 | grep -E "(CACHED|Using cache)"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

# .dockerignore
.git
.github
.vscode
.idea
node_modules
dist
build
*.md
*.log
.env
.env.local
.DS_Store
coverage
.nyc_output

1
2
3
4

# 컨텍스트 크기 확인
docker build --no-cache -t test . 2>&1 | grep "Sending build context"
# 최적화 전: Sending build context to Docker daemon  1.2GB
# 최적화 후: Sending build context to Docker daemon  50MB

1
2
3
4
5
6
7
8

# ❌ 너무 큼
FROM python:3.11          # 1GB

# ✅ 추천
FROM python:3.11-slim     # 130MB

# ✅ 최소 크기 (musl 호환성 문제 주의)
FROM python:3.11-alpine   # 50MB

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# ❌ 5개 레이어
RUN apt-get update
RUN apt-get install -y curl
RUN apt-get install -y wget
RUN apt-get clean
RUN rm -rf /var/lib/apt/lists/*

# ✅ 1개 레이어
RUN apt-get update && \
    apt-get install -y --no-install-recommends \
        curl \
        wget && \
    apt-get clean && \
    rm -rf /var/lib/apt/lists/*

1
2

# 이미지 레이어 수 확인
docker history myapp:latest

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

# 스테이지 1: 빌드
FROM golang:1.21-alpine AS builder
WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 GOOS=linux go build -o app .

# 스테이지 2: 실행 (~15MB)
FROM alpine:3.18
RUN apk --no-cache add ca-certificates
WORKDIR /root/
COPY --from=builder /app/app .
EXPOSE 8080
CMD ["./app"]

1
2
3
4
5
6
7

# BuildKit 활성화
export DOCKER_BUILDKIT=1

# 또는 /etc/docker/daemon.json에 영구 설정
# {
#   "features": { "buildkit": true }
# }

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# 캐시 마운트 사용 (BuildKit 기능)
# syntax=docker/dockerfile:1
FROM node:18-alpine
WORKDIR /app
COPY package.json package-lock.json ./
# 캐시 마운트로 매번 의존성을 다시 다운로드하지 않음
RUN --mount=type=cache,target=/root/.npm \
    npm ci --production
COPY . .
CMD ["node", "server.js"]

1
2

# BuildKit 활성화 여부 확인
docker build --progress=plain -t myapp . 2>&1 | head -5

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 로컬로 내보내기
docker build \
  --cache-from type=local,src=/tmp/cache \
  --cache-to type=local,dest=/tmp/cache \
  -t myapp .

# 레지스트리를 캐시로 사용
docker build \
  --cache-from type=registry,ref=myregistry/myapp:cache \
  --cache-to type=registry,ref=myregistry/myapp:cache,mode=max \
  -t myapp .

1
2
3
4
5
6
7
8
9

# GitHub Actions 예제
- name: Build and push
  uses: docker/build-push-action@v5
  with:
    context: .
    push: true
    tags: myapp:latest
    cache-from: type=gha
    cache-to: type=gha,mode=max

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# Node.js - npm ci가 npm install보다 빠름
RUN npm ci --production

# Python - 캐시 비활성화
RUN pip install --no-cache-dir -r requirements.txt

# Go - 모듈 병렬 다운로드
RUN go mod download

# Rust - cargo-chef 사용
COPY --from=chef /app/recipe.json recipe.json
RUN cargo chef cook --release --recipe-path recipe.json

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# ✅ 올바른 예: 동일 레이어에서 정리
RUN apt-get update && \
    apt-get install -y --no-install-recommends build-essential && \
    make && make install && \
    apt-get purge -y --auto-remove build-essential && \
    apt-get clean && \
    rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*

# ❌ 잘못된 예: 정리가 다른 레이어에서 수행되어 파일이 여전히 존재함
RUN apt-get update && apt-get install -y build-essential
RUN make && make install
RUN apt-get clean  # 너무 늦었습니다! 이��� 레이어에 파일이 이미 포함됨

1
2
3
4
5
6
7
8

# Node.js
RUN npm ci --production && npm cache clean --force

# Python
RUN pip install --no-cache-dir -r requirements.txt

# Go
RUN go build -o app . && go clean -cache

1
2
3
4
5
6
7
8

# ❌ latest는 변경될 수 있어 캐시를 예측할 수 없음
FROM node:latest

# ✅ 특정 버전
FROM node:18.17.0-alpine3.18

# ✅ 더 안전: SHA256 다이제스트 사용
FROM node:18.17.0-alpine3.18@sha256:abc123...

1
2

# 이미지 레이어 히스토리 확인
docker history <image-name>

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 4개 레이어 생성
FROM node:18-alpine        # 레이어 1
RUN apk add --no-cache curl # 레이어 2
COPY package.json .         # 레이어 3
RUN npm install             # 레이어 4

# 이 명령어들은 레이어를 추가하지 않음
WORKDIR /app               # 레이어 없음
ENV NODE_ENV=production    # 레이어 없음
EXPOSE 3000               # 레이어 없음
CMD ["node", "server.js"]  # 레이어 없음

1
2
3
4
5
6
7
8
9

# ❌ 최적화 전 (8분, 1.2GB)
FROM ubuntu:22.04
RUN apt-get update
RUN apt-get install -y python3 python3-pip
RUN apt-get install -y build-essential
WORKDIR /app
COPY . .
RUN pip3 install -r requirements.txt
CMD ["python3", "app.py"]

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# ✅ 최적화 후 (1.5분, 150MB)
# syntax=docker/dockerfile:1
FROM python:3.11-slim AS builder
WORKDIR /app
COPY requirements.txt .
RUN --mount=type=cache,target=/root/.cache/pip \
    pip install --no-cache-dir -r requirements.txt

FROM python:3.11-slim
WORKDIR /app
COPY --from=builder /usr/local/lib/python3.11/site-packages /usr/local/lib/python3.11/site-packages
COPY . .
EXPOSE 8000
CMD ["python", "app.py"]

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 상세 빌드 시간 표시
time docker build -t myapp .

# BuildKit 상세 진행 상황
DOCKER_BUILDKIT=1 docker build --progress=plain -t myapp .

# 이미지 레이어 분석
docker history myapp:latest

# dive 도구로 심층 분석
dive myapp:latest