[Docker] 이미지 Build

🔍 Docker Build 란?

Docker Build 는 서비스를 격리된 환경에서 실행할 수 있도록 운영체제 및 필요한 의존성과 설정, 실행 파일등을 하나의 이미지로 패키징하는 것을 의미합니다.

이미지 Build 는 Dockerfile 을 기반으로 수행되며, Dockerfile 에는 이미지 생성에 필요한 명령어들이 있으며, 순서대로 실행됩니다.

✅ Build 명령어

# 현재 디렉토리 위치에 Dockerfile 가 있고 현재 위치에서 이미지를 생성할 경우
docker build -t <만들 이미지 이름>:<만들 이미지 태그> .
# Dockerfile 이 다른 경로에 있을 경우
docker build -t <만들 이미지 이름>:<만들 이미지 태그> -f <파일 경로> <빌드 컨텍스트 경로>
# Dockerfile 명이 다를 경우우
docker build -t <만들 이미지 이름>:<만들 이미지 태그> -f <파일 경로/파일 이름> <빌드 컨텍스트 경로>

✅ 이미지지 레이어

Docker 는 Build 시 Dockerfile 의 베이스가 되는 이미지부터 시작해 각 명령어를 실행할 때마다 새로운 이미지를 생성합니다. 이것을 이미지 레이어를 생성한다고 이야기 합니다.

때문에 초기 명령어들이 같고 중간 단계 부터 달라지는 Dockerfile 의 경우 빌드시 각각 이미지 레이어를 생성하는게 아닌 기존에 만들어진 이미지 레이어를 바탕으로 새로운 이미지를 생성해 빌드시간과 저장공간을 절약할 수 있습니다.

✅ Dockerfile

node:18 이라는 베이스 이미지를 시작으로 각 명령어를 실행할때마다 이미지를 생성합니다.

FROM node:18                 # Node.js 기반 이미지 사용
WORKDIR /app                 # 앱 디렉토리 생성
COPY package*.json ./        # package.json 복사 
RUN npm install              # 의존성 설치
COPY . .                     # 앱 소스 복사
EXPOSE 3000                  # 포트 개방
CMD ["npm", "start"]         # 앱 실행

아래 Dockerfile 은 5라인까지는 위 Dockerfile 과 같은 명령어들이 사용되고 있습니다. 빌드시 위에서 5라인에 생성된 이미지 레이어를 기반으로 새로운 이미지를 생성하게 됩니다.

FROM node:18                 # Node.js 기반 이미지 사용
WORKDIR /app                 # 앱 디렉토리 생성
COPY package*.json ./        # package.json 복사 
RUN npm install              # 의존성 설치
COPY . .                     # 앱 소스 복사
EXPOSE 5000                  # 포트 개방
CMD ["npm", "run", "dev"]    # 앱 실행

✅ 멀티 스테이지 빌드

빌드와 실행 환경을 분리하고 싶을 때 사용됩니다

# Build stage
FROM node:18 as builder
WORKDIR /app
COPY . .
RUN npm install && npm run build

# Production stage
FROM nginx:alpine
COPY --from=builder /app/dist /usr/share/nginx/html