82 lines
3.7 KiB
Markdown
82 lines
3.7 KiB
Markdown
---
|
|
title: blog-topic / jvm-oom-vs-container-oomkill-exit-137
|
|
source_type: blog-topic
|
|
status: raw
|
|
related_branches: [feature-container-runtime-contract]
|
|
related_projects: [ca-tmpl]
|
|
tags: [blog-topic, ca-tmpl, runtime, docker, kubernetes, graceful-shutdown]
|
|
created: 2026-07-02
|
|
status_label: ready-for-canonical
|
|
target_audience: backend-engineer
|
|
inspiration_url:
|
|
archive_url:
|
|
---
|
|
|
|
# blog-topic: jvm-oom-vs-container-oomkill-exit-137
|
|
|
|
> Layer: `raw/blog-topics/` — 작업 중 나온 블로그 글감 원석. 최종 블로그는 canonical 정제 후 `wiki/blog/`에서 작성한다.
|
|
|
|
## Parent / 부모
|
|
|
|
- [[raw/branch-notes/feature-container-runtime-contract]] — container runtime 계약과 OOM 137 구분 검증에서 나온 글감.
|
|
|
|
## 트리거 / Trigger
|
|
|
|
- 트리거 유형: `branch-work`
|
|
- 트리거 날짜: 2026-07-02
|
|
- 트리거 연결 노트: [[raw/branch-notes/feature-container-runtime-contract]]
|
|
|
|
## 글감 / Topic seed
|
|
|
|
- 한 문장 요지: JVM OOM과 container OOMKill이 모두 exit 137처럼 보일 때 heap dump/native stderr/runtime signal로 구분하는 방법을 정리한다.
|
|
- 예상 제목 후보:
|
|
- exit 137만 보고 JVM OOM과 OOMKill을 구분할 수 있을까
|
|
- container runtime에서 Java OOM을 관측 가능하게 만들기
|
|
|
|
## 핵심 주장 후보 / Claim candidates
|
|
|
|
- 사실 후보:
|
|
- branch가 JVM OOM과 kubelet/container OOMKill 구분을 blog seed로 남겼다 — 근거 후보: [[raw/branch-notes/feature-container-runtime-contract]] D5 section+line `:210-219`, blog seed `:331-335`, verification `:286`.
|
|
- 경험 후보:
|
|
- Docker runtime 검증 기록이 있어 운영 면접/블로그 소재로 확장 가능하다.
|
|
- 의견/해석 후보:
|
|
- exit code는 진단의 출발점일 뿐 원인 판정 근거가 아니다. JVM 내부 OOM과 외부 kill signal을 분리할 관측 자료가 필요하다.
|
|
|
|
## Outline seed
|
|
|
|
1. exit 137은 증상이지 원인이 아니다 — JVM process가 죽은 이유를 runtime 계층별로 나눠야 한다.
|
|
2. JVM OOM에는 JVM이 남길 수 있는 흔적이 있다 — heap dump, error log, stderr가 핵심 단서가 된다.
|
|
3. container OOMKill은 외부에서 죽인다 — runtime event와 memory limit 관측이 필요하다.
|
|
|
|
## Canonical 전환 후보 / Canonical extraction candidates
|
|
|
|
- `wiki/projects/ca-tmpl/runtime-container-health-migration.md` 후보:
|
|
- ca-tmpl container runtime OOM 관측 계약.
|
|
- `wiki/concepts/runtime-container-health-migration.md` 후보:
|
|
- JVM OOM과 container OOMKill 분리 일반 개념.
|
|
- 필요한 추가 검증:
|
|
- 실제 Docker/Kubernetes 재현 절차와 로그/exit code evidence.
|
|
|
|
## Sources / 근거 후보
|
|
|
|
- [[raw/branch-notes/feature-container-runtime-contract]] — D5, blog seed, verification 근거.
|
|
|
|
## 미해결 / Unknown
|
|
|
|
- 아직 확인해야 할 사실: Kubernetes 환경에서의 event/log evidence와 ca-tmpl 검증 범위.
|
|
- 과장하면 안 되는 부분: 운영 Kubernetes에서 검증된 장애 대응 경험처럼 쓰면 안 된다. local/Docker 검증과 운영 가정을 분리한다.
|
|
- 블로그로 쓰기 전에 필요한 canonical 정제: runtime project 문서의 evidence grade 확인.
|
|
|
|
## Decision / 처리 결정
|
|
|
|
- 액션: `promote-to-canonical`
|
|
- 이유: `wiki/projects/ca-tmpl/runtime-container-health-migration.md` 에 JVM OOM vs container OOMKill 글감으로 반영했다.
|
|
- 다음 단계: target canonical이 아직 `draft` 이므로 `blogify` 전 review/verify가 필요하다. 운영 Kubernetes 장애 대응 경험처럼 쓰지 않는다.
|
|
|
|
## Related / 관련
|
|
|
|
- 관련 branch: [[raw/branch-notes/feature-container-runtime-contract]]
|
|
- 관련 error:
|
|
- 관련 interview prep:
|
|
- derived blog: 생성 전. 생성 시 `wiki/blog/jvm-oom-vs-container-oomkill-exit-137-YYYY-MM-DD.md` 후보
|