Files
document-haness/docs/clean-architecture-backend-template/tech-log-studio/what-a-gate-does-not-prove/decision/decision-only-the-certification-lane-carries-no-docker-guard.md
T

2.8 KiB

kind, slug, title, topic, project, status, sourceRevision, rootTreeNode, decisionStatus, decidedOn, source
kind slug title topic project status sourceRevision rootTreeNode decisionStatus decidedOn source
PROJECT_DECISION only-the-certification-lane-carries-no-docker-guard 인증 레인만 Docker 가드를 달지 않는다 what-a-gate-does-not-prove clean-architecture-backend-template 게시 전 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916 decision:only-the-certification-lane-carries-no-docker-guard ADOPTED 2026-08-30
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
final/document.md#6-4

인증 레인만 Docker 가드를 달지 않는다

결정문

컨테이너를 쓰는 모든 suite 는 Docker 가 없으면 이유를 적고 건너뛰되, 인증 레인만은 건너뛰지 않는다.

판단 이유

건너뛰는 레인은 아무도 시작하지 않은 브로커에 대해 성공을 보고한다. 인증은 그 브로커에 대해 무언가를 주장하는 일이므로, 주장의 근거가 없을 때 성공을 내는 것은 인증의 반대다.

다른 컨테이너 suite 는 사정이 다르다. 그것들은 개발자의 랩톱에서도 돌아야 하고, Docker 가 없다는 이유로 빌드가 깨지면 그 suite 는 곧 꺼진다.

그래서 인증 레인은 기본 test 에서 태그로 제외한다. 랩톱 빌드는 깨지지 않고, 인증은 전용 워크플로에서만 돌아간다.

그 워크플로가 도는 것은 레인이 아니라 게이트다. 게이트가 레인에 의존하므로 레인을 빠뜨리면 게이트가 실패한다. 워크플로가 레인 이름을 직접 부르면, 레인이 추가될 때 워크플로를 함께 고쳐야 하고 잊으면 조용히 빠진다.

영향

감수하는 것

인증 레인은 로컬에서 기본 빌드에 포함되지 않는다. 개발자가 그것을 돌리려면 명시적으로 태스크를 지정해야 한다.

Docker 가 없는 CI 환경에서는 인증 워크플로 자체가 실패한다. 그것이 의도이지만, 인프라 문제와 코드 문제가 같은 빨간불로 보인다.

얻는 것

인증 결과의 초록불이 실제로 브로커가 떠 있었다는 뜻이 된다.

레인이 추가될 때 워크플로를 고칠 필요가 없다. 게이트가 의존성을 갖기 때문이다.

근거

  • 아무것도 발견하지 못한 레인은 성공이 아니라 실패여야 한다 이 결정과 같은 원칙의 레인 규약이다.
  • 아무도 돌리지 않는 레인의 게이트는 마지막으로 돌린 사람이 본 것을 보고한다 이 결정이 막으려는 상태다.
  • 릴리스 게이트가 읽는 증거를 아무도 생산하지 않는다 게이트가 레인에 의존하지 않을 때의 결과를 보여 주는 사례다.