Documentación de Oracle Cloud Infrastructure

Uso de las utilidades OCI-KVM

Las utilidades de OCI-KVM (oci-kvm) le permiten crear y configurar invitados de KVM en instancias de Oracle Cloud Infrastructure.

Durante el proceso de creación automática de invitados, la utilidad garantiza que los recursos de Oracle Cloud Infrastructure no se asignen a más de un invitado de KVM. Cuando ya no necesite un invitado, las utilidades pueden eliminarlo y anular la configuración de todos los recursos del sistema asignados al invitado.

oci-kvm create

Descripción

  • Realiza todas las acciones necesarias para crear un invitado de KVM que utilice el almacenamiento de bloques de Oracle Cloud Infrastructure y las VNIC de Oracle Cloud Infrastructure para el disco raíz y la interfaz de red.
  • Para el almacenamiento de bloques, valida y comprueba el dispositivo para asegurarse de que no se haya asignado a otro invitado. También se puede utilizar un pool de almacenamiento.
  • Para las interfaces de red virtual, crea toda la infraestructura de red virtual, incluidas las funciones virtuales, las VLAN, los dispositivos de almacenamiento de bloques individuales y las VNIC necesarias para cada invitado.
  • Los invitados no pueden compartir una VNIC ni un dispositivo de almacenamiento de bloques.
  • Los clientes pueden tener varias VNIC asignadas y estar conectados a más de una red virtual.

Sintaxis

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]

Opciones

-h | --help
Muestra las opciones para el comando.
-D | --domain vm_name
Nombre de la máquina virtual.
-d | --disk device_path
Ruta al dispositivo de bloque que se utilizará como disco raíz de la máquina virtual; utilice con -p | --pool y -s | --disk-size.
-s | --disk-size disk_size
Tamaño del disco, en GB, que se creará al utilizar el pool de almacenamiento; se utiliza con -d | --disk y -p | --pool.
-p | --pool pool_name
Nombre del pool de almacenamiento que se utilizará para el disco raíz. Utilice con -d |--disk y -s | --disk-size.
-v | --virtual-network virtual_network_name
Nombre de la red libvirt a la que conectar el invitado; se puede repetir para conectar al invitado a varias redes.
-n | --net ip_vnic
IP o nombre de la VNIC asignada al invitado; se puede repetir para asignar varias VNIC.
-V | --virt optional_arguments
Otros argumentos opcionales para proporcionar a virt-install. Estos argumentos se transfieren sin modificar a virt-install, incluso si son argumentos que oci-kvm comprendería de otro modo.

Ejemplos

En este ejemplo se muestra cómo crear un invitado denominado MY_VM con un disco raíz de 128 GB en el pool de almacenamiento denominado MY_POOL con la 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

En este ejemplo se muestra cómo crear un invitado de Oracle Linux 7 Update 8 configurado para utilizar un pool de almacenamiento, varias VNIC (dos VNIC en este ejemplo con la opción -n ) y una consola serie para la salida de la consola. 

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"

oci-kvm destroy

Descripción

  • Suprime permanentemente un invitado de KVM.
  • De manera opcional, suprime los discos basados en pools de almacenamiento asociados.

Sintaxis

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

Opciones

-h | --help
Muestra las opciones para el comando.
-D | --domain vm_name
Nombre de la máquina virtual.
--destroy-disks
Suprime los discos basados en pools de almacenamiento.
-f | --force vm_name
Fuerza la detención de la máquina virtual.
-s | --stop vm_name
Para la máquina virtual.

Ejemplos

En este ejemplo, se muestra cómo detener y destruir la máquina virtual MY_VM y suprimir discos basados en pools de almacenamiento asociados.

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

oci-kvm create-pool

Descripción

  • Crea un pool de almacenamiento para alojar discos virtuales de invitado.
  • Los pools se pueden crear en dispositivos de bloques o sistemas de archivos FSS.

Sintaxis

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]

Opciones

-h | --help
Muestra las opciones para el comando.
-n | --name pool_name
Nombre del pool de almacenamiento.
-d | --disk device_path
Ruta al disco donde se crea el pool de almacenamiento.
-N | --netfshost ip_nfs
Nombre o IP del servidor NFS donde se crea el pool de almacenamiento; utilice con -p | --path.
-p | --path path_netfs
Ruta al recurso NETFS; utilice con -N | --netfshost.

Ejemplos

En este ejemplo, se muestra cómo crear un pool de almacenamiento basado en disco en el disco /dev/sdb. 

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

En este ejemplo, se muestra cómo crear un pool de almacenamiento basado en NETFS denominado MY_POOL en el recurso NFS FileSystem-20201212-1454 en el servidor NFS 192.168.100.1.

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

oci-kvm list-pool

Descripción

Muestra los pools de almacenamiento asociados a la instancia.

Sintaxis

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

Opciones

-h | --help
Muestra las opciones para el comando.
--output-mode mode
Define el modo de visualización de salida. Para mode, especifique parsable, table, json o text.

Ejemplos

En este ejemplo se muestran los pools en el modo de salida de texto.

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

oci-kvm create-network

Descripción

  • Crea una red virtual (libvirt) que utiliza una VNIC de Oracle Cloud Infrastructure.
  • La red libvirt creada ofrece un rango de IP que pueden utilizar otros invitados de KVM.

Sintaxis

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]

Opciones

-h | --help
Muestra las opciones para el comando.
-n | --net ip_vnic
IP de la VNIC utilizada para crear la red.
-N | --network-name network_name
Nombre de la red virtual.
-B | --ip-bridge ip_bridge
IP de puente para espacio de dirección de red virtual.
-S | --ip-start ip_start
Primer rango de IP invitado en el espacio de dirección de red virtual.
-E | --ip-end ip_end
Último rango de IP invitado en el espacio de direcciones de red virtual.
-P | --ip-prefix ip_prefix
Prefijo IP que se utilizará en la red virtual.

Ejemplos

En este ejemplo, se muestra cómo crear una red virtual denominada MYNET0 en una VNIC con 10.0.1.2 como dirección IP, una IP de puente 192.168.100.9, un rango de IP 192.168.100.10 - 192.268.100.30 y un prefijo 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

Descripción

Suprime una red libvirt creada previamente con el comando oci-kvm create-network.

Sintaxis

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

Opciones

-h | --help
Muestra las opciones para el comando.
-N | --network-name network_name
Nombre de la red virtual.
-y | --yes
Permite confirmar la supresión de la red virtual, sin necesidad de que se le solicite.

Ejemplos

En este ejemplo, se muestra cómo suprimir una red virtual denominada MYNET0.

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