Documentação do Oracle Cloud Infrastructure

Usando os Utilitários OCI-KVM

Os utilitários OCI-KVM (oci-kvm) permitem criar e configurar convidados do KVM nas instâncias do Oracle Cloud Infrastructure.

Durante o processo de criação automatizada de convidados, o utilitário garante que os recursos do Oracle Cloud Infrastructure não sejam designados a mais de um convidado KVM. Quando você não precisar mais de um convidado, os utilitários poderão remover o convidado e desconfigurar todos os recursos do sistema designados ao convidado.

criação oci-kvm

Descrição

  • Executa todas as ações necessárias para criar um convidado KVM que use o armazenamento em blocos do Oracle Cloud Infrastructure e as VNICs do Oracle Cloud Infrastructure para o disco raiz e a interface de rede.
  • Para armazenamento em blocos, valida e verifica o dispositivo para garantir que ele não tenha sido designado a outro convidado. Um pool de armazenamento também pode ser usado.
  • Para interfaces de rede virtual, cria toda a infraestrutura de rede virtual necessária para cada convidado, incluindo funções virtuais, VLANs, dispositivos de armazenamento em blocos individuais e VNICs.
  • Os convidados não podem compartilhar uma VNIC nem um dispositivo de armazenamento em blocos.
  • Os convidados podem ter várias VNICs designadas e estar anexados a mais de uma rede virtual.

Uso

oci-kvm create [-h] [-D | --domain vm_name] [-d | --disk device_path] [-p | --pool pool_name] [-s | --disk-size disk_size] [-n | --net ip_vnic] [-v | --virtual-network virtual_network_name] [-V | --virt opt_args]

Opções

-h | --help
Exibe as opções do comando.
-D | --domain vm_name
O nome da máquina virtual.
-d | --disk device_path
Caminho para o dispositivo de bloco a ser usado como disco raiz da VM; use com -p | --pool e -s | --disk-size.
-s | --disk-size disk_size
Tamanho do disco, em gigabytes, a ser criado ao usar o pool de armazenamento; use com -d | --disk e -p | --pool.
-p | --pool pool_name
O nome do pool de armazenamento a ser usado para o disco raiz. Use com -d |--disk e -s | --disk-size.
-v | --virtual-network virtual_network_name
O nome da rede libvirt à qual anexar o convidado; pode ser repetido para anexar o convidado a várias redes.
-n | --net ip_vnic
IP ou nome da VNIC designada ao convidado; pode ser repetido para designar várias VNICs.
-V | --virt optional_arguments
Outros argumentos opcionais a serem fornecidos para virt-install. Esses argumentos são informados não modificados para virt-install, mesmo que sejam argumentos que o oci-kvm entenderia de outra forma.

Exemplos

Este exemplo mostra como criar um convidado chamado MY_VM com um disco raiz de 128 GB no pool de armazenamento chamado MY_POOL usando a VNIC 192.168.100.1.

oci-kvm create -D MY_VM --disk-size 128 --disk DEVICE_PATH --pool MY_POOL --net
            192.168.100.1 --virt --vcpu 1 --memory 8g --pxe

Este exemplo mostra como criar um convidado do Oracle Linux 7 Update 8 configurado para usar um pool de armazenamento, várias VNICs (duas VNICs neste exemplo usando a opção -n ) e uma console serial para saída da console. 

oci-kvm create -D MY_VM -p MY_POOL -s 35
                -n 10.0.0.97 -n 10.0.1.2 -V --vcpus 4 --memory 8192 --boot cdrom,hd --location
                /tmp/OracleLinux-R7-U8-Server-x86_64-dvd.iso --nographics --console
                pty,target_type=serial --console pty,target_type=virtio --noautoconsole
                --os-variant=rhel7 --extra-args "console=ttyS0,115200n8"

destruição de oci-kvm

Descrição

  • Exclui permanentemente um convidado KVM.
  • Opcionalmente, exclui os discos associados baseados no pool de armazenamento.

Uso

oci-kvm destroy [-D | --domain vm_name][--destroy-disks] [-f | --force vm_name] [-s | --stop vm_name]

Opções

-h | --help
Exibe as opções do comando.
-D | --domain vm_name
O nome da máquina virtual.
--destroy-disks
Exclui discos baseados em pool de armazenamento.
-f | --force vm_name
Força a máquina virtual a parar.
-s | --stop vm_name
Interrompe a máquina virtual.

Exemplos

Este exemplo mostra como interromper e destruir a máquina virtual MY_VM e excluir seus discos baseados no pool de armazenamento associado.

oci-kvm destroy -s -D MY_VM --destroy-disks

pool de criação oci-kvm

Descrição

  • Cria um pool de armazenamento para hospedar discos virtuais convidados.
  • É possível criar pools em dispositivos de bloco ou sistemas de arquivos FSS.

Uso

oci-kvm create-pool [-n | --name pool_name][-d | --disk device_path]

oci-kvm create-pool [-n | --name pool_name][-N | --netfshost ip_nfs][-p | --path path_netfs]

Opções

-h | --help
Exibe as opções do comando.
-n | --name pool_name
Nome do pool de armazenamento.
-d | --disk device_path
Caminho para o disco no qual o pool de armazenamento é criado.
-N | --netfshost ip_nfs
Nome ou IP do servidor NFS no qual o pool de armazenamento é criado; use com -p | --path.
-p | --path path_netfs
Caminho para o recurso NETFS; use com -N | --netfshost.

Exemplos

Esse exemplo mostra como criar um pool de armazenamento baseado em disco no disco /dev/sdb. 

oci-kvm create-pool --disk /dev/sdb

Esse exemplo mostra como criar um pool de armazenamento baseado em NETFS chamado MY_POOL no recurso NFS FileSystem-20201212-1454 no servidor NFS 192.168.100.1.

oci-kvm create-pool --netfshost 192.168.100.2 --path /FileSystem-20201212-1454 --name MY_POOL

oci-kvm pool de listas

Descrição

Lista os pools de armazenamento associados à instância.

Uso

oci-kvm list-pool [--output-mode mode]

Opções

-h | --help
Exibe as opções do comando.
--output-mode mode
Define o modo de exibição de saída. Para mode, especifique parsable, table, json ou text.

Exemplos

Este exemplo lista os pools no modo de saída de texto.

oci-kvm list-pool --output-mode text

oci-kvm create-network

Descrição

  • Cria uma rede virtual (libvirt) que usa uma VNIC do Oracle Cloud Infrastructure.
  • A rede libvirt criada oferece uma faixa de IPs que pode ser utilizada por outros convidados KVM.

Uso

oci-kvm create-network [-n | --net ip_vnic] [-N | --network-name network_name] [-B | --ip-bridge ip_bridge] [-S | --ip-start ip_start] [-E | --ip-end ip_end] [-P | --ip-prefix ip_prefix]

Opções

-h | --help
Exibe as opções do comando.
-n | --net ip_vnic
IP da VNIC usada para construir a rede.
-N | --network-name network_name
Nome da rede virtual.
-B | --ip-bridge ip_bridge
IP ponte para espaço de endereço de rede virtual.
-S | --ip-start ip_start
Primeira faixa de IPs convidados no espaço de endereço da rede virtual.
-E | --ip-end ip_end
Última faixa de IPs convidados no espaço de endereço da rede virtual.
-P | --ip-prefix ip_prefix
Prefixo de IP a ser usado na rede virtual.

Exemplos

Esse exemplo mostra como criar uma rede virtual chamada MYNET0 em uma VNIC com 10.0.1.2 como endereço IP, um IP ponte 192.168.100.9, uma faixa de IPs 192.168.100.10 - 192.268.100.30 e um prefixo de IP 24.

oci-kvm create-network --network-name=MYNET0 --net=10.0.1.2 --ip-bridge=192.168.100.9
            --ip-start=192.168.100.10 --ip-end=192.168.100.30 --ip-prefix=24

oci-kvm delete-network

Descrição

Exclui uma rede libvirt criada anteriormente com o comando oci-kvm create-network.

Uso

oci-kvm delete-network [-N | --network-name network_name][-y | --yes]

Opções

-h | --help
Exibe as opções do comando.
-N | --network-name network_name
O nome da rede virtual.
-y | --yes
Permite que você confirme a exclusão da rede virtual, sem precisar ser solicitado.

Exemplos

Esse exemplo mostra como excluir uma rede virtual chamada MYNET0.

oci-kvm delete-network --network-name=MYNET0 -y