DongHyeonkaandClaude Opus 5
95c0e680b5
The skill says drawings carry names and sentences go in <desc> and the paragraph beside the figure. I put sentences in node details and edge labels instead, and 27 of the 28 diagrams shipped with prose inside the canvas — "예측 다섯 개가 틀렸다", "아홉 번 조용히 실패했다", "막혀서 닿지 않는다". Only label and details render on the canvas; description does not. So every sentence moved to a noun phrase and the meaning stays in description, which was already carrying it. 막혀서 닿지 않는다 -> 차단 아홉 번 조용히 실패했다 -> 조용한 실패 9건 예측 다섯 개가 틀렸다 -> 틀린 예측 5건 로그아웃이 정리하지 않는다 -> 로그아웃 미정리 볼륨이 없으면 여기까지다 -> 볼륨 없음 Three node labels were sentences too and became names: 세션 스냅샷, 예측 선기록, 대조군 확보. What stays is what the rules protect — identifiers, commands and measured values: PRIMARY KEY (client_registration_id, principal_name), ValidationFailedException: 1 changesets check sum, nginx -t && nginx -s reload, SET LOCAL synchronous_commit TO OFF. Those are names of things, not prose about them. 294 canvas strings across 28 diagrams, none matching a sentence ending, average 11 characters. All 28 still lint clean and re-rendered. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
168 lines
5.2 KiB
JSON
168 lines
5.2 KiB
JSON
{
|
|
"version": "1.1",
|
|
"id": "renewal-to-serving-gap",
|
|
"title": "인증서 갱신이 서빙에 닿기까지",
|
|
"question": "certbot 이 갱신에 성공한 뒤 nginx 가 새 인증서를 서빙하기까지 무엇이 필요한가",
|
|
"type": "architecture",
|
|
"direction": "LR",
|
|
"audience": [
|
|
"TLS 종단을 직접 운영하는 인프라 엔지니어"
|
|
],
|
|
"summary": "certbot 은 live 심볼릭 링크를 갈아끼우지만 nginx 는 기동 시점에 읽은 인증서를 메모리에 들고 있다. 둘을 잇는 것은 reload 하나뿐이고 이 실험대에는 그것을 부르는 경로가 셋 다 비어 있었다.",
|
|
"alt": "certbot 이 archive 에 새 인증서를 쓰고 live 링크를 옮기지만, nginx 워커가 교체되지 않아 옛 인증서를 계속 서빙하는 구성.",
|
|
"long_description": "certbot renew 는 archive 디렉터리에 새 인증서를 쓰고 live 심볼릭 링크가 그것을 가리키게 한다. nginx 는 ssl_certificate 가 가리키는 파일을 기동 시점에 한 번 읽어 메모리에 보관하므로, 경로가 그대로여도 reload 없이는 옛 인증서를 계속 서빙한다. 이 실험대에서는 certbot-renew.service 의 ExecStartPost, renewal-hooks 의 세 디렉터리, certbot 의 nginx 플러그인이 모두 비어 있어 2305초 동안 옛 인증서가 서빙됐다. deploy 훅 하나를 넣자 같은 구간이 1~2초가 됐다.",
|
|
"source_context": {
|
|
"document": "docs/keycloak-session-store/final/document.md",
|
|
"document_sha256": "609353e10bfd37a9bbb6a79ecf2a32f3d3c02d5d161879a14ad4713e49e7e5e8",
|
|
"anchor": {
|
|
"kind": "heading",
|
|
"value": "D-4 · D-4a — 인증서, 그리고 이 실험대 최대의 발견",
|
|
"line": 497
|
|
}
|
|
},
|
|
"composition": {
|
|
"profile": "component-flow",
|
|
"diagram_only": true,
|
|
"reference_ids": [
|
|
"payment-event-flow"
|
|
],
|
|
"rationale": "이 절의 지배적 질문은 시간 순서가 아니라 '디스크의 새 인증서가 네트워크에 닿는 경로가 무엇인가' 이다. 경로의 유무가 핵심이므로 component-flow 를 골랐다."
|
|
},
|
|
"groups": [],
|
|
"nodes": [
|
|
{
|
|
"id": "certbot",
|
|
"label": "certbot renew",
|
|
"kind": "process",
|
|
"role": "source",
|
|
"emphasis": "primary",
|
|
"description": "ACME 로 새 인증서를 받아 archive 에 쓰고 live 링크를 옮긴다.",
|
|
"details": [
|
|
"--force-renewal"
|
|
],
|
|
"evidence": [
|
|
{
|
|
"start_line": 499,
|
|
"end_line": 504
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "live-link",
|
|
"label": "live/fullchain.pem",
|
|
"kind": "datastore",
|
|
"role": "store",
|
|
"emphasis": "primary",
|
|
"description": "심볼릭 링크. 경로는 그대로이고 가리키는 대상만 바뀐다.",
|
|
"details": [
|
|
"→ archive/cert2.pem"
|
|
],
|
|
"evidence": [
|
|
{
|
|
"start_line": 536,
|
|
"end_line": 540
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "deploy-hook",
|
|
"label": "renewal-hooks/deploy",
|
|
"kind": "process",
|
|
"role": "control",
|
|
"emphasis": "warning",
|
|
"description": "갱신이 실제로 일어났을 때만 실행된다. 이 실험대에서는 비어 있었다.",
|
|
"details": [
|
|
"nginx -t && nginx -s reload"
|
|
],
|
|
"evidence": [
|
|
{
|
|
"start_line": 527,
|
|
"end_line": 533
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "nginx",
|
|
"label": "nginx 워커",
|
|
"kind": "service",
|
|
"role": "target",
|
|
"emphasis": "primary",
|
|
"description": "기동 시점에 읽은 인증서를 메모리에 들고 있다. reload 해야 새 워커가 새 인증서를 읽는다.",
|
|
"details": [
|
|
"마스터 유지 · 워커 교체"
|
|
],
|
|
"evidence": [
|
|
{
|
|
"start_line": 541,
|
|
"end_line": 548
|
|
}
|
|
],
|
|
"assumption": false
|
|
}
|
|
],
|
|
"edges": [
|
|
{
|
|
"id": "write",
|
|
"from": "certbot",
|
|
"to": "live-link",
|
|
"label": "새 인증서 기록",
|
|
"kind": "write",
|
|
"evidence": [
|
|
{
|
|
"start_line": 504,
|
|
"end_line": 510
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "needs-reload",
|
|
"from": "live-link",
|
|
"to": "nginx",
|
|
"label": "reload 필요",
|
|
"kind": "blocked",
|
|
"evidence": [
|
|
{
|
|
"start_line": 536,
|
|
"end_line": 540
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "trigger",
|
|
"from": "certbot",
|
|
"to": "deploy-hook",
|
|
"label": "갱신 성공 시 호출",
|
|
"kind": "request",
|
|
"evidence": [
|
|
{
|
|
"start_line": 527,
|
|
"end_line": 533
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "reload",
|
|
"from": "deploy-hook",
|
|
"to": "nginx",
|
|
"label": "reload 신호",
|
|
"kind": "request",
|
|
"evidence": [
|
|
{
|
|
"start_line": 556,
|
|
"end_line": 562
|
|
}
|
|
],
|
|
"assumption": false
|
|
}
|
|
],
|
|
"legend": [],
|
|
"metadata": {
|
|
"rationale": "갱신과 서빙을 두 사건으로 분리하고 그 사이에 reload 를 놓았다. 이 그림의 요지는 그 자리가 비어 있을 수 있다는 것이다."
|
|
}
|
|
} |