🐋Docker Compose Spring Boot + MySQL Project

이 프로젝트는 Docker Compose를 사용하여 Spring Boot 애플리케이션과 MySQL 데이터베이스를 연동하고, 각 컨테이너의 상태를 모니터링하기 위한 헬스체크(Healthcheck) 설정을 포함하고 있습니다.

1. 서비스 구성 및 헬스체크 설정

데이터베이스 서비스 (db)

데이터베이스 내부적으로 쿼리 처리가 가능한 상태인지 확인합니다.

• 설정 위치: docker-compose.yml
• 검증 방법: mysqladmin ping 명령어를 사용하여 서버 응답을 확인합니다.
• 주요 파라미터:
  • interval: 10s: 10초마다 체크 수행
  • timeout: 5s: 응답 대기 시간
  • retries: 10: 최대 10회 재시도
  • start_period: 30s: 초기 구동 시 30초 동안은 실패해도 무시하고 기다려줌

애플리케이션 서비스 (app)

애플리케이션 개발 단계에서 설정한 엔드포인트가 정상 응답을 주는지 확인합니다.

• 설정 위치: Dockerfile
• 검증 방법: curl을 사용하여 특정 경로(/emp/)의 응답을 확인합니다.
• 주요 특징:
  • 애플리케이션의 컨텍스트 경로(/emp)를 반영하여 체크합니다.
  • 서버가 구동 중임을 확인하기 위해 404 응답이라도 서버가 살아있다면 정상으로 간주하도록 설정되어 있습니다.
    
    

2. 컨테이너 간 의존성 관리 (depends_on)

본 프로젝트는 docker-compose.yml에서 다음과 같은 의존성 설정을 사용합니다:

depends_on:
  db:
    condition: service_healthy

이 설정은 단순히 컨테이너가 '실행 중'인 것을 넘어, 데이터베이스가 헬스체크를 통과하여 healthy 상태가 되었을 때만 애플리케이션 컨테이너를 시작하도록 보장합니다.

3. 주요 테스트 및 고찰 (Troubleshooting)

Q1. MySQL이 죽어있거나 시작되지 않으면 App 컨테이너는 어떻게 되나요?

• 답변: app 컨테이너는 생성 및 실행되지 않고 대기합니다. Docker Compose는 db가 healthy 상태가 될 때까지 app의 시작을 보류합니다.
• 소요 시간: 만약 MySQL이 끝내 살아나지 않는다면, db 컨테이너가 unhealthy로 최종 확정될 때까지 약 130초(30s + 10s * 10회) 정도 소요됩니다.

Q2. 처음 실행 시 데이터베이스 접속 권한 에러(Access Denied)가 발생한다면?

• 원인: Docker 볼륨(db_data)에 이전 실행 정보가 남아있어 docker-compose.yml에 설정한 새로운 계정 정보가 반영되지 않을 수 있습니다.
• 해결: docker compose down -v 명령어로 볼륨을 완전히 삭제한 후 다시 빌드(--build)하여 실행하면 새로운 데이터베이스와 계정이 정상적으로 초기화됩니다.

Q3. 컨테이너 상태가 unhealthy로 표시될 때 확인해야 할 점

• 포트 매핑: Dockerfile의 SERVER_PORT와 docker-compose.yml의 포트 매핑이 일치하는지 확인하십시오 (현재 설정: 80:80).
• 컨텍스트 경로: 헬스체크 경로에 애플리케이션의 이름이나 컨텍스트 경로가 누락되지 않았는지 확인하십시오.
  
  

4. 트러블슈팅(Troubleshooting)

프로젝트 구성 중 발생할 수 있는 주요 문제와 해결 방법입니다.

Case 1. Dockerfile 빌드 에러 (COPY 명령어 오류)

• 증상: failed to solve: dockerfile parse error: COPY requires at least two arguments
• 원인: COPY 명령어에서 소스 파일은 명시했으나 컨테이너 내부의 목적지 경로를 누락한 경우 발생합니다.
• 해결: COPY <source> <destination> 형식을 지켜 목적지 경로(예: app.jar)를 반드시 추가합니다.

Case 2. 데이터베이스 접속 에러 (Communications link failure)

• 증상: Spring Boot 로그에 Connection refused 또는 Communications link failure 발생.
• 원인: DB가 아직 준비되지 않았거나, 잘못된 호스트/포트로 접속을 시도할 때 발생합니다.
• 해결:
  • docker-compose.yml의 depends_on에 condition: service_healthy를 추가합니다.
  • JDBC URL에 ?allowPublicKeyRetrieval=true&useSSL=false 옵션을 추가하여 접속 안정성을 높입니다.

Case 3. 권한 에러 또는 DB 미생성 (Access Denied)

• 증상: 지정된 계정(user01)으로 접속이 되지 않거나, 생성한 데이터베이스(fisa)를 찾을 수 없는 경우.
• 원인: 이전 실행에서 생성된 Docker 볼륨(db_data)에 구형 설정 데이터가 남아있어 새로운 설정이 반영되지 않는 경우입니다.
• 해결: docker compose down -v 명령어로 볼륨데이터를 완전히 삭제한 후 재시작하여 DB를 새로 초기화합니다.

Case 4. 애플리케이션 상태가 unhealthy로 표시될 때

• 증상: docker ps 결과에서 app 컨테이너가 unhealthy로 나타남.
• 원인: 헬스 체크 경로가 잘못되었거나 포트 매핑이 일치하지 않는 경우입니다.
• 해결:
  • 애플리케이션의 Context Path (예: /emp/)가 헬스 체크 URL에 포함되어 있는지 확인합니다.
  • Dockerfile의 SERVER_PORT와 docker-compose.yml의 호스트 포트 매핑(80:80)을 확인합니다.