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
outext
.
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