- analysis/·source-index·state.json 을 final/document.md 제2부·제3부로 접었다. SSOT 는 하나다 - 파일럿 — commit-ambiguity-as-a-result 를 새 기준으로 재선별. 후보 14 → 글감 5 (PROMOTE 5 · MERGE_INTO 3 · KEEP_IN_SSOT 4 · 보류 2). 기록 5건을 다시 썼고 그림 1개를 techviz 로 만들었다 - 재선별이 잡은 것: 제1부 §6.2·§11.1 이 자기 §13.2 와 어긋나 있었다(레인을 안 돌렸다 vs 돌렸다) — 정정. 이미 답이 나와 있던 Question 을 HEAD 재실행 질문으로 다시 세웠다. Concept 이 인용한 코드가 SSOT 에 없어 뺐다 - candidateScope·sourceRepository 기록. 나머지 43개 주제는 재선별 대기(PENDING 905) Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
58 lines
2.7 KiB
Markdown
58 lines
2.7 KiB
Markdown
---
|
|
kind: PROJECT_DECISION
|
|
slug: only-the-certification-lane-carries-no-docker-guard
|
|
title: 인증 레인만 Docker 가드를 달지 않는다
|
|
topic: what-a-gate-does-not-prove
|
|
project: clean-architecture-backend-template
|
|
status: 게시 전
|
|
sourceRevision: 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916
|
|
rootTreeNode: decision:only-the-certification-lane-carries-no-docker-guard
|
|
decisionStatus: ADOPTED
|
|
decidedOn: 2026-08-30
|
|
source:
|
|
- src/messaging/messaging-kafka/build.gradle
|
|
- .github/workflows/messaging-certification.yml
|
|
- src/build-logic/src/main/groovy/ca.strict-test-lane.gradle
|
|
- final/document.md#a19
|
|
---
|
|
|
|
# 인증 레인만 Docker 가드를 달지 않는다
|
|
|
|
## 결정문
|
|
|
|
컨테이너를 쓰는 모든 suite 는 Docker 가 없으면 이유를 적고 건너뛰되, 인증 레인만은 건너뛰지 않는다.
|
|
|
|
## 판단 이유
|
|
|
|
건너뛰는 레인은 아무도 시작하지 않은 브로커에 대해 성공을 보고한다. 인증은 그 브로커에 대해 무언가를 주장하는 일이므로, 주장의 근거가 없을 때 성공을 내는 것은 인증의 반대다.
|
|
|
|
다른 컨테이너 suite 는 사정이 다르다. 그것들은 개발자의 랩톱에서도 돌아야 하고, Docker 가 없다는 이유로 빌드가 깨지면 그 suite 는 곧 꺼진다.
|
|
|
|
그래서 인증 레인은 기본 test 에서 태그로 제외한다. 랩톱 빌드는 깨지지 않고, 인증은 전용 워크플로에서만 돌아간다.
|
|
|
|
그 워크플로가 도는 것은 레인이 아니라 게이트다. 게이트가 레인에 의존하므로 레인을 빠뜨리면 게이트가 실패한다. 워크플로가 레인 이름을 직접 부르면, 레인이 추가될 때 워크플로를 함께 고쳐야 하고 잊으면 조용히 빠진다.
|
|
|
|
## 영향
|
|
|
|
감수하는 것
|
|
|
|
인증 레인은 로컬에서 기본 빌드에 포함되지 않는다. 개발자가 그것을 돌리려면 명시적으로 태스크를 지정해야 한다.
|
|
|
|
Docker 가 없는 CI 환경에서는 인증 워크플로 자체가 실패한다. 그것이 의도이지만, 인프라 문제와 코드 문제가 같은 빨간불로 보인다.
|
|
|
|
얻는 것
|
|
|
|
인증 결과의 초록불이 실제로 브로커가 떠 있었다는 뜻이 된다.
|
|
|
|
레인이 추가될 때 워크플로를 고칠 필요가 없다. 게이트가 의존성을 갖기 때문이다.
|
|
|
|
## 근거
|
|
|
|
- **아무것도 발견하지 못한 레인은 성공이 아니라 실패여야 한다**
|
|
이 결정과 같은 원칙의 레인 규약이다.
|
|
- **아무도 돌리지 않는 레인의 게이트는 마지막으로 돌린 사람이 본 것을 보고한다**
|
|
이 결정이 막으려는 상태다.
|
|
- **릴리스 게이트가 읽는 증거를 아무도 생산하지 않는다**
|
|
게이트가 레인에 의존하지 않을 때의 결과를 보여 주는 사례다.
|
|
|