Documentazione dell'infrastruttura Oracle Cloud

Utilizzo delle utility OCI-KVM

Le utility OCI-KVM (oci-kvm) ti consentono di creare e configurare guest KVM sulle istanze di Oracle Cloud Infrastructure.

Durante il processo di creazione automatizzato dei guest, la utility garantisce che le risorse Oracle Cloud Infrastructure non vengano assegnate a più guest KVM. Quando non è più necessario un guest, le utility possono rimuovere il guest e annullare la configurazione di tutte le risorse di sistema assegnate al guest.

creazione oci-kvm

Descrizione

  • Esegue tutte le azioni necessarie per creare un guest KVM che utilizza lo storage a blocchi di Oracle Cloud Infrastructure e le VNIC di Oracle Cloud Infrastructure sia per il disco root che per l'interfaccia di rete.
  • Per lo storage a blocchi, convalida e controlla il dispositivo per assicurarsi che non sia stato assegnato a un altro guest. È inoltre possibile utilizzare un pool di memorizzazione.
  • Per le interfacce di rete virtuali, vengono create tutte le infrastrutture di rete virtuali, incluse le funzioni virtuali, le VLAN, i singoli dispositivi di storage a blocchi e le VNIC richieste per ciascun guest.
  • I guest non possono condividere una VNIC o un dispositivo di storage a blocchi.
  • Ai guest possono essere assegnate più VNIC ed essere collegate a più reti virtuali.

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]

Opzioni

-h | --help
Visualizza le opzioni per il comando.
-D | --domain vm_name
Nome della virtual machine.
-d | --disk device_path
Percorso del dispositivo a blocchi da utilizzare come disco root della VM; utilizzare con -p | --pool e -s | --disk-size.
-s | --disk-size disk_size
Dimensione del disco, espressa in gigabyte, da creare quando si utilizza il pool di memorizzazione. Utilizzare con -d | --disk e -p | --pool.
-p | --pool pool_name
Nome del pool di memorizzazione da utilizzare per il disco root. Utilizzare con -d |--disk e -s | --disk-size.
-v | --virtual-network virtual_network_name
Il nome della rete libvirt a cui collegare l'ospite; può essere ripetuto per collegare l'ospite a più reti.
-n | --net ip_vnic
IP o nome della VNIC assegnata al guest; può essere ripetuto per assegnare più VNIC.
-V | --virt optional_arguments
Altri argomenti facoltativi da fornire a virt-install. Questi argomenti sono passati non modificati in virt-install, anche se sono argomenti che oci-kvm altrimenti capirebbe.

Esempi

Questo esempio mostra come creare un guest denominato MY_VM con un disco root di 128 GB sul pool di memorizzazione denominato MY_POOL utilizzando 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

Questo esempio mostra come creare un guest Oracle Linux 7 Update 8 configurato per utilizzare un pool di memorizzazione, più VNIC (due VNIC in questo esempio utilizzando l'opzione -n ) e una console seriale per l'output della 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"

distruzione di oci-kvm

Descrizione

  • Elimina definitivamente un guest KVM.
  • Se si desidera, elimina i dischi basati sul pool di memorizzazione associati.

Uso

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

Opzioni

-h | --help
Visualizza le opzioni per il comando.
-D | --domain vm_name
Nome della virtual machine.
--destroy-disks
Elimina i dischi basati su pool di storage.
-f | --force vm_name
Forza l'arresto della virtual machine.
-s | --stop vm_name
Arresta la virtual machine.

Esempi

Questo esempio mostra come arrestare ed eliminare la virtual machine MY_VM ed eliminare i dischi basati sul pool di memorizzazione associati.

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

cre-pool oci-kvm

Descrizione

  • Crea un pool di memorizzazione per l'hosting dei dischi virtuali guest.
  • I pool possono essere creati su dispositivi a blocchi o file system 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]

Opzioni

-h | --help
Visualizza le opzioni per il comando.
-n | --name pool_name
Nome del pool di memoria.
-d | --disk device_path
Percorso del disco in cui viene creato il pool di memorizzazione.
-N | --netfshost ip_nfs
Nome o IP del server NFS in cui viene creato il pool di memorizzazione. Utilizzare con -p | --path.
-p | --path path_netfs
Percorso della risorsa NETFS; utilizzare con -N | --netfshost.

Esempi

Questo esempio mostra come creare un pool di memorizzazione basato su disco sul disco /dev/sdb. 

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

Questo esempio mostra come creare un pool di memorizzazione basato su NETFS denominato MY_POOL sulla risorsa NFS FileSystem-20201212-1454 sul server NFS 192.168.100.1.

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

pool_elenco_kvm oci

Descrizione

Elenca i pool di memorizzazione associati all'istanza.

Uso

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

Opzioni

-h | --help
Visualizza le opzioni per il comando.
--output-mode mode
Imposta la modalità di visualizzazione dell'output. Per mode, specificare parsable, table, json o text.

Esempi

In questo esempio sono elencati i pool in modalità di output di testo.

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

oci-kvm create-network

Descrizione

  • Crea una rete virtuale (libvirt) che utilizza una VNIC di Oracle Cloud Infrastructure.
  • La rete libvirt creata offre una gamma IP utilizzabile da altri guest 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]

Opzioni

-h | --help
Visualizza le opzioni per il comando.
-n | --net ip_vnic
IP della VNIC utilizzata per creare la rete.
-N | --network-name network_name
Nome della rete virtuale.
-B | --ip-bridge ip_bridge
IP bridge per lo spazio degli indirizzi di rete virtuale.
-S | --ip-start ip_start
Primo intervallo IP guest nello spazio degli indirizzi di rete virtuale.
-E | --ip-end ip_end
Ultimo intervallo IP guest nello spazio degli indirizzi di rete virtuale.
-P | --ip-prefix ip_prefix
Prefisso IP da utilizzare nella rete virtuale.

Esempi

Questo esempio mostra come creare una rete virtuale denominata MYNET0 su una VNIC con 10.0.1.2 come indirizzo IP, un IP bridge di 192.168.100.9, un intervallo IP di 192.168.100.10 - 192.268.100.30 e un prefisso IP di 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 elimina-rete

Descrizione

Elimina una rete libvirt creata in precedenza con il comando oci-kvm create-network.

Uso

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

Opzioni

-h | --help
Visualizza le opzioni per il comando.
-N | --network-name network_name
Il nome della rete virtuale.
-y | --yes
Consente di confermare l'eliminazione della rete virtuale, senza dover essere richiesto.

Esempi

Questo esempio mostra come eliminare una rete virtuale denominata MYNET0.

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