donghyeon.kang/document-haness
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

docs(keycloak-session-store): remake all 28 diagrams through the techviz pipeline

Browse Source 
The originating repository's SVGs were drawn by hand and every one of them
put a title, a subtitle and an explanation band inside the canvas. This
repository forbids both, so they could not be carried over — the whole set
was rebuilt through the skill's pipeline instead.

Each diagram went through prepare, references, prompt, a VizSpec 1.1 citing
document line ranges, lint, and render. All 28 pass lint and produce the
same eight formats the existing keycloak project has. Sentences moved out of
the canvas into <desc> and the paragraph beside each figure; the drawings
carry names only.

Two lint rules did real work rather than formatting work:

  edge-through-node                  caught arrows crossing an unrelated
                                     node and implying an adjacency that
                                     does not exist — four diagrams had to
                                     be restructured, not just relaid out
  evidence-outside-prepared-context  caught a diagram citing another
                                     section; its anchor moved from B-0 to
                                     B-1 so all three sections it draws on
                                     are inside the prepared context

lab-topology also had to change profile: its context offers a different
candidate set, and query-fanout with shard roles is what the section
actually shows — one entry point spreading to two Keycloak nodes.

The document now carries all 28 inline, one per claim that needed one, and
the section recording what was still missing is updated: the diagram gap is
closed, Studio records remain.

verify-pipeline.py passes. audit-records.py reports no issues.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
DongHyeonka
2026-09-05 11:03:10 +09:00
co-authored by Claude Opus 5
parent b2963105a8
commit 75bed382c8
286 changed files with 65385 additions and 710 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/keycloak-session-store/final/assets/d4a-hook-effect/d4a-hook-effect.alt.md
+22
View File
@@ -0,0 +1,22 @@
# 훅 하나가 만드는 차이
## Alternative text
certbot 이 갱신에 성공한 뒤 deploy 훅이 nginx 를 reload 하는 경로와, 그 훅이 없어 사람이 개입해야 하는 경로가 갈리는 구성.
## Long description
훅이 없을 때 새 인증서가 디스크에 기록된 08:20:27 과 실제로 서빙된 08:58:52 사이가 2305초였고, 그것도 사람이 nginx -s reload 를 쳤기 때문이다. deploy 훅을 넣자 발급에서 서빙까지 1~2초가 됐다. 판정은 문구가 아니라 워커 PID 로 한다. certbot 이 Hook 'deploy-hook' ran with error output 이라고 찍지만 실패가 아니며 nginx 의 types_hash 경고가 stderr 로 나갔을 뿐이다. 로그에서 error 를 grep 하는 감시는 성공한 훅을 실패로 오독한다.
## Elements and evidence
- **certbot 갱신 성공** (process): archive 에 쓰고 live 링크를 옮긴다. Evidence: L560–L570.
- **deploy 훅** (process): 갱신이 실제로 일어났을 때만 실행된다. Evidence: L560–L575.
- **nginx 워커 교체** (process): 마스터는 유지되고 워커만 새로 뜬다. Evidence: L571–L580.
- **새 인증서 서빙** (service): 훅이 없으면 사람이 칠 때까지 옛 것이다. Evidence: L560–L580.
## Relationships
- **deploy 훅 → nginx 워커 교체:** reload 신호. Evidence: L560–L580.
- **certbot 갱신 성공 → deploy 훅:** 갱신 성공 시 호출. Evidence: L560–L575.
- **nginx 워커 교체 → 새 인증서 서빙:** 새 워커가 새 인증서를 읽는다. Evidence: L571–L580.
docs/keycloak-session-store/final/assets/d4a-hook-effect/d4a-hook-effect.d2
+18
View File
@@ -0,0 +1,18 @@
# 훅 하나가 만드는 차이
# Question: 갱신을 서빙으로 잇는 자리는 무엇인가
direction: down
n0: "certbot 갱신 성공" {
shape: rectangle
}
n1: "deploy 훅" {
shape: rectangle
}
n2: "nginx 워커 교체" {
shape: rectangle
}
n3: "새 인증서 서빙" {
shape: rectangle
}
n0 -> n1: "갱신 성공 시 호출"
n1 -> n2: "reload 신호"
n2 -> n3: "새 워커가 새 인증서를 읽는다"
docs/keycloak-session-store/final/assets/d4a-hook-effect/d4a-hook-effect.dot
+12
View File
@@ -0,0 +1,12 @@
digraph techviz {
graph [rankdir=TB, splines=ortho, nodesep=0.55, ranksep=0.85];
node [fontname=Helvetica, fontsize=11, margin="0.18,0.12", style="rounded,filled", fillcolor=white, color="#2d4357", penwidth=1.5];
edge [fontname=Helvetica, fontsize=10, color="#364b5f", penwidth=1.4, arrowsize=0.75];
n0 [label="certbot 갱신 성공", shape=box, style="rounded,filled"];
n1 [label="deploy 훅", shape=box, style="rounded,filled"];
n2 [label="nginx 워커 교체", shape=box, style="rounded,filled"];
n3 [label="새 인증서 서빙", shape=box, style="rounded,filled"];
n0 -> n1 [label="갱신 성공 시 호출", style=solid];
n1 -> n2 [label="reload 신호", style=solid];
n2 -> n3 [label="새 워커가 새 인증서를 읽는다", style=solid];
}
docs/keycloak-session-store/final/assets/d4a-hook-effect/d4a-hook-effect.drawio
+38
View File
@@ -0,0 +1,38 @@
<?xml version="1.0" encoding="UTF-8"?>
<mxfile host="app.diagrams.net" modified="2026-07-23T00:00:00.000Z" agent="techviz-harness" version="24.7.17" type="device">
<diagram id="d4a-hook-effect" name="훅 하나가 만드는 차이">
<mxGraphModel dx="680" dy="670" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="827" pageHeight="1169" math="0" shadow="0">
<root>
<mxCell id="0"/>
<mxCell id="1" parent="0"/>
<mxCell id="n_renew" value="certbot 갱신 성공" tooltip="archive 에 쓰고 live 링크를 옮긴다. | Evidence: L560-L570" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
<mxGeometry x="106.5" y="60.0" width="150.0" height="64.0" as="geometry"/>
</mxCell>
<mxCell id="n_hook" value="deploy 훅&lt;br/&gt;nginx -t &amp;&amp; nginx -s reload" tooltip="갱신이 실제로 일어났을 때만 실행된다. | Evidence: L560-L575" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
<mxGeometry x="70.0" y="220.0" width="223.0" height="71.0" as="geometry"/>
</mxCell>
<mxCell id="n_worker" value="nginx 워커 교체&lt;br/&gt;28829 → 37252" tooltip="마스터는 유지되고 워커만 새로 뜬다. | Evidence: L571-L580" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
<mxGeometry x="106.5" y="387.0" width="150.0" height="71.0" as="geometry"/>
</mxCell>
<mxCell id="n_serving" value="새 인증서 서빙&lt;br/&gt;훅 없음 2305초 · 훅 있음 1~2초" tooltip="훅이 없으면 사람이 칠 때까지 옛 것이다. | Evidence: L560-L580" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
<mxGeometry x="87.5" y="554.0" width="188.0" height="71.0" as="geometry"/>
</mxCell>
<mxCell id="e_h-w" value="reload 신호" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_hook" target="n_worker">
<mxGeometry relative="1" as="geometry">
<mxPoint x="205.5" y="339.0" as="offset"/>
</mxGeometry>
</mxCell>
<mxCell id="e_r-h" value="갱신 성공 시 호출" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_renew" target="n_hook">
<mxGeometry relative="1" as="geometry">
<mxPoint x="205.5" y="172.0" as="offset"/>
</mxGeometry>
</mxCell>
<mxCell id="e_w-s" value="새 워커가 새 인증서를 읽는다" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_worker" target="n_serving">
<mxGeometry relative="1" as="geometry">
<mxPoint x="205.5" y="506.0" as="offset"/>
</mxGeometry>
</mxCell>
</root>
</mxGraphModel>
</diagram>
</mxfile>
docs/keycloak-session-store/final/assets/d4a-hook-effect/d4a-hook-effect.excalidraw
+586
View File
@@ -0,0 +1,586 @@
{
"type": "excalidraw",
"version": 2,
"source": "techviz-harness",
"elements": [
{
"id": "edge-h-w",
"type": "arrow",
"x": 181.5,
"y": 291.0,
"width": 0.0,
"height": 96.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "solid",
"roughness": 1,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": null,
"seed": 1181325743,
"version": 1,
"versionNonce": 140076830,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"points": [
[
0.0,
0.0
],
[
0.0,
48.0
],
[
0.0,
48.0
],
[
0.0,
96.0
]
],
"lastCommittedPoint": null,
"startBinding": {
"elementId": "node-hook",
"focus": 0,
"gap": 4
},
"endBinding": {
"elementId": "node-worker",
"focus": 0,
"gap": 4
},
"startArrowhead": null,
"endArrowhead": "arrow",
"elbowed": true
},
{
"id": "edge-label-h-w",
"type": "text",
"x": 160.5,
"y": 327.0,
"width": 90,
"height": 24,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 1,
"strokeStyle": "solid",
"roughness": 0,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 611698824,
"version": 1,
"versionNonce": 767259210,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 13,
"fontFamily": 5,
"text": "reload 신호",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "reload 신호",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "edge-r-h",
"type": "arrow",
"x": 181.5,
"y": 124.0,
"width": 0.0,
"height": 96.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "solid",
"roughness": 1,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": null,
"seed": 937318733,
"version": 1,
"versionNonce": 1126736476,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"points": [
[
0.0,
0.0
],
[
0.0,
48.0
],
[
0.0,
48.0
],
[
0.0,
96.0
]
],
"lastCommittedPoint": null,
"startBinding": {
"elementId": "node-renew",
"focus": 0,
"gap": 4
},
"endBinding": {
"elementId": "node-hook",
"focus": 0,
"gap": 4
},
"startArrowhead": null,
"endArrowhead": "arrow",
"elbowed": true
},
{
"id": "edge-label-r-h",
"type": "text",
"x": 160.5,
"y": 160.0,
"width": 90,
"height": 24,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 1,
"strokeStyle": "solid",
"roughness": 0,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 1300676751,
"version": 1,
"versionNonce": 159837689,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 13,
"fontFamily": 5,
"text": "갱신 성공 시 호출",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "갱신 성공 시 호출",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "edge-w-s",
"type": "arrow",
"x": 181.5,
"y": 458.0,
"width": 0.0,
"height": 96.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "solid",
"roughness": 1,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": null,
"seed": 635791852,
"version": 1,
"versionNonce": 232690295,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"points": [
[
0.0,
0.0
],
[
0.0,
48.0
],
[
0.0,
48.0
],
[
0.0,
96.0
]
],
"lastCommittedPoint": null,
"startBinding": {
"elementId": "node-worker",
"focus": 0,
"gap": 4
},
"endBinding": {
"elementId": "node-serving",
"focus": 0,
"gap": 4
},
"startArrowhead": null,
"endArrowhead": "arrow",
"elbowed": true
},
{
"id": "edge-label-w-s",
"type": "text",
"x": 141.5,
"y": 494.0,
"width": 128,
"height": 24,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 1,
"strokeStyle": "solid",
"roughness": 0,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 919243678,
"version": 1,
"versionNonce": 1666844084,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 13,
"fontFamily": 5,
"text": "새 워커가 새 인증서를 읽는다",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "새 워커가 새 인증서를 읽는다",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-renew",
"type": "rectangle",
"x": 106.5,
"y": 60.0,
"width": 150.0,
"height": 64.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "#ffffff",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "solid",
"roughness": 1,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 687891721,
"version": 1,
"versionNonce": 825729045,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-renew",
"type": "text",
"x": 116.5,
"y": 70.0,
"width": 130.0,
"height": 44.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 1,
"strokeStyle": "solid",
"roughness": 0,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 1764821854,
"version": 1,
"versionNonce": 408319867,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "certbot 갱신 성공",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "certbot 갱신 성공",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-hook",
"type": "rectangle",
"x": 70.0,
"y": 220.0,
"width": 223.0,
"height": 71.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "#ffffff",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "solid",
"roughness": 1,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 52798060,
"version": 1,
"versionNonce": 1762279132,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-hook",
"type": "text",
"x": 80.0,
"y": 230.0,
"width": 203.0,
"height": 51.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 1,
"strokeStyle": "solid",
"roughness": 0,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 1606824864,
"version": 1,
"versionNonce": 144284808,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "deploy 훅\nnginx -t && nginx -s reload",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "deploy 훅\nnginx -t && nginx -s reload",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-worker",
"type": "rectangle",
"x": 106.5,
"y": 387.0,
"width": 150.0,
"height": 71.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "#ffffff",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "solid",
"roughness": 1,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 30752778,
"version": 1,
"versionNonce": 414770937,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-worker",
"type": "text",
"x": 116.5,
"y": 397.0,
"width": 130.0,
"height": 51.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 1,
"strokeStyle": "solid",
"roughness": 0,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 1868671159,
"version": 1,
"versionNonce": 124169031,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "nginx 워커 교체\n28829 → 37252",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "nginx 워커 교체\n28829 → 37252",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-serving",
"type": "rectangle",
"x": 87.5,
"y": 554.0,
"width": 188.0,
"height": 71.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "#ffffff",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "solid",
"roughness": 1,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 1830555484,
"version": 1,
"versionNonce": 1718998402,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-serving",
"type": "text",
"x": 97.5,
"y": 564.0,
"width": 168.0,
"height": 51.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 1,
"strokeStyle": "solid",
"roughness": 0,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 84142791,
"version": 1,
"versionNonce": 1400725333,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "새 인증서 서빙\n훅 없음 2305초 · 훅 있음 1~2초",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "새 인증서 서빙\n훅 없음 2305초 · 훅 있음 1~2초",
"autoResize": true,
"lineHeight": 1.25
}
],
"appState": {
"gridSize": 10,
"viewBackgroundColor": "#ffffff",
"currentItemFontFamily": 5
},
"files": {}
}
docs/keycloak-session-store/final/assets/d4a-hook-effect/d4a-hook-effect.manifest.json
+32
View File
@@ -0,0 +1,32 @@
{
"harness_version": "0.2.0",
"spec_id": "d4a-hook-effect",
"spec_version": "1.1",
"spec_sha256": "59efe2ccd992f17d10ab3dfb326165c08f77c325c5d080f339ea556a07daefe3",
"source_context": {
"document": "docs/keycloak-session-store/final/document.md",
"document_sha256": "1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe",
"anchor": {
"kind": "heading",
"value": "D-4 · D-4a — 인증서, 그리고 이 실험대 최대의 발견",
"line": 509
}
},
"outputs": [
"d4a-hook-effect.svg",
"d4a-hook-effect.mmd",
"d4a-hook-effect.d2",
"d4a-hook-effect.dot",
"d4a-hook-effect.drawio",
"d4a-hook-effect.excalidraw",
"d4a-hook-effect.alt.md"
],
"lint_issue_count": 0,
"assumption_count": 0,
"assumptions_allowed": false,
"composition_profile": "component-flow",
"reference_ids": [
"payment-event-flow"
],
"diagram_only": true
}
docs/keycloak-session-store/final/assets/d4a-hook-effect/d4a-hook-effect.mmd
+10
View File
@@ -0,0 +1,10 @@
%% 훅 하나가 만드는 차이
%% question: 갱신을 서빙으로 잇는 자리는 무엇인가
flowchart TB
n0["certbot 갱신 성공"]
n1["deploy 훅"]
n2["nginx 워커 교체"]
n3["새 인증서 서빙"]
n0 -->|"갱신 성공 시 호출"| n1
n1 -->|"reload 신호"| n2
n2 -->|"새 워커가 새 인증서를 읽는다"| n3
docs/keycloak-session-store/final/assets/d4a-hook-effect/d4a-hook-effect.svg
+84
View File
@@ -0,0 +1,84 @@
<?xml version="1.0" encoding="UTF-8"?>
<svg xmlns="http://www.w3.org/2000/svg" width="680" height="670" viewBox="0 0 680 670" role="img" aria-labelledby="diagram-title diagram-description">
<title id="diagram-title">훅 하나가 만드는 차이</title>
<desc id="diagram-description">훅이 없을 때 새 인증서가 디스크에 기록된 08:20:27 과 실제로 서빙된 08:58:52 사이가 2305초였고, 그것도 사람이 nginx -s reload 를 쳤기 때문이다. deploy 훅을 넣자 발급에서 서빙까지 1~2초가 됐다. 판정은 문구가 아니라 워커 PID 로 한다. certbot 이 Hook &#x27;deploy-hook&#x27; ran with error output 이라고 찍지만 실패가 아니며 nginx 의 types_hash 경고가 stderr 로 나갔을 뿐이다. 로그에서 error 를 grep 하는 감시는 성공한 훅을 실패로 오독한다.</desc>
<metadata>{&quot;techviz&quot;:{&quot;spec_version&quot;:&quot;1.1&quot;,&quot;id&quot;:&quot;d4a-hook-effect&quot;,&quot;profile&quot;:&quot;component-flow&quot;},&quot;source_context&quot;:{&quot;document&quot;:&quot;docs/keycloak-session-store/final/document.md&quot;,&quot;document_sha256&quot;:&quot;1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe&quot;,&quot;anchor&quot;:{&quot;kind&quot;:&quot;heading&quot;,&quot;value&quot;:&quot;D-4 · D-4a — 인증서, 그리고 이 실험대 최대의 발견&quot;,&quot;line&quot;:509}},&quot;evidence_policy&quot;:&quot;Each factual element cites source lines or is marked assumption.&quot;,&quot;diagram_only&quot;:true}</metadata>
<defs>
<marker id="arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
<path d="M 0 0 L 10 5 L 0 10 z" />
</marker>
<style>
:root { color-scheme: light; }
text { font-family: Inter, Pretendard, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #111827; }
.canvas { fill: #ffffff; }
.group-box { fill: #ffffff; stroke: #9ca3af; stroke-width: 1.4; stroke-dasharray: 7 5; }
.group-label-bg { fill: #ffffff; }
.group-label { font-size: 13px; font-weight: 650; fill: #374151; }
.edge { fill: none; stroke: #374151; stroke-width: 1.8; stroke-linejoin: round; stroke-linecap: round; marker-end: url(#arrow); }
.edge.style-dashed, .edge.semantic-dashed, .edge.assumption { stroke-dasharray: 7 5; }
.edge.style-dotted { stroke-dasharray: 2 5; }
.edge.emphasis-primary { stroke: #2563eb; stroke-width: 2.2; }
.edge.emphasis-muted { stroke: #9ca3af; }
.edge.emphasis-warning, .edge.kind-failure, .edge.kind-error { stroke: #dc2626; stroke-width: 2.2; }
.edge-label-bg { fill: #ffffff; }
.edge-label { font-size: 12px; font-weight: 560; text-anchor: middle; }
.node-shape { fill: #ffffff; stroke: #4b5563; stroke-width: 1.7; }
.node-shape.emphasis-primary { stroke: #2563eb; stroke-width: 2.2; }
.node-shape.emphasis-muted { stroke: #9ca3af; fill: #f9fafb; }
.node-shape.emphasis-warning { stroke: #d97706; stroke-width: 2; fill: #fffdf5; }
.node-shape.kind-database, .node-shape.kind-datastore, .node-shape.kind-storage { fill: #f8fafc; }
.node-shape.kind-queue, .node-shape.kind-event, .node-shape.kind-topic { fill: #fafafa; }
.node-shape.assumption { stroke-dasharray: 4 4; }
.storage-bottom, .controller-divider { fill: none; stroke: #4b5563; stroke-width: 1.4; }
.controller-led { fill: #4b5563; }
.actor-symbol { fill: none; stroke: #4b5563; stroke-width: 1.8; stroke-linecap: round; }
.actor-symbol.emphasis-primary { stroke: #2563eb; stroke-width: 2.2; }
.node-label { font-size: 14px; font-weight: 650; text-anchor: middle; }
.node-role { font-size: 10px; letter-spacing: 0.04em; text-anchor: middle; fill: #6b7280; }
.node-detail-divider { stroke: #d1d5db; stroke-width: 1; }
.node-detail { font-size: 11px; fill: #374151; }
.assumption-badge { font-size: 9px; font-weight: 700; fill: #92400e; }
.failure-mark { stroke: #dc2626; stroke-width: 4; stroke-linecap: round; }
.lifeline { stroke: #9ca3af; stroke-width: 1.2; stroke-dasharray: 5 5; }
.timeline-axis { stroke: #374151; stroke-width: 1.8; marker-end: url(#arrow); }
.timeline-stem { stroke: #6b7280; stroke-width: 1.3; }
.timeline-marker { fill: #ffffff; stroke: #374151; stroke-width: 1.7; }
.timeline-marker.primary { fill: #2563eb; stroke: #2563eb; }
.timeline-marker.warning { fill: #dc2626; stroke: #dc2626; }
.timeline-label { font-size: 13px; font-weight: 650; text-anchor: middle; }
.timeline-detail { font-size: 11px; fill: #4b5563; text-anchor: middle; }
</style>
</defs>
<rect class="canvas" width="680" height="670" />
<polyline class="edge kind-request style-solid emphasis-normal" points="181.5,291.0 181.5,339.0 181.5,339.0 181.5,387.0" data-evidence="560-580" />
<rect class="edge-label-bg" x="166.3" y="325.0" width="78.3" height="22" rx="3" />
<text class="edge-label" x="205.5" y="340.0">reload 신호</text>
<polyline class="edge kind-request style-solid emphasis-normal" points="181.5,124.0 181.5,172.0 181.5,172.0 181.5,220.0" data-evidence="560-575" />
<rect class="edge-label-bg" x="163.0" y="158.0" width="85.0" height="22" rx="3" />
<text class="edge-label" x="205.5" y="173.0">갱신 성공 시 호출</text>
<polyline class="edge kind-request style-solid emphasis-normal" points="181.5,458.0 181.5,506.0 181.5,506.0 181.5,554.0" data-evidence="571-580" />
<rect class="edge-label-bg" x="142.9" y="492.0" width="125.2" height="22" rx="3" />
<text class="edge-label" x="205.5" y="507.0">새 워커가 새 인증서를 읽는다</text>
<g id="node-renew">
<rect class="node-shape kind-process emphasis-primary role-source" data-evidence="560-570" x="106.5" y="60.0" width="150.0" height="64.0" rx="7" />
<text class="node-label" x="181.5" y="90.0">certbot 갱신 성공</text>
</g>
<g id="node-hook">
<rect class="node-shape kind-process emphasis-primary role-control" data-evidence="560-575" x="70.0" y="220.0" width="223.0" height="71.0" rx="7" />
<text class="node-label" x="181.5" y="247.0">deploy 훅</text>
<line class="node-detail-divider" x1="84.0" y1="268.0" x2="279.0" y2="268.0" />
<text class="node-detail" x="86.0" y="285.0">nginx -t &amp;&amp; nginx -s reload</text>
</g>
<g id="node-worker">
<rect class="node-shape kind-process emphasis-primary role-control" data-evidence="571-580" x="106.5" y="387.0" width="150.0" height="71.0" rx="7" />
<text class="node-label" x="181.5" y="414.0">nginx 워커 교체</text>
<line class="node-detail-divider" x1="120.5" y1="435.0" x2="242.5" y2="435.0" />
<text class="node-detail" x="122.5" y="452.0">28829 → 37252</text>
</g>
<g id="node-serving">
<rect class="node-shape kind-service emphasis-primary role-target" data-evidence="560-580" x="87.5" y="554.0" width="188.0" height="71.0" rx="7" />
<text class="node-label" x="181.5" y="581.0">새 인증서 서빙</text>
<line class="node-detail-divider" x1="101.5" y1="602.0" x2="261.5" y2="602.0" />
<text class="node-detail" x="103.5" y="619.0">훅 없음 2305초 · 훅 있음 1~2초</text>
</g>
</svg>
Side by Side

After

Width:  |  Height:  |  Size: 6.9 KiB