2022-01-29 23:43:22 +03:00
|
|
|
|
[Документация](../../README-ru.md#документация) → Использование → QEMU и qemu-img
|
|
|
|
|
|
|
|
|
|
|
|
-----
|
|
|
|
|
|
|
|
|
|
|
|
[Read in English](qemu.en.md)
|
|
|
|
|
|
|
|
|
|
|
|
# QEMU и qemu-img
|
|
|
|
|
|
|
|
|
|
|
|
## QEMU
|
|
|
|
|
|
|
|
|
|
|
|
Чтобы использовать Vitastor-диски в QEMU, вам нужна доработанная версия QEMU.
|
|
|
|
|
|
Её можно установить [из пакетов](../installation/packages.ru.md).
|
|
|
|
|
|
|
|
|
|
|
|
Для ручного запуска виртуальной машины QEMU из командной строки с Vitastor-диском
|
|
|
|
|
|
используйте один из следующих вариантов команд:
|
|
|
|
|
|
|
|
|
|
|
|
Старый синтаксис (-drive):
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
qemu-system-x86_64 -enable-kvm -m 1024 \
|
|
|
|
|
|
-drive 'file=vitastor:etcd_host=192.168.7.2\:2379/v3:image=debian9',
|
|
|
|
|
|
format=raw,if=none,id=drive-virtio-disk0,cache=none \
|
|
|
|
|
|
-device 'virtio-blk-pci,scsi=off,bus=pci.0,addr=0x5,drive=drive-virtio-disk0,
|
|
|
|
|
|
id=virtio-disk0,bootindex=1,write-cache=off' \
|
|
|
|
|
|
-vnc 0.0.0.0:0
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
Новый синтаксис (-blockdev):
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
qemu-system-x86_64 -enable-kvm -m 1024 \
|
|
|
|
|
|
-blockdev '{"node-name":"drive-virtio-disk0","driver":"vitastor","image":"debian9",
|
|
|
|
|
|
"cache":{"direct":true,"no-flush":false},"auto-read-only":true,"discard":"unmap"}' \
|
|
|
|
|
|
-device 'virtio-blk-pci,scsi=off,bus=pci.0,addr=0x5,drive=drive-virtio-disk0,
|
|
|
|
|
|
id=virtio-disk0,bootindex=1,write-cache=off' \
|
|
|
|
|
|
-vnc 0.0.0.0:0
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
Вместо `:image=<IMAGE>` также можно указывать номер инода, пул и размер: `:pool=<POOL>:inode=<INODE>:size=<SIZE>`.
|
|
|
|
|
|
|
|
|
|
|
|
## qemu-img
|
|
|
|
|
|
|
|
|
|
|
|
Для qemu-img используйте строку `vitastor:etcd_host=<HOST>:image=<IMAGE>` в качестве имени файла диска.
|
|
|
|
|
|
|
|
|
|
|
|
Например, чтобы загрузить образ диска в Vitastor:
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
qemu-img convert -f qcow2 debian10.qcow2 -p -O raw 'vitastor:etcd_host=10.115.0.10\:2379/v3:image=testimg'
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
Если вы не хотите обращаться к образу по имени, вместо `:image=<IMAGE>` можно указать номер пула, номер инода и размер:
|
|
|
|
|
|
`:pool=<POOL>:inode=<INODE>:size=<SIZE>`.
|
2023-01-06 17:33:49 +03:00
|
|
|
|
|
|
|
|
|
|
### Экспорт снимков
|
|
|
|
|
|
|
|
|
|
|
|
Начиная с 0.8.4 вы можете экспортировать отдельные слои (изменения в снимках) с помощью `qemu-img`.
|
|
|
|
|
|
|
|
|
|
|
|
Допустим, что у вас есть образ `testimg` и его снимок `testimg@0`, созданный с помощью `vitastor-cli snap-create testimg@0`.
|
|
|
|
|
|
|
|
|
|
|
|
Тогда вы можете выгрузить снимок `testimg@0` и данные, изменённые в `testimg` после создания снимка, отдельно,
|
|
|
|
|
|
с помощью следующих команд (ключевые моменты - использование `skip-parents=1` и опции `-B backing_file.qcow2`):
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
qemu-img convert -f raw 'vitastor:etcd_host=192.168.7.2\:2379/v3:image=testimg@0' \
|
|
|
|
|
|
-O qcow2 testimg_0.qcow2
|
|
|
|
|
|
|
|
|
|
|
|
qemu-img convert -f raw 'vitastor:etcd_host=192.168.7.2\:2379/v3:image=testimg:skip-parents=1' \
|
|
|
|
|
|
-O qcow2 -o 'cluster_size=4k' -B testimg_0.qcow2 testimg.qcow2
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
На самом деле, с `cluster_size=4k` вместо `-B testimg_0.qcow2` можно использовать любой qcow2-файл,
|
|
|
|
|
|
даже пустой.
|
|
|
|
|
|
|
|
|
|
|
|
Опция QCOW2 `cluster_size=4k` нужна, если вы хотите, чтобы `testimg.qcow2` содержал **в точности**
|
|
|
|
|
|
данные, перезаписанные в дочернем слое. С размером кластера QCOW2 по умолчанию, составляющим 64 КБ,
|
|
|
|
|
|
вы получите немного "лишних" данных из родительских слоёв - перезапись 4 КБ будет приводить к тому,
|
|
|
|
|
|
что в `testimg.qcow2` будет появляться 64 КБ данных. Причём "лишние" данные qemu-img будет брать
|
|
|
|
|
|
как раз из файла, указанного в опции `-B`, так что если там указан пустой образ, кластер обязан быть 4 КБ.
|
|
|
|
|
|
|
|
|
|
|
|
После данной процедуры вы получите два QCOW2-образа, связанных в цепочку. Чтобы "отцепить" образ
|
|
|
|
|
|
`testimg.qcow2` от базового, выполните:
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
qemu-img rebase -u -b '' testimg.qcow2
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
Это можно использовать для резервного копирования. Только помните, что экспортировать образ, в который
|
|
|
|
|
|
в то же время идёт запись, небезопасно - результат чтения не будет целостным. Так что если вы работаете
|
|
|
|
|
|
с активными виртуальными машинами, экспортируйте только их снимки, но не сам образ.
|
