[Docker] Docker Compose 파일로 다중 컨테이너 환경 구성하고 실행하기(feat. 오류들)

필자는 프로젝트에서 redis 를 사용하기 위해 docker-compose 파일을 사용하여 redis 컨테이너랑 mysql 컨테이너 2개를 띄울려고 한다.

우선 도커와 도커 컴포즈의 차이를 알아보자.

 

Docker

• Docker는 단일 컨테이너를 빌드, 실행 및 관리하기 위한 도구
• Docker 명령어를 사용하여 이미지 빌드, 컨테이너 실행, 로그 확인, 컨테이너 중지 등의 작업을 수행할 수 있습니다.
• 예를 들어, 단일 웹 서버 컨테이너를 실행하거나 데이터베이스 컨테이너를 띄울 때 Docker를 사용할 수 있습니다.

Docker Compose

• Docker Compose는 여러 컨테이너의 애플리케이션을 정의하고 실행하기 위한 도구
• 여러 개의 서비스, 네트워크, 볼륨 등을 포함하는 복잡한 애플리케이션 스택을 정의할 수 있습니다.
• docker-compose.yml 파일에 애플리케이션의 서비스 구성을 기술하고, 이 파일을 사용하여 여러 컨테이너를 한 번에 띄울 수 있다.

 

---

 

 

그럼 도커 컴포즈를 활용해서 컨테이너들을 띄워보자!

Docker 이미지를 빌드하기 위한 설정 파일인 Dockerfile과 컨테이너로 이루어진 애플리케이션 스택을 정의하고 실행하기 위한 설정 파일인 docker-compose.yml를 만들어줘야한다.

홈 디렉토리 아래에 database, redis 디렉토리 하위에 Dockerfile을 생성하고 사진과 같이 작성하면 된다.

 

FROM 

명령어를 통해서 어떤 도커 베이스 이미지를 사용할지 명시한다.
ENV TZ=Asia/Seoul 
컨테이너는 기본적으로 UTC 시간을 바라보고 있으니깐 한국시간으로 설정해준다.

 

데이터베이스에서 간혹 한글이 깨지는 경우가 있으므로 데이터베이스 디렉토리 하위, config 디렉토리 아래 mysql.cnf 파일을 추가해주자.

 

[client]
default-character-set=utf8mb4

[mysql]
default-character-set=utf8mb4

[mysqld]
character-set-server=utf8mb4
collation-server=utf8mb4_unicode_ci
skip-character-set-client-handshake

[mysqldump]
default-character-set=utf8mb4

이제 도커 컴포즈 파일을 생성하자.

루트 디렉토리에 docker-compose-local 파일을 생성한다.

해당 파일에 실행시킬 레디스와 데이터베이스 컨테이너 정보를 명시해준다.

 

데이터베이스는 환경변수를 추가해줘야 한다.

volume 부분은 데이터베이스 한글이 깨지지 않게 설정한 mysql.cnf파일 위치를 명시한다. 이 부분을 추가해서 컨테이너가 참조해서 데이터베이스 초기화를 할수 있도록 한다. 먼저 호스트 디렉토리에 있는 작성한 디렉토리 경로를 작성하고 : 도커가 바라보는 디렉토리를 작성해주면 된다. 

데이터베이스의 비밀번호는 깃허브에 올라가는 안되는 정보라서 외부에서 환경변수로 주입해준다. 이제 .env 파일을 만들어 외부에 공개되지 말아야할 정보를 추가해주고 .gitignore에도 추가해줘야한다.
작성한 해당 파일은 도커 컴포즈가 실행이 될때 자동으로 이 파일을 참조해서 환경변수를 가져오게 된다. 

로컬에서 사용할 DB, Redis 도커파일을 작성을 했으니, 도커 컴포즈 파일을 실행시켜 정상적으로 데이터베이스와 레디스가 컨테이너에 의해서 실행이 되는지 확인을 해보자.
우선 도커가 실행되어야하고 다음 명령어를 입력해주자.

docker-compose -f docker-compose-local.yml up

 

docker-compose up : Docker Compose로 정의된 서비스들을 시작하고 컨테이너를 생성하여 실행하는 명령어
-f : 어떤 도커 컴포즈 파일을 실행시킬것인가 지정

필자는 해당 명령어를 실행시켰는데...오류가 발생했다.

Caused by: com.mysql.cj.jdbc.exceptions.CommunicationsException: Communications link failure

 

mysql이랑 연결이 안된다는뜻인데 저번에 비슷한 오류가 있었을때 포트를 변경해서 해결한적이 있어 포트를 변경해보기로 했다.

필자는 3308로 바꿔줄것이다.

우선 도커 컴포즈 파일에서 mysql 포트를 3308:3308 로 바꿔준다.

그리고 mysql_root_password도 우선 명시해준다. 추후 mysql 오류로 인해 mysql 컨테이너로 접속하기 위해서다.

 

 

 

다시 docker-compose -f docker-compose-local.yml up 명령어를 실행했더니 잘 실행됐다.

 

그리고서 mysql workbench로 가서 연결시도해보니깐

Communications link failure. The last packet sent successfully to the server was 0 milliseconds age. The driver has not received any packets from the server.

에러뜨면서 연결이 안되었다...;;ㅠㅠ

실행중인 mysql 컨테이너 3308포트로 잘 연결되있는데...ㅠㅠ

 

 

열심히 삽질하고서 해결방법을 찾았다. 필자와 같은 오류가 나면 아래 블로그를 통해 해결할수 있다.

https://hy-ung.tistory.com/82

Docker 에 mysql 설치 후 workbench 연결 오류!?

 

 

위의 방법을 적용하고 다시 mysql 컨테이너를 실행시켰더니 드디어 잘 실행된다.!!!

 

 

 

이제 스프링부트와 연결을 시도해보자.

application.yml에서 db 와 redis 설정을 적어준다.

 

 

설정해준후 스프링부트를 실행시키면 잘 실행된다.

mysql workbench도 연결해보면 잘 연결된다.

 

 

 

 

한달 스트레스 하루만에 받앗다...ㅎ

끝!!!ㅠ