[Infrastructure] Spring Boot × Docker × AWS 배포 흐름 한 번에 이해하기

DEPLOYMENT

Spring Boot 앱을 Docker로 AWS에 배포하는 전체 흐름 정리

목차

1. Docker가 왜 필요한가?
2. Docker와 AWS의 차이
3. AWS 서비스 역할 정리
4. 전체 아키텍처 흐름
5. Dockerfile 작성과 배포
6. 배포 방식 비교
7. 마치며

Docker와 AWS를 처음 접하면 가장 헷갈리는 부분이 있다. “Docker를 쓰는 건가? AWS를 쓰는 건가?” 이 둘의 관계부터 실제 배포 흐름까지 한 번에 정리해보자.

 

 

Docker가 무엇인지 알고 싶다면 👇

Docker

1. Docker가 왜 필요한가?

Spring Boot 앱이 로컬에서는 잘 돌아가는데, 서버에 올리면 갑자기 오류가 나는 경우가 있다. 이런 문제는 대부분 실행 환경 차이 때문에 발생한다. Java 버전이 다르거나, OS 환경이 다르거나, 환경 변수 설정이 달라서 문제가 생기는 것이다.

개발자들 사이에서 자주 나오는 말이 있다.
“내 컴퓨터에선 됐는데?”
Docker는 바로 이 문제를 해결하기 위해 등장했다.

Docker는 앱과 실행 환경을 하나의 이미지로 묶는다. 즉, 어디서 실행하든 동일한 환경을 보장할 수 있다.

Docker를 비유하면?

레시피(코드)만 전달하는 게 아니라, 주방 환경까지 통째로 박스에 담아 보내는 개념이라고 보면 된다.

Docker 이미지에는 앱뿐 아니라 실행에 필요한 JDK, 설정, 라이브러리까지 포함된다.

2. Docker와 AWS의 차이

가장 많이 헷갈리는 부분이 바로 이것이다.

구분	역할
Docker	앱을 패키징하고 실행하는 방식
AWS	서버, DB, 네트워크 등을 제공하는 인프라

즉, 둘 중 하나를 선택하는 개념이 아니다. AWS라는 인프라 위에서 Docker 컨테이너를 실행하는 것이다.

Docker는 “어떻게 실행할 것인가”, AWS는 “어디서 실행할 것인가”에 가깝다.

3. AWS 서비스 역할 정리

Spring Boot 프로젝트를 AWS로 배포할 때 자주 사용하는 서비스들은 다음과 같다.

서비스	역할
EC2	Docker 컨테이너가 실행되는 서버
RDS	MySQL 같은 데이터베이스 관리
ElastiCache	Redis 캐시 서버 제공
S3	파일 저장소
CloudFront	CDN 기반 빠른 정적 파일 배포

실무에서는 보통 EC2 + RDS + Redis + S3 조합을 많이 사용한다.

4. 전체 아키텍처 흐름

전체 흐름은 다음과 같다.

개발자 코드 작성
        ↓
Docker 이미지 빌드
        ↓
DockerHub 또는 ECR 업로드
        ↓
EC2 서버에서 이미지 pull
        ↓
Docker 컨테이너 실행
        ↓
RDS / Redis / S3 연결
        ↓
사용자 요청 처리

사용자의 요청이 들어오면 Spring Boot 앱이 데이터를 처리하고, 필요한 경우 RDS(MySQL), Redis, S3와 통신하게 된다.

실제 서비스는 단순히 “Spring Boot 하나 실행”으로 끝나지 않는다. DB, 캐시, 파일 저장소 등 여러 서비스가 함께 동작한다.

5. Dockerfile 작성과 배포

Spring Boot 앱을 Docker 이미지로 만들기 위해 Dockerfile을 작성한다.

Dockerfile 예시

# Build Stage
FROM eclipse-temurin:17-jdk-alpine AS builder

WORKDIR /app

COPY . .

RUN ./gradlew bootJar

# Run Stage
FROM eclipse-temurin:17-jre-alpine

WORKDIR /app

COPY --from=builder /app/build/libs/*.jar app.jar

EXPOSE 8080

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

Multi-stage Build를 사용하면 최종 이미지 크기를 줄일 수 있다.

Docker 이미지 빌드

docker build -t my-spring-app .

DockerHub 업로드

docker push your-dockerhub-id/my-spring-app

EC2에서 실행

docker pull your-dockerhub-id/my-spring-app

docker run -d -p 80:8080 your-dockerhub-id/my-spring-app

DB 비밀번호 같은 민감 정보는 Dockerfile에 직접 작성하지 말고, 환경 변수로 관리하는 것이 안전하다.

application.yml 예시

spring:
  datasource:
    url: ${SPRING_DATASOURCE_URL}
    username: ${SPRING_DATASOURCE_USERNAME}
    password: ${SPRING_DATASOURCE_PASSWORD}

  data:
    redis:
      host: ${SPRING_REDIS_HOST}
      port: 6379

6. 배포 방식 비교

방식	장점	단점
JAR 직접 배포	단순하다	환경 차이 문제 발생 가능
Docker 배포	환경 일관성 보장	Docker 학습 필요
Docker Compose	여러 컨테이너 관리 편리	운영 환경에선 관리 필요
PaaS (Railway 등)	배포가 매우 쉽다	커스터마이징 제한

Docker Compose 예시

version: '3.8'

services:
  app:
    image: my-spring-app
    ports:
      - "80:8080"

  db:
    image: mysql:8

  redis:
    image: redis:7

운영 환경에서는 DB와 Redis를 직접 컨테이너로 운영하기보다, RDS와 ElastiCache 같은 관리형 서비스를 사용하는 경우가 많다.

7. 마치며

Docker는 앱을 어떻게 패키징할지 결정하는 기술이고, AWS는 그 컨테이너가 실제로 실행되는 인프라다. 둘은 경쟁 관계가 아니라 함께 사용하는 조합이다.

정리하면

• Docker는 실행 환경을 통째로 패키징한다
• AWS는 서버와 인프라를 제공한다
• Spring Boot + Docker + AWS 조합은 실무에서도 매우 많이 사용된다
• 다음 단계로는 GitHub Actions를 이용한 CI/CD 자동 배포까지 공부해보면 좋다.