앱은 여전히 열리는데 컨테이너 상태 점검은 왜 실패할까요?

Eva Wong 는 테크니컬 라이터 이자 상주 메이커 로 ZimaSpace에서 활동합니다. 평생 기술을 사랑해 온 그녀는 홈랩과 오픈 소스 소프트웨어에 열정을 품고 있으며, 복잡한 기술 개념을 누구나 이해하기 쉬운 실습 가이드로 풀어내는 데 전문성을 갖추고 있습니다. Eva는 셀프 호스팅이 어렵고 부담스러운 일이 아니라 즐거워야 한다고 믿습니다. 그녀는 튜토리얼을 통해 커뮤니티가 하드웨어 설정의 어려움을 풀어내고, 첫 NAS를 조립하는 것부터 Docker 컨테이너를 능숙하게 다루는 것까지 도전하도록 돕습니다.

프로브가 브라우저에서 사용하는 경로와 다른 명령, 주소, 사용자 또는 준비 상태를 확인하기 때문에 헬스 체크가 실패해도 컨테이너를 계속 사용할 수 있습니다.

홈 서버에서는 Docker가 컨테이너 내부에서 localhost, 없는 유틸리티, 잘못된 포트 또는 일시적으로 사용할 수 없는 종속성을 대상으로 헬스 명령을 실행하더라도 리버스 프록시를 통해 앱이 열릴 수 있습니다. 먼저 컨테이너 내부에서 정확한 프로브를 재현한 다음, 재시도 횟수를 늘리거나 헬스 체크를 비활성화하기 전에 프로브 대상과 예상 결과를 실제 사용자 경로와 비교하세요.

브라우저가 검사하는 항목과 헬스 체크가 검사하는 항목 비교하기

애플리케이션이 정상적으로 열리는 URL과 네트워크 경로를 기록하세요. 브라우저가 리버스 프록시, 공개된 호스트 포트, 로컬 IP 또는 컨테이너에 직접 연결되는지 확인하세요.

Docker는 설정된 프로브를 컨테이너 내부에서 실행하므로 브라우저와 다른 엔드포인트를 검사할 수 있습니다. Docker 커뮤니티의 한 사례에서는 서비스 프로세스 자체는 계속 실행될 수 있었지만, 이미지에 프로브에서 사용하는 curl 명령이 없어 헬스 체크가 실패했습니다.

브라우저에서 성공하는 경로가 다른 프록시나 포트를 거친다면, 그 결과만으로 내부 프로브 대상이 올바르다고 판단하지 마세요. 두 경로를 모두 기록하고 가장 먼저 다른 구성 요소를 확인하세요.

컨테이너 내부에서 헬스 명령을 그대로 실행하기

셸 형식, URL, 플래그, 인증 정보, 환경 변수를 포함해 헬스 체크 명령을 정확히 복사하세요. 실행 중인 컨테이너 내부에서 동일한 사용자로 명령을 실행하고 종료 코드와 출력을 기록하세요.

비정상 상태로 표시된 컨테이너도 프로세스는 계속 실행 중일 수 있습니다. 헬스 상태는 사용자가 페이지를 로드할 수 있는지가 아니라 프로브 결과를 반영하기 때문입니다. Netdata의 진단 절차는 재시작 동작을 변경하기 전에 프로브 실패와 프로세스 실패를 구분합니다.

명령이 수동 실행에서 성공하면 자동 검사에 사용되는 실행 사용자, 셸, 작업 디렉터리, 환경, 실행 시점을 비교하세요. 수동 실행에서 실패하면 다음 헬스 체크 주기를 기다리지 않아도 오류를 통해 다음에 살펴볼 계층을 파악할 수 있습니다.

프로브 도구, 셸, PATH, 사용자 확인

헬스 명령에 사용되는 모든 실행 파일이 현재 이미지 안에 있고 컨테이너 사용자로 실행할 수 있는지 확인하세요. 최소 구성 이미지에는 curl, wget, bash, DNS 도구 또는 인증서 저장소가 없을 수 있습니다.

shell 형식과 exec 형식의 프로브는 다르게 동작합니다. 인용, 파이프, 변수 확장, 복합 명령에는 사용 가능한 셸이 필요하지만, 직접 명령을 실행하려면 헬스 체크 환경의 PATH가 제한적일 때 실행 파일의 전체 경로를 지정해야 합니다.

절대 경로와 지정된 서비스 사용자로 명령을 실행하세요. 도구를 직접 설치하는 대신 이미지나 프로브를 수정하세요. 컨테이너에서 수동으로 변경한 내용은 다음 빌드 후 사라집니다.

내부 주소, 포트 및 프로토콜 확인하기

컨테이너 내부의 애플리케이션 수신 주소를 확인하고 프로브 URL과 비교하세요. 8080:80처럼 호스트 포트를 게시했다고 해서 서비스가 컨테이너 내부의 8080 포트에서 수신 대기한다는 뜻은 아닙니다.

헬스 체크는 컨테이너가 제어하는 애플리케이션 상태를 테스트해야 합니다. Dash0의 실용 가이드에 따르면 프로브는 HTTP 엔드포인트를 호출하거나 프로세스를 검사할 수 있지만, 해당 엔드포인트는 외부 프록시를 통해서만 사용할 수 있는 경로가 아니라 실제 컨테이너 준비 상태를 반영해야 합니다.

각 주소가 적절한 경우에만 127.0.0.1, 컨테이너의 수신 주소, 서비스 이름을 테스트하세요. 앱이 유닉스 소켓이나 다른 인터페이스에만 바인딩된다면 프로브를 실제 내부 진입점에 맞게 변경하세요.

느린 시작과 영구적인 장애 구분하기

올바른 엔드포인트가 응답하기까지 애플리케이션 시작, 데이터베이스 마이그레이션, 캐시 예열 또는 모델 로드에 걸리는 시간을 측정하세요. 이 시간을 start_period, interval, timeout, retries 값과 비교하세요.

종속 서비스가 아직 비정상 상태로 표시되어 있으면, 나중에 준비 상태가 되더라도 Compose가 종속 서비스를 차단할 수 있습니다. 보고된 Compose 회귀 사례에서는 종속 서비스 장애로 스택이 이미 중지된 뒤에야 해당 서비스가 정상 상태가 되었고, 이로 인해 지나치게 좁은 헬스 체크 시작 시간 범위가 드러났습니다.

로그를 통해 앱이 정상적으로 진행 중임이 확인될 때만 시간을 늘리세요. 재시도 시간을 늘려 잘못된 포트, 마이그레이션 실패, 인증서 누락 또는 연결할 수 없는 데이터베이스 문제를 숨겨서는 안 됩니다.

프로브 범위를 좁게 유지하고 복구 여부 확인하기

헬스 체크가 프로세스 생존 여부, 로컬 애플리케이션 준비 상태 또는 더 깊은 종속성 체인 중 무엇을 나타내야 하는지 결정하세요. 선택 사항인 외부 API를 사용할 수 없다는 이유만으로 로컬 컨테이너를 비정상 상태로 만들지 마세요.

애플리케이션이 데이터베이스, 캐시 또는 네트워크 서비스 없이는 준비 상태가 될 수 없다면, 다음 단계로 ZimaSpace 가이드에서 처음 실패한 종속 서비스 찾기를 살펴보세요.

정상 시작 후 정확한 자동 프로브가 성공하고, 종속 서비스가 재시작되어도 컨테이너가 정상 상태를 유지하며, 실제 앱 워크플로를 계속 사용할 수 있으면 문제가 해결된 것입니다. 서비스 장애를 감지할 만큼 엄격하되, 관련 없는 시스템으로 인한 오탐은 방지할 수 있도록 프로브 범위를 좁게 유지하세요.

지원 및 팁

더 읽어보기

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.