EC2에서 쿠버네티스로 백엔드(Spring Boot) 서버 띄우기

JSCODE 박재성

2026. 03. 30.

✅ EC2에서 쿠버네티스로 백엔드(Spring Boot) 서버 띄우기

1. 매니페스트 파일 클론 받기
AWS EC2에서 백엔드(Spring Boot) 서버를 띄울 때 오로지 매니페스트 파일만 있으면 된다. Spring Boot에 관련된 프로젝트 파일은 필요 없다. 왜냐하면 매니페스트 파일을 통해 백엔드(Spring Boot)서버를 실행시킬 이미지를 다운받아와서 실행시길 것이기 때문이다.

$ git clone https://github.com/JSCODE-COURSE/kubernetes-manifests.git
$ cd kubernetes-manifests

 

2. Deployment, ConfigMap, Secret 파일 수정하기
이전에 생성한 RDS, ECR 정보에 맞게 Deployment, ConfigMap, Secret 정보를 수정해주어야 한다.
spring-deployment.yaml

apiVersion: apps/v1
kind: Deployment

# Deployment 기본 정보
metadata:
  name: spring-deployment # Deployment 이름

# Deployment 세부 정보
spec:
  replicas: 3 # 생성할 파드의 복제본 개수
  selector:
    matchLabels:
      app: backend-app # 아래에서 정의한 Pod 중 'app: backend-app'이라는 값을 가진 파드를 선택

  # 배포할 Pod 정의
  template:
    metadata:
      labels: # 레이블 (= 카테고리)
        app: backend-app
    spec:
      imagePullSecrets:
        - name: regcred
      containers:
        - name: spring-container # 컨테이너 이름
          # ECR에 저장된 이미지의 주소 및 태그명
          image: 002177417362.dkr.ecr.ap-northeast-2.amazonaws.com/kube-ecr:1.0
          ports:
            - containerPort: 8080  # 컨테이너에서 사용하는 포트를 명시적으로 표현
          env:
            - name: DB_HOST
              valueFrom:
                configMapKeyRef:
                  name: spring-config
                  key: db-host
            - name: DB_PORT
              valueFrom:
                configMapKeyRef:
                  name: spring-config
                  key: db-port
            - name: DB_NAME
              valueFrom:
                configMapKeyRef:
                  name: spring-config
                  key: db-name
            - name: DB_USERNAME
              valueFrom:
                secretKeyRef:
                  name: spring-secret
                  key: db-username
            - name: DB_PASSWORD
              valueFrom:
                secretKeyRef:
                  name: spring-secret
                  key: db-password

• imagePullSecrets : 이미지를 Pull 할 때 해당 Secret 값을 활용해서 Private ECR 레지스트리에 접근한다.
 
spring-config.yaml

apiVersion: v1
kind: ConfigMap

# ConfigMap 기본 정보
metadata:
  name: spring-config # ConfigMap 이름

# Key, Value 형식으로 설정값 저장
data:
  # RDS 엔드포인트 작성하기
  db-host: kube-database.coseefawhrzc.ap-northeast-2.rds.amazonaws.com
  db-port: "3306"
  db-name: mydb

 
spring-secret.yaml

apiVersion: v1
kind: Secret
type: Opaque # 임의의 사용자 정의 데이터를 저장할 때 사용하는 타입

# Secret 기본 정보
metadata:
  name: spring-secret # Secret 이름

# Key, Value 형식으로 값 저장
stringData:
  # RDS 생성 시 기재한 사용자 이름과 마스터 비밀번호 입력하기
  db-username: admin
  db-password: password

 

3. 매니페스트 파일을 통해 오브젝트 생성하기

$ kubectl apply -f spring-secret.yaml
$ kubectl apply -f spring-config.yaml
$ kubectl apply -f spring-deployment.yaml
$ kubectl apply -f spring-service.yaml

 

4. 잘 생성됐는 지 확인

$ kubectl get secret
$ kubectl get configmap
$ kubectl get deployment
$ kubectl get service
$ kubectl get pods

5. API가 잘 작동하는 지 확인

6. DB에 정상적으로 데이터가 저장되는 지 확인

✅ 아키텍처 다시 한 번 짚어보기