refactor: 문서 개선 중

This commit is contained in:
donghyeon-ka
2026-09-21 14:30:55 +09:00
parent c93cdea150
commit 805a18f486
1497 changed files with 525837 additions and 59152 deletions
@@ -10,11 +10,11 @@
## Elements and evidence
- **주입 명령** (process): NetworkPolicy · tc · kill · iptables. Evidence: L109L112.
- **대상 상태 확인** (process): 결과가 아니라 대상이 그 상태인지를 본다. Evidence: L128L133.
- **결과 관측** (process): 여기만 보면 두 상황이 같아 보인다. Evidence: L128L131.
- **주입 명령** (process): NetworkPolicy · tc · kill · iptables. Evidence: L292L294.
- **대상 상태 확인** (process): 결과가 아니라 대상이 그 상태인지를 본다. Evidence: L311L316.
- **결과 관측** (process): 여기만 보면 두 상황이 같아 보인다. Evidence: L311L313.
## Relationships
- **주입 명령 → 대상 상태 확인:** 상태 확인. Evidence: L128L133.
- **대상 상태 확인 → 결과 관측:** 결과 판독. Evidence: L128L133.
- **주입 명령 → 대상 상태 확인:** 상태 확인. Evidence: L311L316.
- **대상 상태 확인 → 결과 관측:** 결과 판독. Evidence: L311L316.
@@ -5,13 +5,13 @@
<root>
<mxCell id="0"/>
<mxCell id="1" parent="0"/>
<mxCell id="n_inject" value="주입 명령&lt;br/&gt;NetworkPolicy · tc · kill · iptables" tooltip="NetworkPolicy · tc · kill · iptables. | Evidence: L109-L112" 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">
<mxCell id="n_inject" value="주입 명령&lt;br/&gt;NetworkPolicy · tc · kill · iptables" tooltip="NetworkPolicy · tc · kill · iptables. | Evidence: L292-L294" 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="60.0" width="286.0" height="71.0" as="geometry"/>
</mxCell>
<mxCell id="n_verify" value="대상 상태 확인&lt;br/&gt;cluster_size · 워커 PID · conntrack · 패킷 카운터" tooltip="결과가 아니라 대상이 그 상태인지를 본다. | Evidence: L128-L133" 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">
<mxCell id="n_verify" value="대상 상태 확인&lt;br/&gt;cluster_size · 워커 PID · conntrack · 패킷 카운터" tooltip="결과가 아니라 대상이 그 상태인지를 본다. | Evidence: L311-L316" 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="516.0" y="60.0" width="300.0" height="71.0" as="geometry"/>
</mxCell>
<mxCell id="n_observe" value="결과 관측&lt;br/&gt;실패 · 무영향 구별 불가" tooltip="여기만 보면 두 상황이 같아 보인다. | Evidence: L128-L131" 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">
<mxCell id="n_observe" value="결과 관측&lt;br/&gt;실패 · 무영향 구별 불가" tooltip="여기만 보면 두 상황이 같아 보인다. | Evidence: L311-L313" 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="976.0" y="60.0" width="150.0" height="71.0" as="geometry"/>
</mxCell>
<mxCell id="e_i-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_inject" target="n_verify">
@@ -2,14 +2,14 @@
"harness_version": "0.2.0",
"spec_id": "injection-verification",
"spec_version": "1.1",
"spec_sha256": "bcb6e7986678316d1e39d514d21dc15383a852bbfde3eb32ccb18e97e3cbc416",
"spec_sha256": "5a0824a5464994cc4ac1cdb7af1160053ca6dcbcf3025d34bcba6dc5183f027f",
"source_context": {
"document": "docs/keycloak-session-store/final/document.md",
"document_sha256": "1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe",
"document_sha256": "28aef96a2bbb94fbb10ade26a71238fee62a5a4d9fa6e7749ae98cfd0a65e560",
"anchor": {
"kind": "heading",
"value": "주입이 먹지 않는다 — 아홉 번, 전부 조용히",
"line": 113
"line": 296
}
},
"outputs": [
@@ -2,7 +2,7 @@
<svg xmlns="http://www.w3.org/2000/svg" width="1171" height="300" viewBox="0 0 1171 300" role="img" aria-labelledby="diagram-title diagram-description">
<title id="diagram-title">주입이 걸렸는지 따로 확인한다</title>
<desc id="diagram-description">이 실험대에서 아홉 번의 주입이 조용히 실패했다. conntrack 이 ESTABLISHED 연결을 통과시키고, kubectl delete --force 가 크래시가 아니며, PID 1 이 SIGKILL 을 무시하고, kube-router 가 iptables 체인을 다시 끼워 넣는다. 모두 아무 일도 없었다로 보였다. 그래서 주입 뒤에는 결과를 보기 전에 대상이 실제로 그 상태인지를 cluster_size, 워커 PID, conntrack 표, 패킷 카운터로 확인한다.</desc>
<metadata>{&quot;techviz&quot;:{&quot;spec_version&quot;:&quot;1.1&quot;,&quot;id&quot;:&quot;injection-verification&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;주입이 먹지 않는다 — 아홉 번, 전부 조용히&quot;,&quot;line&quot;:113}},&quot;evidence_policy&quot;:&quot;Each factual element cites source lines or is marked assumption.&quot;,&quot;diagram_only&quot;:true}</metadata>
<metadata>{&quot;techviz&quot;:{&quot;spec_version&quot;:&quot;1.1&quot;,&quot;id&quot;:&quot;injection-verification&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;28aef96a2bbb94fbb10ade26a71238fee62a5a4d9fa6e7749ae98cfd0a65e560&quot;,&quot;anchor&quot;:{&quot;kind&quot;:&quot;heading&quot;,&quot;value&quot;:&quot;주입이 먹지 않는다 — 아홉 번, 전부 조용히&quot;,&quot;line&quot;:296}},&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" />
@@ -50,26 +50,26 @@
</style>
</defs>
<rect class="canvas" width="1171" height="300" />
<polyline class="edge kind-request style-solid emphasis-normal" points="356.0,95.5 436.0,95.5 436.0,95.5 516.0,95.5" data-evidence="128-133" />
<polyline class="edge kind-request style-solid emphasis-normal" points="356.0,95.5 436.0,95.5 436.0,95.5 516.0,95.5" data-evidence="311-316" />
<rect class="edge-label-bg" x="410.2" y="53.5" width="51.5" height="22" rx="3" />
<text class="edge-label" x="436.0" y="68.5">상태 확인</text>
<polyline class="edge kind-request style-solid emphasis-normal" points="816.0,95.5 896.0,95.5 896.0,95.5 976.0,95.5" data-evidence="128-133" />
<polyline class="edge kind-request style-solid emphasis-normal" points="816.0,95.5 896.0,95.5 896.0,95.5 976.0,95.5" data-evidence="311-316" />
<rect class="edge-label-bg" x="870.2" y="53.5" width="51.5" height="22" rx="3" />
<text class="edge-label" x="896.0" y="68.5">결과 판독</text>
<g id="node-inject">
<rect class="node-shape kind-process emphasis-primary role-source" data-evidence="109-112" x="70.0" y="60.0" width="286.0" height="71.0" rx="7" />
<rect class="node-shape kind-process emphasis-primary role-source" data-evidence="292-294" x="70.0" y="60.0" width="286.0" height="71.0" rx="7" />
<text class="node-label" x="213.0" y="87.0">주입 명령</text>
<line class="node-detail-divider" x1="84.0" y1="108.0" x2="342.0" y2="108.0" />
<text class="node-detail" x="86.0" y="125.0">NetworkPolicy · tc · kill · iptables</text>
</g>
<g id="node-verify">
<rect class="node-shape kind-process emphasis-warning role-control" data-evidence="128-133" x="516.0" y="60.0" width="300.0" height="71.0" rx="7" />
<rect class="node-shape kind-process emphasis-warning role-control" data-evidence="311-316" x="516.0" y="60.0" width="300.0" height="71.0" rx="7" />
<text class="node-label" x="666.0" y="87.0">대상 상태 확인</text>
<line class="node-detail-divider" x1="530.0" y1="108.0" x2="802.0" y2="108.0" />
<text class="node-detail" x="532.0" y="125.0">cluster_size · 워커 PID · conntrack · 패킷 카운터</text>
</g>
<g id="node-observe">
<rect class="node-shape kind-process emphasis-primary role-target" data-evidence="128-131" x="976.0" y="60.0" width="150.0" height="71.0" rx="7" />
<rect class="node-shape kind-process emphasis-primary role-target" data-evidence="311-313" x="976.0" y="60.0" width="150.0" height="71.0" rx="7" />
<text class="node-label" x="1051.0" y="87.0">결과 관측</text>
<line class="node-detail-divider" x1="990.0" y1="108.0" x2="1112.0" y2="108.0" />
<text class="node-detail" x="992.0" y="125.0">실패 · 무영향 구별 불가</text>

Before

Width:  |  Height:  |  Size: 6.3 KiB

After

Width:  |  Height:  |  Size: 6.3 KiB