[Docker] Dockerfile 작성하기: 단계별 가이드

Dockerfile을 작성하고, 이를 통해 Docker 이미지를 빌드 및 배포하는 과정을 자세히 알아보겠습니다.

Docker는 애플리케이션을 컨테이너화하여 일관된 환경에서 실행할 수 있게 해주는 강력한 도구입니다.

 

Dockerfile은 이러한 컨테이너를 자동으로 생성하기 위한 설정 파일로, 효율적이고 일관된 이미지를 만들기 위해 필수적입니다. 이 글에서는 Dockerfile의 기본 개념부터 실제 예제까지 단계별로 상세히 설명드릴 테니, 따라오시면 쉽게 이해하실 수 있을 거예요!

---

Dockerfile이란?

Dockerfile은 Docker 이미지를 자동으로 빌드하기 위한 명령어들이 모여 있는 텍스트 파일입니다.

Dockerfile reference

애플리케이션을 실행하기 위한 환경을 코드로 정의할 수 있으며, 반복 가능하고 일관된 이미지 생성을 가능하게 합니다.

Dockerfile을 작성하면 동일한 환경을 손쉽게 재현할 수 있어 개발, 테스트, 배포 과정에서 큰 이점을 제공합니다.

Dockerfile의 주요 역할

• 베이스 이미지 지정: 애플리케이션이 동작할 기본 환경 설정
• 애플리케이션 코드 복사: 소스 코드를 이미지 안으로 복사
• 의존성 설치 및 빌드: 필요한 패키지 설치 및 애플리케이션 빌드
• 환경 변수 설정: 애플리케이션 실행에 필요한 환경 변수 정의
• 실행 명령어 설정: 컨테이너가 시작될 때 실행할 명령어 지정

---

Dockerfile 작성하기

이제 실제로 Dockerfile을 작성해보겠습니다. 예제로 Next.js 애플리케이션을 Docker 컨테이너로 패키징하는 과정을 살펴보겠습니다.

1. 베이스 이미지 선택

Docker 이미지는 여러 개의 레이어(Layer)로 구성됩니다.

각 레이어는 이전 레이어 위에 쌓이며, 변경된 부분만 업데이트됩니다. 따라서 베이스 이미지를 신중하게 선택하는 것이 중요합니다.

# Node.js 베이스 이미지 지정
FROM node:20.15.1

• FROM: 베이스 이미지를 지정하는 명령어입니다. 여기서는 Node.js 버전 20.15.1을 사용합니다.
• node:20.15.1: Node.js 공식 이미지를 사용하며, 특정 버전을 명시하여 일관된 환경을 보장합니다.

---

2. 소스 코드 복사

애플리케이션의 소스 코드를 이미지 안으로 복사합니다.

# 현재 디렉토리의 모든 파일을 /app 디렉토리로 복사
COPY . /app

• COPY: 호스트 시스템의 파일을 이미지 안으로 복사합니다. 첫 번째 인자는 복사할 소스 경로, 두 번째 인자는 복사할 목적지 경로입니다.
• .: 현재 디렉토리를 의미하며, Dockerfile이 위치한 디렉토리의 모든 파일을 복사합니다.
• /app: 이미지 내부의 /app 디렉토리에 파일을 복사합니다.

---

3. 작업 디렉토리 설정

복사한 소스 코드가 위치한 디렉토리로 작업 디렉토리를 변경합니다.

# 작업 디렉토리 설정
WORKDIR /app

• WORKDIR: 이후의 모든 명령어들이 실행될 디렉토리를 설정합니다. 여기서는 /app으로 설정하여 복사한 소스 코드가 있는 디렉토리로 이동합니다.

---

4. 의존성 설치 및 빌드

애플리케이션 실행에 필요한 의존성을 설치하고 빌드합니다.

# 의존성 설치 및 빌드
RUN npm ci && npm run build

• RUN: 이미지 안에서 명령어를 실행합니다.
  • npm ci: package-lock.json을 기반으로 정확한 의존성을 설치합니다. npm install보다 더 빠르고 일관된 설치를 보장합니다.
  • npm run build: 애플리케이션을 빌드합니다. Next.js 프로젝트의 경우, 정적 파일 생성 및 최적화를 수행합니다.

---

5. 환경 변수 설정

애플리케이션 실행에 필요한 환경 변수를 정의합니다.

# 환경 변수 정의
ENV PORT=3000

• ENV: 환경 변수를 설정합니다. 여기서는 애플리케이션이 사용할 포트를 3000으로 설정합니다.
• 여러 개의 환경 변수를 한 번에 설정할 수도 있습니다:

ENV PORT=3000 \
    NODE_ENV=production

---

6. 애플리케이션 실행 명령어 설정

컨테이너가 시작될 때 실행할 명령어를 지정합니다.

# 애플리케이션 실행
ENTRYPOINT ["npm", "run", "start"]

• ENTRYPOINT: 컨테이너가 시작될 때 실행할 명령어를 설정합니다. 여기서는 npm run start 명령어를 실행하여 애플리케이션을 시작합니다.
• CMD와의 차이점:
  • ENTRYPOINT는 컨테이너가 실행될 때 항상 실행되는 명령어를 설정하며, CMD는 기본 인자를 제공하는 데 사용됩니다. ENTRYPOINT는 더 강력한 명령어 실행 설정을 제공합니다.

---

최종 Dockerfile

위의 모든 단계를 종합하면, 다음과 같은 Dockerfile이 완성됩니다.

# Node 설치 (베이스 이미지)
FROM node:20.15.1

# 소스코드 복사
COPY . /app

# 작업 디렉토리 설정
WORKDIR /app

# 의존성 설치 및 빌드
RUN npm ci && npm run build

# 환경 변수 정의
ENV PORT=3000

# 애플리케이션 실행
ENTRYPOINT ["npm", "run", "start"]

 

---

.dockerignore 설정

Docker 이미지를 빌드할 때, 불필요한 파일이 포함되지 않도록 .dockerignore 파일을 작성하는 것이 좋습니다.
이를 통해 이미지의 크기를 줄이고 보안을 강화할 수 있습니다.

.dockerignore 예제

node_modules
dist
*.log

• node_modules: 호스트 환경의 의존성 파일들이 포함된 디렉토리를 제외합니다. 컨테이너 내부에서 의존성을 다시 설치하도록 하여 일관성을 유지합니다.
• dist: 빌드된 파일들을 제외합니다. 필요 시 Dockerfile 내에서 빌드를 수행하므로, 별도로 포함할 필요가 없습니다.
• *.log: 로그 파일들을 제외하여 이미지 크기를 줄입니다.

---

Dockerfile을 작성하고 이미지를 빌드 및 배포하는 과정은 처음에는 복잡하게 느껴질 수 있지만, 한 번 익숙해지면 매우 강력한 도구가 됩니다. 이번 글에서는 Dockerfile의 기본 구조와 작성 방법을 단계별로 살펴보았습니다.