[Docker] SpringBoot/MyBatis 프로젝트 Docker에서 실행하기

 

 

 

 

 

이번 포스팅에서는 MyBatis 를 사용하는 SpringBoot 프로젝트를 Docker 에서 실행해보는 과정을 적어보려고 한다.

 

 

✅ 우선 Eclipse 에 접속하여 SpringBoot 프로젝트의 설정부터 확인한다. MyBatisProject/pom.xml 에 dependency 로 mysql 과 mybatis 를 주입해준다.

 

 

 

 

✅ 그리고 war 파일로 export 하기 위해서 <packaging>jar</packaging> 를 war 로 바꿔준다.

 

 

 

 

✅ mybatis-config.xml 에 DB 연동하는 정보를 작성한다.

 

 

 

 

 

✅ mysql 과 tomcat 이미지를 설정한 후 docker hub 에 push 하고 pull 받아서 사용한다.

 

# docker 설치
sudo apt-get install docker
sudo apt-get install docker.io

# tomcat 이미지 container 실행
sudo docker pull tomcat:9
# volume
sudo docker run -d --name="tomcat-test" -p 8383:8080 \
-v /home/tiger/webapps:/usr/local/tomcat/webapps/ tomcat:9

# tomcat container 를 docker hub 에 push
sudo docker commit tomcat-test(컨테이너 이름) tomcat_test:latest(이미지 이름)
sudo docker tag tomcat_test:latest wjdalsdkcla/tomcat-test
sudo docker login
sudo docker push wjdalsdkcla/tomcat-test (docker hub 레파지토리)

# docker hub 에 올린 tomcat 이미지 pull
sudo docker pull wjdalsdkcla/tomcat-test:latest
# volume
sudo docker run -d --name="tomcat-test" -p 8383:8080 \
-v /home/tiger/webapps:/usr/local/tomcat/webapps/ \
wjdalsdkcla/tomcat-test:latest

# mysql 이미지 container 실행
sudo docker pull mysql:latest
# volume
sudo docker run -it --name mysql-container -p 3380:3306 \
-v /home/tiger/db_data:/var/lib/mysql \
-e MYSQL_ROOT_PASSWORD=mysql비번 \
-d mysql:latest

# mysql container 를 docker hub 에 push
sudo docker commit mysql-container(컨테이너 이름) mysql-test:latest(이미지 이름)
sudo docker tag mysql-test:latest wjdalsdkcla/mysql-test
sudo docker login
sudo docker push wjdalsdkcla/mysql-test (docker hub 레파지토리)

# docker hub 에 올린 mysql 이미지 pull
sudo docker pull wjdalsdkcla/mysql-test:latest

# mysql 이미지 container 실행
# volume
sudo docker run -it --name mysql-container -p 3380:3306 \
-v /home/tiger/db_data:/var/lib/mysql \
-e MYSQL_ROOT_PASSWORD=mysql비번 \
-d wjdalsdkcla/mysql-test:latest

# mysql 접속 후 계정 설정
sudo docker exec -it mysql-container /bin/bash
> mysql -u root -p
> use mysql;
> CREATE USER 'user1'@'%'IDENTIFIED BY '1234'; 
> GRANT ALL PRIVILEGES ON *.* TO 'user1'@'%';
> FLUSH PRIVILEGES;
> exit
> mysql -u user1 -p

 

 

tomcat 이미지를 실행할 때 volume (-v) 을 사용한다.

volume 은 docker 의 경로에서 로컬의 경로에 있는 파일을 참조해서 사용할 수 있는 명령으로, container run 할 때마다 -v 명령으로 그 경로를 지정해줘야 한다.

 

sudo docker run -d --name="tomcat-test" -p 8383:8080 \
-v /home/tiger/webapps:/usr/local/tomcat/webapps/ tomcat:9

 

 

 

💡 위의 command 에서 -v 명령이 수행되는 과정은 대략 이러하다. 사용자가 리눅스의 로컬인 home/tiger 안에 webapps 폴더를 만들고 그 안에 ROOT.war 파일을 넣는다. 그러면 command 로 copy를 따로 해주지 않더라도 docker 의 usr/local/tomcat/webapps/ 경로에 ROOT.war 파일이 참조된다. 다만, -v 명령으로 docker 에서 ROOT.war 파일을 참조하여 정상적으로 실행된다고 해서 그 war 파일이 이미지에 계속 남아있는 것은 아니다. 즉, dokcer 에서 local 의 ROOT.war 파일을 참조하여 정상적으로 실행되는 이미지를 docker hub 에 push 하고 다시 pull 받아서 -v 명령 없이 실행해보면 그 war 파일은 docker 에 남아있지 않다. -v 명령을 실행해서 local 폴더에 있는 ROOT.war 파일의 경로를 지정해주면 docker 의 tomcat/webapps/ 경로로 war 파일이 참조되어 들어가고 실행이 정상적으로 되는 것이다.

 

 

 

 

mysql 이미지를 실행할 때에도 volume (-v) 을 사용해보았다.

 

sudo docker run -it --name mysql-container -p 3380:3306 \
-v /home/tiger/db_data:/var/lib/mysql \
-e MYSQL_ROOT_PASSWORD=mysql비번 \
-d wjdalsdkcla/mysql-test:latest

 

 

💡 위의 command 에서 -v 명령이 수행되는 과정은 대략 이러하다. 사용자가 리눅스의 로컬인 home/tiger 안에 db_data 폴더를 만들고 command 를 실행한다. 그러면 docker 의 var/lib/mysql 경로에 저장되는 db data 정보들이 참조되어 로컬의 db_data 폴더에 백업이 된다. 사용자가 docker의 mysql 에 접속해서 데이터베이스 db01 과 db02 를 만들고 db01 데이터베이스에 president 와 citizen 테이블을 만들면 그 정보가 로컬의 db_data/db01/ 경로에 저장이 된다. 이 폴더는 로컬에서 계속 유지가 되기 때문에 다른 컨테이너를 실행할 때에도 db_data 내의 데이터를 공유해서 사용할 수 있다. 다만, mysql 데이터베이스에 데이터를 업데이트(insert, update, delete) 하고 나서 해당 이미지를 docker hub 에 push 하고나서 다시 pull 받아보면 이미지에 그 데이터는 더이상 남아있지 않다. 다만 로컬에 db_data 정보가 남아있기 때문에 데이터베이스와 테이블은 유지된다.

 

 

 

💡 volume 과 mount 의 차이는 무엇일까?

-v (volume) 은 모든 옵션을 하나로 결합하는 데에 비해 --mount 는 옵션을 분리함으로써 더 명확하다.

docker volume 에 대한 공식 문서 : https://docs.docker.com/storage/volumes/

 

--mount 명령어  /  --v 명령어

 

 

 

✅ docker hub 에 이미지가 정상적으로 업로드 된 것을 확인한다.

 

 

 

 

✅ docker-compose 에서 docker hub에 업로드 된 이미지들을 받아서 사용한다.

 

 

 

 

✅ docker-compose.yml 파일을 작성한다.

 

 

 

 

✅ docker-compose 파일 혹은 프로젝트를 github 에 업로드 하고 clone 을 받는다.

 

# 깃 설치
sudo apt-get install git -y

# 깃 클론
git clone https://github.com/qwa310/compose-test.git

cd 깃클론 받은 폴더 # docker-compose.yml 이 있는 폴더까지 들어간다.

# docker compose 실행
docker-compose up -d

 

 

 

✅ docker-compose.yml 이 있는 경로까지 들어가서 sudo docker-compose up -d 명령어를 수행한다.

 

컨테이너를 중지하고 삭제할 때는 sudo docker-compose down 명령어를 수행한다.

 

 

 

 

 

✅ web 실행 및 DB 연동 확인

 

 

웹 실행

DB 연동