Gérer le stockage avec Incus : pools et volumes

Dans Incus, tout le stockage repose sur deux objets : les pools (les réservoirs de données, basés sur dir, ZFS, btrfs ou LVM) et les volumes (les unités de stockage à l'intérieur). Ce guide montre comment lister, créer et inspecter des pools, gérer des volumes personnalisés, choisir le bon backend, et pourquoi ZFS change la donne pour les snapshots. Tout a été testé sur Incus 7.0. Pour qui veut organiser proprement les données de ses instances.

Ce que vous allez apprendre

• Les concepts : pool, volume, snapshot.
• Lister et inspecter les pools de stockage.
• Créer un pool et choisir son backend.
• Gérer des volumes personnalisés et les attacher à une instance.

Les concepts en bref

Trois notions structurent le stockage Incus.

• Un pool (storage pool) est le réservoir où Incus range les disques des instances et les volumes. Il s'appuie sur un backend : dir (simple dossier), ZFS, btrfs, LVM ou Ceph.
• Un volume est une unité de stockage dans un pool. Chaque instance a son volume de disque ; on peut aussi créer des volumes personnalisés pour partager des données.
• Un snapshot fige l'état d'un volume à un instant donné, pour revenir en arrière en cas de problème.

Lister et inspecter les pools

À l'initialisation, incus admin init a créé un pool default. On le retrouve avec :

incus storage list
incus storage show default

config:
  source: /var/lib/incus/storage-pools/default
name: default
driver: dir
used_by:
  - /1.0/instances/c1
  - /1.0/instances/vm1

Ici le pool default utilise le backend dir et sert déjà deux instances (c1, vm1).

Créer un pool de stockage

On crée un pool avec incus storage create <nom> <backend>. Le plus simple, dir, fonctionne partout :

incus storage create donnees dir
# Storage pool donnees created

Pour un backend ZFS ou btrfs, les outils correspondants doivent être installés sur l'hôte, sinon Incus refuse :

incus storage create rapide zfs
# Error: Required tool 'zpool' is missing

Installer le backend voulu

Avant de créer un pool ZFS ou btrfs, installez les paquets : apt install zfsutils-linux (ZFS) ou apt install btrfs-progs (btrfs). Idem lvm2 pour LVM. Le backend dir ne demande rien.

Choisir le bon backend

Le choix du backend conditionne les performances et les fonctionnalités (snapshots rapides, compression).

Backend	Snapshots rapides	Quand le choisir
dir	non (copie)	tests, simplicité, aucun prérequis
ZFS	oui	recommandé : snapshots/clones instantanés, compression
btrfs	oui	alternative à ZFS, intégrée au noyau
LVM	oui (par blocs)	volumes de blocs, infra existante LVM
Ceph	oui	stockage distribué en cluster

Glissez pour voir

Pour un usage sérieux, ZFS est le choix de référence : ses snapshots et clones sont quasi instantanés et n'occupent que les différences. dir reste parfait pour découvrir ou pour un lab.

ZFS sur fichier loopback : ça ne rétrécit jamais

Au lieu d'un disque ou dataset dédié, incus admin init peut créer un pool ZFS sur un fichier loopback. Piège vécu : ce fichier grossit jusqu'à sa limite mais ne se réduit jamais, même après suppression d'instances ou d'images. On peut l'agrandir (incus storage set <pool> size=...) mais pas le rétrécir. En production, préférez un dataset ou un disque dédié au loopback.

Gérer des volumes personnalisés

Au-delà des disques d'instances, on crée des volumes personnalisés pour stocker des données indépendamment, par exemple à partager entre instances :

incus storage volume create donnees data1
incus storage volume list donnees

+--------+-------+--------------+---------+
|  TYPE  | NAME  | CONTENT-TYPE | USED BY |
+--------+-------+--------------+---------+
| custom | data1 | filesystem   | 0       |
+--------+-------+--------------+---------+

On attache ensuite ce volume à une instance, à un point de montage donné :

incus storage volume attach donnees data1 c1 /mnt/data

Le volume data1 devient accessible dans /mnt/data du conteneur c1. Comme il vit dans le pool et non dans l'instance, il survit à la suppression du conteneur.

Snapshots de volumes

Comme les instances, les volumes se snapshotent :

incus storage volume snapshot create donnees data1 avant-maj
incus storage volume snapshot list donnees data1

Sur un pool ZFS ou btrfs, ces snapshots sont instantanés et peu coûteux ; sur dir, ils reposent sur une copie complète.

À retenir

• Le stockage Incus s'organise en pools (réservoirs) et volumes (unités à l'intérieur).
• incus storage list/show inspecte les pools ; incus storage create en crée un.
• Les backends ZFS/btrfs/LVM exigent leurs outils installés (sinon Required tool missing).
• ZFS est recommandé pour ses snapshots et clones instantanés ; dir pour la simplicité.
• Un volume personnalisé s'attache à une instance et survit à sa suppression.

FAQ : questions fréquentes sur le stockage Incus

Quels backends de stockage Incus existe-t-il ?

Incus supporte plusieurs backends pour ses pools : dir (un simple dossier, sans prérequis), ZFS, btrfs, LVM et Ceph pour le stockage distribué en cluster. ZFS est le plus recommandé pour ses snapshots et clones instantanés. Le backend dir convient aux tests et aux labs.

Quel backend de stockage choisir pour Incus ?

ZFS est le choix de référence : ses snapshots et clones sont quasi instantanés et n'occupent que les différences. btrfs est une alternative intégrée au noyau. LVM convient à une infra de blocs existante, Ceph au stockage distribué en cluster.

Pourquoi Incus refuse de créer un pool avec l'erreur Required tool missing ?

Parce que le backend choisi (ZFS, btrfs ou LVM) a besoin de ses outils en ligne de commande sur l'hôte. Sans eux, Incus renvoie par exemple Required tool zpool is missing. Il faut installer les paquets correspondants : zfsutils-linux pour ZFS, btrfs-progs pour btrfs, lvm2 pour LVM.

Comment partager un volume entre plusieurs instances Incus ?

On crée un volume personnalisé dans un pool avec incus storage volume create, puis on l'attache à chaque instance avec incus storage volume attach en précisant un point de montage.

Prochaines étapes

Gérer ses instances Conteneurs et VMs au quotidien.

Premiers pas avec Incus Les commandes de base.

Incus, c'est quoi ? Le panorama de la section.

×

📖 Voir la documentation →