Spring Boot + Docker + Kubernetes 배포 구조

Java/Spring 개발자가 알아야 할 클라우드 네이티브 배포 방식

최근 많은 Java/Spring 기반 시스템이 컨테이너 기반 배포 환경으로 전환하고 있습니다.
특히 Spring Boot + Docker + Kubernetes 조합은 클라우드 환경에서 가장 많이 사용되는 배포 구조입니다.

이 글에서는 Java Spring 개발자 관점에서 애플리케이션이 어떻게 배포되는지 전체 구조를 정리해 보겠습니다.

---

1. 전통적인 Java 배포 방식

과거 Java 웹 애플리케이션은 보통 다음과 같은 방식으로 배포되었습니다.

 

개발
↓
빌드 (WAR 생성)
↓
서버 접속
↓
Tomcat 배포
↓
서버 재시작

 

구조

 

Server
└ Tomcat
└ application.war

 

이 방식은 다음과 같은 문제가 있습니다.

• 서버 환경 의존성
• 수동 배포
• 스케일링 어려움
• 서버 관리 비용 증가

---

2. Spring Boot 기반 배포 구조

Spring Boot는 Embedded Server 구조를 가지고 있습니다.

즉 애플리케이션 내부에 서버(Tomcat)가 포함됩니다.

구조

 

Spring Boot Application
+ Embedded Tomcat
↓
Fat Jar

 

실행 방식

 

java -jar app.jar

 

이 구조는 컨테이너 환경과 매우 잘 맞습니다.

---

3. Docker를 이용한 애플리케이션 컨테이너화

Spring Boot 애플리케이션을 Docker 이미지로 만들면 다음과 같은 구조가 됩니다.

 

Spring Boot App
↓
Docker Image
↓
Container 실행

 

예시 Dockerfile

 

FROM openjdk:17-jdk-slim

WORKDIR /app

COPY build/libs/app.jar app.jar

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

 

빌드

 

docker build -t spring-app .

 

실행

 

docker run -p 8080:8080 spring-app

 

이렇게 하면 Spring Boot 애플리케이션이 컨테이너에서 실행됩니다.

---

4. Kubernetes에서의 배포 구조

Docker 컨테이너를 Kubernetes에 배포하면 다음과 같은 구조가 됩니다.

 

Kubernetes Cluster
↓
Deployment
↓
Pod
↓
Container
↓
Spring Boot App

 

구조 그림

 

Client
↓
Service
↓
Pod
└ Container
└ Spring Boot Application

 

Pod는 Kubernetes에서 애플리케이션 실행 단위입니다.

---

5. Kubernetes 배포 예시

Spring Boot 애플리케이션을 Kubernetes에 배포하려면 Deployment를 생성합니다.

예시

 

apiVersion: apps/v1
kind: Deployment
metadata:
name: spring-app
spec:
replicas: 3
selector:
matchLabels:
app: spring-app
template:
metadata:
labels:
app: spring-app
spec:
containers:
- name: spring-app
image: spring-app:latest
ports:
- containerPort: 8080

 

이 설정은 다음 의미를 가집니다.

• 애플리케이션 Pod 3개 실행
• 컨테이너 이미지 실행
• 포트 8080 사용

---

6. Service를 통한 트래픽 연결

Kubernetes에서는 Service를 통해 Pod에 접근합니다.

구조

 

Client
↓
Service
↓
Pod1
Pod2
Pod3

 

예시

 

apiVersion: v1
kind: Service
metadata:
name: spring-service
spec:
selector:
app: spring-app
ports:
- port: 80
targetPort: 8080
type: ClusterIP

 

Service는 로드밸런싱 역할을 합니다.

---

7. 전체 배포 아키텍처

Spring Boot + Docker + Kubernetes 구조는 다음과 같습니다.

 

Developer
↓
Git Repository
↓
CI/CD Pipeline
↓
Docker Image Build
↓
Container Registry
↓
Kubernetes Deployment
↓
Pod 실행
↓
Service 통해 접근

 

이 구조는 클라우드 네이티브 애플리케이션 아키텍처의 기본 형태입니다.

---

8. Kubernetes 환경에서의 장점

Spring Boot 애플리케이션을 Kubernetes에서 운영하면 다음과 같은 장점이 있습니다.

자동 스케일링

트래픽이 증가하면 Pod 수를 자동으로 늘릴 수 있습니다.

 

Traffic 증가
↓
Pod 자동 증가

 

---

장애 복구(Self-Healing)

애플리케이션이 죽으면 Kubernetes가 자동으로 재시작합니다.

 

Pod Crash
↓
자동 재시작

 

 

---

무중단 배포

Rolling Update를 통해 서비스 중단 없이 배포할 수 있습니다.

 

Old Pod
↓
New Pod 생성
↓
Old Pod 종료

 

---

결론

Spring Boot + Docker + Kubernetes 조합은 현대적인 Java 애플리케이션 배포 구조입니다.

이 구조를 사용하면

• 배포 자동화
• 운영 안정성
• 확장성

을 확보할 수 있습니다.

Java/Spring 개발자가 Kubernetes 환경을 이해하면 단순한 애플리케이션 개발을 넘어 클라우드 네이티브 시스템 설계 능력까지 확장할 수 있습니다.