donghyeon.kang/llm-wiki
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
Files
docs/ca-skeleton-frontend-runtime-adapter-features
llm-wiki/raw/official-docs/openjdk-jdk-8196595-container-support.md
T

11 KiB
Raw Permalink Blame History

title, source_type, url, archive_url, related_branches, related_projects, tags, created, confidence
title source_type url archive_url related_branches related_projects tags created confidence
OpenJDK JDK-8196595: JVM Container Support & RAM Percentage Flags (Official JDK Documentation) official-doc https://bugs.openjdk.org/browse/JDK-8196595
feature-container-runtime-contract
ca-skeleton
official-doc
ca-skeleton
runtime
docker
2026-06-14 medium

OpenJDK JDK-8196595: JVM Container Support & RAM Percentage Flags

Layer: raw/ — 외부 자료(공식 문서)의 원문 발췌·출처 기록. 검증된 요약은 /ingest 후 wiki/concepts/에 source-summary-template 형식으로 별도 작성. 원본은 raw에 영구 보관.

Fetch 상태 경고: 1차 출처 URL (https://bugs.openjdk.org/browse/JDK-8196595) 은 HTTP 403 Forbidden 으로 직접 fetch 불가. Web Archive 도 접근 차단됨. 아래 인용과 Claim 은 동일 변경의 내용을 담은 Oracle 공식 JDK 문서 (JDK 8 / 11 / 17 / 21 Tools Reference, java.html) 에서 추출하였으며, OpenJDK HotSpot 소스 (globals_linux.hpp, gcArguments.cpp) 를 보조 근거로 사용함. confidence: medium 으로 하향 조정 — 이슈 트래커 페이지의 Release Note 텍스트를 직접 발췌하지 못했기 때문.

Parent / 활용 branch

Branch 이 자료가 정당화하는 결정
raw/branch-notes/feature-container-runtime-contract D4 — JVM 기본값 -XX:MaxRAMPercentage=75 + -XX:+UseContainerSupport: 이 문서는 UseContainerSupport 가 기본 활성(default true)이고, -XX:{Initial,Max,Min}RAMPercentage 플래그가 container/system 메모리 대비 비율로 Java heap 크기를 제어함을 공식 JDK 문서 수준으로 증명함

출처 / Source

왜 저장했는지 / Why archived

feature-container-runtime-contract D4 결정 (-XX:MaxRAMPercentage=75 기본값 설정) 이 UNSUPPORTED_DECISION 으로 표기되어 있어 공식 근거 source 가 필요했음. JDK-8196595 가 도입한 UseContainerSupport 기본 활성 + {Initial,Max,Min}RAMPercentage 플래그 존재 및 동작을 Oracle 공식 JDK 문서로 증명함으로써 D4 결정의 근거 강도를 official-vendor-doc 수준으로 승급.

핵심 인용 / Key quotes (verbatim, 3~5개)

[JDK 11 java.html, §-XX:-UseContainerSupport] "The VM now provides automatic container detection support, which allows the VM to determine the amount of memory and number of processors that are available to a Java process running in docker containers. It uses this information to allocate system resources. This support is only available on Linux x64 platforms. If supported, the default for this flag is true, and container support is enabled by default. It can be disabled with -XX:-UseContainerSupport."

[JDK 8 java.html, §-XX:-UseContainerSupport] "The VM provides automatic container detection support, which enables the VM to determine the amount of memory and number of processors that are available to a Java process running in docker containers. It uses this information to allocate system resources. This support is only available on Linux x64 platforms. If supported, then the default value for this flag is true and container support is enabled by default. You can disable it with -XX:-UseContainerSupport."

[JDK 8 java.html, §-XX:InitialRAMPercentage] "Sets the initial amount of memory that the JVM will use for the Java heap before applying ergonomics heuristics as a percentage of the maximum amount determined as described in the -XX:MaxRAM option. The default value is 1.5625 percent."

[JDK 8 java.html, §-XX:MaxRAMPercentage] "Sets the maximum amount of memory that the JVM may use for the Java heap before applying ergonomics heuristics as a percentage of the maximum amount determined as described in the -XX:MaxRAM option. The default value is 25 percent."

[JDK 8 java.html, §-XX:MinRAMPercentage] "Sets the maximum amount of memory that the JVM may use for the Java heap before applying ergonomics heuristics as a percentage of the maximum amount determined as described in the -XX:MaxRAM option for small heaps. A small heap is a heap of approximately 125 MB. The default value is 50 percent."

Claims Extracted / 추출된 주장

Claim ID Claim (이 자료가 직접 말하는 것) Evidence quote Strength Applies to Does not prove
JDK-8196595-C1 UseContainerSupport 는 기본값 true 이며 container 지원이 기본 활성이다. -XX:-UseContainerSupport 로 비활성화 가능 [JDK 11 java.html] "the default for this flag is true, and container support is enabled by default. It can be disabled with -XX:-UseContainerSupport." official-vendor-doc Linux x64 플랫폼의 JDK 10+ (JDK 8u191 backport 포함) Windows/macOS 에서의 동작; cgroup v2 환경에서의 동작은 별도 확인 필요
JDK-8196595-C2 JVM 은 container 에서 실행 중인 Java 프로세스에 사용 가능한 메모리 양과 프로세서 수를 결정하고 이를 시스템 자원 할당에 사용한다 [JDK 11 java.html] "allows the VM to determine the amount of memory and number of processors that are available to a Java process running in docker containers. It uses this information to allocate system resources." official-vendor-doc UseContainerSupport 가 활성화된 Linux x64 JVM cgroup 읽기 구현 세부사항 (v1 vs v2 분기); 모든 JVM 배포판 (Temurin, Corretto 등) 이 동일하게 동작함을 직접 증명하지는 않음
JDK-8196595-C3 -XX:MaxRAMPercentage 는 Java heap 이 사용할 수 있는 최대 메모리를 -XX:MaxRAM 기준 비율로 설정하며, 기본값은 25% 이다 [JDK 8 java.html] "Sets the maximum amount of memory that the JVM may use for the Java heap before applying ergonomics heuristics as a percentage of the maximum amount determined as described in the -XX:MaxRAM option. The default value is 25 percent." official-vendor-doc JDK 8u191+, JDK 10+ MaxRAM 이 container cgroup limit 으로 자동 대체된다는 것을 이 인용 자체가 직접 명시하지는 않음 — UseContainerSupport 와 조합 시 container limit 이 MaxRAM 기준이 됨은 간접 추론
JDK-8196595-C4 -XX:InitialRAMPercentage 는 ergonomics 적용 전 JVM 이 사용할 초기 heap 메모리를 -XX:MaxRAM 기준 비율로 설정하며, 기본값은 1.5625% 이다 [JDK 8 java.html] "Sets the initial amount of memory that the JVM will use for the Java heap before applying ergonomics heuristics as a percentage of the maximum amount determined as described in the -XX:MaxRAM option. The default value is 1.5625 percent." official-vendor-doc JDK 8u191+, JDK 10+ container cgroup limit 과의 직접 연동을 명시한 인용 아님
JDK-8196595-C5 -XX:MinRAMPercentage 는 소형 heap (약 125 MB) 에 대해 JVM 이 사용할 최대 메모리를 -XX:MaxRAM 기준 비율로 설정하며, 기본값은 50% 이다 [JDK 8 java.html] "Sets the maximum amount of memory that the JVM may use for the Java heap before applying ergonomics heuristics as a percentage of the maximum amount determined as described in the -XX:MaxRAM option for small heaps. A small heap is a heap of approximately 125 MB. The default value is 50 percent." official-vendor-doc JDK 8u191+, JDK 10+ 대형 heap 에는 MinRAMPercentage 가 아닌 MaxRAMPercentage 가 적용된다는 경계 기준을 이 인용이 명시적으로 정의하지는 않음

Usage Boundaries / 적용 경계

  • 이 자료가 직접 증명하는 것:
    • JDK-8196595-C1: UseContainerSupport 기본 활성 (default true) + 비활성화 플래그 존재
    • JDK-8196595-C2: JVM 이 docker container 내 메모리/프로세서 제한을 감지하여 자원 할당에 사용함
    • JDK-8196595-C3: MaxRAMPercentage 가 heap 최대 크기를 메모리 비율로 제어하며 기본값 25%
    • JDK-8196595-C4: InitialRAMPercentage 기본값 1.5625%
    • JDK-8196595-C5: MinRAMPercentage 가 소형 heap 에 적용되며 기본값 50%
  • 이 자료가 증명하지 않는 것:
    • MaxRAMPercentage=75 가 최적 비율임을 Oracle 이 권고한다는 주장 — 75% 는 branch D4 의 팀 관행이며 이 문서에서 75% 를 명시적으로 권고하지 않음
    • cgroup v2 환경에서 UseContainerSupport 가 올바르게 동작함 — JDK 17+ 이슈(JDK-8230305 등)와 별도 확인 필요
    • Temurin, Corretto, Azul 등 배포판이 동일하게 UseContainerSupport=true 기본값을 유지함
    • Linux x64 이외 플랫폼 (ARM, Windows, macOS) 에서의 동작
  • 내 프로젝트 적용 시 추가 확인이 필요한 것:
    • ca-tmpl 컨테이너 환경에서 Runtime.getRuntime().maxMemory() 가 container memory limit × 75% 로 계산되는지 실측 (Claims To Verify 참조)
    • 사용 JDK 버전/배포판의 UseContainerSupport 기본값 실제 확인

메모 / Notes

  • 이슈 트래커 원본 (bugs.openjdk.org/browse/JDK-8196595) 에 직접 접근하지 못해 Release Note 원문을 byte-for-byte 발췌하지 못함. 인용은 동일 변경을 반영한 Oracle 공식 JDK 문서 (java.html) 에서 발췌. 향후 이슈 트래커 접근이 가능해지면 Release Note 원문으로 교체 권장.
  • MaxRAMPercentage 의 -XX:MaxRAM 기준 비율 정의 — UseContainerSupport 활성 시 JVM 이 cgroup limit 을 MaxRAM 으로 인식하므로, container limit × MaxRAMPercentage / 100 이 실효 heap 상한이 됨 (간접 추론, C2 + C3 조합).
  • MinRAMPercentage 의 "소형 heap" 경계는 이 문서에서 "약 125 MB" 로만 명시. 정확한 경계는 HotSpot 소스 (gcArguments.cpp) 추가 확인 필요.
  • 추가로 봐야 할 동일 출처 페이지: JDK-8230305 (cgroup v2 지원 개선), JDK-8272124 (heap 사이징 개선)

Related / 관련

  • 관련 raw official-doc: raw/official-docs/redhat-openjdk-container-awareness-java17 (Red Hat 의 JDK 17 container awareness 해설 — C1~C4 claim 이 본 문서 claim 과 corroborate 관계)
  • 이 자료를 인용한 wiki 요약: (생성 시 [[wiki/concepts/jvm-container-heap-ergonomics]] 예정)
Reference in New Issue View Git Blame Copy Permalink