Files
clean-architecture-backend-…/docs/upgrade
DongHyeonka 13ffb6cfb1 docs(runbooks): runbook 본문의 옛 설계 번호와 커밋 sha를 설명으로 바꾼다
job·outbox·internal-error-spike runbook이 근거를 템플릿 개발 때의 설계
번호(D2·D4·D7·D8, K8S-POD-LC-C2, WAF-REL05-C3, TPE-JDK21-C6,
OUT_OF_BRANCH_SCOPE), 옛 feature 브랜치 이름의 wiki 링크, 커밋 sha
bbe944bd로 적는다. 파생 서비스의 운영자는 그 번호와 브랜치를 찾을 수
없어 근거를 읽지 못한다.

번호마다 그 뜻을 문장으로 쓴다: 한도 없는 queue가 무너지는 이유,
CallerRunsPolicy가 요청 지연을 늘리는 이유, 종료 대기 19s와 k8s grace
period의 SIGKILL, 다시 해도 같은 오류는 곧바로 DLQ로. PARKED가 생긴
버전은 커밋 sha 대신 V22 migration으로 가리킨다. 「관련 branch」 줄은
지우고, 「관련 runbook」의 wiki 링크는 상대 링크로 바꾼다.

위험: 문서만 바뀐다. 절차와 SQL 블록은 그대로다.

검증: python3 scripts/check-work-docs.py --history docs/runbooks에서
걸린 줄 0, check-docs.py OK.

Refs: round9 그룹 A 범위 밖 후속 6
2026-11-13 19:30:12 +09:00
..