refactor: 문서 사람처럼 작성하기

This commit is contained in:
donghyeon-ka
2026-09-22 16:24:58 +09:00
parent 1549e62b5e
commit f3bed70991
158 changed files with 4381 additions and 832 deletions
@@ -1,7 +1,7 @@
---
kind: CONCEPT
slug: a-cloud-image-is-an-installed-disk-and-cloud-init-fills-the-blanks
title: 설치를 안 했는데 왜 뜨는가 — 클라우드 이미지는 설치가 끝난 디스크이고 cloud-init 이 빈칸을 채운다
title: 클라우드 이미지와 cloud-init은 각각 무엇을 준비하는가
topic: lab-environment-build
topicName: 실험대 환경 구성
project: virtualization
@@ -18,9 +18,9 @@ source:
- final/document.md#217-부팅할-때-일어나는-일
---
# 설치를 안 했는데 왜 뜨는가 — 클라우드 이미지는 설치가 끝난 디스크이고 cloud-init 이 빈칸을 채운다
# 클라우드 이미지와 cloud-init은 각각 무엇을 준비하는가
클라우드 이미지는 배포자가 설치를 한 번 끝내 놓은 디스크 파일이라 게스트를 만들 때 설치 단계가 없다. 대신 hostname 과 SSH 호스트키 같은 고유값을 비워 둔 채 배포하고, cloud-init 이 첫 부팅에 그 빈칸을 채운다.
클라우드 이미지는 운영체제가 미리 설치된 디스크 이미지다. 게스트를 만들 때 운영체제 설치 과정을 다시 거치지 않고, 호스트명·사용자·SSH 키처럼 인스턴스마다 달라지는 값은 cloud-init이 첫 부팅 때 적용한다.
<!-- body:start -->
@@ -43,7 +43,7 @@ VM 의 디스크는 호스트의 파일 하나다. `kc-lab-1.qcow2` 라는 파
"부팅 가능한 특정 바이트 배열" 상태의 디스크
```
설치 과정은 수단이고 목적은 마지막 줄의 상태이며, 그 상태는 파일 하나의 내용으로 남는다. Debian 과 Ubuntu 는 자기 빌드 서버에서 이 설치를 한 번 수행하고 완성된 디스크를 qcow2 파일로 떠서 공개한다. 이 실험대에서는 그 파일을 내려받아 게스트 디스크의 바닥 이미지로 사용한다. 소스를 직접 컴파일하는 대신 이미 빌드된 바이너리를 받아 쓰는 것과 같아서, 결과물은 같고 시간만 아낀다.
설치 과정은 수단이고 목적은 마지막 줄의 상태이며, 그 상태는 파일 하나의 내용으로 남는다. Debian 과 Ubuntu 는 자기 빌드 서버에서 이 설치를 한 번 수행하고 완성된 디스크를 qcow2 파일로 떠서 공개한다. 이 실험대에서는 그 파일을 내려받아 게스트 디스크의 base image로 사용한다. 소스를 직접 컴파일하는 대신 이미 빌드된 바이너리를 받아 쓰는 것과 같아서, 결과물은 같고 시간만 아낀다.
## 그대로 복제하면 식별자가 겹치므로 일부러 비워 둔다
@@ -66,7 +66,7 @@ VM 의 디스크는 호스트의 파일 하나다. `kc-lab-1.qcow2` 라는 파
| SSH 호스트 키 | 없음 — 첫 부팅에 새로 생성 |
| machine-id | 비어 있음 |
cloud-init 이 이 빈칸을 첫 부팅에 채우는 장치다. `user-data` 라는 YAML 을 읽어 계정을 만들고 SSH 키를 등록하고 패키지를 깔고 임의의 스크립트를 실행한다.
cloud-init은 인스턴스마다 달라지는 설정을 첫 부팅에 적용한다. `user-data` 라는 YAML 을 읽어 계정을 만들고 SSH 키를 등록하고 패키지를 깔고 임의의 스크립트를 실행한다.
```text label="설치와 개인화를 누가 언제 하나"
전통적 설치 : [설치 + 개인화]를 부팅 전에 대화형으로 수행
@@ -86,19 +86,19 @@ cloud-init 이 이 빈칸을 첫 부팅에 채우는 장치다. `user-data` 라
|---|---|---|
| ISO로 정식 설치 | VM마다 대화형 설치 | 매번 처음부터 반복 |
| 이미지를 미리 개조 (`virt-customize`, `guestfish`) | libguestfs 설치 + 이미지 마운트 | 개조본을 따로 관리해야 함 |
| cloud-init | YAML 한 장 | 명령 한 줄 |
| cloud-init | YAML 설정 파일 | 명령 한 줄 |
이 실험대는 `virsh destroy` 와 오버레이 삭제로 게스트를 반복해서 지우고 다시 만드는 것이 실험 그 자체다. 재생성 비용이 낮아야 실험이 굴러간다. 두 노드가 바이트 단위로 같은 초기 상태로 만들어져야 한다는 조건도 붙는다. 손으로 설치하면 미묘하게 달라지고 그 차이가 실험 결과를 오염시킨다.
이 실험대는 `virsh destroy` 와 오버레이 삭제로 게스트를 반복해서 지우고 다시 만드는 것이 실험 그 자체다. 재생성 비용이 낮아야 실험이 굴러간다. 두 노드가 바이트 단위로 같은 초기 상태로 만들어져야 한다는 조건도 붙는다. 게스트마다 수동으로 설치하면 설정 차이가 생길 수 있어 두 노드의 조건을 동일하게 맞추기 어려워진다.
이미지 종류도 그 축에서 고른다. Debian 은 같은 판을 여러 변종으로 배포한다.
| Debian 변종 | 어디에 쓰나 |
|---|---|
| `genericcloud` | 가상화 환경 전용. virtio 드라이버만 담아 가볍다 → KVM에는 이걸 |
| `generic` | 베어메탈 포함. 드라이버가 많아 더 크다 |
| `nocloud` | cloud-init 없이 기본 계정이 박혀 있는 변종 |
| `genericcloud` | 이 실험대에서 사용한 Debian 12 클라우드 이미지 변종 |
| `generic` | Debian이 별도로 제공하는 다른 cloud image 변종. 이 실험대에서는 사용하지 않음 |
| `nocloud` | Debian이 별도로 제공하는 변종. 이 실험대에서는 사용하지 않음 |
`genericcloud` 가 가벼운 까닭은 물리 하드웨어 드라이버를 뺐다는 데 있고, 시드를 SATA CD-ROM 으로 붙이면 게스트가 그 장치를 보지 못하는 함정도 같은 이유로 생긴다. `virt-install --cloud-init` 은 시드를 `<target dev='sda' bus='sata'/>`, 즉 SATA CD-ROM 으로 붙인다. 그래서 이 조합에서는 게스트가 시드를 아예 장치로 보지 못한다. 「확정된 함정: `--cloud-init` + Debian `genericcloud` 조합은 동작하지 않는다」에서는 성공 판정을 `virsh domblklist` 의 장치 이름으로 잡아 둔 까닭이 여기 있다 — 시드가 `vdb` 로 보여야 하고, `sda` 로 보이면 게스트가 읽지 못한다.
이 실험대에서는 `virt-install --cloud-init`으로 만든 시드 연결에서 기대한 NoCloud 데이터소스를 확인하지 못했다. 이후 seed ISO를 `bus=virtio` 디스크로 연결했고, 정상 부팅한 게스트의 `cloud-init status --long`에서 `DataSourceNoCloud [seed=/dev/vdb]`를 확인했다. 따라서 현재 구성은 실제로 확인한 virtio seed 경로를 사용한다. `--cloud-init` 경로가 동작하지 않았던 원인을 Debian genericcloud의 특정 드라이버 부재로 단정할 증거는 남아 있지 않다.
## 게스트에게 디스크는 두 장이고, 시드는 OS 가 아니다
@@ -109,7 +109,7 @@ cloud-init 이 이 빈칸을 첫 부팅에 채우는 장치다. `user-data` 라
| `vda` | 20G | ext4 루트. 여기서 부팅한다 |
| `vdb` | 370K | `LABEL=CIDATA` 인 iso9660. 읽기 전용이고 마운트되지 않는다 |
`vda` 는 `base.qcow2` 위의 오버레이라 바닥 한 벌을 두 게스트가 공유하고 각자 변경분만 쌓는다. `vdb` 는 원본 YAML 을 구워 만든 ISO 를 풀에 올린 것이다.
`vda`는 공통 `base.qcow2`를 backing image로 사용하는 오버레이라 두 게스트가 같은 초기 이미지를 공유하고 각자 변경분만 저장한다. `vdb` 는 원본 YAML 을 구워 만든 ISO 를 풀에 올린 것이다.
```text label="같은 설정이 존재하는 세 곳"
kc-lab-1.yaml ──①──▶ seed-kc-lab-1.iso ──②③──▶ /var/lib/libvirt/images/seed-kc-lab-1.iso
@@ -119,7 +119,7 @@ kc-lab-1.yaml ──①──▶ seed-kc-lab-1.iso ──②③──▶ /va
같은 내용이 세 곳에 있어서 원본만 고치면 VM 에 반영되지 않는다. 셋을 한 번에 맞추는 것이 `deploy/lab/scripts/rebuild-seed.sh` 다.
## 부팅 다섯 단계 가운데 3번이 실패하면 조용히 끝난다
## cloud-init이 실패해도 VM 자체는 실행 중일 수 있다
```text label="첫 부팅에 일어나는 다섯 단계"
1. QEMU 가 vda 에서 부팅 → Debian 커널 시작
@@ -129,9 +129,9 @@ kc-lab-1.yaml ──①──▶ seed-kc-lab-1.iso ──②③──▶ /va
5. 언마운트 → SSH 로그인 가능
```
cloud-init 은 `cidata` 레이블을 가진 블록 장치를 찾지 못하면 데이터소스 없이 종료하기 때문에, 3번이 실패하면 hostname 이 `localhost` 로 남고 사용자가 생성되지 않는다. 오류 메시지는 어디에도 남지 않는다. `virsh screenshot` 으로 로그인 프롬프트만 봐도 즉시 판정할 수 있다.
NoCloud 시드를 읽지 못하면 `user-data`에 넣은 hostname·사용자·SSH 키 설정도 기대한 상태로 적용되지 않을 수 있다. 이 실험대에서는 `localhost` 호스트명과 SSH 인증 실패가 먼저 보였지만, 원인에 따라 cloud-init 로그와 상태 출력이 달라질 수 있으므로 로그가 남지 않는다고 일반화하지 않는다. SSH가 되지 않으면 `virsh screenshot`으로 콘솔의 호스트명을 확인하고, 가능하면 `cloud-init status --long`과 로그를 함께 확인한다.
`user-data` 파일은 `#cloud-config` 로 시작해야 한다. 이 첫 줄이 없으면 cloud-init 이 YAML 로 인식하지 못하고 무시하며, 증상은 「부팅은 됐는데 계정이 없다」로 나타난다.
이 절차의 `user-data`는 `#cloud-config`로 시작하는 cloud-config 형식을 사용한다. 헤더와 YAML 문법, cloud-init 스키마를 각각 확인하고, 실제 적용 여부는 부팅한 게스트의 hostname·사용자·SSH 상태와 cloud-init 로그에서 다시 확인한다.
「클라우드 이미지와 cloud-init」에서는 비상 접근 수단을 남기라는 항목 하나를 「실제로 겪은 교훈」이라고 따로 적어 두었다. `ssh_pwauth: false` 에 키 인증만 걸어 둔 상태로 3번이 실패하면 사용자가 생성되지 않아 키도 비밀번호도 없고, 콘솔에 붙어도 로그인할 수 없다. 실패 원인을 적어 둔 `/var/log/cloud-init.log` 를 읽을 방법이 그래서 사라지고, VM 을 지우고 다시 만드는 것 말고 남는 선택지가 없어진다. 콘솔 로그인용 비밀번호를 하나 넣어 두면 그 골목을 피하는데, 콘솔 로그인은 sshd 를 거치지 않으므로 `ssh_pwauth: false` 는 그대로 둔다.
@@ -148,7 +148,7 @@ multipass 와 virt-install 과 virsh 는 서로 배포판이 다른 도구가
| 네트워크·DHCP 구성 | `virbr0` + DHCP 예약 |
| `multipass shell` 로 즉시 접속 | `~/.ssh/config` 별칭 작성 |
multipass 를 쓰지 않은 까닭은 배포판이 아니라 범위에 있다. multipass 는 Ubuntu 이미지만 공식 지원해서 Debian 게스트를 띄울 수 없다. 그리고 이 실험대는 `virsh destroy` 로 노드를 죽이고 NetworkPolicy 로 포트를 막고 스냅샷으로 되돌리는 저수준 제어가 실험의 본체라 관리 계층이 필요했다.
multipass 를 쓰지 않은 까닭은 배포판이 아니라 범위에 있다. multipass 는 Ubuntu 이미지만 공식 지원해서 Debian 게스트를 띄울 수 없다. 그리고 이 실험대는 `virsh destroy`로 VM을 중단하고 NetworkPolicy로 포트를 차단하며 스냅샷으로 되돌리는 저수준 제어가 필요했기 때문에 libvirt 기반 구성을 사용했다.
## 이 설명이 걸려 있는 판올림
@@ -1,7 +1,7 @@
---
kind: CONCEPT
slug: inside-a-qcow2-file-the-mapping-table-and-its-clusters
title: qcow2 파일 안 — 매핑표와 클러스터, 그리고 항목이 0 이면 바닥에 다시 묻는다
title: qcow2의 매핑 테이블과 데이터 클러스터
topic: lab-environment-build
topicName: 실험대 환경 구성
project: virtualization
@@ -20,9 +20,9 @@ source:
- final/document.md#234-그래서-마이그레이션과-스냅샷이-된다
---
# qcow2 파일 안 — 매핑표와 클러스터, 그리고 항목이 0 이면 바닥에 다시 묻는다
# qcow2의 매핑 테이블과 데이터 클러스터
qcow2 는 raw 에 매핑표 하나를 더한 것이고, 표가 가리키는 값은 호스트 주소가 아니라 파일 안의 몇 번째 바이트다. 매핑 항목이 0 이면 바닥 파일의 같은 위치를 읽는다. 오버레이와 스냅샷과 압축이 전부 그 규칙 위에서 돈다.
qcow2는 가상 디스크의 블록을 파일 안의 어느 위치에서 읽을지 매핑 테이블로 관리한다. 매핑 항목이 비어 있고 backing file이 설정돼 있으면 같은 게스트 오프셋을 backing file에서 읽는다. 오버레이와 스냅샷도 이 매핑을 이용한다.
<!-- body:start -->
@@ -53,11 +53,11 @@ qcow2 는 「가상 디스크의 이 위치가 파일 안의 어디에 있는가
그리고 표에 적히는 값은 호스트 물리 디스크의 주소가 아니라 파일 안의 몇 번째 바이트다. 그래서 파일을 다른 기계로 통째로 옮겨도 표가 그대로 유효하다. 파일 밖을 가리키는 것은 백킹 파일 경로 하나뿐이라 그것만 따로 챙긴다.
## 클러스터 — 매핑의 최소 단위
## 클러스터는 qcow2 매핑의 최소 단위다
섹터 512B 하나하나를 매핑하면 표가 너무 커지기 때문에 클러스터라는 덩어리 단위로 끊고, 그 기본값이 64KB 다.
```bash label="바닥 이미지의 포맷과 크기를 읽는다"
```bash label="backing image의 포맷과 크기를 읽는다"
qemu-img info /var/lib/libvirt/images/base.qcow2
```
@@ -81,9 +81,9 @@ cluster_size: 65536
다섯 층의 크기가 서로 달라도 상관없고, 각 층이 자기 위층을 자기 단위로 쪼개 담는다. FAT 과 NTFS 도 할당 단위를 클러스터라고 부르는데, 같은 낱말이고 다른 층이다.
## 2단계 매핑 — L1 에서 L2 로
## L1과 L2 테이블로 클러스터 위치를 찾는다
매핑표를 한 장으로 만들면 20GB 디스크 하나에 표만 수 MB 가 되고, 대부분이 비어 있는데도 항상 들고 있어야 한다. 그래서 두 단계로 나눈다.
가상 디스크 전체를 단일 매핑 테이블로 관리하면 비어 있는 영역까지 큰 테이블을 유지해야 한다. qcow2는 이를 L1과 L2 두 단계로 나눠 필요한 영역의 매핑만 사용한다.
```text label="게스트 오프셋이 세 조각으로 쓰인다"
게스트가 읽으려는 위치
@@ -105,19 +105,19 @@ cluster_size: 65536
운영체제의 페이지 테이블과 같은 구조다. 필요한 L2 표만 만들면 되므로 안 쓴 영역은 L1 항목이 0 인 채로 끝난다.
## 항목이 0 이면 바닥에 다시 묻는다
## 매핑이 없으면 backing file을 확인한다
오버레이가 성립하는 규칙이 여기 있다.
| L2 항목이 | 바닥 파일이 | 읽으면 무엇이 돌아오나 |
| L2 항목 | backing file | 읽기 결과 |
|---|---|---|
| 값이 있음 | (무관) | 이 파일의 그 위치를 읽는다 |
| 0 | 없음 | 0 으로 채운 64KB 를 만들어 돌려준다 |
| 0 | 있음 | 바닥 파일의 같은 위치를 읽는다 |
| 0 | 있음 | backing file의 같은 게스트 오프셋을 읽는다 |
그래서 `kc-lab-1.qcow2` 는 자기가 바꾼 클러스터만 들고 있고 나머지는 전부 `base.qcow2` 를 본다. 20GB 를 선언한 파일이 1.4GB 로 잡히는 까닭이 이 규칙에 있다.
바닥 경로는 헤더에 `backing_file_offset` 으로 자리를 잡고 문자열로 들어가서, 바닥을 옮기거나 이름을 바꾸면 게스트가 부팅하지 못한다. 오버레이만 다른 기계로 복사하면 안 되는 까닭도 여기 있고, 경로를 절대경로로 주는 것도 같은 이유다.
backing file 경로는 qcow2 헤더에 저장되므로 파일을 옮기거나 이름을 바꾸면 오버레이가 backing file을 찾지 못할 수 있다. 오버레이만 다른 기계로 복사하면 안 되는 까닭도 여기 있고, 경로를 절대경로로 주는 것도 같은 이유다.
헤더에는 매직값 `QFI\xfb`, 버전, `cluster_bits`, 가상 디스크 크기, `l1_table_offset`, `refcount_table_offset`, `backing_file_offset` 이 들어간다.
@@ -148,7 +148,7 @@ qemu-img map --output=json /var/lib/libvirt/images/base.qcow2
```text label="실측 — Debian 12 genericcloud"
{'start': 0, 'length': 65536, 'data': True, 'compressed': True} ← 압축된 클러스터
{'start': 65536, 'length': 983040, 'data': False, 'zero': True} ← 구멍
{'start': 65536, 'length': 983040, 'data': False, 'zero': True} ← 할당되지 않은 희소 영역
{'start': 1048576, 'length': 65536, 'data': True, 'compressed': True}
compressed 구간: 606개 / 전체 1236개
@@ -156,13 +156,13 @@ compressed 구간: 606개 / 전체 1236개
| 3 GiB 가 324 MiB 가 되는 이유 | 이 이미지에서 |
|---|---|
| ① 안 쓴 공간을 안 적음 (희소) | 3 GiB 중 2.01 GiB 가 구멍 |
| ① 사용하지 않은 영역은 블록을 할당하지 않음 | 3 GiB 중 2.01 GiB가 희소 영역 |
| ② 쓴 부분을 zlib 압축 | 남은 1010 MiB → 324 MiB |
| ③ genericcloud 자체가 작음 | GUI·문서·물리 하드웨어 드라이버 없음 |
| ③ 배포 이미지 자체의 내용 | 어떤 패키지와 파일이 들어 있는지에 따라 사용 블록 양이 달라짐 |
압축도 우리가 한 것이 아니라 Debian 이 배포 시점에 한 것이다. `qemu-img convert -c` 를 돌린 적이 없는데도 `compressed: True` 가 나온다.
압축 클러스터는 읽을 때 자동으로 풀린다. 게스트가 그 클러스터에 쓰면 압축하지 않은 형태로 새로 할당하므로, 오버레이에 쌓이는 것은 비압축 클러스터다. 바닥은 작은데 오버레이가 상대적으로 커 보이는 까닭 가운데 하나가 여기 있다.
압축 클러스터는 읽을 때 자동으로 풀린다. 게스트가 그 클러스터에 쓰면 압축하지 않은 형태로 새로 할당하므로, 오버레이에 쌓이는 것은 비압축 클러스터다. 배포된 base image와 실행 후 오버레이의 파일 크기가 크게 달라질 수 있는 이유 가운데 하나다.
압축 단위가 클러스터이므로 1바이트를 읽어도 그 클러스터 전체를 풀어야 한다. 그래서 쓰기가 잦은 디스크에는 압축을 걸지 않는다.
@@ -179,17 +179,17 @@ base.qcow2 ← k3s-golden.qcow2 ← kc-lab-1.qcow2
|---|---|---|
| 언제 쌓나 | 빌드 시점에 의도적으로 | 주로 런타임 파생 |
| 층의 정체성 | 레이어마다 다이제스트 | 경로 문자열 |
| 배포 단위 | 레이어 tar 여러 개 + 매니페스트 | 파일들 (바닥까지 전부 필요) |
| 배포 단위 | 레이어 tar 여러 개 + 매니페스트 | qcow2 파일과 필요한 backing file |
| 층이 깊어지면 | 읽기 성능 영향 적음 | 읽을 때마다 사슬을 거슬러 올라간다 |
체인이 깊으면 읽기가 느려진다. 클러스터가 어느 층에 있는지 찾으려면 L2 항목이 0 일 때마다 한 층 아래로 내려가기 때문이다. 실험대에서 층을 두세 겹 넘게 쌓지 않는 까닭이 여기 있다.
| 사슬을 끊는 명령 | 무엇을 하나 | 결과 |
|---|---|---|
| `qemu-img commit <오버레이>` | 오버레이의 변경분을 바닥에 병합 | 바닥이 바뀐다. 다른 오버레이가 있으면 그것들이 깨진다 |
| `qemu-img convert -O qcow2 <오버레이> <새파일>` | 사슬 전체를 읽어 단일 파일로 평탄화 | 바닥과 무관해진다. 용량은 늘어난다 |
| `qemu-img commit <오버레이>` | 오버레이 변경분을 backing file에 병합 | backing file 내용이 바뀌므로 이를 공유하는 다른 오버레이에도 영향을 줄 수 있다 |
| `qemu-img convert -O qcow2 <오버레이> <새파일>` | backing chain을 읽어 독립된 파일로 변환 | 원래 backing file이 없어도 사용할 수 있다. 파일 크기는 커질 수 있다 |
다른 기계로 게스트를 보낼 때 오버레이만 복사하면 바닥이 없어 부팅하지 못하므로, 옮길 때는 `convert` 로 평탄화해 파일 하나로 완결시킨다.
다른 기계로 오버레이만 복사하면 backing file을 찾지 못할 수 있으므로, backing chain을 함께 옮기거나 `qemu-img convert`로 독립된 이미지로 변환해야 한다.
## `qemu-img` 는 VM 을 돌리지 않는다
@@ -197,11 +197,11 @@ base.qcow2 ← k3s-golden.qcow2 ← kc-lab-1.qcow2
`virt-install --disk size=20,backing_store=...` 이 내부적으로 `qemu-img create` 를 부른다. 골든 이미지를 만들거나 오버레이만 초기화할 때 이 도구를 직접 쓴다.
포맷을 알아보는 것도 헤더의 매직값이다. `qemu-img info` 가 `file format: raw` 로 읽으면 그 파일은 qcow2 가 아니고, 바닥 이미지를 받다가 끊겨 HTML 오류 페이지를 저장했을 때 그렇게 나온다.
포맷을 알아보는 것도 헤더의 매직값이다. `qemu-img info` 가 `file format: raw` 로 읽으면 그 파일은 qcow2 가 아니고, base image 다운로드가 실패해 HTML 오류 페이지가 저장됐을 때도 이런 식으로 잘못된 포맷이 드러날 수 있다.
## 이 설명이 걸려 있는 것
실측은 배포본 `base.qcow2` 한 장에 대한 것이고 `qemu-img info` 와 `qemu-img map --output=json` 의 출력이 근거다. 오버레이 쪽 매핑을 같은 명령으로 떠 본 기록은 없다.
실측은 배포본 `base.qcow2` 파일 하나에 대한 것이고 `qemu-img info` 와 `qemu-img map --output=json` 의 출력이 근거다. 오버레이 쪽 매핑을 같은 명령으로 떠 본 기록은 없다.
비트 나누기는 `cluster_size` 65536 에서 따라 나오는 계산이라 다른 클러스터 크기로 만든 이미지에서는 숫자가 달라진다.
@@ -1,7 +1,7 @@
---
kind: CONCEPT
slug: what-a-qcow2-file-carries
title: qcow2 파일 한 장이 담는 것 — 매핑표와 데이터 클러스터가 같은 파일 안에 있고, 파일 밖을 가리키는 것은 백킹 파일 경로 하나다
title: qcow2 파일에는 무엇이 저장되는가
topic: lab-environment-build
topicName: 실험대 환경 구성
project: virtualization
@@ -13,16 +13,16 @@ source:
- final/document.md#178-이-부의-출처와-범위
---
# qcow2 파일 한 장이 담는 것 — 매핑표와 데이터 클러스터가 같은 파일 안에 있고, 파일 밖을 가리키는 것은 백킹 파일 경로 하나다
# qcow2 파일에는 무엇이 저장되는가
qcow2 한 장에는 데이터 클러스터와 그것이 파일의 어느 오프셋에 놓였는지 적은 매핑표가 들어 있다. 이 실험대의 오버레이에서 파일 밖으로 이어지는 핵심 의존성은 백킹 파일 경로다. 실행 중인 프로세스와 안 내려간 dirty page, vCPU·RAM·NIC 를 적어 둔 VM 정의 XML 은 없다. 오버레이의 virtual size가 20GiB인데 host allocation이 몇 GiB에 그치는 주된 이유는 아직 쓰지 않은 영역을 파일에 할당하지 않는 sparse allocation이다. 다만 qcow2 포맷 자체는 압축을 지원하고, 이 실험대의 Debian `base.qcow2`에는 실제 압축 클러스터도 있다.
qcow2 파일에는 데이터 클러스터와 각 클러스터가 파일의 어느 오프셋에 놓였는지 기록한 매핑 테이블이 들어 있다. 이 실험대의 오버레이가 파일 밖에서 필요로 하는 정보는 backing file 경로다. 실행 중인 프로세스와 안 내려간 dirty page, vCPU·RAM·NIC 를 적어 둔 VM 정의 XML 은 없다. 오버레이의 virtual size가 20GiB인데 host allocation이 몇 GiB에 그치는 주된 이유는 아직 쓰지 않은 영역을 파일에 할당하지 않는 sparse allocation이다. 다만 qcow2 포맷 자체는 압축을 지원하고, 이 실험대의 Debian `base.qcow2`에는 실제 압축 클러스터도 있다.
<!-- body:start -->
## 파일 한 장 안에 들어 있는 것
## qcow2 파일 안에 들어 있는 것
qcow2 는 가상 디스크 한 장의 블록을 담는 파일이다. 블록의 내용이 들어가는 데이터 클러스터와, 그 클러스터가 파일의 어느 오프셋에 놓였는지 적은 매핑표가 같은 파일 안에 함께 있다.
qcow2는 가상 디스크의 블록을 담는 파일이다. 블록의 내용이 들어가는 데이터 클러스터와, 그 클러스터가 파일의 어느 오프셋에 놓였는지 적은 매핑표가 같은 파일 안에 함께 있다.
매핑표에 적히는 값은 호스트의 물리 주소가 아니라 파일 안의 오프셋이어서, 파일을 다른 디렉터리로 옮기든 다른 호스트로 복사하든 표가 가리키는 곳은 달라지지 않는다. 파일을 통째로 옮기기만 하면 매핑은 그대로 유효하다.
@@ -74,6 +74,6 @@ qcow2 는 가상 디스크 한 장의 블록을 담는 파일이다. 블록의
매핑표가 파일 안에서 어떤 구조로 나뉘는지는 여기서 다루지 않는다. 이식 관점에서 필요한 것은 매핑표가 파일 내부 오프셋을 가리킨다는 데까지다. qcow2 내부 L1/L2 table, blk-mq tag allocator, NVMe submission/completion queue 같은 세부 구현은 이 경로를 더 깊게 볼 때 별도로 다룬다.
온프렘 이미지를 클라우드로 올리는 절차도 이 글 밖이다. 원본 문서가 그 부분을 코드 관측이 아닌 외부 지식이라고 스스로 표시해 두었고 이 실험대에서 한 번도 해 보지 않아서, 원본 문서에만 두고 이 기록으로 옮기지 않았다.
온프렘에서 만든 이미지를 클라우드로 옮기는 절차는 이 실험대에서 수행하지 않았다. 여기서는 로컬 libvirt에서 qcow2 이미지를 생성하고 사용하는 범위까지만 다룬다.
<!-- body:end -->