6.3. Exemplo de configuração de XML de máquina virtual

<domain type='kvm'>
 <name>Testguest1</name>
 <uuid>ec6fbaa1-3eb4-49da-bf61-bb02fbec4967</uuid>
 <memory unit='KiB'>1048576</memory>
 <currentMemory unit='KiB'>1048576</currentMemory>

Esta é uma máquina virtual KVM chamada Testguest1, com 1024 MiB de RAM alocada.

 <vcpu placement='static'>1</vcpu>

A VM é alocada com uma única CPU virtual (vCPU).

Para informações sobre a configuração de vCPUs, veja Seção 16.5, “Otimizando o desempenho da CPU da máquina virtual”.

 <os>
  <type arch='x86_64' machine='pc-q35-4.1'>hvm</type>
  <boot dev='hd'/>
 </os>

A arquitetura da máquina está ajustada à arquitetura AMD64 e Intel 64, e usa o tipo de máquina Intel Q35 para determinar a compatibilidade dos recursos. O sistema operacional está configurado para ser inicializado a partir do disco rígido.

Para informações sobre como criar uma VM com um sistema operacional instalado, veja Seção 2.2.2, “Criação de máquinas virtuais e instalação de sistemas operacionais convidados usando o console web”.

 <features>
  <acpi/>
  <apic/>
  <vmport state='off'/>
 </features>

Os recursos do hipervisor acpi e apic estão desativados e a porta VMWare IO está desligada.

 <cpu mode='host-model' check='partial'>

As definições de CPU do host a partir das capacidades XML (obtidas com virsh capabilities) são automaticamente copiadas para a configuração XML da VM. Portanto, quando a VM é inicializada, libvirt escolhe um modelo de CPU que é similar à CPU do host, e então adiciona características extras para aproximar o modelo do host o mais próximo possível.

 <clock offset='utc'>
  <timer name='rtc' tickpolicy='catchup'/>
  <timer name='pit' tickpolicy='delay'/>
  <timer name='hpet' present='no'/>
 </clock>

O relógio de hardware virtual da VM usa o fuso horário UTC. Além disso, três temporizadores diferentes são configurados para sincronização com o hipervisor QEMU.

 <on_poweroff>destroy</on_poweroff>
 <on_reboot>restart</on_reboot>
 <on_crash>destroy</on_crash>

Quando a VM desliga, ou seu sistema operacional termina inesperadamente, libvirt termina a VM e libera todos os seus recursos alocados. Quando a VM é reinicializada, libvirt a reinicia com a mesma configuração.

 <pm>
  <suspend-to-mem enabled='no'/>
  <suspend-to-disk enabled='no'/>
 </pm>

Os estados S3 e S4 ACPI do sono estão desativados para esta VM.

 <devices>
  <emulator>/usr/bin/qemu-kvm</emulator>
  <disk type='file' device='disk'>
   <driver name='qemu' type='qcow2'/>
   <source file='/var/lib/libvirt/images/Testguest.qcow2'/>
   <target dev='hda' bus='ide'/>
   <address type='drive' controller='0' bus='0' target='0' unit='0'/>
  </disk>
  <disk type='file' device='cdrom'>
   <driver name='qemu' type='raw'/>
   <target dev='hdb' bus='ide'/>
   <readonly/>
   <address type='drive' controller='0' bus='0' target='0' unit='1'/>
  </disk>

A VM usa o arquivo binário /usr/bin/qemu-kvm para emulação. Além disso, ele tem dois discos anexados. O primeiro disco é um disco rígido virtualizado baseado no /var/lib/libvirt/images/Testguest.qcow2 armazenado no host, e seu nome de dispositivo lógico está definido para hda.

  <controller type='usb' index='0' model='qemu-xhci' ports='15'>
   <address type='pci' domain='0x0000' bus='0x02' slot='0x00' function='0x0'/>
  </controller>
  <controller type='sata' index='0'>
   <address type='pci' domain='0x0000' bus='0x00' slot='0x1f' function='0x2'/>
  </controller>
  <controller type='pci' index='0' model='pcie-root'/>
  <controller type='pci' index='1' model='pcie-root-port'>
   <model name='pcie-root-port'/>
   <target chassis='1' port='0x10'/>
    <address type='pci' domain='0x0000' bus='0x00' slot='0x02' function='0x0' multifunction='on'/>
  </controller>
  <controller type='pci' index='2' model='pcie-root-port'>
   <model name='pcie-root-port'/>
   <target chassis='2' port='0x11'/>
    <address type='pci' domain='0x0000' bus='0x00' slot='0x02' function='0x1'/>
  </controller>
  <controller type='pci' index='3' model='pcie-root-port'>
   <model name='pcie-root-port'/>
   <target chassis='3' port='0x12'/>
    <address type='pci' domain='0x0000' bus='0x00' slot='0x02' function='0x2'/>
  </controller>
  <controller type='pci' index='4' model='pcie-root-port'>
   <model name='pcie-root-port'/>
   <target chassis='4' port='0x13'/>
    <address type='pci' domain='0x0000' bus='0x00' slot='0x02' function='0x3'/>
  </controller>
  <controller type='pci' index='5' model='pcie-root-port'>
   <model name='pcie-root-port'/>
   <target chassis='5' port='0x14'/>
     <address type='pci' domain='0x0000' bus='0x00' slot='0x02' function='0x4'/>
  </controller>
  <controller type='pci' index='6' model='pcie-root-port'>
   <model name='pcie-root-port'/>
   <target chassis='6' port='0x15'/>
    <address type='pci' domain='0x0000' bus='0x00' slot='0x02' function='0x5'/>
  </controller>
  <controller type='pci' index='7' model='pcie-root-port'>
   <model name='pcie-root-port'/>
   <target chassis='7' port='0x16'/>
   <address type='pci' domain='0x0000' bus='0x00' slot='0x02' function='0x6'/>
  </controller>
  <controller type='virtio-serial' index='0'>
   <address type='pci' domain='0x0000' bus='0x03' slot='0x00' function='0x0'/>
  </controller>

A VM usa um único controlador para anexar dispositivos USB, e um controlador raiz para dispositivos PCI-Express (PCIe). Além disso, está disponível uma controladora virtio-serial, que permite que a VM interaja com o host de diversas maneiras, como o console serial.

Para mais informações sobre dispositivos virtuais, veja Seção 10.5, “Tipos de dispositivos virtuais”.

 <interface type='network'>
  <mac address='52:54:00:65:29:21'/>
  <source network='default'/>
  <model type='rtl8139'/>
  <address type='pci' domain='0x0000' bus='0x00' slot='0x03' function='0x0'/>
 </interface>

Uma interface de rede é estabelecida na VM que utiliza a rede virtual default e o modelo de dispositivo de rede rtl8139.

Para informações sobre como configurar a interface de rede, veja Seção 16.6, “Otimizando o desempenho da rede de máquinas virtuais”.

  <serial type='pty'>
   <target type='isa-serial' port='0'>
    <model name='isa-serial'/>
   </target>
  </serial>
  <console type='pty'>
   <target type='serial' port='0'/>
  </console>
  <channel type='unix'>
   <target type='virtio' name='org.qemu.guest_agent.0'/>
   <address type='virtio-serial' controller='0' bus='0' port='1'/>
  </channel>
  <channel type='spicevmc'>
   <target type='virtio' name='com.redhat.spice.0'/>
    <address type='virtio-serial' controller='0' bus='0' port='2'/>
  </channel>

Um console serial pty é instalado na VM, o que permite a comunicação rudimentar da VM com o host. O console utiliza o canal UNIX na porta 1, e o paravirtualizado SPICE na porta 2. Isto é configurado automaticamente e não é recomendável alterar estas configurações.

Para mais informações sobre como interagir com VMs, veja Seção 2.4.1, “Interagindo com máquinas virtuais usando o console web”.

  <input type='tablet' bus='usb'>
   <address type='usb' bus='0' port='1'/>
  </input>
  <input type='mouse' bus='ps2'/>
  <input type='keyboard' bus='ps2'/>

A VM usa uma porta virtual usb, que é configurada para receber a entrada do tablet, e uma porta virtual ps2 configurada para receber a entrada do mouse e do teclado. Esta é configurada automaticamente e não é recomendável alterar estas configurações.

  <graphics type='spice' autoport='yes' listen='127.0.0.1'>
   <listen type='address' address='127.0.0.1'/>
   <image compression='off'/>
  </graphics>
  <graphics type='vnc' port='-1' autoport='yes' listen='127.0.0.1'>
   <listen type='address' address='127.0.0.1'/>
  </graphics>

A VM usa os protocolos vnc e SPICE para renderizar sua saída gráfica, e a compressão de imagem é desligada.

  <sound model='ich6'>
   <address type='pci' domain='0x0000' bus='0x00' slot='0x04' function='0x0'/>
  </sound>
  <video>
   <model type='qxl' ram='65536' vram='65536' vgamem='16384' heads='1' primary='yes'/>
   <address type='pci' domain='0x0000' bus='0x00' slot='0x02' function='0x0'/>
  </video>

Um dispositivo de som ICH6 HDA é configurado para a VM, e o dispositivo paravirtualizado QEMU QXL é configurado como o acelerador de vídeo. Isto é configurado automaticamente e não é recomendável alterar estas configurações.

  <redirdev bus='usb' type='spicevmc'>
   <address type='usb' bus='0' port='1'/>
  </redirdev>
  <redirdev bus='usb' type='spicevmc'>
   <address type='usb' bus='0' port='2'/>
  </redirdev>
  <memballoon model='virtio'>
   <address type='pci' domain='0x0000' bus='0x00' slot='0x07' function='0x0'/>
  </memballoon>
 </devices>
</domain>

A VM tem dois redirecionadores para anexar dispositivos USB remotamente, e o balonamento de memória é ligado. Isto é configurado automaticamente e não é recomendável alterar estas configurações.