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

refactor: 문서 개선 중

Browse Source
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
Download Patch File Download Diff File Expand all files Collapse all files
docs/virtualization/final/assets/diagrams/qemu-block-backend-forms/qemu-block-backend-forms.alt.md
+26
View File
@@ -0,0 +1,26 @@
# virtqueue 뒤 QEMU block backend의 세 형태
## Alternative text
Guest의 /dev/vda가 virtio-blk와 virtqueue를 지나 QEMU block backend에 도착한 뒤 qcow2 파일, RAW 파일, Host block device 세 갈래로 나뉘는 구조도. 그 아래 Host block stack은 별도 Concept이 맡아 이 그림에서는 다시 합치지 않는다.
## Long 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이 맡으므로 이 그림에서는 다시 합치지 않는다.
## Elements and evidence
- **/dev/vda** (storage): Guest가 보는 virtual disk. Evidence: L6355–L6363.
- **virtio-blk · virtqueue** (component): Guest /dev/vda 요청을 virtio-blk가 받아 virtqueue에 싣는 경로를 한 노드로 묶었다. Evidence: L6355–L6364.
- **QEMU block backend** (service): Guest virtual I/O를 실제 Host backend에 연결한다. Evidence: L6367–L6387.
- **qcow2 file** (storage): sparse/COW 기능을 가진 file backend. Evidence: L6419–L6460, L6512–L6547.
- **RAW file** (storage): 상대적으로 단순한 offset 대응을 쓰는 file backend. Evidence: L6512–L6547.
- **Host block device** (storage): QEMU가 Host block device를 직접 backend로 사용할 수 있는 형태. Evidence: L6551–L6575.
## Relationships
- **QEMU block backend → Host block device:** block-device backend. Evidence: L6551–L6575.
- **QEMU block backend → qcow2 file:** qcow2 backend. Evidence: L6369–L6379, L6419–L6460.
- **QEMU block backend → RAW file:** RAW backend. Evidence: L6512–L6547.
- **/dev/vda → virtio-blk · virtqueue:** block I/O. Evidence: L6355–L6363.
- **virtio-blk · virtqueue → QEMU block backend:** VM boundary. Evidence: L6362–L6374.
docs/virtualization/final/assets/diagrams/qemu-block-backend-forms/qemu-block-backend-forms.d2
+26
View File
@@ -0,0 +1,26 @@
# virtqueue 뒤 QEMU block backend의 세 형태
# Question: Guest /dev/vda 요청이 VM boundary를 넘은 뒤 QEMU에서 qcow2, RAW, Host block device 중 어느 backend로 이어지는가
direction: right
n0: "/dev/vda" {
shape: cylinder
}
n1: "virtio-blk · virtqueue" {
shape: rectangle
}
n2: "QEMU block backend" {
shape: rectangle
}
n3: "qcow2 file" {
shape: cylinder
}
n4: "RAW file" {
shape: cylinder
}
n5: "Host block device" {
shape: cylinder
}
n0 -> n1: "block I/O"
n1 -> n2: "VM boundary"
n2 -> n3: "qcow2 backend"
n2 -> n4: "RAW backend"
n2 -> n5: "block-device backend"
docs/virtualization/final/assets/diagrams/qemu-block-backend-forms/qemu-block-backend-forms.dot
+16
View File
@@ -0,0 +1,16 @@
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="/dev/vda", shape=cylinder, style="rounded,filled"];
n1 [label="virtio-blk · virtqueue", shape=box, style="rounded,filled"];
n2 [label="QEMU block backend", shape=box, style="rounded,filled"];
n3 [label="qcow2 file", shape=cylinder, style="rounded,filled"];
n4 [label="RAW file", shape=cylinder, style="rounded,filled"];
n5 [label="Host block device", shape=cylinder, style="rounded,filled"];
n0 -> n1 [label="block I/O", style=solid];
n1 -> n2 [label="VM boundary", style=solid];
n2 -> n3 [label="qcow2 backend", style=solid];
n2 -> n4 [label="RAW backend", style=solid];
n2 -> n5 [label="block-device backend", style=solid];
}
docs/virtualization/final/assets/diagrams/qemu-block-backend-forms/qemu-block-backend-forms.drawio
+54
View File
@@ -0,0 +1,54 @@
<?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="qemu-block-backend-forms" name="virtqueue 뒤 QEMU block backend의 세 형태">
<mxGraphModel dx="1253" dy="564" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1253" pageHeight="1169" math="0" shadow="0">
<root>
<mxCell id="0"/>
<mxCell id="1" parent="0"/>
<mxCell id="n_vda" value="/dev/vda" tooltip="Guest가 보는 virtual disk. | Evidence: L6355-L6363" 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;" vertex="1" parent="1">
<mxGeometry x="70.0" y="257.5" width="150.0" height="64.0" as="geometry"/>
</mxCell>
<mxCell id="n_virtio-queue" value="virtio-blk · virtqueue&lt;br/&gt;Guest&lt;br/&gt;VM boundary 직전" tooltip="Guest /dev/vda 요청을 virtio-blk가 받아 virtqueue에 싣는 경로를 한 노드로 묶었다. | Evidence: L6355-L6364" 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="380.0" y="245.5" width="188.0" height="88.0" as="geometry"/>
</mxCell>
<mxCell id="n_backend" value="QEMU block backend" tooltip="Guest virtual I/O를 실제 Host backend에 연결한다. | Evidence: L6367-L6387" 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="728.0" y="257.5" width="160.0" height="64.0" as="geometry"/>
</mxCell>
<mxCell id="n_block-device" value="Host block device&lt;br/&gt;/dev/...&lt;br/&gt;file 없음&lt;br/&gt;→ Host block stack" tooltip="QEMU가 Host block device를 직접 backend로 사용할 수 있는 형태. | Evidence: L6551-L6575" 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;" vertex="1" parent="1">
<mxGeometry x="1048.0" y="60.0" width="160.0" height="105.0" as="geometry"/>
</mxCell>
<mxCell id="n_qcow2" value="qcow2 file&lt;br/&gt;file backend&lt;br/&gt;mapping · metadata&lt;br/&gt;→ Host filesystem" tooltip="sparse/COW 기능을 가진 file backend. | Evidence: L6419-L6460, L6512-L6547" 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;" vertex="1" parent="1">
<mxGeometry x="1048.0" y="237.0" width="160.0" height="105.0" as="geometry"/>
</mxCell>
<mxCell id="n_raw" value="RAW file&lt;br/&gt;file backend&lt;br/&gt;offset 대응&lt;br/&gt;→ Host filesystem" tooltip="상대적으로 단순한 offset 대응을 쓰는 file backend. | Evidence: L6512-L6547" 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;" vertex="1" parent="1">
<mxGeometry x="1051.5" y="414.0" width="153.0" height="105.0" as="geometry"/>
</mxCell>
<mxCell id="e_backend-block" value="block-device backend" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_backend" target="n_block-device">
<mxGeometry relative="1" as="geometry">
<mxPoint x="992.0" y="192.0" as="offset"/>
</mxGeometry>
</mxCell>
<mxCell id="e_backend-qcow2" value="qcow2 backend" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_backend" target="n_qcow2">
<mxGeometry relative="1" as="geometry">
<mxPoint x="968.0" y="261.5" as="offset"/>
</mxGeometry>
</mxCell>
<mxCell id="e_backend-raw" value="RAW backend" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_backend" target="n_raw">
<mxGeometry relative="1" as="geometry">
<mxPoint x="993.8" y="387.0" as="offset"/>
</mxGeometry>
</mxCell>
<mxCell id="e_vda-virtio" value="block I/O" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_vda" target="n_virtio-queue">
<mxGeometry relative="1" as="geometry">
<mxPoint x="300.0" y="261.5" as="offset"/>
</mxGeometry>
</mxCell>
<mxCell id="e_vq-backend" value="VM boundary" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_virtio-queue" target="n_backend">
<mxGeometry relative="1" as="geometry">
<mxPoint x="648.0" y="261.5" as="offset"/>
</mxGeometry>
</mxCell>
</root>
</mxGraphModel>
</diagram>
</mxfile>
docs/virtualization/final/assets/diagrams/qemu-block-backend-forms/qemu-block-backend-forms.excalidraw
+922
View File
@@ -0,0 +1,922 @@
{
"type": "excalidraw",
"version": 2,
"source": "techviz-harness",
"elements": [
{
"id": "edge-backend-block",
"type": "arrow",
"x": 888.0,
"y": 112.5,
"width": 160.0,
"height": 159.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": 1753917267,
"version": 1,
"versionNonce": 7070954,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"points": [
[
0.0,
159.0
],
[
80.0,
159.0
],
[
80.0,
0.0
],
[
160.0,
0.0
]
],
"lastCommittedPoint": null,
"startBinding": {
"elementId": "node-backend",
"focus": 0,
"gap": 4
},
"endBinding": {
"elementId": "node-block-device",
"focus": 0,
"gap": 4
},
"startArrowhead": null,
"endArrowhead": "arrow",
"elbowed": true
},
{
"id": "edge-label-backend-block",
"type": "text",
"x": 912.0,
"y": 180.0,
"width": 160,
"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": 948380865,
"version": 1,
"versionNonce": 1886842897,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 13,
"fontFamily": 5,
"text": "block-device backend",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "block-device backend",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "edge-backend-qcow2",
"type": "arrow",
"x": 888.0,
"y": 289.5,
"width": 160.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": 1037898307,
"version": 1,
"versionNonce": 605207362,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"points": [
[
0.0,
0.0
],
[
80.0,
0.0
],
[
80.0,
0.0
],
[
160.0,
0.0
]
],
"lastCommittedPoint": null,
"startBinding": {
"elementId": "node-backend",
"focus": 0,
"gap": 4
},
"endBinding": {
"elementId": "node-qcow2",
"focus": 0,
"gap": 4
},
"startArrowhead": null,
"endArrowhead": "arrow",
"elbowed": true
},
{
"id": "edge-label-backend-qcow2",
"type": "text",
"x": 916.0,
"y": 249.5,
"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": 801300859,
"version": 1,
"versionNonce": 607900389,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 13,
"fontFamily": 5,
"text": "qcow2 backend",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "qcow2 backend",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "edge-backend-raw",
"type": "arrow",
"x": 888.0,
"y": 307.5,
"width": 163.5,
"height": 159.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": 845643799,
"version": 1,
"versionNonce": 622700656,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"points": [
[
0.0,
0.0
],
[
81.75,
0.0
],
[
81.75,
159.0
],
[
163.5,
159.0
]
],
"lastCommittedPoint": null,
"startBinding": {
"elementId": "node-backend",
"focus": 0,
"gap": 4
},
"endBinding": {
"elementId": "node-raw",
"focus": 0,
"gap": 4
},
"startArrowhead": null,
"endArrowhead": "arrow",
"elbowed": true
},
{
"id": "edge-label-backend-raw",
"type": "text",
"x": 948.75,
"y": 375.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": 694437893,
"version": 1,
"versionNonce": 1459806024,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 13,
"fontFamily": 5,
"text": "RAW backend",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "RAW backend",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "edge-vda-virtio",
"type": "arrow",
"x": 220.0,
"y": 289.5,
"width": 160.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": 1903638622,
"version": 1,
"versionNonce": 339021053,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"points": [
[
0.0,
0.0
],
[
80.0,
0.0
],
[
80.0,
0.0
],
[
160.0,
0.0
]
],
"lastCommittedPoint": null,
"startBinding": {
"elementId": "node-vda",
"focus": 0,
"gap": 4
},
"endBinding": {
"elementId": "node-virtio-queue",
"focus": 0,
"gap": 4
},
"startArrowhead": null,
"endArrowhead": "arrow",
"elbowed": true
},
{
"id": "edge-label-vda-virtio",
"type": "text",
"x": 255.0,
"y": 249.5,
"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": 124979975,
"version": 1,
"versionNonce": 1180572335,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 13,
"fontFamily": 5,
"text": "block I/O",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "block I/O",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "edge-vq-backend",
"type": "arrow",
"x": 568.0,
"y": 289.5,
"width": 160.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": 1649285052,
"version": 1,
"versionNonce": 359088642,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"points": [
[
0.0,
0.0
],
[
80.0,
0.0
],
[
80.0,
0.0
],
[
160.0,
0.0
]
],
"lastCommittedPoint": null,
"startBinding": {
"elementId": "node-virtio-queue",
"focus": 0,
"gap": 4
},
"endBinding": {
"elementId": "node-backend",
"focus": 0,
"gap": 4
},
"startArrowhead": null,
"endArrowhead": "arrow",
"elbowed": true
},
{
"id": "edge-label-vq-backend",
"type": "text",
"x": 603.0,
"y": 249.5,
"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": 1715374896,
"version": 1,
"versionNonce": 804862916,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 13,
"fontFamily": 5,
"text": "VM boundary",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "VM boundary",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-vda",
"type": "rectangle",
"x": 70.0,
"y": 257.5,
"width": 150.0,
"height": 64.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": 656251698,
"version": 1,
"versionNonce": 1124580118,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-vda",
"type": "text",
"x": 80.0,
"y": 267.5,
"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": 1507714488,
"version": 1,
"versionNonce": 673939059,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "/dev/vda",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "/dev/vda",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-virtio-queue",
"type": "rectangle",
"x": 380.0,
"y": 245.5,
"width": 188.0,
"height": 88.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": 1377893440,
"version": 1,
"versionNonce": 287173562,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-virtio-queue",
"type": "text",
"x": 390.0,
"y": 255.5,
"width": 168.0,
"height": 68.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": 931218772,
"version": 1,
"versionNonce": 1603301814,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "virtio-blk · virtqueue\nGuest\nVM boundary 직전",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "virtio-blk · virtqueue\nGuest\nVM boundary 직전",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-backend",
"type": "rectangle",
"x": 728.0,
"y": 257.5,
"width": 160.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": 430450037,
"version": 1,
"versionNonce": 288855291,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-backend",
"type": "text",
"x": 738.0,
"y": 267.5,
"width": 140.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": 349920174,
"version": 1,
"versionNonce": 257387561,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "QEMU block backend",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "QEMU block backend",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-block-device",
"type": "rectangle",
"x": 1048.0,
"y": 60.0,
"width": 160.0,
"height": 105.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": 1046702581,
"version": 1,
"versionNonce": 1391342654,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-block-device",
"type": "text",
"x": 1058.0,
"y": 70.0,
"width": 140.0,
"height": 85.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": 1997913124,
"version": 1,
"versionNonce": 1061639791,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "Host block device\n/dev/...\nfile 없음\n→ Host block stack",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "Host block device\n/dev/...\nfile 없음\n→ Host block stack",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-qcow2",
"type": "rectangle",
"x": 1048.0,
"y": 237.0,
"width": 160.0,
"height": 105.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": 1108590116,
"version": 1,
"versionNonce": 663628861,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-qcow2",
"type": "text",
"x": 1058.0,
"y": 247.0,
"width": 140.0,
"height": 85.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": 1782912670,
"version": 1,
"versionNonce": 427333534,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "qcow2 file\nfile backend\nmapping · metadata\n→ Host filesystem",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "qcow2 file\nfile backend\nmapping · metadata\n→ Host filesystem",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-raw",
"type": "rectangle",
"x": 1051.5,
"y": 414.0,
"width": 153.0,
"height": 105.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": 1800492809,
"version": 1,
"versionNonce": 641737384,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-raw",
"type": "text",
"x": 1061.5,
"y": 424.0,
"width": 133.0,
"height": 85.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": 401005464,
"version": 1,
"versionNonce": 131485356,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "RAW file\nfile backend\noffset 대응\n→ Host filesystem",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "RAW file\nfile backend\noffset 대응\n→ Host filesystem",
"autoResize": true,
"lineHeight": 1.25
}
],
"appState": {
"gridSize": 10,
"viewBackgroundColor": "#ffffff",
"currentItemFontFamily": 5
},
"files": {}
}
docs/virtualization/final/assets/diagrams/qemu-block-backend-forms/qemu-block-backend-forms.manifest.json
+42
View File
@@ -0,0 +1,42 @@
{
"harness_version": "0.2.0",
"spec_id": "qemu-block-backend-forms",
"spec_version": "1.1",
"spec_sha256": "f93efd7e7cc5bcf159ec1c0741a18e6f394ccb5aa7b257edf2d9a5339c4d0315",
"source_context": {
"document": "docs/virtualization/final/document.md",
"document_sha256": "8c4ecc64c8cea9a4450ed7131fdd9cb2048dc092b66cd969f6346ed77887c210",
"anchor": {
"kind": "heading",
"value": "제4부 — 스토리지 가상화",
"line": 5791
}
},
"outputs": [
"qemu-block-backend-forms.svg",
"qemu-block-backend-forms.mmd",
"qemu-block-backend-forms.d2",
"qemu-block-backend-forms.dot",
"qemu-block-backend-forms.drawio",
"qemu-block-backend-forms.excalidraw",
"qemu-block-backend-forms.alt.md"
],
"lint_issue_count": 0,
"assumption_count": 0,
"assumptions_allowed": false,
"composition_profile": "component-flow",
"reference_ids": [
"payment-event-flow"
],
"diagram_only": true,
"source_spec_file_sha256": "85100cd6fde358fcc1408453c9208a1bbee5e58219856b92ff9346b3116623e3",
"output_sha256": {
"qemu-block-backend-forms.svg": "c493b2209e6af06b96bbc3affa53990a477ec71cd355f2cf8e84f2fba4beaedf",
"qemu-block-backend-forms.mmd": "638f59435935b3df10da5209b13de0a6286d2835267c54d2039d8bc64c66ced3",
"qemu-block-backend-forms.d2": "fa95e164401780c28227177a17d0d4ab48edb86c1c7dc74b2d92c25d4a4d280e",
"qemu-block-backend-forms.dot": "f4ec55f023a6738a43a18bae7c40921ea9ba14390c224add8a9f2b133d3e7e32",
"qemu-block-backend-forms.drawio": "f7d53a7f56be239541dd5edfef2cbc88834e886cb9a8aebdb260d6f6a39b6d2b",
"qemu-block-backend-forms.excalidraw": "195dcaa2379574889102dd39a3af19aec39ed5b61b5173a953143ed13ffddadd",
"qemu-block-backend-forms.alt.md": "ee90a0c129da2dd608e199df0a267d783af6bb0dd34dff1d5967a075dc42d2d5"
}
}
docs/virtualization/final/assets/diagrams/qemu-block-backend-forms/qemu-block-backend-forms.mmd
+14
View File
@@ -0,0 +1,14 @@
%% virtqueue 뒤 QEMU block backend의 세 형태
%% question: Guest /dev/vda 요청이 VM boundary를 넘은 뒤 QEMU에서 qcow2, RAW, Host block device 중 어느 backend로 이어지는가
flowchart LR
n0[("/dev/vda")]
n1["virtio-blk · virtqueue"]
n2["QEMU block backend"]
n3[("qcow2 file")]
n4[("RAW file")]
n5[("Host block device")]
n0 -->|"block I/O"| n1
n1 -->|"VM boundary"| n2
n2 -->|"qcow2 backend"| n3
n2 -->|"RAW backend"| n4
n2 -->|"block-device backend"| n5
docs/virtualization/final/assets/diagrams/qemu-block-backend-forms/qemu-block-backend-forms.svg
+107
View File
@@ -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>
Side by Side

After

Width:  |  Height:  |  Size: 9.2 KiB