DongHyeonkaandClaude Opus 5
b2963105a8
The keycloak project ended with four open questions that design could not
settle. A two-VM lab was built to answer them by measurement, and this is
that material: 26 experiments, 125 raw command outputs, 22 browser captures.
Follows the import procedure in README.md.
source/ the originating repository verbatim — 78 documents, 28 SVGs,
8 manifests, plus .source-revision recording the commit
final/ the SSOT
document.md 729 lines written from the 29 experiment documents, not
concatenated: what was predicted, what was measured, and
where the measurement itself was wrong
evidence/raw 125 outputs, flattened to <experiment>__<file> because
the originals collided (01-baseline.txt appeared three
times) and the audit only globs the top level
evidence/meta one per raw file; command and exitCode are null and the
README says why rather than inventing them
evidence/browser 22 captures
assets/ three diagrams through techviz
.techviz/ their VizSpecs
A separate project rather than an addition to keycloak: the B-layer answers
that project's four questions, but the A, C and D layers are about cluster
failure, SSO and operations, and one document.md should hold one subject.
The four question records there can point here through 관계.
Recorded rather than papered over: only three of the 28 diagrams were
remade. The repository forbids hand-drawn SVG and forbids titles inside the
canvas; all 28 originals carry both, so converting them is redrawing, not
reformatting. They stay in source/ and the gap is written into the document.
verify-pipeline.py passes. audit-records.py reports no issues.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
4.9 KiB
kind, slug, title, topic, project, status, sourceRevision, rootTreeNode, evidenceCapturedOn, assets, evidence, source
| kind | slug | title | topic | project | status | sourceRevision | rootTreeNode | evidenceCapturedOn | assets | evidence | source | |||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| CASE | three-versions-declared-one-executed | 릴리스 레인이 매트릭스 세 버전 중 첫 번째만 돌리고 세 개를 커버로 기록했다 | what-a-gate-does-not-prove | clean-architecture-backend-template | 게시 전 | 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916 | case:three-versions-declared-one-executed | 2026-09-01 |
|
|
|
릴리스 레인이 매트릭스 세 버전 중 첫 번째만 돌리고 세 개를 커버로 기록했다
계약 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
재현 조건
- JpaPlatformContractSupport 의 인자 없는 start 메서드와 그 위 javadoc 을 읽는다.
- 선택 버전이 하나가 아닐 때의 예외 메시지를 확인한다.
- release-registry.json 의 주석 배열을 읽는다. 이전 수집 방식의 문제가 열거되어 있다.
본문
릴리스 레인이 -Pjpa.matrix.versions=16,17,18을 selectedVersions().get(0)을 쓰는 지원 클래스에 넘겼고 통합 suite 전체가 PostgreSQL 16에 대해 돌았다.
레인이 넘긴 값과 지원 클래스가 쓴 값
:::evidence key="three-versions-declared-one-executed" alt="분석 문서 analysis/05-adapter-outbound-persistence-jpa.md 에서 이 기록의 근거 절을 그대로 잘라낸 16줄. 코드베이스를 측정한 것이 아니라 원본 판정이 무엇을 적었는지를 보여 준다." caption="analysis/05-adapter-outbound-persistence-jpa.md 발췌 — 16줄" zoom="true" :::
나머지 두 major 를 커버로 만든 것
3개 assertion짜리 smoke test 하나다. 지원 표는 그 힘으로 17과 18을 완전 커버로 기록했다.
수정이 세 곳을 동시에 건드린다
start()가 다중 선택을 아예 거부하고, workflow가 major당 job으로 fan-out하며, promotion job이 세 major의 증거가 같은 commit SHA를 담기를 요구한다.
확인하지 못한 것
CI 워크플로가 실제로 major 당 한 잡으로 팬아웃하는지 실행으로 확인하지 않았다. 이 사이클에서 jpaPlatformFailureTest 를 포함한 일부 컨테이너 레인은 돌리지 않았다.