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

feat(pipeline): keycloak-session-store 25편·virtualization 59편을 S3→S5→S6 으로 돌린다

Browse Source 
기록 84편을 계약 에이전트로 다시 썼다. 기존 71편(kss 25 · virt 46)과, 계약에만
있고 안 쓰여 있던 새 글감 13편이다. 원장 84개를 열어 단계마다 스킬 영수증과 관문
종료 코드를 적었고 verify-pipeline-run.py 가 error 0 으로 닫는다.

SSOT 결함 둘을 고쳤다.

- kss 의 `약 58일` 이 반입 중 `약 59일` 로 바뀌어 있었다. 원 증거 파일이
  「남은 일수: 88일 … 실제 갱신까지 약 58일」로 산수를 직접 적는다. D-4a 쪽
  `약 59일` 은 강제 갱신 뒤(`VALID: 89 days`)라 맞는 값이라 그대로 뒀다.
- virt §198 의 `11.6GB` 는 §178 의 원 측정 `Mem: 11648`(MiB)과 어긋나는데
  원 가이드의 표기 그대로라 고치지 않고 쓰이는 자리에 대조를 적었다.

기록의 수치 오류 셋을 고쳤다 — CASE 요약의 「게스트 셋에 8240MB」(5120+3120 은
둘이다), k3s 편이 같은 것을 여섯·일곱·여덟로 세던 것, no-docker 편의 「셋을 더
든다」(§281 의 표는 네 행이고 디스크 행이 빠져 있었다).

계약을 셋 고쳤다.

- kss 의 sourceRepository 리비전이 cdac9b8 이었는데 그 커밋에는 docs/guides/**
  28개가 아예 없다. 9465582b 로 바꾸고, 반입한 바이트가 어느 커밋과도 같지 않다는
  것을 측정값과 함께 적었다 — 반입은 커밋이 아니라 그 시점의 작업 트리에서 떠 온
  것이다(kss 297/306 · virt 12/14 가 작업 트리와 같고, 200 커밋을 거슬러 전수
  대조했을 때 가장 가까운 커밋도 28개가 어긋났다).
- virt 계약이 「2026-09-11 재배분」이라고 적는데 SSOT 는 재배분 날짜를 적지 않고
  재배분 뒤 값은 이미 2026-09-10 측정에 찍혀 있다.
- kss 후보 대장이 지나친 절 아홉에 처분을 적었다(warn 9 → 0). 새 글감은 0건이고
  넷은 앵커가 h3 슬러그의 접두가 아니라 중간 토막이라 검사기가 못 본 것이었다.

style_profile.mjs 의 결함 둘을 고쳤다 — frontmatter 가 문장으로 세어져
(실측 398자짜리 「문장」 하나) 평균 길이를 기준 안으로 밀어 올리고 있었고,
engPerSent 의 분자는 목록을 포함한 글에서, 분모는 목록을 걷어낸 글에서 세고
있었다(Question 기록에서 11.94 → 3.86).

verify-pipeline.py 전 항목 PASS · error 0 · unittest 334건 OK.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
DongHyeonka
2026-09-17 11:01:55 +09:00
co-authored by Claude Opus 5
parent d473609e0a
commit 2109f726fe
574 changed files with 159654 additions and 1551 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/keycloak-session-store/final/assets/ghost-row-cleanup-order/ghost-row-cleanup-order.alt.md
+24
View File
@@ -0,0 +1,24 @@
# 유령 행을 지운 쪽과 그 시각
## Alternative text
kubectl 이 강제 종료한 Keycloak 노드가 클러스터에서 빠지고, 남은 노드가 JGROUPS_PING 의 행을 지운 뒤 다른 이름의 새 노드가 합류하는 시간 순서.
## Long description
왼쪽부터 kubectl, keycloak-0-60375, keycloak-1-36736, JGROUPS_PING, keycloak-0-16105 다섯 참여자가 생명선으로 선다. 1번 메시지에서 kubectl 이 keycloak-0-60375 를 --grace-period=0 --force 로 끊는다. 2번에서 07:40:28 에 남은 노드 keycloak-1-36736 의 뷰에서 그 노드가 빠진다. 3번이 이 그림의 중심이다 — 같은 07:40:28 에 JGROUPS_PING 의 행을 지우는 화살표가 keycloak-1-36736 에서 나온다. 강제 종료로 이미 끊긴 keycloak-0-60375 의 생명선에서는 테이블로 가는 화살표가 없다. 4번에서 20초 뒤 07:40:48 에 keycloak-0-16105 가 합류한다. 돌아온 노드의 이름은 접두사 keycloak-0 만 같고 접미사가 다르다.
## Elements and evidence
- **kubectl** (participant): 파드를 정상 종료와 강제 종료로 끊는 쪽. Evidence: L886–L888.
- **keycloak-0-60375** (participant): 강제 종료로 끊긴 노드. 자기 행을 지우고 나갈 틈이 없다. Evidence: L898–L901.
- **keycloak-1-36736** (participant): 남아 있는 코디네이터. 정리 주체다. Evidence: L914–L916.
- **JGROUPS_PING** (participant): 노드 행이 등록되는 발견 테이블. Evidence: L888–L888.
- **keycloak-0-16105** (participant): 복구 뒤 올라온 노드. 접두사만 같다. Evidence: L918–L920.
## Relationships
- **kubectl → keycloak-0-60375:** delete pod --force. Evidence: L886–L888.
- **keycloak-0-60375 → keycloak-1-36736:** 이탈 07:40:28. Evidence: L906–L907.
- **keycloak-1-36736 → JGROUPS_PING:** 행 삭제 07:40:28. Evidence: L897–L898, L914–L916.
- **keycloak-0-16105 → keycloak-1-36736:** 합류 07:40:48. Evidence: L908–L909.
docs/keycloak-session-store/final/assets/ghost-row-cleanup-order/ghost-row-cleanup-order.d2
+22
View File
@@ -0,0 +1,22 @@
# 유령 행을 지운 쪽과 그 시각
# Question: SIGKILL 로 끊긴 노드의 JGROUPS_PING 행은 누가, 언제 지우는가
direction: right
n0: "kubectl" {
shape: rectangle
}
n1: "keycloak-0-60375" {
shape: rectangle
}
n2: "keycloak-1-36736" {
shape: rectangle
}
n3: "JGROUPS_PING" {
shape: rectangle
}
n4: "keycloak-0-16105" {
shape: rectangle
}
n0 -> n1: "delete pod --force"
n1 -> n2: "이탈 07:40:28" { style.stroke-dash: 4 }
n2 -> n3: "행 삭제 07:40:28"
n4 -> n2: "합류 07:40:48" { style.stroke-dash: 4 }
docs/keycloak-session-store/final/assets/ghost-row-cleanup-order/ghost-row-cleanup-order.dot
+14
View File
@@ -0,0 +1,14 @@
digraph techviz {
graph [rankdir=LR, 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="kubectl", shape=box, style="rounded,filled"];
n1 [label="keycloak-0-60375", shape=box, style="rounded,filled"];
n2 [label="keycloak-1-36736", shape=box, style="rounded,filled"];
n3 [label="JGROUPS_PING", shape=box, style="rounded,filled"];
n4 [label="keycloak-0-16105", shape=box, style="rounded,filled"];
n0 -> n1 [label="delete pod --force", style=solid];
n1 -> n2 [label="이탈 07:40:28", style=dashed];
n2 -> n3 [label="행 삭제 07:40:28", style=solid];
n4 -> n2 [label="합류 07:40:48", style=dashed];
}
docs/keycloak-session-store/final/assets/ghost-row-cleanup-order/ghost-row-cleanup-order.drawio
+46
View File
@@ -0,0 +1,46 @@
<?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="ghost-row-cleanup-order" name="유령 행을 지운 쪽과 그 시각">
<mxGraphModel dx="1080" dy="418" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1080" pageHeight="1169" math="0" shadow="0">
<root>
<mxCell id="0"/>
<mxCell id="1" parent="0"/>
<mxCell id="n_kubectl" value="kubectl" tooltip="파드를 정상 종료와 강제 종료로 끊는 쪽. | Evidence: L886-L888" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;" vertex="1" parent="1">
<mxGeometry x="45.0" y="35.0" width="150.0" height="64.0" as="geometry"/>
</mxCell>
<mxCell id="n_dying" value="keycloak-0-60375&lt;br/&gt;SIGKILL" tooltip="강제 종료로 끊긴 노드. 자기 행을 지우고 나갈 틈이 없다. | Evidence: L898-L901" 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="255.0" y="35.0" width="150.0" height="71.0" as="geometry"/>
</mxCell>
<mxCell id="n_coordinator" value="keycloak-1-36736&lt;br/&gt;코디네이터" tooltip="남아 있는 코디네이터. 정리 주체다. | Evidence: L914-L916" 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="465.0" y="35.0" width="150.0" height="71.0" as="geometry"/>
</mxCell>
<mxCell id="n_pingtable" value="JGROUPS_PING" tooltip="노드 행이 등록되는 발견 테이블. | Evidence: L888-L888" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;" vertex="1" parent="1">
<mxGeometry x="675.0" y="35.0" width="150.0" height="64.0" as="geometry"/>
</mxCell>
<mxCell id="n_rejoined" value="keycloak-0-16105&lt;br/&gt;새 접미사" tooltip="복구 뒤 올라온 노드. 접두사만 같다. | Evidence: L918-L920" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;" vertex="1" parent="1">
<mxGeometry x="885.0" y="35.0" width="150.0" height="71.0" as="geometry"/>
</mxCell>
<mxCell id="e_m1" value="delete pod --force" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_kubectl" target="n_dying">
<mxGeometry relative="1" as="geometry">
<mxPoint x="225.0" y="128.0" as="offset"/>
</mxGeometry>
</mxCell>
<mxCell id="e_m2" value="이탈 07:40:28" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;dashed=1;" edge="1" parent="1" source="n_dying" target="n_coordinator">
<mxGeometry relative="1" as="geometry">
<mxPoint x="435.0" y="190.0" as="offset"/>
</mxGeometry>
</mxCell>
<mxCell id="e_m3" value="행 삭제 07:40:28" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_coordinator" target="n_pingtable">
<mxGeometry relative="1" as="geometry">
<mxPoint x="645.0" y="252.0" as="offset"/>
</mxGeometry>
</mxCell>
<mxCell id="e_m4" value="합류 07:40:48" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;dashed=1;" edge="1" parent="1" source="n_rejoined" target="n_coordinator">
<mxGeometry relative="1" as="geometry">
<mxPoint x="750.0" y="314.0" as="offset"/>
</mxGeometry>
</mxCell>
</root>
</mxGraphModel>
</diagram>
</mxfile>
docs/keycloak-session-store/final/assets/ghost-row-cleanup-order/ghost-row-cleanup-order.excalidraw
+722
View File
@@ -0,0 +1,722 @@
{
"type": "excalidraw",
"version": 2,
"source": "techviz-harness",
"elements": [
{
"id": "edge-m1",
"type": "arrow",
"x": 120.0,
"y": 140.0,
"width": 210.0,
"height": 0.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": 1391175952,
"version": 1,
"versionNonce": 1697606636,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"points": [
[
0.0,
0.0
],
[
210.0,
0.0
]
],
"lastCommittedPoint": null,
"startBinding": {
"elementId": "node-kubectl",
"focus": 0,
"gap": 4
},
"endBinding": {
"elementId": "node-dying",
"focus": 0,
"gap": 4
},
"startArrowhead": null,
"endArrowhead": "arrow",
"elbowed": true
},
{
"id": "edge-label-m1",
"type": "text",
"x": 153.0,
"y": 116.0,
"width": 144,
"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": 205439938,
"version": 1,
"versionNonce": 479762556,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 13,
"fontFamily": 5,
"text": "delete pod --force",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "delete pod --force",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "edge-m2",
"type": "arrow",
"x": 330.0,
"y": 202.0,
"width": 210.0,
"height": 0.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "dashed",
"roughness": 1,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": null,
"seed": 1592612909,
"version": 1,
"versionNonce": 300451842,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"points": [
[
0.0,
0.0
],
[
210.0,
0.0
]
],
"lastCommittedPoint": null,
"startBinding": {
"elementId": "node-dying",
"focus": 0,
"gap": 4
},
"endBinding": {
"elementId": "node-coordinator",
"focus": 0,
"gap": 4
},
"startArrowhead": null,
"endArrowhead": "arrow",
"elbowed": true
},
{
"id": "edge-label-m2",
"type": "text",
"x": 390.0,
"y": 178.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": 774335790,
"version": 1,
"versionNonce": 203462744,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 13,
"fontFamily": 5,
"text": "이탈 07:40:28",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "이탈 07:40:28",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "edge-m3",
"type": "arrow",
"x": 540.0,
"y": 264.0,
"width": 210.0,
"height": 0.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": 986781738,
"version": 1,
"versionNonce": 1446276182,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"points": [
[
0.0,
0.0
],
[
210.0,
0.0
]
],
"lastCommittedPoint": null,
"startBinding": {
"elementId": "node-coordinator",
"focus": 0,
"gap": 4
},
"endBinding": {
"elementId": "node-pingtable",
"focus": 0,
"gap": 4
},
"startArrowhead": null,
"endArrowhead": "arrow",
"elbowed": true
},
{
"id": "edge-label-m3",
"type": "text",
"x": 593.0,
"y": 240.0,
"width": 104,
"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": 79282802,
"version": 1,
"versionNonce": 1904842631,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 13,
"fontFamily": 5,
"text": "행 삭제 07:40:28",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "행 삭제 07:40:28",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "edge-m4",
"type": "arrow",
"x": 540.0,
"y": 326.0,
"width": 420.0,
"height": 0.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "dashed",
"roughness": 1,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": null,
"seed": 522855009,
"version": 1,
"versionNonce": 870155517,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"points": [
[
420.0,
0.0
],
[
0.0,
0.0
]
],
"lastCommittedPoint": null,
"startBinding": {
"elementId": "node-rejoined",
"focus": 0,
"gap": 4
},
"endBinding": {
"elementId": "node-coordinator",
"focus": 0,
"gap": 4
},
"startArrowhead": null,
"endArrowhead": "arrow",
"elbowed": true
},
{
"id": "edge-label-m4",
"type": "text",
"x": 705.0,
"y": 302.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": 1255410992,
"version": 1,
"versionNonce": 1365345158,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 13,
"fontFamily": 5,
"text": "합류 07:40:48",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "합류 07:40:48",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-kubectl",
"type": "rectangle",
"x": 45.0,
"y": 35.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": 310398853,
"version": 1,
"versionNonce": 116533940,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-kubectl",
"type": "text",
"x": 55.0,
"y": 45.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": 607402474,
"version": 1,
"versionNonce": 792058739,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "kubectl",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "kubectl",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-dying",
"type": "rectangle",
"x": 255.0,
"y": 35.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": 879819054,
"version": 1,
"versionNonce": 570398284,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-dying",
"type": "text",
"x": 265.0,
"y": 45.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": 5641074,
"version": 1,
"versionNonce": 615997913,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "keycloak-0-60375\nSIGKILL",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "keycloak-0-60375\nSIGKILL",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-coordinator",
"type": "rectangle",
"x": 465.0,
"y": 35.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": 519833945,
"version": 1,
"versionNonce": 233315132,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-coordinator",
"type": "text",
"x": 475.0,
"y": 45.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": 854296125,
"version": 1,
"versionNonce": 719549114,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "keycloak-1-36736\n코디네이터",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "keycloak-1-36736\n코디네이터",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-pingtable",
"type": "rectangle",
"x": 675.0,
"y": 35.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": 95452246,
"version": 1,
"versionNonce": 150236146,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-pingtable",
"type": "text",
"x": 685.0,
"y": 45.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": 513625111,
"version": 1,
"versionNonce": 166196202,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "JGROUPS_PING",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "JGROUPS_PING",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-rejoined",
"type": "rectangle",
"x": 885.0,
"y": 35.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": 273638174,
"version": 1,
"versionNonce": 1227607187,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-rejoined",
"type": "text",
"x": 895.0,
"y": 45.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": 1686781613,
"version": 1,
"versionNonce": 1893349373,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "keycloak-0-16105\n새 접미사",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "keycloak-0-16105\n새 접미사",
"autoResize": true,
"lineHeight": 1.25
}
],
"appState": {
"gridSize": 10,
"viewBackgroundColor": "#ffffff",
"currentItemFontFamily": 5
},
"files": {}
}
docs/keycloak-session-store/final/assets/ghost-row-cleanup-order/ghost-row-cleanup-order.manifest.json
+32
View File
@@ -0,0 +1,32 @@
{
"harness_version": "0.2.0",
"spec_id": "ghost-row-cleanup-order",
"spec_version": "1.1",
"spec_sha256": "54c91ca2c94de14228b7b09f36c806ecbd99e3ffa7ccbf667658a3b3126d9f75",
"source_context": {
"document": "docs/keycloak-session-store/final/document.md",
"document_sha256": "88a081390dff22cd4171d5f9b534e46a37f6295c3b2652bc4c6fff0b578d5c6b",
"anchor": {
"kind": "heading",
"value": "관측 (observed)",
"line": 892
}
},
"outputs": [
"ghost-row-cleanup-order.svg",
"ghost-row-cleanup-order.drawio",
"ghost-row-cleanup-order.mmd",
"ghost-row-cleanup-order.d2",
"ghost-row-cleanup-order.dot",
"ghost-row-cleanup-order.excalidraw",
"ghost-row-cleanup-order.alt.md"
],
"lint_issue_count": 0,
"assumption_count": 0,
"assumptions_allowed": false,
"composition_profile": "sequence",
"reference_ids": [
"payment-approval-sequence"
],
"diagram_only": true
}
docs/keycloak-session-store/final/assets/ghost-row-cleanup-order/ghost-row-cleanup-order.mmd
+12
View File
@@ -0,0 +1,12 @@
%% 유령 행을 지운 쪽과 그 시각
%% question: SIGKILL 로 끊긴 노드의 JGROUPS_PING 행은 누가, 언제 지우는가
sequenceDiagram
participant n0 as kubectl
participant n1 as keycloak-0-60375
participant n2 as keycloak-1-36736
participant n3 as JGROUPS_PING
participant n4 as keycloak-0-16105
n0->>n1: delete pod --force
n1-->>n2: 이탈 07:40:28
n2->>n3: 행 삭제 07:40:28
n4-->>n2: 합류 07:40:48
docs/keycloak-session-store/final/assets/ghost-row-cleanup-order/ghost-row-cleanup-order.svg
+86
View File
@@ -0,0 +1,86 @@
<?xml version="1.0" encoding="UTF-8"?>
<svg xmlns="http://www.w3.org/2000/svg" width="1080" height="418" viewBox="0 0 1080 418" role="img" aria-labelledby="diagram-title diagram-description">
<title id="diagram-title">유령 행을 지운 쪽과 그 시각</title>
<desc id="diagram-description">왼쪽부터 kubectl, keycloak-0-60375, keycloak-1-36736, JGROUPS_PING, keycloak-0-16105 다섯 참여자가 생명선으로 선다. 1번 메시지에서 kubectl 이 keycloak-0-60375 를 --grace-period=0 --force 로 끊는다. 2번에서 07:40:28 에 남은 노드 keycloak-1-36736 의 뷰에서 그 노드가 빠진다. 3번이 이 그림의 중심이다 — 같은 07:40:28 에 JGROUPS_PING 의 행을 지우는 화살표가 keycloak-1-36736 에서 나온다. 강제 종료로 이미 끊긴 keycloak-0-60375 의 생명선에서는 테이블로 가는 화살표가 없다. 4번에서 20초 뒤 07:40:48 에 keycloak-0-16105 가 합류한다. 돌아온 노드의 이름은 접두사 keycloak-0 만 같고 접미사가 다르다.</desc>
<metadata>{&quot;techviz&quot;:{&quot;spec_version&quot;:&quot;1.1&quot;,&quot;id&quot;:&quot;ghost-row-cleanup-order&quot;,&quot;profile&quot;:&quot;sequence&quot;},&quot;source_context&quot;:{&quot;document&quot;:&quot;docs/keycloak-session-store/final/document.md&quot;,&quot;document_sha256&quot;:&quot;88a081390dff22cd4171d5f9b534e46a37f6295c3b2652bc4c6fff0b578d5c6b&quot;,&quot;anchor&quot;:{&quot;kind&quot;:&quot;heading&quot;,&quot;value&quot;:&quot;관측 (observed)&quot;,&quot;line&quot;:892}},&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="1080" height="418" />
<rect class="node-shape kind-participant emphasis-normal role-participant" data-evidence="886-888" x="45.0" y="35.0" width="150.0" height="64.0" rx="7" />
<text class="node-label" x="120.0" y="65.0">kubectl</text>
<line class="lifeline" x1="120.0" y1="99.0" x2="120.0" y2="388.0" />
<rect class="node-shape kind-participant emphasis-warning role-participant" data-evidence="898-901" x="255.0" y="35.0" width="150.0" height="71.0" rx="7" />
<text class="node-label" x="330.0" y="62.0">keycloak-0-60375</text>
<line class="node-detail-divider" x1="269.0" y1="83.0" x2="391.0" y2="83.0" />
<text class="node-detail" x="271.0" y="100.0">SIGKILL</text>
<line class="lifeline" x1="330.0" y1="106.0" x2="330.0" y2="388.0" />
<rect class="node-shape kind-participant emphasis-primary role-participant" data-evidence="914-916" x="465.0" y="35.0" width="150.0" height="71.0" rx="7" />
<text class="node-label" x="540.0" y="62.0">keycloak-1-36736</text>
<line class="node-detail-divider" x1="479.0" y1="83.0" x2="601.0" y2="83.0" />
<text class="node-detail" x="481.0" y="100.0">코디네이터</text>
<line class="lifeline" x1="540.0" y1="106.0" x2="540.0" y2="388.0" />
<rect class="node-shape kind-participant emphasis-normal role-participant" data-evidence="888-888" x="675.0" y="35.0" width="150.0" height="64.0" rx="7" />
<text class="node-label" x="750.0" y="65.0">JGROUPS_PING</text>
<line class="lifeline" x1="750.0" y1="99.0" x2="750.0" y2="388.0" />
<rect class="node-shape kind-participant emphasis-normal role-participant" data-evidence="918-920" x="885.0" y="35.0" width="150.0" height="71.0" rx="7" />
<text class="node-label" x="960.0" y="62.0">keycloak-0-16105</text>
<line class="node-detail-divider" x1="899.0" y1="83.0" x2="1021.0" y2="83.0" />
<text class="node-detail" x="901.0" y="100.0">새 접미사</text>
<line class="lifeline" x1="960.0" y1="106.0" x2="960.0" y2="388.0" />
<polyline class="edge kind-request style-solid emphasis-normal" points="120.0,140.0 330.0,140.0" data-evidence="886-888" />
<rect class="edge-label-bg" x="145.6" y="114.0" width="158.7" height="22" rx="3" />
<text class="edge-label" x="225.0" y="129.0">1. delete pod --force</text>
<polyline class="edge kind-event style-dashed emphasis-normal semantic-dashed" points="330.0,202.0 540.0,202.0" data-evidence="906-907" />
<rect class="edge-label-bg" x="379.1" y="176.0" width="111.8" height="22" rx="3" />
<text class="edge-label" x="435.0" y="191.0">2. 이탈 07:40:28</text>
<polyline class="edge kind-data style-solid emphasis-primary" points="540.0,264.0 750.0,264.0" data-evidence="897-898,914-916" />
<rect class="edge-label-bg" x="582.4" y="238.0" width="125.2" height="22" rx="3" />
<text class="edge-label" x="645.0" y="253.0">3. 행 삭제 07:40:28</text>
<polyline class="edge kind-event style-dashed emphasis-normal semantic-dashed" points="960.0,326.0 540.0,326.0" data-evidence="908-909" />
<rect class="edge-label-bg" x="694.1" y="300.0" width="111.8" height="22" rx="3" />
<text class="edge-label" x="750.0" y="315.0">4. 합류 07:40:48</text>
</svg>
Side by Side

After

Width:  |  Height:  |  Size: 7.7 KiB