fix(compose): heap dump 경로를 컨테이너 메모리 한계 안의 tmpfs에 두지 않는다 #24
Closed
donghyeon.kang
wants to merge 0 commits from
claude/r9-compose-ops into main
pull from: claude/r9-compose-ops
merge into: :main
:main
:claude/r9-review-record-2
:docs/improve-review-budget
:claude/r9-objstore-exceptions
:claude/w2-be-flaky-ledger
:claude/r9-a-follow-ups
:claude/r9-b-claim-tx
:claude/w2-be-ci-perf-4
:claude/r9-review-record
:claude/r9-c-tests-build
:claude/r9-c-docs-body
:claude/r9-c-contracts
:claude/r9-compose-ops
:claude/r9-public-surface
:claude/r9-stale-names
:claude/r9-tx-timeouts
:claude/r9-env-keys
:claude/r9-arch-rules
:claude/w2-be-ci-perf-2
:claude/w2-be-ci-perf-2-wip
:claude/redteam-be-fixes-main
:claude/w2-be-ci-perf-e89fe7
:claude/redteam-be-fixes
:claude/t2a-backend-ci-451e3b
:claude/x3-messaging-library-1aa3fa
:claude/x2-grpc-library-43dd09
:claude/h3-backend-harness-34fc23
:claude/v1-vuln-fix-e089b9
:claude/i2-docs-merge-02df15
:claude/d2c-ops-docs-1-c22c9f
:claude/d2a-entry-docs-12a342
:claude/d2b-src-adr-d46d23
:claude/d2d-ops-docs-2-e40938
:claude/i1-layout-docs-merge-217f1e
:refactor/maturity-review-2026-11
:claude/t1-backend-layout-46973e
:claude/d1-docs-system-fd4a0f
:claude/integration-r9-f1bc5c
:claude/r9-g1-inbound-456713
:claude/r9-g3-migration-7ce36d
:claude/r9-g2-stomp-interceptor-f5675d
:claude/r9-g4-idempotency-c669be
:claude/manual-gap-fix-2-9b0fe2
:claude/r8-review-a-3851a7
:claude/integration-r8-a4196a
:claude/r8-f1-transport-errors-b21ebf
:claude/r8-f5-small-fixes-f40412
:claude/r8-f3-persistence-9e8157
:claude/r8-f2-arch-rules-60140e
:claude/r8-f4-idempotency-3a6a0f
:claude/manual-gap-fix-1-824a41
:claude/t4-2-manual-history-ids-9ac57c
:claude/t1-r10-review-d0ecc6
:claude/integration-r7
:claude/t5-idempotency-operation-id-9bd973
:claude/t3-error-codes-loglevel-fcf427
:claude/t1-baseline-7d623a
:claude/t2-circuit-breaker-2ff8df
:claude/t4-manual-history-ids-51889f
:claude/b3-docs-work-34a1dd
:claude/perf-assertions-fail-closed-c09414
:claude/improvement-manual-6ae516
:refactor/review-followup
No Reviewers
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
donghyeon.kang (동현 강)
Clear assignees
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: donghyeon.kang/clean-architecture-backend-template#24
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
무엇을, 왜
round9 리뷰 RR9-01-21(Medium)과 고치며 찾은 RR9-03-30(Medium)을 고친다.
compose.yaml은-XX:HeapDumpPath=/var/tmp/heap을 512m tmpfs로 붙였다. 컨테이너는mem_limit512m·swap 없음이고 힙은 그 75%다. tmpfs에 쓴 페이지는 같은 메모리 한계에 잡혀, OutOfMemoryError 때 덤프를 쓰다 OOM kill(137)이 났다. runbook이 기대하는 깨끗한 끝(코드 3)이 사라지고, 덤프가 써져도 컨테이너와 함께 사라졌다. Dockerfile 주석은 그 경로를 tmpfs로 붙이라고 했고, runbook은 없는 파일 이름(heapdump-<pid>.hprof)을 적었다.integrationTestlane은requires로 적은 클래스 넷만 고른다.ComposeMergeCharacterizationTest는 그 넷에 없어 돈 적이 없고,build.gradle은 그 lane 입력에 compose 파일을 선언해 돈다고 믿었다.고른 방법과 버린 대안
compose.yaml은 그 경로에 아무것도 붙이지 않는다. 루트가 읽기 전용이라 JVM은 파일을 못 만들고 바로 코드 3으로 끝난다. 덤프를 남기는 dev lane(named volumeheap-dumps)은 그대로다.scripts/verify-compose-profile-contracts.sh(PR 단계verifyComposeProfiles)가 모든 lane에서 그 경로의 tmpfs를 거절한다. 경로는 Dockerfile의-XX:HeapDumpPath에서 읽는다.runtime-jvm-oom.md「진단」,internal-error-spike.md)에 덤프를 남기는 법(Kubernetes는medium: Memory없는 emptyDir나 PV, dev lane은 volume)과 실제 파일 이름(java_pid<pid>.hprof)을 적었다.compose.yaml「No volume」 주석)과 다르다.verifyComposeProfiles가 18개 lane(off-local=기본,off-dev=기본+dev 포함)으로 이미 본다. lane에requires로 더하는 안은 같은 검사를 두 번 돌리는 것이라 버렸다.위험과 영향
docs/capability-status.md가 병렬 그룹 C 파일이라 그 묶음에 넘겼다.검증
desktop, 로그
~/r9-be-logs/b19-{red,probe,green2}.log.RED: 기준
ca1fbfde+ 검사 스크립트만으로:verifyComposeProfiles실패(기본 compose를 쓰는 lane마다 「heap dump path /var/tmp/heap as a tmpfs」).탐침(
eclipse-temurin:21-jdk-noble, 읽기 전용 루트, 메모리 192m·swap 없음,-Xmx96m으로 OutOfMemoryError):Unable to create /var/tmp/heap: Read-only file system, 코드 3GREEN(
--no-build-cache)::verifyComposeProfiles(18 lane),:app-bootstrap:integrationTest,repositoryContractTest,spotlessCheck— 71건 실패 0, skip 1, rc=0.노트북(main
fe0f8141병합 뒤):check-docs.py·check-work-docs.py·check-repo-layout.pyrc=0.리뷰어가 볼 곳
verify-compose-profile-contracts.sh의 9번 검사와HEAP_DUMP_PATH를 Dockerfile에서 읽는 줄.관련
docs/reviews/2026-11-12-round9-review/RR9-01-21, RR9-03-30.#28로 병합됐다(main
3d31896a). 이 PR의 head5a68b29c가 #28 브랜치에 merge 커밋으로 들어 있고, #28의 runnerpr / done이 그 합친 트리로 초록이었다. runner 대기를 줄이려고 이번만 쓴 방식이다(소유자 승인, 2026-11-13).Pull request closed