KVM avec gestion web via Cockpit¶

Dans cet article

• Fonctionnalités de déploiement
• Démarrage après déploiement
• Accès à l'interface web Cockpit
• Interface Cockpit : Vue d'ensemble des sections
• System Management
• Création et installation d'une VM invitée
• Vérification et gestion de base des VM
• Commande de KVM avec gestion web via Cockpit en utilisant l'API

Fonctionnalités de déploiement¶

Chemins principaux et fichiers pour KVM/Cockpit :

• Images et disques VM (stockage par défaut) : /var/lib/libvirt/images/
• Configurations VM (libvirt) : /etc/libvirt/qemu/
• Configuration du socket et de libvirtd : /etc/libvirt/libvirtd.conf, /var/run/libvirt/
• Configuration Cockpit : /etc/cockpit/
• Certificats TLS Cockpit (ws-certs) : /etc/cockpit/ws-certs.d/
• Répertoire Let's Encrypt pour le FQDN Cockpit : /etc/letsencrypt/live/<kvm_fqdn>/
• Journaux libvirt : journalctl -u libvirtd, /var/log/libvirt/
• Journaux Cockpit : journalctl -u cockpit -u cockpit.socket

Démarrage après déploiement¶

Après paiement de la commande, une notification de disponibilité du serveur sera envoyée à l'adresse e‑mail fournie lors de l'inscription. L'e‑mail contiendra l'adresse IP du VPS/serveur, l'identifiant SSH et le mot de passe, ainsi qu'un lien vers le panneau de gestion du serveur — Invapi.

Les clients gèrent l'équipement via le panneau de gestion du serveur et l'API — Invapi. Dans l'onglet Info >> Tags du serveur sélectionné, les paramètres techniques et les liens de service sont disponibles.

Les données d'autorisation, qui peuvent être trouvées soit dans l'onglet Info >> Tags du panneau de gestion du serveur, soit dans le message e‑mailé :
- Lien d'accès à l'interface web Cockpit : dans la balise webpanel (port 9090, HTTPS)

Accès à l'interface web Cockpit¶

Connexion au panneau¶

1. Ouvrez un navigateur sur votre machine locale (par ex., Firefox sur Ubuntu).

2. Naviguez vers une adresse telle que :

3. https://<IP_address>:9090 — lors de l'accès par IP;

4. https://<kvm_fqdn>:9090 — lors de l'accès par nom de domaine à partir de la balise webpanel.

Par défaut, Cockpit écoute sur le port TCP 9090, qui doit être autorisé dans le pare‑feu utilisé (UFW, firewalld, iptables, etc.).

Connexion et Accès Administratif¶

1. Sur la page de connexion, entrez User name et Password du serveur (généralement le compte fourni dans l’e‑mail ou créé par l’administrateur).

1. Après vous être connecté, la page de démarrage de Cockpit s’ouvre avec les indicateurs clés (charge CPU, RAM, systèmes de fichiers, trafic réseau).

Interface Cockpit : Vue d'ensemble des sections¶

L’interface Cockpit possède un menu de navigation simple et logique sur la gauche. Chaque section gère un aspect spécifique de la gestion du serveur et de la virtualisation.

Sections du Système¶

Overview (Tableau de bord)¶

La page principale du serveur (« Tableau de bord ») affiche un résumé de la santé du système :

• Health : Statut du système (erreurs, avertissements).
• Usage : Graphiques d'utilisation en temps réel (CPU, RAM, I/O disque, réseau).
• System information : Informations matérielles, nom d’hôte, temps de fonctionnement, version du système d’exploitation.
• Configuration : Accès rapide pour modifier le nom d’hôte, l’heure, rejoindre un domaine et les profils de performance.

Logs¶

Interface de visualisation des journaux système (similaire à journalctl) :

• Permet de filtrer les journaux par date, gravité (Errors, Warnings, Notice) et services.
• Pratique pour diagnostiquer les erreurs de démarrage de VM ou les problèmes réseau sans utiliser la console.

Storage¶

Gestion du sous‑système de disques :

• Drives : Liste des disques physiques. Vous pouvez créer des tables de partitions, formater les disques.
• Filesystems : Afficher les points de montage et l’espace utilisé.
• NFS mounts : Connecter un stockage NFS distant.
• Storage logs : Journaux liés uniquement au sous‑système de disques.

Networking¶

Gestion des interfaces réseau de l’hôte :

• Interfaces : Liste des cartes réseau. Ici vous pouvez configurer les adresses IP (statique/DHCP), DNS et passerelles.

  • Add Bridge / Add Bond / Add VLAN : Boutons pour créer des ponts réseau (Bridge), agrégation de canaux (Bonding) et VLAN. Ceci est une section d'une importance critique pour la configuration du réseau des machines virtuelles (création ** br0).
  • Firewall : Gestion basique des règles de pare‑feu (si firewalld est installé).
  • Network logs : Journaux réseau.

Virtualization¶

Virtual Machines¶

Section clé pour gérer l'hyperviseur KVM (nécessite que le plugin cockpit-machines soit installé).

• VM List: Tableau de toutes les machines virtuelles avec leur statut (En cours, Éteint) et des caractéristiques brèves.
• Create VM: Assistant pour créer de nouvelles machines (téléchargement ISO, création de disque).
• VM Detail view: Vue détaillée de la VM: Cliquer sur une machine ouvre sa carte avec des onglets:
• Overview: Paramètres généraux, démarrage automatique.
• Console: Accès à l'écran de la VM (VNC/SPICE) directement dans le navigateur.
• Disks: Ajouter/supprimer des disques virtuels.
• Network Interfaces: Associer des adaptateurs réseau à des ponts ou NAT.

System Management¶

Accounts¶

Gestion des utilisateurs serveur:

• Créer de nouveaux utilisateurs.
• Changer les mots de passe, verrouiller les comptes.
• Configurer les clés SSH pour les utilisateurs.
• Gérer les droits d'administrateur (sudo).

Services¶

Couche graphique sur systemd:

• Services: Liste de tous les démons (services). Vous pouvez démarrer, arrêter, redémarrer et activer/désactiver le démarrage automatique du service (par ex., libvirtd, ssh, nginx).
• Targets / Sockets / Timers: Gérer d'autres unités systemd.

Tools¶

Cette section regroupe généralement des plugins supplémentaires.

• Applications: Gestionnaire d'applications Cockpit (installer des modules supplémentaires).
• Software Updates: Gestion des mises à jour système (analogues à apt update / dnf update). Affiche les correctifs de sécurité disponibles et permet de les installer d'un seul clic. Les mises à jour automatiques peuvent être activées.
• Terminal (Terminal)

Ligne de commande complète (shell) dans le navigateur:

• Fournit un accès au serveur en tant qu'utilisateur actuel.
• Permet d'exécuter n'importe quelle commande virsh, htop, vim, etc. si une interface graphique est insuffisante.
• Fonctionne via websockets, prend en charge le copier/coller.

Création et installation d'une VM invitée¶

Préparer l'image ISO (facultatif)¶

Si vous prévoyez d'utiliser votre propre image ISO, téléchargez-la sur le serveur à l'avance, par ex., vers /var/lib/libvirt/images/ ou /tmp/. Si vous souhaitez utiliser le téléchargement automatique des distributions populaires via Cockpit, vous pouvez ignorer cette étape.

Création d'une nouvelle machine virtuelle¶

1. Dans le menu Cockpit à gauche, allez à la section Virtual Machines.

2. Cliquez sur le bouton Create VM.

   

3. Dans l'assistant qui s'ouvre, définissez les paramètres :

4. Name : spécifiez un nom unique, par ex., TestVM.
5. Installation Type : choisissez l'une des options disponibles :
   • Download an OS : la méthode la plus simple. Sélectionnez un OS dans la liste, et Cockpit téléchargera l'image requise.
   • Local install media : choisissez cette option si vous avez déjà téléchargé votre fichier ISO sur le serveur. Dans le champ qui apparaît, indiquez le chemin vers le fichier (par ex., /tmp/ubuntu-24.04.1-desktop-amd64.iso).
   • URL : permet de spécifier un lien direct vers une ISO à télécharger.
6. Operating System : lorsque vous choisissez Download an OS, la liste sera automatiquement remplie. Avec une ISO locale, le système tentera de détecter l'OS lui-même, ou vous pouvez le sélectionner manuellement dans la liste.
7. Storage :
   • Size : spécifiez la taille du disque virtuel (par ex., 20 GiB). Le disque sera créé automatiquement.
8. Memory : spécifiez la quantité de RAM à allouer (par ex., 4 GiB).

9. Immediately start VM : laissez la coche si vous souhaitez démarrer l'installation immédiatement, ou décochez-la si vous devez modifier les paramètres (par ex., le réseau) avant de démarrer.

10. Si des paramètres supplémentaires sont requis (par ex., choisir un pont réseau), décochez Immediately start VM et cliquez sur Create..

Configuration supplémentaire avant l'installation¶

Si vous avez choisi de créer sans démarrage immédiat, une page VM s'ouvrira. Allez à l'onglet Network Interfaces :

1. Assurez-vous que le champ Source est défini sur :
2. ou l'interface pont br0, si la VM doit recevoir une IP du même réseau que l'hôte (recommandé pour l'accessibilité externe) ;
3. ou le réseau NAT standard defaultvirbr0, si l'accès Internet de la VM sans visibilité externe directe est suffisant.
4. Cliquez sur Add pour démarrer la VM et commencer l'installation.

Processus d'installation dans la console VM¶

1. Dans la liste des machines virtuelles, sélectionnez le TestVM créé.
2. Cliquez sur le bouton Install.
3. Vous verrez l'écran d'installation de l'OS dans l'onglet Console. Suivez les instructions de l'installateur (sélection de la langue, partitionnement du disque, création d'utilisateur).

Une fois l'installation terminée, la machine virtuelle redémarrera et sera prête à l'emploi.

Vérification et gestion de base des VM¶

Premier démarrage et test réseau¶

1. Assurez-vous que TestVM est dans l'état Running.
2. Ouvrez la console VM dans Cockpit et connectez‑vous avec l'utilisateur créé lors de l'installation.

3. À l'intérieur du système invité, ouvrez un terminal et vérifiez les paramètres réseau :

   ip addr
   

   • En utilisant le pont br0, la VM devrait obtenir une IP de votre réseau physique, par ex., 192.168.0.x.
   • En utilisant le réseau NAT default, l'adresse sera généralement du réseau interne, par ex., 192.168.122.x.

4. Vérifiez la connectivité Internet :

   ping 8.8.8.8
   

Opérations quotidiennes des VM dans Cockpit¶

Les actions de base sont disponibles dans la carte de chaque machine virtuelle :

• Run — démarrer une VM arrêtée.
• Shut Down — éteindre proprement le système invité (signal ACPI).
• Force shut down — arrêt forcé (mise hors tension).
• Reboot — redémarrer la VM.
• Delete — supprimer la VM (avec l'option de supprimer les disques virtuels associés).

À travers les onglets Disks et Network Interfaces vous pouvez ajouter des périphériques supplémentaires.

Commande de KVM avec gestion web via Cockpit en utilisant l'API¶

Pour installer ce logiciel en utilisant l'API, suivez les instructions suivantes.