Emploi des utilitaires OCI-KVM

Les utilitaires OCI-KVM (oci-kvm) vous permettent de créer et de configurer des invités KVM sur des instances Oracle Cloud Infrastructure.

Lors du processus de création d'invité automatisé, l'utilitaire s'assure que les ressources Oracle Cloud Infrastructure ne sont pas affectées à plusieurs invités KVM. Lorsque vous n'avez plus besoin d'un invité, les utilitaires peuvent l'enlever et déconfigurer toutes les ressources système qui lui sont affectées.

oci-kvm create

Description

  • Effectue toutes les actions requises pour créer un invité KVM qui utilise le stockage de blocs Oracle Cloud Infrastructure et les cartes d'interface réseau virtuelles Oracle Cloud Infrastructure pour le disque racine et l'interface réseau.
  • Pour le stockage de blocs, valide et vérifie le périphérique pour s'assurer qu'il n'a pas été affecté à un autre invité. Un pool de stockage peut également être utilisé.
  • Pour les interfaces de réseau virtuel, crée l'intégralité de l'infrastructure de réseau virtuel, y compris les fonctions virtuelles, les VLAN, les périphériques de stockage de blocs individuels et les cartes d'interface réseau virtuelles requis pour chaque invité.
  • Les invités ne peuvent partager ni carte d'interface réseau virtuelle ni périphérique de stockage de blocs.
  • Plusieurs cartes d'interface réseau virtuelles peuvent être affectées aux invités et ces derniers peuvent être attachés à plusieurs réseaux virtuels.

Syntaxe

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]

Options

-h | --help
Affiche les options de la commande.
-D | --domain vm_name
Nom de la machine virtuelle.
-d | --disk device_path
Chemin de l'unité de blocs à utiliser en tant que disque racine de la machine virtuelle. A utiliser avec -p | --pool et -s | --disk-size.
-s | --disk-size disk_size
Taille du disque, en giga-octets, à créer lors de l'utilisation du pool de stockage. A utiliser avec -d | --disk et -p | --pool.
-p | --pool pool_name
Nom du pool de stockage à utiliser pour le disque racine. A utiliser avec -d |--disk et -s | --disk-size.
-v | --virtual-network virtual_network_name
Nom du réseau libvirt auquel attacher l'invité. L'option peut être répétée pour attacher l'invité à plusieurs réseaux.
-n | --net ip_vnic
Adresse IP ou nom de la carte d'interface réseau virtuelle affectée à l'invité. L'option peut être répétée pour affecter plusieurs cartes d'interface réseau virtuelles.
-V | --virt optional_arguments
Autres arguments facultatifs à fournir à virt-install. Ces arguments sont transmis sans modification à virt-install, même s'il s'agit d'arguments qu'oci-kvm comprendrait.

Exemples

Cet exemple montre comment créer un invité nommé MY_VM avec un disque racine de 128 Go sur le pool de stockage nommé MY_POOL utilisant la carte d'interface réseau virtuelle 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

Cet exemple montre comment créer un invité Oracle Linux 7 Update 8 configuré afin d'utiliser un pool de stockage, plusieurs cartes d'interface réseau virtuelles (deux cartes d'interface réseau virtuelles dans cet exemple avec l'option -n ) et une console série pour la sortie de 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"

oci-kvm destroy

Description

  • Supprime définitivement un invité KVM.
  • Supprime éventuellement les disques de pool de stockage associés.

Syntaxe

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

Options

-h | --help
Affiche les options de la commande.
-D | --domain vm_name
Nom de la machine virtuelle.
--destroy-disks
Supprime les disques de pool de stockage.
-f | --force vm_name
Force l'arrêt de la machine virtuelle.
-s | --stop vm_name
Arrête la machine virtuelle.

Exemples

Cet exemple montre comment arrêter et détruire la machine virtuelle MY_VM et supprimer les disques de pool de stockage associés.

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

oci-kvm create-pool

Description

  • Crée un pool de stockage pour héberger les disques virtuels invités.
  • Les pools peuvent être créés sur des unités de blocs ou des systèmes de fichiers FSS.

Syntaxe

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]

Options

-h | --help
Affiche les options de la commande.
-n | --name pool_name
Nom du pool de stockage.
-d | --disk device_path
Chemin du disque où le pool de stockage est créé.
-N | --netfshost ip_nfs
Nom ou adresse IP du serveur NFS sur lequel le pool de stockage est créé. A utiliser avec -p | --path.
-p | --path path_netfs
Chemin de la ressource NETFS. A utiliser avec -N | --netfshost.

Exemples

Cet exemple montre comment créer un pool de stockage sur disque sur le disque /dev/sdb.

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

Cet exemple montre comment créer un pool de stockage NETFS nommé MY_POOL sur la ressource NFS FileSystem-20201212-1454 sur le serveur NFS 192.168.100.1.

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

pool-liste oci-kvm

Description

Répertorie les pools de stockage associés à l'instance.

Syntaxe

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

Options

-h | --help
Affiche les options de la commande.
--output-mode mode
Définit le mode d'affichage de la sortie. Pour mode, indiquez parsable, table, json ou text.

Exemples

Cet exemple répertorie les pools en mode de sortie text.

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

oci-kvm create-network

Description

  • Crée un réseau virtuel (libvirt) qui utilise une carte d'interface réseau virtuelle Oracle Cloud Infrastructure.
  • Le réseau libvirt créé offre une plage d'adresses IP utilisable par d'autres invités KVM.

Syntaxe

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]

Options

-h | --help
Affiche les options de la commande.
-n | --net ip_vnic
Adresse IP de la carte d'interface réseau virtuelle utilisée pour créer le réseau.
-N | --network-name network_name
Nom du réseau virtuel.
-B | --ip-bridge ip_bridge
Adresse IP de pont pour l'espace d'adresse de réseau virtuel.
-S | --ip-start ip_start
Première adresse de la plage d'adresses IP de l'invité dans l'espace d'adresse de réseau virtuel.
-E | --ip-end ip_end
Dernière adresse de la plage d'adresses IP de l'invité dans l'espace d'adresse de réseau virtuel.
-P | --ip-prefix ip_prefix
Préfixe d'adresse IP à utiliser dans le réseau virtuel.

Exemples

Cet exemple montre comment créer un réseau virtuel nommé MYNET0 sur une carte d'interface réseau virtuelle avec 10.0.1.2 comme adresse IP, l'adresse IP de pont 192.168.100.9, la plage d'adresses IP 192.168.100.10 - 192.268.100.30 et le préfixe d'adresse 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

Description

Supprime un réseau libvirt précédemment créé à l'aide de la commande oci-kvm create-network.

Syntaxe

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

Options

-h | --help
Affiche les options de la commande.
-N | --network-name network_name
Nom du réseau virtuel.
-y | --yes
Permet de confirmer la suppression du réseau virtuel, sans avoir besoin d'être invité.

Exemples

Cet exemple montre comment supprimer un réseau virtuel nommé MYNET0.

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