--- kind: CASE slug: three-versions-declared-one-executed title: 릴리스 레인이 매트릭스 세 버전 중 첫 번째만 돌리고 세 개를 커버로 기록했다 topic: what-a-gate-does-not-prove project: clean-architecture-backend-template status: 게시 전 sourceRevision: 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916 rootTreeNode: case:three-versions-declared-one-executed evidenceCapturedOn: 2026-09-01 assets: - key: three-versions-declared-one-executed file: ../../../final/evidence/rendered/three-versions-declared-one-executed.svg evidence: - ../../../final/evidence/raw/three-versions-declared-one-executed.txt source: - 원본 분석 절은 final/document.md#a05 §15.4 이다. --- # 릴리스 레인이 매트릭스 세 버전 중 첫 번째만 돌리고 세 개를 커버로 기록했다 계약 suite 가 여러 PostgreSQL major 를 선택받으면 첫 번째만 실제로 돌면서 지원 매트릭스에는 세 개 모두 전체 계약 suite 로 기록했다. 지금은 여러 개가 선택되면 시작 자체를 거부한다. ## 관계 - **빠뜨림이 통과가 되는 게이트는 게이트가 아니다** 커버리지 기록과 실제 실행이 어긋난 형태다. - **컨테이너가 필요한 레인의 실제 결과를 실행으로 확인하지 않았다** 이 레인의 현재 상태에 대한 미해결 질문이다. ## 문제 계약 suite 는 여러 major 를 한 번에 커버할 수 없다. 그러려면 버전마다 모든 테스트를 반복해야 하고 그것은 별도의 작업이다. 그런데 예전에는 여러 개가 선택되면 첫 번째 하나로 컨테이너를 띄우고 진행했다. 지원 매트릭스에는 세 개 모두 전체 계약 suite 로 기록됐다. 18 에서만 깨지는 매핑이나 Hibernate 방언 차이나 Flyway 업그레이드가 초록불 릴리스와 함께 출하될 수 있는 상태였다. ## 결론 여러 개가 선택되면 시작을 거부한다. 정확히 하나가 아니면 IllegalStateException 을 던지고, 메시지가 왜 그런지와 어떻게 해야 하는지를 함께 적는다. 하나의 JVM 에서 정확히 하나의 major 에 대해 돌아야 하고, 실행을 major 당 한 잡으로 나누라는 것이며, 여기서 여러 버전을 선택하면 첫 번째만 조용히 테스트되면서 전부에 대한 커버리지가 보고된다는 것이다. 정직한 형태는 major 당 한 잡이다. CI 매트릭스가 팬아웃하고 이 코드는 그렇지 않은 척하기를 거부한다. 같은 계열의 문제가 릴리스 레지스트리에도 기록되어 있다. 예전에는 지원 매트릭스가 언급하는 모든 PostgreSQL NN 문자열과 모든 게이트 표기를 수집했고, 일치가 어느 표에서 왔는지도 그 행이 어떤 지원 등급을 선언했는지도 알지 못했다. 그래서 실험 등급 PG19 가 안정 major 와 같은 목록에 들어가고, 문장에서 한 번 언급된 버전이 지원으로 집계되고, PG17 을 실험으로 강등해도 문서 어딘가에 문자열이 살아 있으면 아무것도 바뀌지 않았다. 게이트 목록은 두 곳에 더 있었고 그중 어느 것도 실제로 존재하는 Gradle 태스크에 묶여 있지 않았다. ## 검증 환경 OpenJDK : 21.0.12 Gradle : 9.0.0 데이터베이스 : PostgreSQL, Testcontainers 근거 : 레지스트리 주석과 코드 javadoc 이 사후 기록으로 남긴 회귀 소스 수정 : x ## 재현 조건 1. JpaPlatformContractSupport 의 인자 없는 start 메서드와 그 위 javadoc 을 읽는다. 2. 선택 버전이 하나가 아닐 때의 예외 메시지를 확인한다. 3. release-registry.json 의 주석 배열을 읽는다. 이전 수집 방식의 문제가 열거되어 있다. ## 본문 릴리스 레인이 `-Pjpa.matrix.versions=16,17,18`을 `selectedVersions().get(0)`을 쓰는 지원 클래스에 넘겼고 **통합 suite 전체가 PostgreSQL 16에 대해 돌았다.** ## 레인이 넘긴 값과 지원 클래스가 쓴 값 :::evidence key="three-versions-declared-one-executed" alt="분석 문서 final/document.md#a05 에서 이 기록의 근거 절을 그대로 잘라낸 16줄. 코드베이스를 측정한 것이 아니라 원본 판정이 무엇을 적었는지를 보여 준다." caption="final/document.md#a05 발췌 — 16줄" zoom="true" ::: ## 나머지 두 major 를 커버로 만든 것 3개 assertion짜리 smoke test 하나다. 지원 표는 그 힘으로 17과 18을 완전 커버로 기록했다. ## 수정이 세 곳을 동시에 건드린다 `start()`가 다중 선택을 아예 거부하고, workflow가 major당 job으로 fan-out하며, promotion job이 세 major의 증거가 **같은 commit SHA**를 담기를 요구한다. ## 확인하지 못한 것 CI 워크플로가 실제로 major 당 한 잡으로 팬아웃하는지 실행으로 확인하지 않았다. 이 사이클에서 jpaPlatformFailureTest 를 포함한 일부 컨테이너 레인은 돌리지 않았다.