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
@@ -0,0 +1,107 @@
<?xml version="1.0" encoding="UTF-8"?>
<svg xmlns="http://www.w3.org/2000/svg" width="1253" height="564" viewBox="0 0 1253 564" role="img" aria-labelledby="diagram-title diagram-description">
<title id="diagram-title">virtqueue 뒤 QEMU block backend의 세 형태</title>
<desc id="diagram-description">왼쪽에서 Guest /dev/vda 요청이 virtio-blk와 virtqueue를 지나 VM boundary를 넘는다. QEMU block backend에서 qcow2 file, RAW file, Host block device 세 갈래로 나뉜다. qcow2와 RAW 노드에는 Host filesystem을 경유한다는 차이를, Host block device에는 파일 backend가 아니라는 차이를 적었다. 세 경로 아래의 Host block stack은 별도 Concept이 맡으므로 이 그림에서는 다시 합치지 않는다.</desc>
<metadata>{&quot;techviz&quot;:{&quot;spec_version&quot;:&quot;1.1&quot;,&quot;id&quot;:&quot;qemu-block-backend-forms&quot;,&quot;profile&quot;:&quot;component-flow&quot;},&quot;source_context&quot;:{&quot;document&quot;:&quot;docs/virtualization/final/document.md&quot;,&quot;document_sha256&quot;:&quot;8c4ecc64c8cea9a4450ed7131fdd9cb2048dc092b66cd969f6346ed77887c210&quot;,&quot;anchor&quot;:{&quot;kind&quot;:&quot;heading&quot;,&quot;value&quot;:&quot;제4부 — 스토리지 가상화&quot;,&quot;line&quot;:5791}},&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="1253" height="564" />
<polyline class="edge kind-data style-solid emphasis-normal" points="888.0,271.5 968.0,271.5 968.0,112.5 1048.0,112.5" data-evidence="6551-6575" />
<rect class="edge-label-bg" x="916.0" y="178.0" width="152.0" height="22" rx="3" />
<text class="edge-label" x="992.0" y="193.0">block-device backend</text>
<polyline class="edge kind-data style-solid emphasis-normal" points="888.0,289.5 968.0,289.5 968.0,289.5 1048.0,289.5" data-evidence="6369-6379,6419-6460" />
<rect class="edge-label-bg" x="915.5" y="247.5" width="105.1" height="22" rx="3" />
<text class="edge-label" x="968.0" y="262.5">qcow2 backend</text>
<polyline class="edge kind-data style-solid emphasis-normal" points="888.0,307.5 969.8,307.5 969.8,466.5 1051.5,466.5" data-evidence="6512-6547" />
<rect class="edge-label-bg" x="947.9" y="373.0" width="91.7" height="22" rx="3" />
<text class="edge-label" x="993.8" y="388.0">RAW backend</text>
<polyline class="edge kind-request style-solid emphasis-normal" points="220.0,289.5 300.0,289.5 300.0,289.5 380.0,289.5" data-evidence="6355-6363" />
<rect class="edge-label-bg" x="260.9" y="247.5" width="78.3" height="22" rx="3" />
<text class="edge-label" x="300.0" y="262.5">block I/O</text>
<polyline class="edge kind-request style-solid emphasis-normal" points="568.0,289.5 648.0,289.5 648.0,289.5 728.0,289.5" data-evidence="6362-6374" />
<rect class="edge-label-bg" x="602.1" y="247.5" width="91.7" height="22" rx="3" />
<text class="edge-label" x="648.0" y="262.5">VM boundary</text>
<g id="node-vda">
<rect class="node-shape kind-storage emphasis-normal role-source" data-evidence="6355-6363" x="70.0" y="268.2" width="150.0" height="42.7" /><ellipse class="node-shape kind-storage emphasis-normal role-source" cx="145.0" cy="268.2" rx="75.0" ry="10.7" /><path class="storage-bottom" d="M 70.0 310.8 A 75.0 10.7 0 0 0 220.0 310.8" />
<text class="node-label" x="145.0" y="287.5">/dev/vda</text>
</g>
<g id="node-virtio-queue">
<rect class="node-shape kind-component emphasis-normal role-service" data-evidence="6355-6364" x="380.0" y="245.5" width="188.0" height="88.0" rx="7" />
<text class="node-label" x="474.0" y="272.5">virtio-blk · virtqueue</text>
<line class="node-detail-divider" x1="394.0" y1="293.5" x2="554.0" y2="293.5" />
<text class="node-detail" x="396.0" y="310.5">Guest</text>
<text class="node-detail" x="396.0" y="326.5">VM boundary 직전</text>
</g>
<g id="node-backend">
<rect class="node-shape kind-service emphasis-primary role-service" data-evidence="6367-6387" x="728.0" y="257.5" width="160.0" height="64.0" rx="7" />
<text class="node-label" x="808.0" y="287.5">QEMU block backend</text>
</g>
<g id="node-block-device">
<rect class="node-shape kind-storage emphasis-normal role-service" data-evidence="6551-6575" x="1048.0" y="73.0" width="160.0" height="79.0" /><ellipse class="node-shape kind-storage emphasis-normal role-service" cx="1128.0" cy="73.0" rx="80.0" ry="13.0" /><path class="storage-bottom" d="M 1048.0 152.0 A 80.0 13.0 0 0 0 1208.0 152.0" />
<text class="node-label" x="1128.0" y="87.0">Host block device</text>
<line class="node-detail-divider" x1="1062.0" y1="108.0" x2="1194.0" y2="108.0" />
<text class="node-detail" x="1064.0" y="125.0">/dev/...</text>
<text class="node-detail" x="1064.0" y="141.0">file 없음</text>
<text class="node-detail" x="1064.0" y="157.0">→ Host block stack</text>
</g>
<g id="node-qcow2">
<rect class="node-shape kind-storage emphasis-normal role-service" data-evidence="6419-6460,6512-6547" x="1048.0" y="250.0" width="160.0" height="79.0" /><ellipse class="node-shape kind-storage emphasis-normal role-service" cx="1128.0" cy="250.0" rx="80.0" ry="13.0" /><path class="storage-bottom" d="M 1048.0 329.0 A 80.0 13.0 0 0 0 1208.0 329.0" />
<text class="node-label" x="1128.0" y="264.0">qcow2 file</text>
<line class="node-detail-divider" x1="1062.0" y1="285.0" x2="1194.0" y2="285.0" />
<text class="node-detail" x="1064.0" y="302.0">file backend</text>
<text class="node-detail" x="1064.0" y="318.0">mapping · metadata</text>
<text class="node-detail" x="1064.0" y="334.0">→ Host filesystem</text>
</g>
<g id="node-raw">
<rect class="node-shape kind-storage emphasis-normal role-service" data-evidence="6512-6547" x="1051.5" y="427.0" width="153.0" height="79.0" /><ellipse class="node-shape kind-storage emphasis-normal role-service" cx="1128.0" cy="427.0" rx="76.5" ry="13.0" /><path class="storage-bottom" d="M 1051.5 506.0 A 76.5 13.0 0 0 0 1204.5 506.0" />
<text class="node-label" x="1128.0" y="441.0">RAW file</text>
<line class="node-detail-divider" x1="1065.5" y1="462.0" x2="1190.5" y2="462.0" />
<text class="node-detail" x="1067.5" y="479.0">file backend</text>
<text class="node-detail" x="1067.5" y="495.0">offset 대응</text>
<text class="node-detail" x="1067.5" y="511.0">→ Host filesystem</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 9.2 KiB