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 = 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 { 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 } }