MySQL 컨테이너 health check는 mysqladmin ping에 -h 127.0.0.1을 붙여야 첫 기동 초기화 중 통과하지 않는다
·수정 1회
요약
- 공식 MySQL 이미지는 빈 데이터 디렉터리로 처음 뜰 때
--skip-networking임시 서버로 초기화를 하고, 이 구간에는 TCP 3306이 닫혀 있고 소켓 파일만 열려 있다. -h없는mysqladmin ping은 소켓으로 붙으므로 이 구간에도 통과할 수 있다. 컨테이너 밖에서 TCP로 붙는 클라이언트는 그 시점에 접속이 거부될 수 있다.- health check를
mysqladmin ping -h 127.0.0.1로 바꾸면 TCP가 열린 뒤에야 통과한다.
본문
첫 기동 순서 (docker-library/mysql의 docker-entrypoint.sh)
- 데이터 디렉터리가 비어 있으면 임시 서버를
--daemonize --skip-networking --socket="${SOCKET}"으로 띄운다. TCP는 닫고 소켓만 연다 (docker_temp_server_start, 122-124줄 부근). - 그 소켓으로 DB 생성, root 비밀번호 설정 같은 초기화를 한다. 로그에
Temporary server started.가 찍힌다. - 임시 서버를 종료한다 (
Temporary server stopped,MySQL init process done. Ready for start up.). - 진짜 서버를 기동한다. 이때부터 TCP 3306이 열린다.
읽은 파일은 master의 루트 docker-entrypoint.sh다. 이 저장소는 master에서 8.0/ 디렉터리가 빠져 있어, CI가 쓰는 mysql:8.0 태그와 완전히 같은 판이 아닐 수 있다.
왜 ping이 일찍 통과하는가
mysqladmin ping에-h가 없으면localhost로 간주하고 Unix 소켓 파일로 접속한다. 이 규칙은 Unix의 MySQL 클라이언트는 localhost를 TCP가 아닌 Unix 소켓 파일로 접속한다에 정리했다.- 위 2단계의 임시 서버는 소켓을 열고 있으므로 ping이 성공한다. 직원용 뒷문만 열어 보고 "영업 중"이라고 판단한 셈이다.
mysqladmin ping은 서버가 살아 있으면Access denied여도 종료 코드 0이다 (공식 문서). 비밀번호 설정 전후와 무관하게 통과한다.- Docker health check 명령은 컨테이너 안에서 실행되므로 컨테이너 안 소켓 파일에 닿는다. 반면 아래 구성의 pytest는 runner VM에 있어 소켓 파일이 보이지 않고, 포트 매핑된 TCP로만 접속한다. (이 "컨테이너 안에서 실행" 부분은 Docker 문서로 확인하지 못했다.)
사례: connectingServer CI (PR #6452, 커밋 2054745)
- 테스트 job은
runs-on: ubuntu-22.04이고container:키가 없어 pytest가 runner VM에서 직접 돈다. - 서비스는
image: mysql:8.0,ports: - 3306:3306,--mount type=tmpfs,destination=/var/lib/mysql:rw다. 데이터 디렉터리가 매번 빈 tmpfs라 모든 job이 첫 기동 초기화를 거친다. - GitHub Actions runner는 서비스 컨테이너가
starting인 동안 기다리다가healthy가 되면 job 단계를 시작한다 (ContainerOperationProvider.cs442-450줄). health check가 통과하는 순간 테스트가 시작될 수 있다. - 변경한 옵션:
- --health-cmd="mysqladmin ping" --health-interval=10s --health-timeout=5s --health-retries=3
+ --health-cmd="mysqladmin ping -h 127.0.0.1" --health-interval=2s --health-timeout=5s --health-retries=30
- 같은 커밋에서 Redis도 interval 10s에서 2s, retries 3에서 30으로 바꿨다.
redis-cli ping은 그대로다. - 커밋 메시지는 이유를 "mysqladmin ping 은 TCP 로 확인해, 초기화 중 네트워크를 끈 임시 서버를 healthy 로 보지 않게 한다"고 적었다.
해석 (추론, 직접 관찰 아님)
- 수정 전 interval이 10초일 때는 첫 검사가 보통 초기화가 끝난 뒤에 와서 문제가 가려져 있었을 것이다. interval을 2초로 줄이면 임시 서버 구간에 검사가 걸릴 수 있어
-h 127.0.0.1을 함께 넣은 예방 조치로 보인다. 실제 CI에서 접속 거부를 본 것은 아니다. - retries를 3으로 두고 interval만 2초로 줄이면 약 2초 x 3 = 6초 만에 unhealthy가 될 수 있어 30으로 늘렸다. runner는
starting이 아닌 상태에서healthy가 아니면 job을 실패시킨다 (runner 소스로 확인).