SpringBoot 프로젝트를 Docker로 EC2에 배포하기

팀 프로젝트에서 SpringBoot, Docker, AWS EC2를 이용하여 서버 환경을 구성하고자 하였다. 로컬과 개발 서버로 분리하여 운영할 계획이며, 도메인 적용과 CI/CD, Swagger는 추후 도입 예정이다. ~~(프로젝트가 끝난 다음에야 포스팅할지도..)~~

0. 시스템 흐름도

시스템 흐름은 위의 이미지와 같은데, Local에서 스프링부트 프로젝트를 생성하고 Docker Image를 생성한 후 이를 서버에 배포할 것이다.

1. Docker 설치 & Docker Hub 가입

각자 OS에 맞는 도커 설치법을 검색하여 로컬에 설치한다. Window 10 Education을 이용 중이므로 WSL2를 활용하여 로컬에 도커를 설치했다. (Docker Desktop 대신 intellij 플러그인을 사용해도 무관하다.)

WSL2 설치는 아래 글을 참고하면 된다.

https://www.lainyzine.com/ko/article/how-to-install-wsl2-and-use-linux-on-windows-10/

필자는 WSL 버전이 1이었어서 버전 업데이트만 진행하였다.

WSL2 설치가 끝났으면 아래의 공식 홈페이지에서 Window OS 전용 도커를 다운받는다.

https://www.docker.com/products/docker-desktop/

도커가 잘 설치되어있는지 확인은 cmd창에서 'wsl -l -v'으로 확인해볼 수 있다.

도커 허브 가입은 간단하니 링크만 첨부하겠다. :) https://hub.docker.com/

참고로 도커 허브 계정명을 기억하고 있어야 한다. Docker Image 만들 때 쓰이기 때문!

2. Spring-Boot 프로젝트 구축 및 도커 설정

간단한 프로젝트를 생성하고 해당 프로젝트 루트에 Dockerfile 파일을 생성한다.

SpringBoot 2.4.2

테스트 코드를 작성하고 해당 프로젝트의 .jar 파일을 만든다.

IntelliJ의 우측 Gradle 메뉴 -> Tasks-build-bootJar

이제 해당 .jar 경로에 Dockerfile을 만들어주면 된다.

FROM openjdk:8
ARG JAR_FILE=*.jar
COPY ${JAR_FILE} app.jar
ENTRYPOINT ["java","-jar","/app.jar"]

FROM : 기반이 되는 이미지를 의미하고, jdk 버전을 명시해주면 된다.

ARG : 컨테이너 내에서 사용할 수 있는 변수를 지정할 수 있다.

COPY : ARG의 JAR_FILE 변수를 컨테이너의 app.jar에 복사한다는 뜻이다.

ENTRYPOINT : 컨테이너가 시작됐을 때 실행할 스크립트를 명시한다.

3. Docker Image 만들기

SpringBoot 프로젝트 루트 경로로 가서 도커 이미지를 생성한다. 도커 명령어를 실행하면 Dockerfile에서 설정한 내용들이 실행된다.

docker build -t 도커허브ID/레포지토리 이름 .

* 레포지토리 이름은 소문자만 가능하고, 대문자가 포함될 경우 에러를 뱉을 것이다.

이제 push를 해보자~

docker login
# userID와 password 입력
# Login Succeeded

docker push 도커허브ID/레포지토리 이름

도커 허브 홈페이지에서 push 내역을 확인할 수 있다.

4. Container 실행

생성된 이미지로 컨테이너를 실행해보자.

docker run -d -p 8080:8080 도커허브ID/레포지토리 이름

docker ps 명령어로 실행 중인 컨테이너를 확인할 수 있다.

5. EC2에 배포하기

AWS EC2 인스턴스 Amazon Linux 2 AMI

.pem 키 페어 경로로 이동한 후 ssh 연결에 필요한 명령어를 실행한다.

(명령어 확인은 EC2 > 인스턴스 > 사용 중인 인스턴스 클릭 > 인스턴스에 연결 > SSH 클라이언트

> 명령어 복사)

도커를 설치하고 프로그램을 실행한 후, 도커 허브의 이미지를 pull한다.

sudo yum install docker

sudo systemctl start docker

sudo docker pull 도커허브ID/레포지토리 이름

## 이미지 실행
sudo docker run -d -p 8080:8080 도커허브ID/레포지토리 이름

참고 사이트 :

https://devfoxstar.github.io/java/springboot-docker-ec2-deploy/

[윈도우에 도커 설치]

https://www.lainyzine.com/ko/article/a-complete-guide-to-how-to-install-docker-desktop-on-windows-10/

[EC2에 도커 배포]

https://jinjinyang.tistory.com/46

[Spring-Boot 프로젝트 구축 및 도커 설정]

https://aodtns.tistory.com/115

저작자표시 비영리 동일조건