SupportConsoleDéveloppeursCommencer un essaiContact

9.3. Commandes Virtctl

Le client virtctl est un utilitaire de ligne de commande permettant de gérer les ressources de virtualisation OpenShift.

Tableau 9.2. virtctl commandements généraux
CommandementDescription

virtctl version

Consultez les versions du client et du serveur virtctl.

virtctl help

Voir la liste des commandes virtctl.

virtctl <command> -h|--help

Affiche une liste d'options pour une commande spécifique.

virtctl options

Affiche la liste des options de commande globales pour n'importe quelle commande virtctl.

9.3.1. Commandes de gestion des VM et VMI

Vous pouvez utiliser virtctl pour gérer l'état des machines virtuelles (VM) ou des instances de machines virtuelles (VMI) et pour migrer une VM.

Tableau 9.3. virtctl Commandes de gestion des machines virtuelles
CommandementDescription

virtctl start <vm_name>

Démarrer une VM.

virtctl start --paused <vm_name>

Démarrer une VM en état de pause. Cette option permet d'interrompre le processus de démarrage à partir de la console VNC.

virtctl stop <vm_name>

Arrêter une VM.

virtctl stop <vm_name> --grace-period 0 --force

Forcer l'arrêt d'une VM. Cette option peut entraîner des incohérences ou des pertes de données.

virtctl pause vm|vmi <vm_name>

Mettre en pause une VM ou une VMI. L'état de la machine est conservé en mémoire.

virtctl unpause vm|vmi <vm_name>

Désactiver la pause d'une VM ou d'une VMI.

virtctl migrate <vm_name>

Migrer une VM.

virtctl restart <vm_name>

Redémarrer une VM.

9.3.2. Commandes de connexion VM et VMI

Vous pouvez utiliser virtctl pour vous connecter à la console série, exposer un port, établir une connexion proxy, spécifier un port et ouvrir une connexion VNC à une VM.

Tableau 9.4. virtctl consoleles commandes expose et vnc
CommandementDescription

virtctl console <vmi_name>

Se connecter à la console série d'un VMI.

virtctl expose <vm_name>

Créer un service qui transfère un port désigné d'une VM ou d'une VMI et exposer le service sur le port spécifié du nœud.

virtctl vnc --kubeconfig=$KUBECONFIG <vmi_name>

Ouvrez une connexion VNC (Virtual Network Client) à une IMV.

L'accès à la console graphique d'une IMV via VNC nécessite un visualiseur à distance sur votre machine locale.

virtctl vnc --kubeconfig=$KUBECONFIG --proxy-only=true <vmi_name>

Affichez le numéro de port et connectez-vous manuellement à une IMV en utilisant n'importe quelle visionneuse via la connexion VNC.

virtctl vnc --kubeconfig=$KUBECONFIG --port=<port-number> <vmi_name>

Spécifiez un numéro de port pour exécuter le proxy sur le port spécifié, si ce port est disponible.

Si aucun numéro de port n'est spécifié, le proxy fonctionne sur un port aléatoire.

9.3.3. Commandes d'exportation de volumes VM

Vous pouvez utiliser les commandes virtctl vmexport pour créer, télécharger ou supprimer un volume exporté à partir d'une VM, d'un snapshot VM ou d'une revendication de volume persistant (PVC).

Tableau 9.5. virtctl vmexport commandes
CommandementDescription

virtctl vmexport create <vmexport_name> --vm|snapshot|pvc=<object_name>

Créez une ressource personnalisée (CR) VirtualMachineExport pour exporter un volume à partir d'une VM, d'un snapshot VM ou d'un PVC.

  • --vm: Exporte les PVC d'une VM.
  • --snapshot: Exporte les PVC contenus dans un CR VirtualMachineSnapshot.
  • --pvc: Exporte un PVC.
  • Facultatif : --ttl=1h indique la durée de vie. La durée par défaut est de 2 heures.

virtctl vmexport delete <vmexport_name>

Supprimer manuellement un CR VirtualMachineExport.

virtctl vmexport download <vmexport_name> --output=<output_file> --volume=<volume_name>

Télécharger le volume défini dans un CR VirtualMachineExport.

  • --output spécifie le format du fichier. Exemple : disk.img.gz.
  • --volume spécifie le volume à télécharger. Cette option est facultative si un seul volume est disponible.

En option :

  • --keep-vme conserve le CR VirtualMachineExport après le téléchargement. Le comportement par défaut est de supprimer le CR VirtualMachineExport après le téléchargement.
  • --insecure active une connexion HTTP non sécurisée.

virtctl vmexport download <vmexport_name> --<vm|snapshot|pvc>=<object_name> --output=<output_file> --volume=<volume_name>

Créez un CR VirtualMachineExport et téléchargez ensuite le volume défini dans le CR.

9.3.4. Commandes de vidage de la mémoire de la VM

Vous pouvez utiliser la commande virtctl memory-dump pour obtenir un vidage de la mémoire d'une machine virtuelle (VM) sur un PVC. Vous pouvez spécifier un PVC existant ou utiliser l'option --create-claim pour créer un nouveau PVC.

Conditions préalables

  • Le mode de volume du PVC doit être FileSystem.

  • Le PVC doit être suffisamment grand pour contenir le vidage de la mémoire.

    The formula for calculating the PVC size is (VMMemorySize + 100Mi) * FileSystemOverhead, where 100Mi is the memory dump overhead.

  • Vous devez activer la porte de la fonctionnalité hot plug dans la ressource personnalisée HyperConverged en exécutant la commande suivante : 

    $ oc patch hco kubevirt-hyperconverged -n openshift-cnv \
  --type json -p '[{"op": "add", "path": "/spec/featureGates", \
  "value": "HotplugVolumes"}]'

Téléchargement du fichier mémoire

Vous devez utiliser la commande virtctl vmexport download pour télécharger le fichier mémoire : 

$ virtctl vmexport download <vmexport_name> --vm\|pvc=<object_name> \
  --volume=<volume_name> --output=<output_file>
Tableau 9.6. virtctl memory-dump commandes
CommandementDescription

virtctl memory-dump get <vm_name> --claim-name=<pvc_name>

Sauvegarder le vidage de la mémoire d'une VM sur un PVC. L'état du vidage de la mémoire est affiché dans la section status de la ressource VirtualMachine.

En option :

  • --create-claim crée un nouveau PVC de la taille appropriée. Cet indicateur a les options suivantes :

    • --storage-class=<storage_class>: Spécifier une classe de stockage pour le PVC.
    • --access-mode=<access_mode>: Indiquez ReadWriteOnce ou ReadWriteMany.

virtctl memory-dump get <vm_name>

Réexécutez la commande virtctl memory-dump avec le même PVC.

Cette commande écrase la précédente vidange de la mémoire.

virtctl memory-dump remove <vm_name>

Supprimer un vidage de la mémoire.

Vous devez supprimer manuellement un vidage de mémoire si vous souhaitez modifier le PVC cible.

Cette commande supprime l'association entre la VM et le PVC, de sorte que le vidage de la mémoire n'est pas affiché dans la section status de la ressource VirtualMachine. Le PVC n'est pas affecté.

9.3.5. Commandes de téléchargement d'images

Vous pouvez utiliser les commandes virtctl image-upload pour télécharger une image VM sur un volume de données.

Tableau 9.7. virtctl image-upload commandes
CommandementDescription

virtctl image-upload dv <datavolume_name> --image-path=</path/to/image> --no-create

Télécharger une image de VM sur un volume de données existant.

virtctl image-upload dv <datavolume_name> --size=<datavolume_size> --image-path=</path/to/image>

Téléchargement d'une image de VM dans un nouveau volume de données d'une taille spécifiée.

9.3.6. Commandes d'informations sur l'environnement

Vous pouvez utiliser virtctl pour afficher des informations sur les versions, les systèmes de fichiers, les systèmes d'exploitation invités et les utilisateurs connectés.

Tableau 9.8. virtctl commandes d'information sur l'environnement
CommandementDescription

virtctl fslist <vmi_name>

Afficher les systèmes de fichiers disponibles sur une machine invitée.

virtctl guestosinfo <vmi_name>

Afficher des informations sur les systèmes d'exploitation d'une machine invitée.

virtctl userlist <vmi_name>

Afficher les utilisateurs connectés sur une machine invitée.

Red Hat logoGithubRedditYoutubeTwitter

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Nous aidons les utilisateurs de Red Hat à innover et à atteindre leurs objectifs grâce à nos produits et services avec un contenu auquel ils peuvent faire confiance.

Rendre l’open source plus inclusif

Red Hat s'engage à remplacer le langage problématique dans notre code, notre documentation et nos propriétés Web. Pour plus de détails, consultez leBlog Red Hat.

À propos de Red Hat

Nous proposons des solutions renforcées qui facilitent le travail des entreprises sur plusieurs plates-formes et environnements, du centre de données central à la périphérie du réseau.

© 2024 Red Hat, Inc.