Documentation sur Oracle Cloud Infrastructure

Utilisation des utilitaires OCI-KVM

Les utilitaires OCI-KVM (oci-kvm) vous permettent de créer et de configurer des clients KVM dans les instances Oracle Cloud Infrastructure.

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

oci-kvm Créer

Description

  • Effectue toutes les actions requises pour créer un client KVM qui utilise le stockage par blocs d'Oracle Cloud Infrastructure et des cartes vNIC d'Oracle Cloud Infrastructure pour le disque racine et l'interface réseau.
  • Pour le stockage par blocs, valide et vérifie que le périphérique n'a pas été affecté à un autre client. Un groupe de stockage peut également être utilisé.
  • Pour les interfaces de réseau virtuel, crée toute l'infrastructure de réseau virtuel, y compris les fonctions virtuelles, les VLAN, les périphériques de stockage par blocs individuels et les cartes vNIC requis pour chaque client.
  • Les clients ne peuvent pas partager une carte vNIC ou un périphérique de stockage par blocs.
  • Plusieurs cartes vNIC peuvent être affectées aux clients et associées à 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 d'accès au périphérique par blocs à utiliser en tant que disque racine de la machine virtuelle; utilisé avec -p | --pool et -s | --disk-size.
-s | --disk-size disk_size
Taille du disque, en gigaoctets, à créer lors de l'utilisation du groupe de stockage; utilisé avec -d | --disk et -p | --pool.
-p | --pool pool_name
Nom du groupe de stockage à utiliser pour le disque racine. Utilisé avec -d |--disk et -s | --disk-size.
-v | --virtual-network virtual_network_name
Nom du réseau libvirt auquel attacher le client; peut être répété pour attacher le client à plusieurs réseaux.
-n | --net ip_vnic
Adresse IP ou nom de la carte vNIC affectée au client; peut être répété pour affecter plusieurs cartes vNIC.
-V | --virt optional_arguments
Autres arguments facultatifs à indiquer pour virt-install. Ces arguments sont transmis sans modification à virt-install, même s'il s'agit d'arguments que oci-kvm pourrait interpréter différemment.

Exemples

Cet exemple montre comment créer un client nommé MY_VM avec un disque racine de 128 Go dans le groupe de stockage nommé MY_POOL à l'aide de la carte 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

Cet exemple montre comment créer un client Oracle Linux 7.8 configuré pour utiliser un groupe de stockage, plusieurs cartes vNIC (2 cartes vNIC dans cet exemple à l'aide de l'option -n ) et une console série pour la sortie de la 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 client KVM.
  • Supprime éventuellement les disques basés sur un groupe 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 basés sur un groupe 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 basés sur un groupe de stockage associés.

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

oci-kvm create-pool

Description

  • Crée un groupe de stockage pour héberger les disques virtuels clients.
  • Les groupes peuvent être créés sur des périphériques par 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 groupe de stockage.
-d | --disk device_path
Chemin d'accès au disque sur lequel le groupe de stockage est créé.
-N | --netfshost ip_nfs
Nom ou adresse IP du serveur NFS où le groupe de stockage est créé; utilisé avec -p | --path.
-p | --path path_netfs
Chemin d'accès à la ressource NETFS; utilisé avec -N | --netfshost.

Exemples

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

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

Cet exemple montre comment créer un groupe de stockage basé sur 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

oci-kvm list-pool

Description

Liste les groupes 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, spécifiez parsable, table, json ou text.

Exemples

Cet exemple liste les groupes en mode de sortie de texte.

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

oci-kvm create-network

Description

  • Crée un réseau virtuel (libvirt) qui utilise une carte vNIC d'Oracle Cloud Infrastructure.
  • Le réseau libvirt créé offre un intervalle d'adresses IP que d'autres clients KVM peuvent utiliser.

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 vNIC 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 du pont pour l'espace d'adresses de réseau virtuel.
-S | --ip-start ip_start
Premier intervalle d'adresses IP de client dans l'espace d'adresses de réseau virtuel.
-E | --ip-end ip_end
Dernier intervalle d'adresses IP de client dans l'espace d'adresses de réseau virtuel.
-P | --ip-prefix ip_prefix
Préfixe IP à utiliser dans le réseau virtuel.

Exemples

Cet exemple montre comment créer un réseau virtuel nommé MYNET0 sur une carte vNIC avec l'adresse IP 10.0.1.2, l'adresse IP de pont 192.168.100.9, l'intervalle d'adresses IP 192.168.100.10 - 192.268.100.30 et le préfixe 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 créé précédemment avec 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 à être invité.

Exemples

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

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