test(mongo): TLS lane 거절을 첫 handshake 실패로 판정하고 mongod 하나를 없앤다 #79

Merged
donghyeon.kang merged 2 commits from test/mongo-tls-lane-handshake-refusal into main 2026-11-21 08:58:06 +00:00
Owner

무엇을, 왜

REV-BE-0043. MongoTlsLaneTest가 lane(mongoSecurityIntegrationTest) 시간의 절반 넘게 기다림에 쓴다.

  1. 거절 셋(믿지 않는 CA, 이름 불일치, 만료 뒤)은 TLS handshake가 ms 안에 실패해도 command가 서버 선택 timeout 10 s를 다 기다린 뒤에야 던진다. driver-core 5.6.5 BaseCluster.selectServer의 루프는 「드라이버 비호환」과 「timeout」에서만 끝난다.
  2. 만료 시험은 5 s마다 새 연결을 연다.
  3. 「다른 CA」 PEM 하나를 얻으려고 mongod를 하나 더 띄워 rs.initiate까지 한다.

덤으로 지금 단언 isInstanceOf(RuntimeException.class)는 컨테이너가 죽어도 참이다.

이 PR은:

  • 거절 판정을 client의 server monitor에서 받는다. cause 사슬에 CertificateException이 있는 첫 heartbeat 실패가 거절, CONNECTED description이 수락이다. 인증서를 판정하지 않은 실패(소켓 지연·끊김)는 기록만 하고 500 ms heartbeat로 다시 시도한다. 10 s는 상한으로만 남고, 그 안에 판정이 없으면 거절로 세지 않고 AssertionError로 실패한다.
  • 거절 셋은 원인별 root cause를 단언한다: 경로 빌드 실패(CertPathBuilderException, "unable to find valid certification path to requested target"), 이름 불일치(정확히 CertificateException, 메시지에 접속 host), 만료(CertificateExpiredException, "NotAfter:"로 시작).
  • 「다른 CA」는 server 컨테이너 안 openssl 한 번으로 만든다(MongoTlsReplicaSetContainer.unrelatedAuthorityPem(), subject /CN=unrelated-ca). 두 번째 mongod를 지운다.
  • 만료 poll 5 s → 1 s. 45 s 창은 그대로다.
  • 고친 세 메서드의 @DisplayName은 시험 규칙 2대로 한국어다. 고치지 않은 aTrustedAuthorityConnects는 그대로다.

고른 방법과 버린 대안

거절은 heartbeat 이벤트에서, 수락은 description에서 받는다. 근거(driver-core 5.6.5):

  • DefaultServerMonitor$ServerMonitor.setupNewConnectionAndGetInitialDescription은 Exception을 잡아 logAndNotifyHeartbeatFailed를 부른다 → 실패는 시도마다 heartbeat 이벤트로 온다. 성공한 첫 handshake는 heartbeat 이벤트가 없어서 수락은 description(CONNECTED)에서 본다.
  • lookupServerDescription은 예외를 unknownConnectingServerDescription으로 바꾸고, EventHelper.wouldDescriptionsGenerateEquivalentEvents는 바깥 예외의 class와 message만 비교한다 → 소켓 끊김과 인증서 거절이 같은 MongoSocketWriteException: Exception sending message로 겹치면 두 번째 description 이벤트가 오지 않는다. 그래서 첫 serverDescriptionChanged의 예외만 보는 안(항목 「고칠 방향」 1의 첫 형태)을 버렸다.

버린 안:

  • 거절 client만 서버 선택 timeout을 1~2 s로 줄이기 — 부하에 handshake가 느리면 「믿는데도 timeout」이 거절로 셈해진다(항목).
  • 검증 날짜를 미래로 돌린 TrustManager로 만료 대기 없애기 — 시험 경로가 실제 시계·운영 설정과 멀어진다(항목).
  • 「다른 CA」를 같은 subject로 만들기 — JDK PKIXValidator는 trust anchor subject가 issuer와 같으면 경로 빌드 대신 경로 검증으로 가서 root가 서명 검사 실패가 된다(첫 리뷰 High). 이름이 다른 CA로 「믿는 CA가 서명하지 않은 서버」를 만든다.
  • 시험끼리 컨테이너 나눠 쓰기 — 항목 범위 밖.

위험과 영향

  • 기준 2(두 거절 시험 각 5 s 미만) 그대로는 못 채움. 아래 「기준 2」. 넘친 몫은 컨테이너 준비이고 판정은 0.02 s 이하다.
  • 같은 이름·다른 키 CA(교체된 CA)의 서명 검사 실패 경로는 어느 시험도 세우지 않는다. 옛 시험이 그 경우였지만 RuntimeException만 단언했다. 따로 세우려면 컨테이너가 하나 더 들어 완료 기준(6 → 5)과 부딪친다. 시험 주석에 적었다.
  • 단언이 Sun provider 문구와 JDK 예외 사슬 모양에 기댄다. provider·JDK가 바뀌면 RED로 닫힌다(통과 쪽으로 열리지 않는다). driver가 바뀌어 heartbeat 실패 이벤트가 오지 않아도 10 s 상한에서 RED다.
  • 이 lane은 integrationCheck(main·nightly)에서만 돈다(docs/work/reference/gates.md 1절). PR run은 돌리지 않으므로 아래 desktop 결과가 이 lane의 PR 증거다.
  • 바꾸지 않은 것: 45 s 창, MongoSecurityIntegrationLaneTest, lane 설정(build.gradle), 운영 client 설정.

검증

완료 기준

  • 기준 1(3회 중앙값 25 s 이상 단축): 충족 — 중앙값 벽시계 −31.0 s, XML −31.3 s.
  • 컨테이너 6 → 5: 충족.
  • 기준 2(두 거절 시험 각 5 s 미만): 그대로는 못 채움. 판정 구간 (ii)는 0.02 s 이하이고 넘친 몫은 (i) 컨테이너 준비다(아래 「기준 2」의 세 구간 값).
  • RED 변이 둘, 빈 구간 두 번의 판정(docker 쪽)은 아래.

측정 방법

desktop, runner job이 없을 때만, ./gradlew :adapter:outbound:persistence-mongo:mongoSecurityIntegrationTest --rerun --no-build-cache --console=plain(daemon 끔). base = 96c0b4c7, new = 측정 트리 d1ae23e4.

기준 1 — 3회 중앙값 25 s 이상 단축: 충족

base/new 번갈아 3+3회. XML = 두 클래스 time 합. 6회 모두 rc=0, 실패 0.

회 base 벽시계 base XML new 벽시계 new XML
1 108.9 94.5 79.5 65.1
2 128.5 97.4 70.9 56.2
3 105.4 90.6 77.9 63.1
중앙값 108.9 94.5 77.9 63.1

차이: 벽시계 31.0 s, XML 31.3 s.

시험별(JUnit XML time, s, 1/2/3회):

만료 untrusted mismatch trusted
base 58.0/62.3/58.0 19.2/17.3/15.7 14.5/14.6/14.2 2.6/3.0/2.6
new 50.4/45.8/47.2 6.3/3.0/7.0 5.4/4.3/5.9 2.9/3.0/2.8

컨테이너 6 → 5

XML system-out의 Creating container for image: mongo 줄 수: base 3회 모두 MongoTlsLaneTest 5 + MongoSecurityIntegrationLaneTest 1 = 6, new 3회 모두 4 + 1 = 5.

기준 2 — 그대로는 못 채움

new 3회: untrusted 6.3/3.0/7.0 s, mismatch 5.4/4.3/5.9 s. 시간을 셋으로 나눴다(system-out 타임스탬프):

  • (i) 컨테이너 만들기 → client 생성: 컨테이너 시작 + rs.initiate + CA 읽기(untrusted는 openssl 포함)
  • (ii) client 생성 → 첫 monitor 판정 로그
  • (iii) 판정 → 다음 컨테이너 만들기: client close + 컨테이너 stop + 다음 시험 준비
실행 untrusted (i) / (ii) / (iii) mismatch (i) / (ii) / (iii)
new-1 5.48 / 0.01 / 0.81 5.13 / 0.00 / 0.27
new-2 2.70 / 0.01 / 0.28 3.98 / 0.00 / 0.28
new-3 6.16 / 0.01 / 0.86 5.63 / 0.00 / 0.28
  • (ii)는 모든 실행에서 0.02 s 이하다. 5 s를 넘긴 몫은 (i)이다.
  • mismatch 컨테이너는 base와 같은 코드다. base (i)은 4.23/4.29/3.90 s. (i)에서 컨테이너 시작(started in)을 뺀 나머지는 base·new 모두 2.392.44 s로 같고, 차이는 docker 컨테이너 시작(base 1.491.85 s, new 1.59~3.22 s)에서 났다.
  • 탐침 실행(아래 p3, 같은 코드 + 시간 찍는 줄). runner가 빈 p3-1·2·3·5: untrusted 3.2/3.2/3.5/3.0 s, mismatch 4.1/4.6/4.3/4.1 s. 12코어 부하(nice 19)와 runner job 아래 p3-load12: untrusted 9.3 s((i) 8.22 / (ii) 0.01 / (iii) 1.10), mismatch 7.7 s((i) 7.16 / (ii) 0.01 / (iii) 0.52). p3-4는 아래 「빈 구간 두 번」의 둘째다.
  • 항목이 잡은 「컨테이너 하나 약 3 s」가 desktop에서는 TLS 컨테이너 하나 2.7~6.2 s였다.

RED 변이 둘(측정 트리 d1ae23e4)

  • (a) untrusted 시험이 unrelatedAuthorityPem() 대신 certificateAuthorityPem()(server 자신의 CA)을 믿게 → rc=1, [no handshake failure came: the first handshake was accepted] Expecting Optional to contain a value but it was empty.
  • (b) withMismatchedHostname()이 reachableSubjectAlternativeNames()를 쓰게 → rc=1, 같은 메시지.

지연 handshake 탐침(탐침 트리만, 최종 diff에 없음)

컨테이너를 docker pause로 멈춘 채 untrusted client를 연다.

  • 3 s 정지 → 3011 ms에 PKIX 판정.
  • 1 s connectTimeout + 3 s 정지 → 인증서를 판정하지 않은 소켓 실패 2회(MongoSocketWriteException)는 미판정으로 남고 다시 시도해 3047 ms에 PKIX 판정.
  • 12 s 정지 → 10084 ms에 no handshake was decided within PT10S AssertionError(거절로 세지 않음).

빈 구간 두 번 — docker 쪽

new 코드 11회 중 두 번, untrusted 시험 하나가 판정과 상관없이 길었다. 둘 다 판정 (ii)는 0.05 s 이하였다.

첫째, new-check 30.4 s. 첫 확인 실행(runner job이 돌던 때)에서 untrusted 시험 하나가 30.4 s였다. 판정은 client 생성 8 ms 뒤(04:33:56.840Z)였고 다음 컨테이너 생성(04:34:24.424Z)까지 27.6 s가 비었다.

  • dockerd 일지: 그 시험 서버 컨테이너 00a11e21852a의 task-delete가 13:33:56.910(판정 70 ms 뒤)에 왔는데, 13:34:06.893에 Container failed to exit within 10s of kill - trying direct SIGKILL. 프로세스는 이미 끝났는데 dockerd가 그 종료를 10 s 넘게 보고하지 않았다.
  • 2026-11-20 0시부터 같은 경고는 2건뿐이고, 다른 1건(06:50:08, 91b2402c56d1)은 이 diff와 무관한 MongoNetworkFaultLaneTest 컨테이너다.
  • 탐침 p3: client close와 컨테이너 stop(직전 docker top)을 따로 찍는 줄을 탐침 트리에만 넣고 클래스 5회 + 12코어 부하 1회. 6회 모두 rc=0. client close는 모두 3 ms 이하, stop 직전 컨테이너 안 프로세스는 매번 mongod 하나(openssl은 남지 않음). untrusted 컨테이너 stop은 255~989 ms, p3-4 한 번만 10649 ms.

둘째, p3-4 41.2 s. 이번 빈 구간은 판정 앞이었다. (i) 30.41 s 중 docker 시작은 2.58 s이고, started in(07:21:54.814Z) 뒤 client 생성(07:22:22.649Z)까지 27.8 s가 빈다. 이 사이에는 rs.initiate exec와 이 PR이 더한 openssl exec가 있다. 어느 exec에서 멈췄는지는 이 로그로 가를 수 없다. 다만 이 diff 탓이 아니라고 본 근거는 넷이다.

  • 그 컨테이너가 쓴 CPU는 2.78 s였다(systemd scope). 같은 시험의 정상 실행(p3-5)은 1.89 s다. 27.8 s 동안 일을 하지 않고 기다렸다.
  • 멈춤이 끝난 시각(07:22:22.65Z)은 runner 안 dockerd에서 무관한 CI job 컨테이너(7e9cbdce4dc6)가 끝난 시각(07:22:23.20Z)과 0.55 s 차이다.
  • 이어서 두 dockerd가 같은 경고를 62 ms 차이로 냈다: 이 시험 서버 0b7eed3f8d08(호스트, 07:22:32.990Z)와 runner 안 7e9cbdce4dc6(07:22:33.052Z). 이 경고가 p3-4의 (iii) 10.68 s(stop 10649 ms)다. 그 컨테이너의 scope는 stop 시작 0.3 s 뒤에 이미 끝나 있었다.
  • 같은 경고는 이 lane 밖에서도 난다. runner 안 dockerd는 2026-11-20 0시(KST)부터 18건(CI job 컨테이너), 호스트는 4건이다. 호스트 넷은 MongoNetworkFaultLaneTest, 첫째·둘째의 untrusted, 그리고 p3-load12의 만료 시험 컨테이너다(이 PR이 더한 openssl exec가 없는 컨테이너, stop 19291 ms).

흔들림

new 코드로 MongoTlsLaneTest 전체를 돈 11회(new-check, load12, new-13, p3-15, p3-load12) 모두 rc=0, 실패 0이다. 시간이 튄 두 번은 위 「빈 구간 두 번」이다.

verify

깨끗한 detached worktree(74187f38, 미추적 0)에서:

  • desktop scripts/verify.sh leaf :adapter:outbound:persistence-mongo rc=0, tests=583 failures=0.
  • desktop scripts/verify.sh pr --no-cache rc=0, tests=7329 failures=0 skipped=35.
  • 노트북 scripts/verify.sh docs rc=0.
  • desktop 두 단계 모두 첫 줄 「트리 3fc6c75da821(HEAD 트리와 같음)」.

이 lane은 두 단계 어디에도 없어서, 위 desktop 측정이 lane 증거다.

push 전에 main(a776c8cb, #76·#77)을 merge했다. 바뀐 경로 14개 중 이 leaf는 0개이고, 이 PR의 git diff --numstat은 merge 전후 같다. merge 뒤 트리는 PR run이 본다.

측정 트리 d1ae23e4와 최종 트리 3fc6c75d의 차이는 시험 동작 밖이다: untrusted 시험의 주석 2줄과 root cause 단언의 .as(...) 문구 1줄, 만료 시험 @DisplayName 1줄. 변이 (a)·(b)의 실패는 첫 .as 문구에서 나므로 메시지도 같다.

리뷰어가 볼 곳

  • MongoTlsLaneTest.java firstHandshake·HandshakeWatch — 수락·거절 신호와 10 s 상한.
  • 세 거절 시험의 root cause 단언.
  • MongoTlsReplicaSetContainer.java unrelatedAuthorityPem().

리뷰 반영

첫 리뷰 1회(종류 B, 렌즈 be-testing·be-persistence·be-security, 세션 기본 모델): High 1, Low 2 → 모두 고침. High가 있어 최종 diff로 확인 리뷰 1회(새 눈, 같은 렌즈): High·Medium 0, Low 2, Minor 1 → 모두 고침, 다시 리뷰하지 않았다.

  • High(첫 리뷰) — 「다른 CA」가 server CA와 같은 subject면 JDK가 경로 검증으로 가서 root가 CertPathBuilderException이 아니다 → subject /CN=unrelated-ca.
  • Low(첫 리뷰) — DisplayName 괄호 삭제.
  • Low(첫 리뷰) — HANDSHAKE_BOUND Javadoc을 상한이라는 뜻으로.
  • Low(확인 리뷰) — untrusted 시험의 「handshake가 받아들여졌다」 문구가 root cause 단언까지 따라가 틀린 진단을 붙인다 → rootCause() 뒤에 .as("refused, but not because no path led to a trusted authority").
  • Low(확인 리뷰) — 같은 이름·다른 키 CA 경로를 아무 시험도 밟지 않는다 → 시험 주석에 적고 「위험과 영향」에 둠(컨테이너를 늘리지 않음).
  • Minor(확인 리뷰) — 만료 시험 이름 「그 뒤 첫 handshake」가 단언보다 강하다 → 「그 뒤 새 client의 handshake」.
  • diff 밖 발견은 이 PR에서 고치지 않고 따로 적었다(trustOnly catch의 FQN, leaf AGENTS.md의 「TLS lane 싣지 않음」 문장, evaluateShell이 exit code·stderr를 버림).

관련

  • 리뷰 항목 REV-BE-0043(관련 REV-BE-0044).
  • docs/work/reference/gates.md 1절(이 lane이 도는 단계).
## 무엇을, 왜 REV-BE-0043. `MongoTlsLaneTest`가 lane(`mongoSecurityIntegrationTest`) 시간의 절반 넘게 기다림에 쓴다. 1. 거절 셋(믿지 않는 CA, 이름 불일치, 만료 뒤)은 TLS handshake가 ms 안에 실패해도 command가 서버 선택 timeout 10 s를 다 기다린 뒤에야 던진다. driver-core 5.6.5 `BaseCluster.selectServer`의 루프는 「드라이버 비호환」과 「timeout」에서만 끝난다. 2. 만료 시험은 5 s마다 새 연결을 연다. 3. 「다른 CA」 PEM 하나를 얻으려고 mongod를 하나 더 띄워 `rs.initiate`까지 한다. 덤으로 지금 단언 `isInstanceOf(RuntimeException.class)`는 컨테이너가 죽어도 참이다. 이 PR은: - 거절 판정을 client의 server monitor에서 받는다. cause 사슬에 `CertificateException`이 있는 첫 heartbeat 실패가 거절, `CONNECTED` description이 수락이다. 인증서를 판정하지 않은 실패(소켓 지연·끊김)는 기록만 하고 500 ms heartbeat로 다시 시도한다. 10 s는 상한으로만 남고, 그 안에 판정이 없으면 거절로 세지 않고 `AssertionError`로 실패한다. - 거절 셋은 원인별 root cause를 단언한다: 경로 빌드 실패(`CertPathBuilderException`, "unable to find valid certification path to requested target"), 이름 불일치(정확히 `CertificateException`, 메시지에 접속 host), 만료(`CertificateExpiredException`, "NotAfter:"로 시작). - 「다른 CA」는 server 컨테이너 안 `openssl` 한 번으로 만든다(`MongoTlsReplicaSetContainer.unrelatedAuthorityPem()`, subject `/CN=unrelated-ca`). 두 번째 mongod를 지운다. - 만료 poll 5 s → 1 s. 45 s 창은 그대로다. - 고친 세 메서드의 `@DisplayName`은 시험 규칙 2대로 한국어다. 고치지 않은 `aTrustedAuthorityConnects`는 그대로다. ## 고른 방법과 버린 대안 거절은 heartbeat 이벤트에서, 수락은 description에서 받는다. 근거(driver-core 5.6.5): - `DefaultServerMonitor$ServerMonitor.setupNewConnectionAndGetInitialDescription`은 `Exception`을 잡아 `logAndNotifyHeartbeatFailed`를 부른다 → 실패는 시도마다 heartbeat 이벤트로 온다. 성공한 첫 handshake는 heartbeat 이벤트가 없어서 수락은 description(`CONNECTED`)에서 본다. - `lookupServerDescription`은 예외를 `unknownConnectingServerDescription`으로 바꾸고, `EventHelper.wouldDescriptionsGenerateEquivalentEvents`는 바깥 예외의 class와 message만 비교한다 → 소켓 끊김과 인증서 거절이 같은 `MongoSocketWriteException: Exception sending message`로 겹치면 두 번째 description 이벤트가 오지 않는다. 그래서 첫 `serverDescriptionChanged`의 예외만 보는 안(항목 「고칠 방향」 1의 첫 형태)을 버렸다. 버린 안: - 거절 client만 서버 선택 timeout을 1~2 s로 줄이기 — 부하에 handshake가 느리면 「믿는데도 timeout」이 거절로 셈해진다(항목). - 검증 날짜를 미래로 돌린 TrustManager로 만료 대기 없애기 — 시험 경로가 실제 시계·운영 설정과 멀어진다(항목). - 「다른 CA」를 같은 subject로 만들기 — JDK `PKIXValidator`는 trust anchor subject가 issuer와 같으면 경로 빌드 대신 경로 검증으로 가서 root가 서명 검사 실패가 된다(첫 리뷰 High). 이름이 다른 CA로 「믿는 CA가 서명하지 않은 서버」를 만든다. - 시험끼리 컨테이너 나눠 쓰기 — 항목 범위 밖. ## 위험과 영향 - **기준 2(두 거절 시험 각 5 s 미만) 그대로는 못 채움.** 아래 「기준 2」. 넘친 몫은 컨테이너 준비이고 판정은 0.02 s 이하다. - 같은 이름·다른 키 CA(교체된 CA)의 서명 검사 실패 경로는 어느 시험도 세우지 않는다. 옛 시험이 그 경우였지만 `RuntimeException`만 단언했다. 따로 세우려면 컨테이너가 하나 더 들어 완료 기준(6 → 5)과 부딪친다. 시험 주석에 적었다. - 단언이 Sun provider 문구와 JDK 예외 사슬 모양에 기댄다. provider·JDK가 바뀌면 RED로 닫힌다(통과 쪽으로 열리지 않는다). driver가 바뀌어 heartbeat 실패 이벤트가 오지 않아도 10 s 상한에서 RED다. - 이 lane은 `integrationCheck`(main·nightly)에서만 돈다(`docs/work/reference/gates.md` 1절). PR run은 돌리지 않으므로 아래 desktop 결과가 이 lane의 PR 증거다. - 바꾸지 않은 것: 45 s 창, `MongoSecurityIntegrationLaneTest`, lane 설정(`build.gradle`), 운영 client 설정. ## 검증 ### 완료 기준 - 기준 1(3회 중앙값 25 s 이상 단축): 충족 — 중앙값 벽시계 −31.0 s, XML −31.3 s. - 컨테이너 6 → 5: 충족. - 기준 2(두 거절 시험 각 5 s 미만): 그대로는 못 채움. 판정 구간 (ii)는 0.02 s 이하이고 넘친 몫은 (i) 컨테이너 준비다(아래 「기준 2」의 세 구간 값). - RED 변이 둘, 빈 구간 두 번의 판정(docker 쪽)은 아래. ### 측정 방법 desktop, runner job이 없을 때만, `./gradlew :adapter:outbound:persistence-mongo:mongoSecurityIntegrationTest --rerun --no-build-cache --console=plain`(daemon 끔). base = 96c0b4c7, new = 측정 트리 d1ae23e4. ### 기준 1 — 3회 중앙값 25 s 이상 단축: 충족 base/new 번갈아 3+3회. XML = 두 클래스 `time` 합. 6회 모두 rc=0, 실패 0. | 회 | base 벽시계 | base XML | new 벽시계 | new XML | | --- | --- | --- | --- | --- | | 1 | 108.9 | 94.5 | 79.5 | 65.1 | | 2 | 128.5 | 97.4 | 70.9 | 56.2 | | 3 | 105.4 | 90.6 | 77.9 | 63.1 | | 중앙값 | 108.9 | 94.5 | 77.9 | 63.1 | 차이: 벽시계 31.0 s, XML 31.3 s. 시험별(JUnit XML `time`, s, 1/2/3회): | | 만료 | untrusted | mismatch | trusted | | --- | --- | --- | --- | --- | | base | 58.0/62.3/58.0 | 19.2/17.3/15.7 | 14.5/14.6/14.2 | 2.6/3.0/2.6 | | new | 50.4/45.8/47.2 | 6.3/3.0/7.0 | 5.4/4.3/5.9 | 2.9/3.0/2.8 | ### 컨테이너 6 → 5 XML system-out의 `Creating container for image: mongo` 줄 수: base 3회 모두 `MongoTlsLaneTest` 5 + `MongoSecurityIntegrationLaneTest` 1 = 6, new 3회 모두 4 + 1 = 5. ### 기준 2 — 그대로는 못 채움 new 3회: untrusted 6.3/3.0/7.0 s, mismatch 5.4/4.3/5.9 s. 시간을 셋으로 나눴다(system-out 타임스탬프): - (i) 컨테이너 만들기 → client 생성: 컨테이너 시작 + `rs.initiate` + CA 읽기(untrusted는 `openssl` 포함) - (ii) client 생성 → 첫 monitor 판정 로그 - (iii) 판정 → 다음 컨테이너 만들기: client close + 컨테이너 stop + 다음 시험 준비 | 실행 | untrusted (i) / (ii) / (iii) | mismatch (i) / (ii) / (iii) | | --- | --- | --- | | new-1 | 5.48 / 0.01 / 0.81 | 5.13 / 0.00 / 0.27 | | new-2 | 2.70 / 0.01 / 0.28 | 3.98 / 0.00 / 0.28 | | new-3 | 6.16 / 0.01 / 0.86 | 5.63 / 0.00 / 0.28 | - (ii)는 모든 실행에서 0.02 s 이하다. 5 s를 넘긴 몫은 (i)이다. - mismatch 컨테이너는 base와 같은 코드다. base (i)은 4.23/4.29/3.90 s. (i)에서 컨테이너 시작(`started in`)을 뺀 나머지는 base·new 모두 2.39~2.44 s로 같고, 차이는 docker 컨테이너 시작(base 1.49~1.85 s, new 1.59~3.22 s)에서 났다. - 탐침 실행(아래 p3, 같은 코드 + 시간 찍는 줄). runner가 빈 p3-1·2·3·5: untrusted 3.2/3.2/3.5/3.0 s, mismatch 4.1/4.6/4.3/4.1 s. 12코어 부하(nice 19)와 runner job 아래 p3-load12: untrusted 9.3 s((i) 8.22 / (ii) 0.01 / (iii) 1.10), mismatch 7.7 s((i) 7.16 / (ii) 0.01 / (iii) 0.52). p3-4는 아래 「빈 구간 두 번」의 둘째다. - 항목이 잡은 「컨테이너 하나 약 3 s」가 desktop에서는 TLS 컨테이너 하나 2.7~6.2 s였다. ### RED 변이 둘(측정 트리 d1ae23e4) - (a) untrusted 시험이 `unrelatedAuthorityPem()` 대신 `certificateAuthorityPem()`(server 자신의 CA)을 믿게 → rc=1, `[no handshake failure came: the first handshake was accepted] Expecting Optional to contain a value but it was empty`. - (b) `withMismatchedHostname()`이 `reachableSubjectAlternativeNames()`를 쓰게 → rc=1, 같은 메시지. ### 지연 handshake 탐침(탐침 트리만, 최종 diff에 없음) 컨테이너를 `docker pause`로 멈춘 채 untrusted client를 연다. - 3 s 정지 → 3011 ms에 PKIX 판정. - 1 s connectTimeout + 3 s 정지 → 인증서를 판정하지 않은 소켓 실패 2회(`MongoSocketWriteException`)는 미판정으로 남고 다시 시도해 3047 ms에 PKIX 판정. - 12 s 정지 → 10084 ms에 `no handshake was decided within PT10S` `AssertionError`(거절로 세지 않음). ### 빈 구간 두 번 — docker 쪽 new 코드 11회 중 두 번, untrusted 시험 하나가 판정과 상관없이 길었다. 둘 다 판정 (ii)는 0.05 s 이하였다. **첫째, new-check 30.4 s.** 첫 확인 실행(runner job이 돌던 때)에서 untrusted 시험 하나가 30.4 s였다. 판정은 client 생성 8 ms 뒤(04:33:56.840Z)였고 다음 컨테이너 생성(04:34:24.424Z)까지 27.6 s가 비었다. - dockerd 일지: 그 시험 서버 컨테이너 `00a11e21852a`의 task-delete가 13:33:56.910(판정 70 ms 뒤)에 왔는데, 13:34:06.893에 `Container failed to exit within 10s of kill - trying direct SIGKILL`. 프로세스는 이미 끝났는데 dockerd가 그 종료를 10 s 넘게 보고하지 않았다. - 2026-11-20 0시부터 같은 경고는 2건뿐이고, 다른 1건(06:50:08, `91b2402c56d1`)은 이 diff와 무관한 `MongoNetworkFaultLaneTest` 컨테이너다. - 탐침 p3: client close와 컨테이너 stop(직전 `docker top`)을 따로 찍는 줄을 탐침 트리에만 넣고 클래스 5회 + 12코어 부하 1회. 6회 모두 rc=0. client close는 모두 3 ms 이하, stop 직전 컨테이너 안 프로세스는 매번 mongod 하나(`openssl`은 남지 않음). untrusted 컨테이너 stop은 255~989 ms, p3-4 한 번만 10649 ms. **둘째, p3-4 41.2 s.** 이번 빈 구간은 판정 앞이었다. (i) 30.41 s 중 docker 시작은 2.58 s이고, `started in`(07:21:54.814Z) 뒤 client 생성(07:22:22.649Z)까지 27.8 s가 빈다. 이 사이에는 `rs.initiate` exec와 이 PR이 더한 `openssl` exec가 있다. 어느 exec에서 멈췄는지는 이 로그로 가를 수 없다. 다만 이 diff 탓이 아니라고 본 근거는 넷이다. - 그 컨테이너가 쓴 CPU는 2.78 s였다(systemd scope). 같은 시험의 정상 실행(p3-5)은 1.89 s다. 27.8 s 동안 일을 하지 않고 기다렸다. - 멈춤이 끝난 시각(07:22:22.65Z)은 runner 안 dockerd에서 무관한 CI job 컨테이너(`7e9cbdce4dc6`)가 끝난 시각(07:22:23.20Z)과 0.55 s 차이다. - 이어서 두 dockerd가 같은 경고를 62 ms 차이로 냈다: 이 시험 서버 `0b7eed3f8d08`(호스트, 07:22:32.990Z)와 runner 안 `7e9cbdce4dc6`(07:22:33.052Z). 이 경고가 p3-4의 (iii) 10.68 s(stop 10649 ms)다. 그 컨테이너의 scope는 stop 시작 0.3 s 뒤에 이미 끝나 있었다. - 같은 경고는 이 lane 밖에서도 난다. runner 안 dockerd는 2026-11-20 0시(KST)부터 18건(CI job 컨테이너), 호스트는 4건이다. 호스트 넷은 `MongoNetworkFaultLaneTest`, 첫째·둘째의 untrusted, 그리고 p3-load12의 만료 시험 컨테이너다(이 PR이 더한 `openssl` exec가 없는 컨테이너, stop 19291 ms). ### 흔들림 new 코드로 `MongoTlsLaneTest` 전체를 돈 11회(new-check, load12, new-1~3, p3-1~5, p3-load12) 모두 rc=0, 실패 0이다. 시간이 튄 두 번은 위 「빈 구간 두 번」이다. ### verify 깨끗한 detached worktree(74187f38, 미추적 0)에서: - desktop `scripts/verify.sh leaf :adapter:outbound:persistence-mongo` rc=0, tests=583 failures=0. - desktop `scripts/verify.sh pr --no-cache` rc=0, tests=7329 failures=0 skipped=35. - 노트북 `scripts/verify.sh docs` rc=0. - desktop 두 단계 모두 첫 줄 「트리 3fc6c75da821(HEAD 트리와 같음)」. 이 lane은 두 단계 어디에도 없어서, 위 desktop 측정이 lane 증거다. push 전에 main(a776c8cb, #76·#77)을 merge했다. 바뀐 경로 14개 중 이 leaf는 0개이고, 이 PR의 `git diff --numstat`은 merge 전후 같다. merge 뒤 트리는 PR run이 본다. 측정 트리 d1ae23e4와 최종 트리 3fc6c75d의 차이는 시험 동작 밖이다: untrusted 시험의 주석 2줄과 root cause 단언의 `.as(...)` 문구 1줄, 만료 시험 `@DisplayName` 1줄. 변이 (a)·(b)의 실패는 첫 `.as` 문구에서 나므로 메시지도 같다. ## 리뷰어가 볼 곳 - `MongoTlsLaneTest.java` `firstHandshake`·`HandshakeWatch` — 수락·거절 신호와 10 s 상한. - 세 거절 시험의 root cause 단언. - `MongoTlsReplicaSetContainer.java` `unrelatedAuthorityPem()`. ## 리뷰 반영 첫 리뷰 1회(종류 B, 렌즈 be-testing·be-persistence·be-security, 세션 기본 모델): High 1, Low 2 → 모두 고침. High가 있어 최종 diff로 확인 리뷰 1회(새 눈, 같은 렌즈): High·Medium 0, Low 2, Minor 1 → 모두 고침, 다시 리뷰하지 않았다. - High(첫 리뷰) — 「다른 CA」가 server CA와 같은 subject면 JDK가 경로 검증으로 가서 root가 `CertPathBuilderException`이 아니다 → subject `/CN=unrelated-ca`. - Low(첫 리뷰) — DisplayName 괄호 삭제. - Low(첫 리뷰) — `HANDSHAKE_BOUND` Javadoc을 상한이라는 뜻으로. - Low(확인 리뷰) — untrusted 시험의 「handshake가 받아들여졌다」 문구가 root cause 단언까지 따라가 틀린 진단을 붙인다 → `rootCause()` 뒤에 `.as("refused, but not because no path led to a trusted authority")`. - Low(확인 리뷰) — 같은 이름·다른 키 CA 경로를 아무 시험도 밟지 않는다 → 시험 주석에 적고 「위험과 영향」에 둠(컨테이너를 늘리지 않음). - Minor(확인 리뷰) — 만료 시험 이름 「그 뒤 첫 handshake」가 단언보다 강하다 → 「그 뒤 새 client의 handshake」. - diff 밖 발견은 이 PR에서 고치지 않고 따로 적었다(trustOnly catch의 FQN, leaf `AGENTS.md`의 「TLS lane 싣지 않음」 문장, `evaluateShell`이 exit code·stderr를 버림). ## 관련 - 리뷰 항목 REV-BE-0043(관련 REV-BE-0044). - `docs/work/reference/gates.md` 1절(이 lane이 도는 단계).
donghyeon.kang added 2 commits 2026-11-21 08:34:18 +00:00
MongoTlsLaneTest가 lane(mongoSecurityIntegrationTest) 시간의 절반 넘게
기다림에 쓴다. 거절 셋(믿지 않는 CA, 이름 불일치, 만료)은 handshake가
ms 안에 실패해도 command가 서버 선택 timeout 10 s를 다 기다린 뒤에야
던지고(driver 5.6.5 BaseCluster.selectServer는 비호환과 timeout에서만
끝난다), 만료 poll은 5 s 간격이고, 「다른 CA」 PEM 하나를 얻으려고
mongod를 하나 더 띄워 rs.initiate까지 한다. 단언도
isInstanceOf(RuntimeException)이라 컨테이너가 죽어도 통과한다.

거절 판정을 client의 server monitor에서 받는다. cause 사슬에
CertificateException이 있는 첫 heartbeat 실패가 거절이고, CONNECTED
description이 수락이다. 인증서를 판정하지 않은 실패(소켓 지연·끊김)는
기록만 하고 500 ms heartbeat로 다시 시도한다. 10 s는 상한으로만 남고,
그 안에 판정이 없으면 거절로 세지 않고 AssertionError로 실패한다.
거절 셋은 원인별 root cause를 단언한다: 경로 빌드 실패, 접속 host를 담은
이름 불일치, CertificateExpiredException. 거절은 description 변화가 아니라
heartbeat 이벤트에서 받는다. driver는 바깥 예외의 class와 message만으로
같은 실패를 가려 description 이벤트를 다시 내지 않아, 소켓 끊김 뒤의
인증서 거절이 묻힐 수 있다(driver-core 5.6.5 EventHelper).

「다른 CA」는 server 컨테이너 안 openssl 한 번
(MongoTlsReplicaSetContainer.unrelatedAuthorityPem, subject
/CN=unrelated-ca)으로 만들고 두 번째 mongod를 지운다. subject가 같은
CA는 JDK가 경로 빌드 대신 서명 검사로 가서 다른 거절이 된다. 만료 poll은
1 s로 줄인다. 45 s 창, MongoSecurityIntegrationLaneTest, lane 설정,
운영 client 설정은 그대로다.

버린 안: 거절 client만 서버 선택 timeout을 줄이기(부하에서 「믿는데도
timeout」이 거절로 셈해진다), 검증 날짜를 미래로 돌린 TrustManager(실제
시계·운영 설정과 멀어진다).

위험·한계: 같은 이름·다른 키 CA(교체된 CA)의 서명 검사 실패 경로는 어느
시험도 세우지 않는다. 컨테이너를 하나 더 띄워야 해서 넣지 않았다. 단언이
Sun provider 문구와 JDK 예외 사슬 모양에 기대어, 바뀌면 RED로 닫힌다.
두 거절 시험 각 5 s 미만은 new 3회 중 untrusted 6.3/3.0/7.0 s,
mismatch 5.4/4.3/5.9 s라 그대로는 못 채웠다. 넘친 몫은 컨테이너
준비(시작 + rs.initiate)이고 판정은 0.02 s 이하다.

검증(desktop, runner job 없을 때): lane --rerun 번갈아 3+3회 중앙값
벽시계 108.9 → 77.9 s, XML 94.5 → 63.1 s. Mongo 컨테이너 6 → 5.
변이 둘(untrusted가 server 자신의 CA, mismatch가 닿는 SAN) 모두 「no
handshake failure came」로 RED. 이 lane은 integrationCheck(main·nightly)
에서만 돌아 PR run이 돌리지 않는다.

Refs: REV-BE-0043
donghyeon.kang merged commit d5b7410102 into main 2026-11-21 08:58:06 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/clean-architecture-backend-template#79