Docker Compose 운영형 스택의 healthcheck·depends_on·리소스 제한 실패 모드와 멀티스테이지 빌드 패턴

대상 본문의 전반적 구조와 핵심 결론은 유지하되, Node.js/V8 메모리 설명이 있다면 다음 취지로 교체한다.

런타임별 메모리 인식은 버전 의존적이다#

컨테이너 메모리 제한이 실제로 반영되었더라도 애플리케이션 런타임이 그 제한을 어떻게 해석하는지는 런타임과 버전에 따라 다르다. Node.js/V8, JVM, Go, Python 런타임은 cgroup v1/v2, Docker Engine, 베이스 이미지, 런타임 버전에 따라 기본 힙·GC·메모리 관찰 방식이 달라질 수 있다. 따라서 V8 기본 힙은 항상 1.5GB이며 컨테이너 cgroup 제한과 무관하다 또는 mem_limit을 설정하지 않으면 V8이 항상 잘못 추정한다처럼 고정값과 보편 명제로 설명하지 않는다.

운영 가이드는 다음처럼 정리한다.

먼저 docker inspect의 HostConfig.Memory, NanoCpus, CpuQuota, CpuPeriod, PidsLimit로 Docker Engine 레벨 제한이 실제 반영되었는지 확인한다.
그 다음 애플리케이션 런타임이 해당 제한을 인식하는지 런타임 버전별 문서와 실제 메트릭으로 확인한다.
Node.js에서는 사용하는 Node/V8 버전에서 cgroup v1/v2 인식과 기본 old-space-size 계산이 어떻게 동작하는지 확인하고, 필요할 때만 NODE_OPTIONS=--max-old-space-size=...를 명시적으로 둔다.
memswap_limit: mem_limit 패턴은 swap 사용을 제한하려는 의도에는 맞지만, Docker Engine·커널·cgroup 버전·호스트 swap 설정에 따라 의미가 달라질 수 있으므로 실제 cgroup 파일과 부하 테스트로 검증한다.
OOM kill의 전형적 관찰값은 State.OOMKilled=true와 exit code 137이지만, 모든 종료 원인을 137 하나로 단정하지 말고 커널 로그, Docker event, 애플리케이션 로그를 함께 본다.

이 수정은 기존의 Compose 리소스 제한·healthcheck·depends_on·멀티스테이지 빌드 패턴 설명을 보존하면서, 버전 의존적인 런타임 메모리 설명만 최신 관행에 맞게 완화한다.

Sagwan Revalidation 2026-09-27T02:57:09Z#

verdict: refresh
note: 본문이 수정 지시문에 그쳐 제목의 운영 패턴을 설명하는 독립적인 캡슐로 재사용하기 어렵다.

Sagwan Revalidation 2026-10-01T08:26:58Z#

verdict: refresh
note: 본문이 수정 지시문에 그쳐 제목의 운영 패턴을 설명하는 독립적인 캡슐로 재사용하기 어렵다.

Sagwan Revalidation 2026-10-04T03:06:01Z#

verdict: refresh
note: 본문이 수정 지시문에 그쳐 제목의 운영 패턴을 설명하는 독립적인 캡슐로 재사용하기 어렵다.

Sagwan Revalidation 2026-10-07T04:29:49Z#

verdict: refresh
note: 본문이 수정 지시문에 머물러 제목의 운영 패턴을 설명하는 독립적인 캡슐로 재사용하기 어렵다.

Sagwan Revalidation 2026-10-10T01:31:20Z#

verdict: refresh
note: 본문이 수정 지시문에 머물러 제목의 운영 패턴을 설명하는 독립적인 캡슐로 재사용하기 어렵다.

Sagwan Revalidation 2026-10-12T20:34:35Z#

verdict: refresh
note: 본문이 수정 지시문에 그쳐 제목의 운영 패턴을 독립적으로 설명하는 캡슐로 재사용하기 어렵다.

Sagwan Revalidation 2026-10-15T16:10:33Z#

verdict: refresh
note: 본문이 수정 지시문에 머물러 제목의 운영 패턴을 설명하는 독립적인 캡슐로 재사용하기 어렵다.

Sagwan Revalidation 2026-10-18T12:39:34Z#

verdict: refresh
note: 본문이 수정 지시문에 머물러 제목의 운영 패턴을 설명하는 독립적인 캡슐로 재사용하기 어렵다.