Dockerfile

Dockerfile이란

Dockerfile은 애플리케이션을 컨테이너 이미지로 빌드하기 위해 필요한 명령어를 정의하는 파일입니다.

 

---

스프링 부트에 최적화된 Dockerfile 예제

# 1. JDK 기반 이미지 설정
FROM openjdk:17-jdk-slim

# 2. 작업 디렉터리 설정
WORKDIR /app

# 3. JAR 파일을 컨테이너에 복사
COPY build/libs/myapp-0.0.1-SNAPSHOT.jar app.jar

# 4. 환경 변수 설정
ENV SPRING_PROFILES_ACTIVE=prod

# 5. 컨테이너에서 사용하는 포트 명시
EXPOSE 8080

# 6. 애플리케이션 실행
ENTRYPOINT ["java", "-jar", "app.jar"]

 

---

Dockerfile의 주요 구성 요소

Dockerfile은 특정 명령어와 옵션들로 구성됩니다. 아래는 주요 명령어와 사용 방법입니다.

 

1. FROM

• 이미지를 기반으로 설정합니다.
• 컨테이너는 항상 특정 이미지에서 시작되므로 FROM은 필수로 작성됩니다.

FROM openjdk:17-jdk-slim

---

2. WORKDIR

• 작업 디렉터리를 설정합니다.
• 이후 명령은 이 디렉터리를 기준으로 실행됩니다.

# /app 디렉터리를 작업 디렉터리로 설정합니다.
WORKDIR /app

---

3. COPY

• Host 내에 있는 파일 또는 디렉토리를 컨테이너로 파일을 복사합니다.

COPY build/libs/myapp-0.0.1-SNAPSHOT.jar app.jar

---

4. ADD

• COPY와 비슷하지만, 추가 기능으로 압축 파일을 자동으로 풀거나 URL에서 파일을 가져올 수 있습니다.

# config.zip 파일을 /app/config/에 복사하고 압축을 풉니다.
# 일반적인 파일 복사에는 COPY를 사용하는 것이 더 권장됩니다.
ADD https://example.com/config.zip /app/config/

---

5. RUN

• 컨테이너 빌드 시 실행할 명령어를 정의합니다.
• 주로 패키지 설치, 설정 파일 수정 등에 사용됩니다.

# 패키지 업데이트 및 curl 설치를 실행합니다.
RUN apt-get update && apt-get install -y curl

---

6. CMD

• 컨테이너가 시작될 때 실행될 명령어를 지정합니다.
• Dockerfile에서 한 번만 사용 가능하며, 명령어는 배열 형식으로 작성합니다.

# 컨테이너가 시작되면 java -jar app.jar 명령을 실행합니다.
CMD ["java", "-jar", "app.jar"]

---

7. ENTRYPOINT

• CMD와 비슷하지만, 고정된 실행 파일을 설정합니다.
• CMD와 함께 사용하여 실행 파일 뒤에 기본 인수를 추가할 수 있습니다.

# ENTRYPOINT는 고정된 실행 파일(java -jar)을 설정하고, CMD는 추가 인수(app.jar)를 전달합니다.
ENTRYPOINT ["java", "-jar"]
CMD ["app.jar"]

---

8. ENV

• 컨테이너에서 사용될 환경 변수를 설정합니다.
• 여러 환경 변수 설정 시 사용됩니다.

# 애플리케이션의 프로파일을 prod로 설정합니다.
ENV SPRING_PROFILES_ACTIVE=prod

---

9. EXPOSE

• 컨테이너에서 사용할 포트를 명시합니다.
• 실제로 포트를 열지는 않으며, 정보 제공 용도로 사용됩니다.

# 컨테이너가 8080번 포트를 사용함을 나타냅니다.
# 주의: 실제 포트 바인딩은 docker run -p 옵션으로 수행됩니다.
EXPOSE 8080

---

10. VOLUME

• 컨테이너와 호스트 간 데이터 공유를 위한 볼륨을 정의합니다.
• 로그 데이터나 영구 데이터 저장 시 유용합니다.

# /data 디렉터리에 데이터를 저장하거나 호스트 디렉터리와 공유합니다.
VOLUME ["/data"]

---

11. ARG

• Docker 빌드 시 사용할 매개변수를 정의합니다.

# 빌드 시 특정 변수를 전달할 때 사용됩니다.
ARG VERSION=1.0
RUN echo "Version: $VERSION"

---

12. LABEL

• 이미지에 메타데이터를 추가합니다.
• 이미지 작성자 정보를 기록하거나 특정 태그를 추가할 때 유용합니다.

LABEL maintainer="your_email@example.com"

---

13. HEALTHCHECK

• 컨테이너의 상태를 확인하기 위한 헬스체크 명령어를 설정합니다.

# 컨테이너 내에서 스프링 부트의 /actuator/health 엔드포인트를 호출하여 상태를 점검합니다.
HEALTHCHECK --interval=30s --timeout=10s \
  CMD curl -f http://localhost:8080/actuator/health || exit 1

 

---

빌드 및 실행 명령어

1. 이미지 빌드

docker build -t my-spring-app . # .은 현재 폴더

 

2. 컨테이너 실행

docker run -p <호스트 포트>:<컨테이너 포트> my-spring-app

1. 호스트 포트

• 호스트 머신의 포트 번호를 의미합니다.
• 호스트에서 외부에서 접근 가능한 포트를 지정합니다.
• 예를 들어, 브라우저에서 http://localhost:8080으로 접근할 때 사용하는 포트입니다.

2. 컨테이너 포트

• 컨테이너 내부에서 애플리케이션이 사용하는 포트 번호를 의미합니다.
• Docker 컨테이너 내부에서 실행 중인 애플리케이션이 바인딩된 포트를 지정합니다.
• 예를 들어, 스프링 부트 애플리케이션이 server.port=8080 설정으로 실행 중이라면, 컨테이너 내부의 8080번 포트가 해당 애플리케이션과 연결됩니다.