3. Dockerfile이란? Spring Boot 이미지 만들기

 

📚 Docker & Kubernetes 시리즈

이전 글에서는 Docker Image와 Container의 차이를 정리했다.

이번에는 Docker Image를 실제로 만드는 방법을 알아본다.

Docker에서는 Dockerfile이라는 파일을 이용해 이미지를 생성한다. Dockerfile은 이미지 생성 과정을 코드로 작성한 설정 파일이라고 생각하면 이해하기 쉽다.

 

 

---

Dockerfile이란?

Dockerfile은 Docker Image를 생성하기 위한 설정 파일이다.

이미지를 만들기 위해 필요한 작업을 순서대로 작성하며, Docker는 이 파일을 읽어 하나의 이미지를 생성한다.

 

Dockerfile에서는 다음과 같은 내용을 정의할 수 있다.

• 어떤 기반 이미지를 사용할 것인지
• 프로젝트 파일을 어디에 복사할 것인지
• 컨테이너가 시작될 때 어떤 명령을 실행할 것인지

 

즉, Dockerfile은 이미지를 만드는 과정을 자동화한 스크립트라고 볼 수 있다.

 

 

---

Spring Boot 프로젝트 준비

예제로 사용할 프로젝트 구조는 다음과 같다.

my-app
├── src
├── build
│   └── libs
│       └── my-app.jar
├── Dockerfile
├── build.gradle
└── ...

 

Spring Boot 애플리케이션은 소스 코드를 직접 실행하는 것이 아니라 빌드된 Jar 파일을 실행한다.

따라서 Docker Image를 만들기 전에 먼저 Gradle 또는 Maven을 이용해 Jar 파일을 생성해야 한다.

Gradle을 사용하는 경우 다음 명령으로 Jar 파일을 생성할 수 있다.

./gradlew bootJar

 

 

빌드가 완료되면 다음과 같이 Jar 파일이 생성된다.

build/libs/my-app.jar

 

 

이제 Docker는 이 Jar 파일을 이용해 이미지를 생성한다.

 

 

---

Dockerfile 작성하기

다음과 같은 Dockerfile을 작성해 보자.

FROM eclipse-temurin:21-jre

WORKDIR /app

COPY build/libs/*.jar app.jar

ENTRYPOINT ["java", "-jar", "app.jar"]

 

이제 각 명령어를 하나씩 살펴보자.

 

 

---

FROM

FROM eclipse-temurin:21-jre

 

FROM은 이미지를 생성할 때 사용할 기반 이미지(Base Image) 를 지정하는 명령어이다.

여기서는 Java 21 Runtime(JRE)이 포함된 이미지를 사용한다.

Spring Boot 애플리케이션은 실행만 하면 되므로 일반적으로 JDK보다 JRE 이미지를 사용하여 이미지 크기를 줄인다.

 

 

---

WORKDIR

WORKDIR /app

 

WORKDIR은 컨테이너 내부에서 작업할 디렉터리를 지정한다.

이후 실행되는 명령은 모두 /app 디렉터리를 기준으로 수행된다.

 

 

---

COPY

COPY build/libs/*.jar app.jar

 

COPY는 호스트에 있는 파일을 Docker Image 내부로 복사하는 명령어이다.

위 명령은 빌드한 Jar 파일을 컨테이너 내부의 /app/app.jar로 복사한다.

내 PC

build/libs/my-app.jar
        │
        ▼
Docker Image

/app/app.jar

 

이렇게 복사된 Jar 파일이 이미지에 포함되고, 이후 생성되는 모든 컨테이너는 이 Jar 파일을 실행하게 된다.

 

 

---

ENTRYPOINT

ENTRYPOINT ["java", "-jar", "app.jar"]

 

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

 

예를 들어 다음 명령으로 컨테이너를 실행하면

docker run my-app

 

 

컨테이너 내부에서는 다음 명령이 실행된다.

java -jar app.jar

 

즉, Spring Boot 애플리케이션이 실행되는 것이다.

 

 

---

Docker Image 생성하기

Dockerfile을 작성했다면 다음 명령으로 이미지를 생성한다.

docker build -t my-app .

 

각 옵션의 의미는 다음과 같다.

• -t : 생성할 이미지 이름(Tag) 지정
• my-app : 이미지 이름
• . : 현재 디렉터리의 Dockerfile 사용

 

빌드가 완료되면 다음 명령으로 이미지를 확인할 수 있다.

docker images

 

 

예시

REPOSITORY   TAG       IMAGE ID       SIZE
my-app       latest    a1b2c3d4       250MB

 

---

컨테이너 실행하기

생성한 이미지를 이용해 컨테이너를 실행해 보자.

docker run -p 8080:8080 my-app

 

-p 옵션은 호스트와 컨테이너의 포트를 연결한다.

예를 들어 Spring Boot가 컨테이너 내부에서 8080 포트를 사용한다면 다음과 같이 연결된다.

내 PC (8080)
        │
        ▼
Container (8080)

 

이제 브라우저에서 http://localhost:8080으로 접속하면 애플리케이션을 확인할 수 있다.

 

 

---

Docker의 동작 과정

지금까지의 과정을 하나의 흐름으로 정리하면 다음과 같다.

Spring Boot 프로젝트

        │
        ▼

Gradle Build

        │
        ▼

JAR 생성

        │
        ▼

Dockerfile

        │
        ▼

docker build

        │
        ▼

Docker Image 생성

        │
        ▼

docker run

        │
        ▼

Container 실행

 

여기서 중요한 점은 Dockerfile은 이미지를 생성할 때(docker build)만 사용된다는 것이다.

이미지가 생성된 이후에는 Dockerfile을 다시 읽지 않으며, 컨테이너는 생성된 이미지를 기반으로 실행된다.

 

 

---

자주 사용하는 Dockerfile 명령어

명령어	설명
FROM	기반 이미지 지정
WORKDIR	작업 디렉터리 지정
COPY	파일 복사
ENTRYPOINT	컨테이너 시작 시 실행할 명령

입문 단계에서는 위 네 가지 명령어만 이해해도 대부분의 Dockerfile을 읽고 작성할 수 있다.

 

 

---

정리

Dockerfile은 Docker Image를 만들기 위한 설정 파일이다.

Spring Boot 프로젝트에서는 일반적으로 다음과 같은 순서로 동작한다.

Spring Boot 프로젝트
        │
        ▼
Gradle Build
        │
        ▼
JAR 생성
        │
        ▼
Docker Build
        │
        ▼
Docker Image 생성
        │
        ▼
Docker Run
        │
        ▼
Container 실행

 

즉,

• Spring Boot 프로젝트를 빌드하여 Jar 파일을 생성한다.
• Dockerfile을 이용해 Docker Image를 생성한다.
• 생성된 이미지를 실행하면 Container가 만들어진다.

 

Docker를 사용하면 개발 환경과 운영 환경에서 동일한 실행 환경을 손쉽게 구성할 수 있다.

 

 

---

다음 글

여기까지 보면 한 가지 궁금한 점이 생길 수 있다.

 

"소스를 수정하면 실행 중인 컨테이너에도 자동으로 반영될까?"

 

 

정답은 아니다.

실행 중인 컨테이너는 이미 생성된 Docker Image를 기반으로 동작하기 때문이다.

다음 글에서는 소스를 수정하면 Docker는 어떻게 동작하는지, 그리고 왜 docker build를 다시 실행해야 하는지 알아보겠다.