Files
document-haness/docs/clean-architecture-backend-template/tech-log-studio/drain-and-shutdown-ordering/case/case-reject-new-admission-that-rejects-nothing.md
T
DongHyeonkaandClaude Fable 5.1 b25357c48a docs(clean-architecture-backend-template): fold analysis into final and re-select one topic
- 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>
2026-09-07 12:39:20 +09:00

3.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 reject-new-admission-that-rejects-nothing 새 승인을 거절한다는 메서드가 단계만 기록하고 아무것도 거절하지 않는다 drain-and-shutdown-ordering clean-architecture-backend-template 게시 전 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916 case:reject-new-admission-that-rejects-nothing 2026-09-01
key file
reject-new-admission-that-rejects-nothing ../../../final/evidence/rendered/reject-new-admission-that-rejects-nothing.svg
../../../final/evidence/raw/reject-new-admission-that-rejects-nothing.txt
원본 분석 절은 final/document.md#a20-grpc-admin §17.1 이다.

새 승인을 거절한다는 메서드가 단계만 기록하고 아무것도 거절하지 않는다

배수 조정자의 새 승인 거절 메서드가 현재 단계를 기록하는 것이 전부다. 승인을 실제로 판정하는 제어기는 다른 리프에 있고 이 단계를 읽지 않는다.

관계

  • 8단계 종료 순서 계약과 실제 종료 경로 이 사례가 속한 구조다.
  • 배수를 시작한 뒤에도 한 서비스가 다시 SERVING 이 될 수 있다 같은 리프에서 배수를 무력하게 만드는 다른 절반이다.
  • 검증기는 발행이 아니라 주입이 강제다 같은 계열의 규칙이다.

문제

배수의 첫 단계는 새 요청을 받지 않는 것이다. 그래야 남은 작업이 줄어들고 드레인이 끝난다.

배수 조정자가 그 단계를 메서드로 갖는다. 이름이 새 승인을 거절한다고 말한다.

결론

본문이 현재 단계를 기록하는 것이 전부다.

승인을 실제로 판정하는 것은 다른 리프의 승인 제어기이고, 그 제어기는 이 조정자의 단계를 읽지 않는다. 두 리프 사이에 참조가 없다.

그래서 배수를 시작해도 새 요청은 계속 승인된다. 드레인이 기다리는 작업 수가 줄지 않고, 드레인 마감이 지나면 아직 처리 중인 요청을 두고 종료한다.

같은 리프의 헬스 레지스트리가 배수 중에 서비스를 다시 서빙으로 돌릴 수 있다는 것과 겹치면 결론이 하나로 모인다. 배수라는 절차가 상태 기록으로만 존재하고 트래픽에 대해서는 아무 효과가 없다.

검증 환경

OpenJDK : 21.0.12 Gradle : 9.0.0 확인 방식 : 메서드 본문 확인과 두 리프 사이의 타입 참조 검색 소스 수정 : x

재현 조건

  1. 배수 조정자의 새 승인 거절 메서드 본문을 읽는다.
  2. 그 메서드가 바꾸는 상태를 읽는 코드를 저장소에서 찾는다.
  3. 승인 제어기가 배수 단계를 참조하는지 확인한다.

본문

배수의 첫 단계는 새 요청을 받지 않는 것이다. rejectNewAdmission() 은 이름이 그것을 말하고, 본문은 현재 단계를 기록하는 것이 전부다.

메서드 본문이 하는 일

:::evidence key="reject-new-admission-that-rejects-nothing" alt="분석 문서 final/document.md#a20-grpc-admin 에서 이 기록의 근거 절을 그대로 잘라낸 18줄. 코드베이스를 측정한 것이 아니라 원본 판정이 무엇을 적었는지를 보여 준다." caption="final/document.md#a20-grpc-admin 발췌 — 18줄" zoom="true" :::

승인을 판정하는 곳이 이 단계를 읽지 않는다

승인 제어기는 다른 리프에 있고 이 조정자의 단계를 읽지 않는다. 그래서 배수를 시작해도 새 요청은 계속 승인된다.

헬스 레지스트리 쪽과 겹치면

배수 중에 서비스를 다시 SERVING 으로 돌릴 수 있다는 것과 합쳐져, 배수라는 절차 전체가 상태 기록으로만 존재하고 트래픽에 대해서는 아무 효과가 없다.

확인하지 못한 것

배수 중 승인 시도를 실행으로 재현하지 않았다. 두 리프 사이에 참조가 없다는 것으로 판정했다.