Compare commits
3
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
3fd10c3d48 | ||
|
|
2b6b9c1445 | ||
|
|
d9755bf995 |
@@ -1,9 +1,12 @@
|
||||
package buildlogic
|
||||
|
||||
import com.sun.management.OperatingSystemMXBean
|
||||
import org.gradle.api.logging.Logging
|
||||
import java.io.IOException
|
||||
import java.lang.management.ManagementFactory
|
||||
import java.nio.charset.StandardCharsets
|
||||
import java.nio.file.Files
|
||||
import java.nio.file.Path
|
||||
import java.util.concurrent.TimeUnit
|
||||
import java.util.regex.Pattern
|
||||
|
||||
@@ -14,6 +17,7 @@ object TestHeapPolicy {
|
||||
"Mach Virtual Memory Statistics:\\s*\\(page size of ([0-9]+) bytes\\)"
|
||||
)
|
||||
private val PAGE_COUNTER = Pattern.compile("Pages (free|inactive)\\s*:\\s*([0-9]+)\\.?")
|
||||
private val LINUX_MEMORY_COUNTER = Pattern.compile("(MemTotal|MemAvailable):\\s+([0-9]+)\\s+kB")
|
||||
|
||||
@JvmStatic
|
||||
fun calculateHeapMiB(availableBytes: Long, maxParallelForks: Int, maxWorkers: Int): Long {
|
||||
@@ -34,7 +38,8 @@ object TestHeapPolicy {
|
||||
|
||||
@JvmStatic
|
||||
fun readAvailableBytes(): Long {
|
||||
val availableBytes = if (System.getProperty("os.name").startsWith("Mac")) {
|
||||
val osName = System.getProperty("os.name")
|
||||
val availableBytes = if (osName.startsWith("Mac")) {
|
||||
val builder = ProcessBuilder("/usr/bin/vm_stat").redirectErrorStream(true)
|
||||
builder.environment()["LC_ALL"] = "C"
|
||||
try {
|
||||
@@ -66,7 +71,25 @@ object TestHeapPolicy {
|
||||
val operatingSystem = checkNotNull(ManagementFactory.getPlatformMXBean(OperatingSystemMXBean::class.java)) {
|
||||
"OperatingSystemMXBean free-memory observation is unavailable"
|
||||
}
|
||||
operatingSystem.freeMemorySize
|
||||
if (osName == "Linux") {
|
||||
val memInfo = try {
|
||||
Files.readString(Path.of("/proc/meminfo"), StandardCharsets.US_ASCII)
|
||||
} catch (failure: IOException) {
|
||||
throw IllegalStateException("Unable to read Linux available memory from /proc/meminfo", failure)
|
||||
}
|
||||
val jvmTotalBytes = operatingSystem.totalMemorySize
|
||||
val jvmFreeBytes = operatingSystem.freeMemorySize
|
||||
val available = resolveLinuxAvailableBytes(memInfo, jvmTotalBytes, jvmFreeBytes)
|
||||
Logging.getLogger(TestHeapPolicy::class.java).lifecycle(
|
||||
"Test memory (Linux): JVM total={} MiB, JVM free={} MiB, effective available={} MiB",
|
||||
jvmTotalBytes / MIB,
|
||||
jvmFreeBytes / MIB,
|
||||
available / MIB
|
||||
)
|
||||
available
|
||||
} else {
|
||||
operatingSystem.freeMemorySize
|
||||
}
|
||||
}
|
||||
check(availableBytes > 0) {
|
||||
"Available-memory observation must be positive: availableBytes=$availableBytes"
|
||||
@@ -74,6 +97,41 @@ object TestHeapPolicy {
|
||||
return availableBytes
|
||||
}
|
||||
|
||||
internal fun resolveLinuxAvailableBytes(memInfo: String, jvmTotalBytes: Long, jvmFreeBytes: Long): Long {
|
||||
var hostTotalBytes = -1L
|
||||
var hostAvailableBytes = -1L
|
||||
try {
|
||||
for (rawLine in memInfo.lineSequence()) {
|
||||
val line = rawLine.trim()
|
||||
if (line.startsWith("MemTotal:") || line.startsWith("MemAvailable:")) {
|
||||
val counter = LINUX_MEMORY_COUNTER.matcher(line)
|
||||
require(counter.matches()) { "Malformed Linux memory counter: $line" }
|
||||
val bytes = Math.multiplyExact(counter.group(2).toLong(), 1024L)
|
||||
if (counter.group(1) == "MemTotal") {
|
||||
require(hostTotalBytes < 0) { "Duplicate Linux MemTotal counter" }
|
||||
hostTotalBytes = bytes
|
||||
} else {
|
||||
require(hostAvailableBytes < 0) { "Duplicate Linux MemAvailable counter" }
|
||||
hostAvailableBytes = bytes
|
||||
}
|
||||
}
|
||||
}
|
||||
} catch (failure: NumberFormatException) {
|
||||
throw IllegalArgumentException("Linux memory counters exceed the supported long range", failure)
|
||||
} catch (failure: ArithmeticException) {
|
||||
throw IllegalArgumentException("Linux memory counters exceed the supported long range", failure)
|
||||
}
|
||||
require(hostTotalBytes > 0 && hostAvailableBytes >= 0 && hostAvailableBytes <= hostTotalBytes) {
|
||||
"Linux /proc/meminfo requires positive MemTotal and MemAvailable within that total"
|
||||
}
|
||||
check(jvmTotalBytes > 0) { "JVM total-memory observation must be positive" }
|
||||
if (jvmTotalBytes < hostTotalBytes) {
|
||||
check(jvmFreeBytes >= 0) { "Container free-memory observation must not be negative" }
|
||||
return minOf(hostAvailableBytes, jvmFreeBytes, jvmTotalBytes)
|
||||
}
|
||||
return hostAvailableBytes
|
||||
}
|
||||
|
||||
internal fun parseMacVmStat(output: String): Long {
|
||||
var pageSize = -1L
|
||||
var freePages = -1L
|
||||
|
||||
@@ -0,0 +1,109 @@
|
||||
package buildlogic
|
||||
|
||||
import org.junit.jupiter.api.Assertions.assertEquals
|
||||
import org.junit.jupiter.api.Assertions.assertThrows
|
||||
import org.junit.jupiter.api.DynamicTest
|
||||
import org.junit.jupiter.api.DynamicTest.dynamicTest
|
||||
import org.junit.jupiter.api.Test
|
||||
import org.junit.jupiter.api.TestFactory
|
||||
|
||||
class LinuxAvailableMemoryTest {
|
||||
@Test
|
||||
fun shouldUseReclaimableHostMemoryInsteadOfTheReportedJenkinsFreeMemory() {
|
||||
val available = TestHeapPolicy.resolveLinuxAvailableBytes(memInfo(), 16 * GIB, 1315 * MIB)
|
||||
|
||||
assertEquals(10 * GIB, available)
|
||||
assertEquals(3840L, TestHeapPolicy.calculateHeapMiB(available, 1, 1))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun shouldAllowHostMemoryWhenJvmTotalIsLargerThanProcTotal() {
|
||||
assertEquals(10 * GIB, TestHeapPolicy.resolveLinuxAvailableBytes(memInfo(), 16 * GIB + 4096, 1315 * MIB))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun shouldNotTreatZeroHostFreePagesAsZeroAvailableMemory() {
|
||||
assertEquals(10 * GIB, TestHeapPolicy.resolveLinuxAvailableBytes(memInfo(), 16 * GIB, 0))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun shouldCapAvailableMemoryByRecognizedContainerHeadroom() {
|
||||
assertEquals(3 * GIB, TestHeapPolicy.resolveLinuxAvailableBytes(memInfo(), 4 * GIB, 3 * GIB))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun shouldRespectHostPressureEvenWhenTheContainerHasMoreHeadroom() {
|
||||
assertEquals(GIB, TestHeapPolicy.resolveLinuxAvailableBytes(memInfo(availableKiB = GIB / 1024), 4 * GIB, 3 * GIB))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun shouldNeverExceedTheRecognizedContainerTotal() {
|
||||
assertEquals(4 * GIB, TestHeapPolicy.resolveLinuxAvailableBytes(memInfo(), 4 * GIB, 8 * GIB))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun shouldPreserveZeroAvailableMemoryWithoutFallingBackToHostFree() {
|
||||
assertEquals(0L, TestHeapPolicy.resolveLinuxAvailableBytes(memInfo(availableKiB = 0), 16 * GIB, 1315 * MIB))
|
||||
assertEquals(0L, TestHeapPolicy.resolveLinuxAvailableBytes(memInfo(), 4 * GIB, 0))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun shouldRejectUnknownRemainingMemoryForARecognizedContainerLimit() {
|
||||
assertThrows(IllegalStateException::class.java) {
|
||||
TestHeapPolicy.resolveLinuxAvailableBytes(memInfo(), 4 * GIB, -1)
|
||||
}
|
||||
}
|
||||
|
||||
@TestFactory
|
||||
fun shouldRejectUnknownJvmTotalMemory(): List<DynamicTest> = listOf(0L, -1L).map { total ->
|
||||
dynamicTest("JVM total $total") {
|
||||
assertThrows(IllegalStateException::class.java) {
|
||||
TestHeapPolicy.resolveLinuxAvailableBytes(memInfo(), total, GIB)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@Test
|
||||
fun shouldParseReorderedKiBCountersWithoutAddingCachedOrSwapPages() {
|
||||
val input = "MemAvailable:\t3072 kB\nCached: 999999 kB\nSwapFree: 999999 kB\n MemTotal: 4096 kB\n"
|
||||
assertEquals(3 * MIB, TestHeapPolicy.resolveLinuxAvailableBytes(input, 4 * MIB, MIB))
|
||||
}
|
||||
|
||||
@TestFactory
|
||||
fun shouldRejectMissingDuplicateMalformedOrOverflowingProcCounters(): List<DynamicTest> {
|
||||
val valid = memInfo()
|
||||
return listOf(
|
||||
"",
|
||||
"MemTotal: 16777216 kB\n",
|
||||
"MemAvailable: 10485760 kB\n",
|
||||
valid + "MemTotal: 16777216 kB\n",
|
||||
valid + "MemAvailable: 10485760 kB\n",
|
||||
valid.replace("16777216 kB", "0 kB"),
|
||||
valid.replace("10485760 kB", "16777217 kB"),
|
||||
valid.replace("10485760 kB", "-1 kB"),
|
||||
valid.replace("10485760 kB", "1.5 kB"),
|
||||
valid.replace("10485760 kB", "invalid kB"),
|
||||
valid.replace("10485760 kB", "10485760 MB"),
|
||||
valid.replace("10485760 kB", "10485760"),
|
||||
valid.replace("10485760 kB", "10485760 kB trailing"),
|
||||
valid.replace("16777216 kB", "9223372036854775808 kB"),
|
||||
valid.replace("10485760 kB", "9223372036854775808 kB"),
|
||||
valid.replace("16777216 kB", "9007199254740992 kB"),
|
||||
valid.replace("10485760 kB", "9007199254740992 kB")
|
||||
).map { input ->
|
||||
dynamicTest("rejects ${input.replace('\n', ' ')}") {
|
||||
assertThrows(IllegalArgumentException::class.java) {
|
||||
TestHeapPolicy.resolveLinuxAvailableBytes(input, 16 * GIB, GIB)
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
private fun memInfo(availableKiB: Long = 10 * GIB / 1024): String =
|
||||
"MemTotal: 16777216 kB\nMemFree: 1346560 kB\nMemAvailable: $availableKiB kB\n"
|
||||
|
||||
companion object {
|
||||
private const val MIB = 1_048_576L
|
||||
private const val GIB = 1_073_741_824L
|
||||
}
|
||||
}
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
- 작성일: 2026-11-18
|
||||
- 기준: [prd.md](prd.md)
|
||||
- 상태: P6 buildSrc Kotlin 통일, 58개 정책/33개 focused/lint/API/리뷰 검증 및 정리 완료. 실제 Jenkins와 전체 suite 재실행은 미수행.
|
||||
- 상태: P7 Linux 메모리 관측 수정·86개 테스트·lint·root 구성 검증·리뷰 승인·정리 완료. 실제 Jenkins와 전체 suite 재실행은 미수행.
|
||||
- 활성 Goal: 없음
|
||||
|
||||
## P1-T1: 실패 원인 재현과 최소 테스트 수정
|
||||
@@ -236,7 +236,29 @@
|
||||
- 독립 P6 리뷰 APPROVE: 계산식/OS reader/parser·예외·프로세스 종료와 58개 case 보존, static API 및 buildSrc Kotlin 설정을 확인했다. `git diff --check` 통과, 소유 테스트 worker 없음 확인. 노트와 owned temp root를 제거했다.
|
||||
- P6에서 전체 앱 테스트나 실제 Jenkins/AWS 실행은 수행하지 않았다. commit/push도 수행하지 않았다. 기존 P5의 비율 정책과 앱 Kotlin 1.6.21은 유지했다.
|
||||
|
||||
## P7: Linux MemAvailable와 JDK 인식 cgroup 상한
|
||||
- 승인된 수정 범위: `buildSrc/src/main/kotlin/buildlogic/TestHeapPolicy.kt`, Linux parser/resolver 회귀 테스트, 실행 가이드와 기존 작업 문서. 앱 테스트/운영 로직/힙 비율/cache/fork/parallel/commit/push는 변경하지 않는다.
|
||||
- 관측: 실제 Jenkins는 가용 1315MiB → 힙 493MiB를 선택했고 AdminMemberServiceTest 실행 중 OOM이 발생했다. 최초 OOM 세부 메시지와 실제 MemAvailable/cgroup 원본은 아직 제공되지 않아 원격 자원 여유량·전체 성공을 추정하지 않는다.
|
||||
- Java17 OpenJDK 소스에서 컨테이너 인식 시 total은 유효 제한, free는 제한-사용량이며 미인식 시 host 지표로 돌아감을 확인했다. 따라서 host MemAvailable와 JVM free의 min을 무조건 취하지 않고, JVM total < host MemTotal인 경우에만 제한을 적용한다.
|
||||
- [x] MemFree는 작고 MemAvailable는 큰 host fixture 및 quota가 더 작은 fixture를 기존 free-only 동작에서 RED로 확인.
|
||||
- [x] MemTotal/MemAvailable kB 파싱과 quota resolver 구현. 누락·중복·잘못된 단위/숫자/overflow·관측 실패 경계를 검증.
|
||||
- [x] 기존 58개 정책/OS 테스트와 새 Linux 테스트 GREEN, Kotlin lint 및 root 연결 검증.
|
||||
- [x] 단일 gate 리뷰, 사용자 진단 로그/제약 문서, 소유 temp 정리.
|
||||
- fixture 기반 Linux 검증과 실제 macOS Gradle 연결 결과를 실제 Jenkins/AWS 실행과 구분한다. JVM이 인식하지 못한 cgroup을 완전히 탐지한다고 주장하지 않는다.
|
||||
- RED: Linux 분기를 분리하되 기존 JVM free-only 반환을 유지한 상태에서 `./gradlew --no-daemon --offline -p buildSrc test --tests 'buildlogic.*' --console=plain` 실행. exit 1/16초, 86개 중 새 Linux 회귀 24개 실패. 기존 58개는 유지됐다. Host MemAvailable 사용·컨테이너/host pressure cap·잘못된 proc 카운터 거부의 누락을 확인했다.
|
||||
- 구현은 Linux의 MemTotal/MemAvailable만 엄격하게 kB 단위로 파싱하고, JVM total이 host total보다 작을 때만 JVM free/total로 상한한다. quota 여유 0을 host 값으로 덮지 않는다. 실제 Linux 실행 시 JVM total/free/effective available 진단 로그를 남긴다.
|
||||
- GREEN: `./gradlew --no-daemon --offline -p buildSrc test --tests 'buildlogic.*' ktlintCheck --console=plain`, exit 0/33초. 기존 58개와 Linux 28개를 합친 86개 통과, buildSrc script/main/test lint 통과. Host MemFree=1315MiB지만 MemAvailable=10GiB인 테스트 fixture는 10GiB를 선택해 힙 3840MiB를 계산한다. 이는 실제 Jenkins의 MemAvailable 측정값이 아니다.
|
||||
- root 연결 확인: `./gradlew --no-daemon --offline help ktlintKotlinScriptCheck --console=plain`, exit 0/35초. 공개 API를 참조하는 root Kotlin DSL과 buildSrc classpath 구성이 정상 로딩되고 root script lint가 통과했다. root 앱 테스트/worker를 실행한 검증과 구분한다.
|
||||
- 사용자 요청에 따라 실행 가이드에 Jenkins `clean build` 명령을 기록했다. 기존 Gradle JVM 2GB/Metaspace768MB와 worker1은 유지하고 `--no-parallel`, `--console=plain`만 명시적으로 추가한다. 테스트 heap은 코드가 산정하며 별도 미구현 CLI 옵션을 제시하지 않는다.
|
||||
- XML로 기존 정책 58개와 Linux 회귀 28개 모두 failures/errors/skipped 0을 확인했다. `git diff --check` 통과, 소유 테스트 worker 없음 확인. 임시 노트·owned root는 제거하며 기존 Gradle/IDE 프로세스는 건드리지 않는다.
|
||||
- 독립 P7 리뷰 APPROVE: Linux kB 파싱, recognized quota/host pressure 제한, zero 보존, 기존 비율 정책 유지와 원격 미검증 한계를 확인했다. 노트·owned root 삭제와 부재 확인 완료. commit/push는 수행하지 않았다.
|
||||
|
||||
## 커밋 전 검증 (2026-11-19)
|
||||
- 사용자 `/commit-with-validation` 요청으로 P5/P6 변경을 커밋한다.
|
||||
- `./gradlew --no-daemon --offline -p buildSrc test --tests 'buildlogic.TestHeapPolicyTest' --rerun ktlintCheck --console=plain` exit 0/9초. 정책 테스트를 재실행해 XML의 58 tests/0 failures/0 errors/0 skipped를 확인했다. buildSrc lint는 UP-TO-DATE였다.
|
||||
- 이번 커밋 검증에서 root focused test와 실제 Jenkins/AWS 실행은 반복하지 않았다. 전체 앱 테스트도 미실행이며 사용자 실행 명령은 `./gradlew test`다.
|
||||
|
||||
## P7 커밋 전 검증 (2026-11-19)
|
||||
- 사용자 `/commit-with-validation` 요청으로 Linux 메모리 관측 변경과 관련 문서를 커밋한다.
|
||||
- `./gradlew --no-daemon --offline -p buildSrc test --tests 'buildlogic.*' --rerun ktlintCheck --console=plain` exit 0/8초. XML에서 기존 정책 58개와 Linux 회귀 28개, 총 86개 tests/0 failures/0 errors/0 skipped를 확인했다. buildSrc lint는 UP-TO-DATE였다.
|
||||
- `git diff --check` 통과. 실제 Jenkins/Linux 환경 실행과 전체 앱 테스트는 미실행이며 사용자 전체 테스트 명령은 `./gradlew test`다.
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# 번역 및 관리자 오디오 테스트 수정
|
||||
|
||||
- 작성일: 2026-11-18
|
||||
- 상태: P6 buildSrc Kotlin 통일 완료. 정책 58개/focused 33개/lint/API/리뷰 통과. 실제 Jenkins와 전체 suite는 P6 후 미실행.
|
||||
- 상태: P7 Linux 메모리 관측 수정·86개 테스트·lint·root 구성 검증·리뷰 승인·정리 완료. 실제 Jenkins와 전체 suite는 P7 후 미실행.
|
||||
- 구현 계획: [plan-task.md](plan-task.md)
|
||||
|
||||
## 목표와 범위
|
||||
@@ -49,3 +49,9 @@
|
||||
- Java helper/test를 Kotlin 소스로 이동하고 중복 Java 파일을 제거한다. 현재 P5 계산식·OS 관측·오류·자원 정리와 58개 테스트 케이스를 보존한다.
|
||||
- buildSrc에는 Gradle 8.1.1에 맞는 `kotlin-dsl`을 적용하고 Java 17/JUnit 5.8.2를 유지한다. 앱의 Kotlin 1.6.21 버전과 운영 코드, root Test 정책은 변경하지 않는다.
|
||||
- public static 호출 호환성과 실제 루트 Gradle 연결을 검증한다. commit/push와 전체 앱 suite 자동 실행은 제외한다.
|
||||
|
||||
## 추가 승인: Linux 가용 메모리 관측 보정
|
||||
- Jenkins에서 `available estimate=1315 MiB, maxHeap=493 MiB` 선택 뒤 실제 OOM이 보고됐다. 사용자가 Linux MemAvailable와 cgroup 제한을 반영하는 수정에 동의했다.
|
||||
- Linux는 `/proc/meminfo`의 MemAvailable를 사용한다. JDK가 보고한 total memory가 proc MemTotal보다 작으면 JDK가 인식한 제한으로 판단하고, 그 free memory와 total memory를 넘지 않도록 가용량을 제한한다.
|
||||
- cgroup v1/v2 파싱을 새로 만들지 않고 Java 17의 컨테이너 인식 API를 재사용한다. `UseContainerSupport` 비활성화·미지원/발견 실패·일부 상위 계층 제한은 JDK 인식 범위를 벗어날 수 있음을 명시한다.
|
||||
- 고정 4GiB 하한을 복원하거나 힙 비율·캐시·worker 정책을 변경하지 않는다. 작은 실제 예산에서도 모든 테스트가 성공한다는 보장은 하지 않는다. 실제 Jenkins 성공 여부는 원격 재실행 전까지 미검증이다.
|
||||
|
||||
@@ -47,16 +47,34 @@
|
||||
## 테스트 메모리와 진행 진단
|
||||
- IntelliJ의 `Build, Execution, Deployment > Build Tools > Gradle > Run tests using`을 `Gradle`로 맞추면 CLI와 같은 테스트 JVM 설정을 사용한다. IDE 자체 JUnit runner는 Gradle의 heap/worker 설정을 적용하지 않는다.
|
||||
- 테스트 JVM heap은 Test task 실행 직전에 가용 메모리로 계산한다. 가용 추정의 50%를 유효 동시 worker 수(`min(maxParallelForks, maxWorkers)`)로 나누고, 그 worker 예산의 25%를 힙 외 용도로 남긴다. 나머지 75%를 MiB 단위로 내려 명시적 `maxHeapSize`로 전달한다. 고정 4GiB 정책 하한이나 고정 1GiB 예약은 사용하지 않는다. 단, JVM 실행 자체가 불가능한 2MiB 미만 결과는 상향 보정하지 않고 명시적으로 거부한다.
|
||||
- macOS 가용 추정은 `vm_stat`의 `(Pages free + Pages inactive) × page size`이며 speculative/file-backed를 별도로 더하지 않는다. 다른 OS는 JDK의 free-memory 관측값을 보수적으로 사용하므로 회수 가능한 캐시를 충분히 반영하지 못할 수 있다. 가용 추정은 OS의 할당 보장이 아니며 다른 앱의 이후 사용량도 예측하지 못한다.
|
||||
- macOS 가용 추정은 `vm_stat`의 `(Pages free + Pages inactive) × page size`이며 speculative/file-backed를 별도로 더하지 않는다. Linux는 `/proc/meminfo`의 `MemAvailable`을 사용해 회수 가능한 메모리를 반영한다. `MemTotal`과 `MemAvailable`은 kB(1024 bytes)로 읽고 잘못되거나 누락된 값은 추정으로 대체하지 않는다.
|
||||
- Linux에서 JDK의 total memory가 host `MemTotal`보다 작으면 JDK가 인식한 더 작은 제한으로 판단한다. 이 경우에만 host `MemAvailable`, JDK free memory, JDK total memory 중 가장 작은 값을 사용한다. cgroup v1/v2는 Java 17의 컨테이너 인식에 의존하며, `UseContainerSupport` 비활성화·발견 실패·미지원 구성이나 JDK가 인식하지 못한 상위 제한까지 탐지한다고 보장하지 않는다.
|
||||
- macOS/Linux 외에는 JDK의 free-memory 값을 보수적으로 사용한다. 모든 관측은 시작 시점의 추정이며 이후 사용량 변화나 앱 테스트에 충분한 메모리를 보장하지 않는다.
|
||||
- 콘솔의 `Test heap:`에서 관측값·유효 worker 수·선택한 상한을 확인한다. task 시작 때 한 번 계산하며 교체된 worker도 동일한 상한을 사용한다. 메모리 부족 오류가 나면 다른 프로그램/중복 테스트를 정리한 뒤 다시 실행한다. 기존 `maxHeapSize`만 지워 Gradle 기본 512MB로 돌아가거나, 비율 옵션만 추가하는 방식은 사용하지 않는다.
|
||||
- Linux는 `Test memory (Linux):`에 JVM total/free와 최종 가용량도 기록한다. Jenkins 메모리 문제를 조사할 때 이 줄과 `Test heap:`, 최초 OOM 전체 메시지를 함께 확인한다. 전체 빌드 명령의 `org.gradle.jvmargs`는 Gradle JVM 설정이며 테스트 worker heap과 별개다.
|
||||
- 예를 들어 관측값 2,460,004,352 bytes와 worker 1개는 879MiB 힙을 선택한다. 4GiB 미만이라는 이유만으로 중단하지 않지만, 선택된 예산이 앱 테스트의 실제 메모리 요구량보다 작으면 JVM에서 OOM이 발생할 수 있다. 계산 성공을 전체 테스트 통과 보장으로 해석하지 않는다.
|
||||
- 동시 worker 1개, Spring context 캐시 최대 4개, 50개 테스트 클래스마다 worker 교체는 유지한다. 클래스 수 기준이므로 단일 클래스의 과도한 사용까지 방지하지는 않는다. Gradle daemon heap과 테스트 worker heap은 별개다. 같은 저장소의 전체 테스트를 IDE와 CLI/에이전트에서 동시에 시작하지 않는다.
|
||||
- 실행 콘솔의 `Test class:`는 클래스 시작 위치이며 완료 또는 성공 표시가 아니다. 최종 종료 코드와 `build/test-results/test/`의 해당 실행 XML을 함께 확인한다.
|
||||
- GC 로그는 `build/test-gc/<task 이름>/gc-<PID>.log`에 기록한다. PID별 10MB 파일과 회전 로그 최대 3개를 사용한다. 오래된 실행 로그는 조사 후 정리한다.
|
||||
- 후반에 진행이 멈추면 해당 worker PID의 `jstat -gcutil <PID>`와 GC 로그를 확인한다. Old 사용률이 높고 Full GC 시간만 증가하는 상태에서는 실행 제한만 늘리지 않는다. 타인이 시작한 worker는 승인 없이 종료하지 않는다.
|
||||
- 힙 예산 build logic를 변경하면 `./gradlew --no-daemon -p buildSrc test --tests 'buildlogic.TestHeapPolicyTest'`로 산정·파싱 경계를 검증한다. 이 테스트는 애플리케이션의 root `test`와 별도이며, 일반 root 실행에서 buildSrc 컴파일만 됐다고 테스트까지 통과한 것으로 보지 않는다.
|
||||
- 힙 예산 build logic를 변경하면 `./gradlew --no-daemon -p buildSrc test --tests 'buildlogic.*'`로 산정·OS 파싱·Linux/container 경계를 검증한다. 이 테스트는 애플리케이션의 root `test`와 별도이며, 일반 root 실행에서 buildSrc 컴파일만 됐다고 테스트까지 통과한 것으로 보지 않는다.
|
||||
- 힙 정책과 테스트는 `buildSrc/src/main/kotlin/buildlogic/TestHeapPolicy.kt`, `buildSrc/src/test/kotlin/buildlogic/TestHeapPolicyTest.kt`에 둔다. buildSrc는 Gradle 버전에 맞는 `kotlin-dsl`과 Java 17 toolchain을 사용하며 앱의 Kotlin 버전과 별도로 관리한다. 해당 Kotlin 소스의 포맷 검사는 `./gradlew --no-daemon -p buildSrc ktlintCheck`로 실행한다.
|
||||
|
||||
## Jenkins 전체 빌드 명령
|
||||
수정된 build logic가 Jenkins workspace에 반영된 뒤 아래 명령을 사용한다. 테스트를 생략하지 않으며, Gradle JVM의 2GB 한도와 테스트 worker의 자동 힙 산정은 별개다.
|
||||
|
||||
```bash
|
||||
./gradlew clean build \
|
||||
--no-daemon \
|
||||
--no-parallel \
|
||||
--max-workers=1 \
|
||||
--console=plain \
|
||||
--stacktrace \
|
||||
'-Dorg.gradle.jvmargs=-Xmx2048m -XX:MaxMetaspaceSize=768m -Dfile.encoding=UTF-8'
|
||||
```
|
||||
|
||||
별도의 테스트 heap 옵션은 필요하지 않다. Linux에서는 `Test memory (Linux):`와 `Test heap:` 두 로그를 함께 확인한다. 이 명령은 Jenkins/사용자의 전체 검증용이며 에이전트가 자동 실행하는 명령이 아니다.
|
||||
|
||||
## AWS 의존성 확인
|
||||
|
||||
기존 SDK v1은 유지하고 Comprehend/Translate만 SDK v2 BOM `2.57.11`을 사용한다. 기본 동기 HTTP runtime은 전이 의존성이다.
|
||||
|
||||
Reference in New Issue
Block a user