refactor: 문서 사람처럼 작성하기
This commit is contained in:
+16
-16
@@ -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 기반 구성을 사용했다.
|
||||
|
||||
## 이 설명이 걸려 있는 판올림
|
||||
|
||||
|
||||
+21
-21
@@ -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 에서 따라 나오는 계산이라 다른 클러스터 크기로 만든 이미지에서는 숫자가 달라진다.
|
||||
|
||||
|
||||
+6
-6
@@ -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 -->
|
||||
|
||||
Reference in New Issue
Block a user