From 2867a6ed3c59a67d8c7966267a7c9d1550ba736f Mon Sep 17 00:00:00 2001 From: Claude-51124 Date: Fri, 16 Jan 2026 22:16:18 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20Docker=20API=20=EC=A0=9C=ED=95=9C=20?= =?UTF-8?q?=EB=B0=8F=20=EC=84=9C=EB=B2=84=20=EA=B0=84=20=EC=A0=91=EA=B7=BC?= =?UTF-8?q?=20=ED=8F=B4=EB=B0=B1=20=EC=9B=90=EC=B9=99=20=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../251228_admin_서비스_헬스체크_개선.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/journey/troubleshooting/251228_admin_서비스_헬스체크_개선.md b/journey/troubleshooting/251228_admin_서비스_헬스체크_개선.md index f035df3..aeb3cde 100644 --- a/journey/troubleshooting/251228_admin_서비스_헬스체크_개선.md +++ b/journey/troubleshooting/251228_admin_서비스_헬스체크_개선.md @@ -49,6 +49,18 @@ - 다른 서버에 있는 서비스는 제거 - docker_services 매핑은 실제 컨테이너 이름 사용 +### Docker API 제한 및 폴백 원칙 + +**원칙**: +- Docker API는 같은 서버의 컨테이너만 조회 가능 (다른 서버의 컨테이너는 조회 불가) +- Docker API 체크 실패 시(`not_found`, `error`) HTTP 헬스체크로 자동 폴백 +- 서버 간 접근 시 URL 폴백: `172.17.0.1` 실패 시 `192.168.219.45`로 재시도 + +**이유**: +- Docker API는 로컬 Docker 데몬에만 접근 가능하여 원격 서버 컨테이너 조회 불가 +- 서버 간 서비스 체크는 HTTP 헬스체크로만 가능 +- Docker 네트워크 IP(`172.17.0.1`)는 같은 서버 내부에서만 유효, 서버 간 접근은 실제 IP(`192.168.219.45`) 필요 + --- ## 참고