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/b5-b6-storage-and-keys/b5-b6-storage-and-keys.alt.md
+22
View File
@@ -0,0 +1,22 @@
# 볼륨 없는 영속화와 유예 없는 회전
## Alternative text
Redis 의 데이터 디렉터리가 컨테이너 파일시스템일 때 영속화 설정이 무의미해지는 구성과, 새 kid 를 만난 검증기가 JWKS 를 재조회하는 구성.
## Long description
redis-cli config set appendonly yes 를 켜도 아무것도 달라지지 않았다. /data 가 컨테이너 파일시스템이라 컨테이너와 함께 죽기 때문이다. appendonlydir 이 만들어졌다가 그대로 버려진다. 볼륨 없는 영속화 설정은 장식이다. realm 키를 회전했을 때는 JWKS 캐시의 유예 구간을 기대했는데 없었다. NimbusJwtDecoder 는 모르는 kid 를 만나면 JWKS 를 다시 가져온다.
## Elements and evidence
- **appendonly yes** (process): 설정은 적용된다. Evidence: L406–L412.
- **/data** (datastore): 컨테이너 파일시스템이다. Evidence: L406–L412.
- **컨테이너** (component): 죽으면 /data 도 같이 사라진다. Evidence: L406–L412.
- **PersistentVolume** (datastore): 여기 있어야 설정이 뜻을 갖는다. Evidence: L406–L412.
## Relationships
- **appendonly yes → /data:** AOF 파일을 쓴다. Evidence: L406–L412.
- **/data → 컨테이너:** 컨테이너와 함께 죽는다. Evidence: L406–L412.
- **/data → PersistentVolume:** 볼륨을 붙여야 남는다. Evidence: L406–L412.
docs/keycloak-session-store/final/assets/b5-b6-storage-and-keys/b5-b6-storage-and-keys.d2
+18
View File
@@ -0,0 +1,18 @@
# 볼륨 없는 영속화와 유예 없는 회전
# Question: 설정만으로 영속화와 무중단 키 교체가 되는가
direction: down
n0: "appendonly yes" {
shape: rectangle
}
n1: "/data" {
shape: cylinder
}
n2: "컨테이너" {
shape: rectangle
}
n3: "PersistentVolume" {
shape: cylinder
}
n0 -> n1: "AOF 파일을 쓴다"
n1 -> n2: "컨테이너와 함께 죽는다"
n1 -> n3: "볼륨을 붙여야 남는다"
docs/keycloak-session-store/final/assets/b5-b6-storage-and-keys/b5-b6-storage-and-keys.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="appendonly yes", shape=box, style="rounded,filled"];
n1 [label="/data", shape=cylinder, style="rounded,filled"];
n2 [label="컨테이너", shape=box, style="rounded,filled"];
n3 [label="PersistentVolume", shape=cylinder, style="rounded,filled"];
n0 -> n1 [label="AOF 파일을 쓴다", style=solid];
n1 -> n2 [label="컨테이너와 함께 죽는다", style=solid];
n1 -> n3 [label="볼륨을 붙여야 남는다", style=solid];
}
docs/keycloak-session-store/final/assets/b5-b6-storage-and-keys/b5-b6-storage-and-keys.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="b5-b6-storage-and-keys" name="볼륨 없는 영속화와 유예 없는 회전">
<mxGraphModel dx="680" dy="555" 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_config" value="appendonly yes&lt;br/&gt;redis-cli config set" tooltip="설정은 적용된다. | Evidence: L406-L412" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#d97706;fillColor=#fffdf5;" vertex="1" parent="1">
<mxGeometry x="163.0" y="60.0" width="174.0" height="71.0" as="geometry"/>
</mxCell>
<mxCell id="n_datadir" value="/data&lt;br/&gt;appendonlydir 이 만들어졌다 버려진다" tooltip="컨테이너 파일시스템이다. | Evidence: L406-L412" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;shape=cylinder3;boundedLbl=1;backgroundOutline=1;fillColor=#eef6fb;strokeColor=#d97706;fillColor=#fffdf5;" vertex="1" parent="1">
<mxGeometry x="142.0" y="227.0" width="216.0" height="97.0" as="geometry"/>
</mxCell>
<mxCell id="n_container" value="컨테이너&lt;br/&gt;볼륨이 없으면 여기까지다" tooltip="죽으면 /data 도 같이 사라진다. | Evidence: L406-L412" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#d97706;fillColor=#fffdf5;" vertex="1" parent="1">
<mxGeometry x="70.0" y="429.5" width="150.0" height="71.0" as="geometry"/>
</mxCell>
<mxCell id="n_volume" value="PersistentVolume" tooltip="여기 있어야 설정이 뜻을 갖는다. | Evidence: L406-L412" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;shape=cylinder3;boundedLbl=1;backgroundOutline=1;fillColor=#eef6fb;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
<mxGeometry x="280.0" y="420.0" width="150.0" height="90.0" as="geometry"/>
</mxCell>
<mxCell id="e_c-d" value="AOF 파일을 쓴다" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_config" target="n_datadir">
<mxGeometry relative="1" as="geometry">
<mxPoint x="274.0" y="179.0" as="offset"/>
</mxGeometry>
</mxCell>
<mxCell id="e_d-c" value="컨테이너와 함께 죽는다" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_datadir" target="n_container">
<mxGeometry relative="1" as="geometry">
<mxPoint x="193.0" y="348.8" as="offset"/>
</mxGeometry>
</mxCell>
<mxCell id="e_d-v" value="볼륨을 붙여야 남는다" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_datadir" target="n_volume">
<mxGeometry relative="1" as="geometry">
<mxPoint x="307.0" y="344.0" as="offset"/>
</mxGeometry>
</mxCell>
</root>
</mxGraphModel>
</diagram>
</mxfile>
docs/keycloak-session-store/final/assets/b5-b6-storage-and-keys/b5-b6-storage-and-keys.excalidraw
+586
View File
@@ -0,0 +1,586 @@
{
"type": "excalidraw",
"version": 2,
"source": "techviz-harness",
"elements": [
{
"id": "edge-c-d",
"type": "arrow",
"x": 250.0,
"y": 131.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": 1041793716,
"version": 1,
"versionNonce": 152807890,
"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-config",
"focus": 0,
"gap": 4
},
"endBinding": {
"elementId": "node-datadir",
"focus": 0,
"gap": 4
},
"startArrowhead": null,
"endArrowhead": "arrow",
"elbowed": true
},
{
"id": "edge-label-c-d",
"type": "text",
"x": 229.0,
"y": 167.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": 1623889644,
"version": 1,
"versionNonce": 941350353,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 13,
"fontFamily": 5,
"text": "AOF 파일을 쓴다",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "AOF 파일을 쓴다",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "edge-d-c",
"type": "arrow",
"x": 145.0,
"y": 324.0,
"width": 96.0,
"height": 105.5,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "solid",
"roughness": 1,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": null,
"seed": 1710772655,
"version": 1,
"versionNonce": 825890023,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"points": [
[
96.0,
0.0
],
[
96.0,
52.75
],
[
0.0,
52.75
],
[
0.0,
105.5
]
],
"lastCommittedPoint": null,
"startBinding": {
"elementId": "node-datadir",
"focus": 0,
"gap": 4
},
"endBinding": {
"elementId": "node-container",
"focus": 0,
"gap": 4
},
"startArrowhead": null,
"endArrowhead": "arrow",
"elbowed": true
},
{
"id": "edge-label-d-c",
"type": "text",
"x": 145.0,
"y": 336.75,
"width": 96,
"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": 1795748316,
"version": 1,
"versionNonce": 1772431002,
"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-d-v",
"type": "arrow",
"x": 259.0,
"y": 324.0,
"width": 96.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": 1778945409,
"version": 1,
"versionNonce": 128234071,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"points": [
[
0.0,
0.0
],
[
0.0,
48.0
],
[
96.0,
48.0
],
[
96.0,
96.0
]
],
"lastCommittedPoint": null,
"startBinding": {
"elementId": "node-datadir",
"focus": 0,
"gap": 4
},
"endBinding": {
"elementId": "node-volume",
"focus": 0,
"gap": 4
},
"startArrowhead": null,
"endArrowhead": "arrow",
"elbowed": true
},
{
"id": "edge-label-d-v",
"type": "text",
"x": 262.0,
"y": 332.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": 1825891785,
"version": 1,
"versionNonce": 120899807,
"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-config",
"type": "rectangle",
"x": 163.0,
"y": 60.0,
"width": 174.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": 736776605,
"version": 1,
"versionNonce": 1424542118,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-config",
"type": "text",
"x": 173.0,
"y": 70.0,
"width": 154.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": 802906507,
"version": 1,
"versionNonce": 72227637,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "appendonly yes\nredis-cli config set",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "appendonly yes\nredis-cli config set",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-datadir",
"type": "rectangle",
"x": 142.0,
"y": 227.0,
"width": 216.0,
"height": 97.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "#e7f5ff",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "solid",
"roughness": 1,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 253670220,
"version": 1,
"versionNonce": 694258328,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-datadir",
"type": "text",
"x": 152.0,
"y": 237.0,
"width": 196.0,
"height": 77.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": 1101224859,
"version": 1,
"versionNonce": 1801986568,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "/data\nappendonlydir 이 만들어졌다 버려진다",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "/data\nappendonlydir 이 만들어졌다 버려진다",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-container",
"type": "rectangle",
"x": 70.0,
"y": 429.5,
"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": 899340409,
"version": 1,
"versionNonce": 719103033,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-container",
"type": "text",
"x": 80.0,
"y": 439.5,
"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": 625860718,
"version": 1,
"versionNonce": 292100911,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "컨테이너\n볼륨이 없으면 여기까지다",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "컨테이너\n볼륨이 없으면 여기까지다",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-volume",
"type": "rectangle",
"x": 280.0,
"y": 420.0,
"width": 150.0,
"height": 90.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "#e7f5ff",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "solid",
"roughness": 1,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 690472711,
"version": 1,
"versionNonce": 62320937,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-volume",
"type": "text",
"x": 290.0,
"y": 430.0,
"width": 130.0,
"height": 70.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": 964975471,
"version": 1,
"versionNonce": 313361807,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "PersistentVolume",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "PersistentVolume",
"autoResize": true,
"lineHeight": 1.25
}
],
"appState": {
"gridSize": 10,
"viewBackgroundColor": "#ffffff",
"currentItemFontFamily": 5
},
"files": {}
}
docs/keycloak-session-store/final/assets/b5-b6-storage-and-keys/b5-b6-storage-and-keys.manifest.json
+32
View File
@@ -0,0 +1,32 @@
{
"harness_version": "0.2.0",
"spec_id": "b5-b6-storage-and-keys",
"spec_version": "1.1",
"spec_sha256": "51b618881bf3ef23a734b2beb319e756c12a9a7ff1ae578b7b5ef78a1461b0e9",
"source_context": {
"document": "docs/keycloak-session-store/final/document.md",
"document_sha256": "1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe",
"anchor": {
"kind": "heading",
"value": "B-5 · B-6 — 저장소 상실과 키 회전",
"line": 415
}
},
"outputs": [
"b5-b6-storage-and-keys.svg",
"b5-b6-storage-and-keys.mmd",
"b5-b6-storage-and-keys.d2",
"b5-b6-storage-and-keys.dot",
"b5-b6-storage-and-keys.drawio",
"b5-b6-storage-and-keys.excalidraw",
"b5-b6-storage-and-keys.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/b5-b6-storage-and-keys/b5-b6-storage-and-keys.mmd
+10
View File
@@ -0,0 +1,10 @@
%% 볼륨 없는 영속화와 유예 없는 회전
%% question: 설정만으로 영속화와 무중단 키 교체가 되는가
flowchart TB
n0["appendonly yes"]
n1[("/data")]
n2["컨테이너"]
n3[("PersistentVolume")]
n0 -->|"AOF 파일을 쓴다"| n1
n1 -->|"컨테이너와 함께 죽는다"| n2
n1 -->|"볼륨을 붙여야 남는다"| n3
docs/keycloak-session-store/final/assets/b5-b6-storage-and-keys/b5-b6-storage-and-keys.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="555" viewBox="0 0 680 555" role="img" aria-labelledby="diagram-title diagram-description">
<title id="diagram-title">볼륨 없는 영속화와 유예 없는 회전</title>
<desc id="diagram-description">redis-cli config set appendonly yes 를 켜도 아무것도 달라지지 않았다. /data 가 컨테이너 파일시스템이라 컨테이너와 함께 죽기 때문이다. appendonlydir 이 만들어졌다가 그대로 버려진다. 볼륨 없는 영속화 설정은 장식이다. realm 키를 회전했을 때는 JWKS 캐시의 유예 구간을 기대했는데 없었다. NimbusJwtDecoder 는 모르는 kid 를 만나면 JWKS 를 다시 가져온다.</desc>
<metadata>{&quot;techviz&quot;:{&quot;spec_version&quot;:&quot;1.1&quot;,&quot;id&quot;:&quot;b5-b6-storage-and-keys&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;B-5 · B-6 — 저장소 상실과 키 회전&quot;,&quot;line&quot;:415}},&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="555" />
<polyline class="edge kind-write style-solid emphasis-normal" points="250.0,131.0 250.0,179.0 250.0,179.0 250.0,227.0" data-evidence="406-412" />
<rect class="edge-label-bg" x="231.5" y="165.0" width="85.0" height="22" rx="3" />
<text class="edge-label" x="274.0" y="180.0">AOF 파일을 쓴다</text>
<polyline class="edge kind-blocked style-solid emphasis-normal" points="241.0,324.0 241.0,376.8 145.0,376.8 145.0,429.5" data-evidence="406-412" />
<rect class="edge-label-bg" x="143.8" y="334.8" width="98.4" height="22" rx="3" />
<text class="edge-label" x="193.0" y="349.8">컨테이너와 함께 죽는다</text>
<polyline class="edge kind-write style-solid emphasis-normal" points="259.0,324.0 259.0,372.0 355.0,372.0 355.0,420.0" data-evidence="406-412" />
<rect class="edge-label-bg" x="261.1" y="330.0" width="91.7" height="22" rx="3" />
<text class="edge-label" x="307.0" y="345.0">볼륨을 붙여야 남는다</text>
<g id="node-config">
<rect class="node-shape kind-process emphasis-warning role-source" data-evidence="406-412" x="163.0" y="60.0" width="174.0" height="71.0" rx="7" />
<text class="node-label" x="250.0" y="87.0">appendonly yes</text>
<line class="node-detail-divider" x1="177.0" y1="108.0" x2="323.0" y2="108.0" />
<text class="node-detail" x="179.0" y="125.0">redis-cli config set</text>
</g>
<g id="node-datadir">
<rect class="node-shape kind-datastore emphasis-warning role-control" data-evidence="406-412" x="142.0" y="240.0" width="216.0" height="71.0" /><ellipse class="node-shape kind-datastore emphasis-warning role-control" cx="250.0" cy="240.0" rx="108.0" ry="13.0" /><path class="storage-bottom" d="M 142.0 311.0 A 108.0 13.0 0 0 0 358.0 311.0" />
<text class="node-label" x="250.0" y="267.0">/data</text>
<line class="node-detail-divider" x1="156.0" y1="288.0" x2="344.0" y2="288.0" />
<text class="node-detail" x="158.0" y="305.0">appendonlydir 이 만들어졌다 버려진다</text>
</g>
<g id="node-container">
<rect class="node-shape kind-component emphasis-warning role-target" data-evidence="406-412" x="70.0" y="429.5" width="150.0" height="71.0" rx="7" />
<text class="node-label" x="145.0" y="456.5">컨테이너</text>
<line class="node-detail-divider" x1="84.0" y1="477.5" x2="206.0" y2="477.5" />
<text class="node-detail" x="86.0" y="494.5">볼륨이 없으면 여기까지다</text>
</g>
<g id="node-volume">
<rect class="node-shape kind-datastore emphasis-primary role-target" data-evidence="406-412" x="280.0" y="433.0" width="150.0" height="64.0" /><ellipse class="node-shape kind-datastore emphasis-primary role-target" cx="355.0" cy="433.0" rx="75.0" ry="13.0" /><path class="storage-bottom" d="M 280.0 497.0 A 75.0 13.0 0 0 0 430.0 497.0" />
<text class="node-label" x="355.0" y="463.0">PersistentVolume</text>
</g>
</svg>
Side by Side

After

Width:  |  Height:  |  Size: 7.2 KiB