// travaux pratiques · Administration système
TP01 - Installer Incus et initialiser le serveur
- TP 1 / 6
- 6 étapes
- ≈ 45 min
- Accès libre
Objectif : préparer le serveur du laboratoire, installer Incus depuis les dépôts Debian, donner les droits d’administration à votre compte, initialiser le démon et vérifier que le stockage, le réseau et le profil par défaut sont opérationnels.
Contexte
Avant d’héberger le moindre service dans Incus, il faut un hôte propre et une initialisation maîtrisée. C’est à cette étape que se décident le pilote de stockage, le réseau des instances et l’exposition éventuelle de l’API : des choix difficiles à modifier une fois des dizaines d’instances en place. Dans une petite structure, cette installation concerne souvent un unique serveur qui hébergera tous les conteneurs ; dans un grand groupe, elle sera répétée sur chaque nœud d’un cluster, d’où l’intérêt de documenter dès le départ la configuration obtenue, pour pouvoir la reproduire à l’identique (par exemple avec le mode « preseed » d’incus admin init, qui lit un fichier YAML au lieu de poser des questions).
À la fin de ce TP, vous saurez installer Incus, distinguer les deux groupes d’accès, lancer une initialisation interactive et contrôler son résultat avec les commandes de diagnostic de base.
Prérequis : un serveur ou une machine virtuelle sous Debian 13 (2 vCPU, 4 Go de RAM, 40 Go de disque au minimum) avec un compte disposant de sudo et un accès Internet. Si le serveur du laboratoire est lui-même une VM, activez la virtualisation imbriquée dans l’hyperviseur, sans quoi les machines virtuelles Incus du TP02 ne pourront pas démarrer (les conteneurs fonctionneront).
Durée estimée : 45 minutes.
Actions à réaliser
Étape 1 : mettre à jour l’hôte et vérifier la virtualisation
On part d’un système à jour pour éviter les écarts de version entre le noyau, QEMU et Incus. On vérifie aussi que le processeur expose les extensions de virtualisation et que le périphérique KVM existe : c’est la condition pour lancer des VM.
sudo apt update && sudo apt full-upgrade -y
grep -cE 'vmx|svm' /proc/cpuinfo
ls -l /dev/kvm
vmx correspond aux processeurs Intel, svm aux processeurs AMD. Résultat attendu : la commande grep renvoie un nombre supérieur à zéro (en général le nombre de cœurs) et /dev/kvm existe. Un résultat nul signifie que la virtualisation est désactivée dans le BIOS ou non transmise par l’hyperviseur.
Étape 2 : installer Incus
Debian fournit Incus dans ses dépôts officiels. Le paquet incus installe le démon, le client et la prise en charge des machines virtuelles ; incus-base se limite aux conteneurs. On ajoute btrfs-progs, qui servira au TP03 pour créer un pool Btrfs.
sudo apt install -y incus btrfs-progs
incus version
Résultat attendu : l’installation se termine sans erreur et incus version affiche la version du client et celle du serveur. Notez ce numéro : il permet de savoir si vous êtes sur une branche LTS et de consulter la bonne version de la documentation.
Étape 3 : donner les droits d’administration à votre compte
Le démon n’accepte que les membres de deux groupes : incus (accès restreint à des projets propres à l’utilisateur) et incus-admin (contrôle total). Pour administrer le serveur du laboratoire, on ajoute son compte au second groupe.
sudo usermod -aG incus-admin $USER
newgrp incus-admin
id
newgrp ouvre un shell dans lequel le nouveau groupe est actif sans avoir à se déconnecter. Résultat attendu : la sortie de id mentionne incus-admin. Dans les autres terminaux, il faudra se reconnecter pour que l’appartenance soit prise en compte.
Étape 4 : initialiser Incus en mode interactif
L’initialisation crée le pool de stockage, le bridge réseau et le profil par défaut. Le mode interactif permet de comprendre chaque choix.
sudo incus admin init
Répondez ainsi pour le laboratoire : pas de cluster ; création d’un nouveau pool de stockage nommé default avec le pilote dir ; création d’un nouveau bridge réseau en acceptant le nom proposé (incusbr0) et l’adressage IPv4 automatique ; pas d’exposition de l’API sur le réseau (elle sera activée au TP06) ; les autres questions peuvent garder leur valeur par défaut. Notez vos réponses : elles constituent la première version de votre documentation d’installation. Résultat attendu : la commande se termine sans message d’erreur.
Étape 5 : contrôler le stockage, le réseau et le profil par défaut
On vérifie que l’initialisation a bien créé les trois ressources dont dépend toute instance.
incus storage list
incus network list
incus network get incusbr0 ipv4.address
incus profile show default
Résultat attendu : un pool default au pilote dir ; un réseau incusbr0 de type bridge géré par Incus (colonne « managed » à vrai) ; une adresse de passerelle avec son masque, dans un sous-réseau privé choisi automatiquement ; enfin un profil default qui contient deux périphériques : root (disque dans le pool default) et eth0 (carte réseau rattachée à incusbr0).
Étape 6 : documenter la configuration obtenue
Les commandes show d’Incus affichent chaque ressource au format YAML. En les enregistrant dans des fichiers, on garde une trace de l’état initial du serveur, que l’on pourra comparer plus tard ou reprendre pour écrire un fichier preseed destiné à d’autres nœuds.
mkdir -p ~/incus-doc
incus storage show default > ~/incus-doc/storage-default.yaml
incus profile show default > ~/incus-doc/profile-default.yaml
incus version > ~/incus-doc/version.txt
ls ~/incus-doc
Résultat attendu : trois fichiers dans ~/incus-doc : la description YAML du pool (pilote, source), celle du profil par défaut (périphériques root et eth0) et les versions du client et du serveur. Conservez-les dans votre dépôt de documentation.
Vérification
Le TP est réussi si : incus version affiche une version serveur (le client parle au démon) ; incus storage list, incus network list et incus profile show default renvoient les ressources décrites ci-dessus ; vous pouvez exécuter ces commandes sans sudo depuis votre compte ; le répertoire ~/incus-doc contient les trois fichiers de l’étape 6. Le service doit aussi apparaître actif dans systemctl status incus.
Problèmes fréquents
- « permission denied » sur le socket d’Incus. Cause : le compte n’est pas encore membre d’
incus-admindans la session courante. Correction : exécuternewgrp incus-adminou se reconnecter, puis vérifier avecid. - La commande
grepde l’étape 1 renvoie 0. Cause : virtualisation désactivée dans le BIOS ou virtualisation imbriquée non activée sur l’hyperviseur qui héberge le laboratoire. Correction : l’activer, redémarrer, puis vérifier de nouveau. Les conteneurs fonctionnent malgré tout. - L’initialisation échoue sur le réseau. Cause : le sous-réseau proposé chevauche un réseau existant, ou il manque
dnsmasq-basesi Incus a été installé sans les paquets recommandés. Correction : installer le paquet manquant ou indiquer un sous-réseau libre lors de l’initialisation. - Une seconde initialisation refuse de créer les ressources. Cause : un pool ou un réseau du même nom existe déjà. Correction : réutiliser les ressources existantes ou les supprimer avant de relancer, sur un serveur de laboratoire uniquement.
Bonnes pratiques et sécurité
- Traitez l’appartenance à
incus-admincomme un accès administrateur au serveur : réservez-la aux personnes qui ont déjà ces droits et utilisez le groupeincuspour les autres. - N’exposez pas l’API sur le réseau tant que vous n’en avez pas besoin ; quand ce sera le cas, limitez le port au réseau d’administration.
- Versionnez la description YAML du serveur (pools, profils, réseaux) : elle décrit l’état attendu et sert de base au mode preseed et à l’automatisation sur un parc de plusieurs nœuds.
- En production, placez le stockage des instances sur un disque ou une partition dédiés plutôt que sur le disque système, pour qu’une instance qui remplit son disque ne bloque pas l’hôte.
Questions de contrôle
1. Quelle est la différence entre les groupes incus et incus-admin ?
Voir la réponse
Le groupe incus donne un accès restreint, limité à des projets propres à l’utilisateur ; incus-admin donne le contrôle total du serveur et équivaut en pratique à un accès administrateur.
2. Que contient le profil default après l’initialisation ?
Voir la réponse
Un disque racine root placé dans le pool default et une carte réseau eth0 rattachée au bridge incusbr0 : toute nouvelle instance en hérite.
3. Quelles ressources la commande incus admin init crée-t-elle ?
Voir la réponse
Selon les réponses données : un pool de stockage, un bridge réseau géré et le profil par défaut qui les relie aux instances ; éventuellement un cluster et l’exposition de l’API sur le réseau.
Pour aller plus loin
Le choix entre Incus et un hyperviseur orienté interface web dépend de vos usages : comparez avec le cours Introduction à Proxmox VE. Sur un parc de plusieurs serveurs, l’initialisation en mode preseed peut être appliquée automatiquement par un playbook, comme vu dans le cours Introduction à Ansible.
Conservez ce serveur tel quel : tous les TP suivants s’appuient sur lui.
// formation sur mesure
Former votre équipe sur ce sujet ?
Azur Secure anime des sessions intra-entreprise, à distance ou dans vos locaux sur la Côte d'Azur, adaptées au niveau de vos équipes.