Migrer de LXD vers Incus avec lxd-to-incus

Vous venez de LXD et voulez passer à Incus ? L'outil lxd-to-incus, livré avec Incus, migre toute l'installation en place : instances, images, profils, réseaux et stockage. Ce guide détaille les prérequis, la procédure et surtout les pièges concrets remontés du terrain (version de LXD, mot de passe de confiance, changement de suffixe DNS, downtime) qui font échouer une migration mal préparée. Pour les administrateurs LXD qui basculent.

Ce que vous allez apprendre

• Les prérequis avant de lancer la migration.
• La procédure lxd-to-incus.
• Les retouches après bascule (groupes, config CLI, DNS).
• Les pièges qui font échouer la migration.

Prérequis

• Incus installé mais NON initialisé : n'exécutez pas incus admin init. L'outil copie lui-même les données et la configuration depuis LXD ; il a seulement besoin que le service Incus soit démarré.

• Une version de LXD au plus 5.21.99 : au-delà, lxd-to-incus refuse de migrer.

• Si vos pools utilisent ZFS, le paquet zfsutils-linux doit être installé (classique du snap LXD).

• core.trust_password désactivé côté LXD, sinon la connexion échoue :

  lxc config unset core.trust_password

Sauvegardez avant : la migration n'est pas réversible

Toutes les instances sont arrêtées pendant la migration, et l'opération n'est pas facilement réversible. Des cas de perte d'instances sur migration interrompue (par exemple par un unattended-upgrades) ont été rapportés. Exportez vos instances critiques avant de lancer, et prévoyez une vraie fenêtre de maintenance.

La procédure

Premier piège, avant même de commencer : l'outil lxd-to-incus n'est pas dans le paquet incus. Sur les dépôts Zabbly, il est fourni par le paquet incus-extra. Sans lui, la commande renvoie lxd-to-incus: command not found alors qu'Incus est bien installé :

sudo apt install incus-extra
which lxd-to-incus   # /usr/bin/lxd-to-incus

Une fois les prérequis réunis, la migration tient en une commande :

sudo lxd-to-incus

L'outil analyse l'installation LXD, vérifie la compatibilité, puis copie les données vers Incus. Il gère aussi les installations LXD en cluster. À la fin, LXD est désactivé au profit d'Incus. Voici la sortie réelle d'une migration d'un LXD 5.0.2 vers un Incus 7.0.0 (une instance webapp à migrer) :

=> Looking for source server
==> Detected: .deb package
=> Looking for target server
==> Detected: systemd
=> Checking server versions
==> Source version: 5.0.2
==> Target version: 7.0.0
=> Validating version compatibility
=> Checking that the source server isn't empty
=> Checking that the target server is empty
=> Validating source server configuration
=> Stopping the source server
=> Stopping the target server
=> Wiping the target server
=> Migrating the data
=> Migrating database
=> Writing database patch
=> Starting the target server
=> Checking the target server
=> Uninstalling the source server

L'outil refuse de migrer si la cible n'est pas vide (d'où la règle « ne pas initialiser Incus avant ») ou si la source est vide. Après le Uninstalling the source server, le service lxd est inactif et Incus a repris la main.

Vérifiez l'état après, ne vous fiez pas au seul code retour

Un bug historique a rendu lxd-to-incus silencieux sur certains échecs internes. Après la migration, vérifiez concrètement l'état du système (incus list, incus info, l'accès aux instances) plutôt que de vous fier au seul code de sortie. Vérifiez aussi en amont le support de shift=true sur la cible si vous avez des conteneurs idmapped.

La vérification confirme que l'instance a bien basculé, en conservant son IP et sa configuration (ici la clé user.role=frontend posée côté LXD) :

incus list
incus config get webapp user.role

+--------+---------+-----------------------+-----------+
|  NAME  |  STATE  |         IPV4          |   TYPE    |
+--------+---------+-----------------------+-----------+
| webapp | RUNNING | 10.181.216.145 (eth0) | CONTAINER |
+--------+---------+-----------------------+-----------+

frontend

L'instance tourne toujours, avec la même adresse qu'avant la migration : lxd-to-incus a repris le disque, la config et le réseau sans les recréer. Le pool de stockage default (driver dir dans ce lab) est repris tel quel.

Après la migration : les retouches

La bascule terminée, plusieurs éléments ne sont pas migrés automatiquement et demandent une intervention manuelle.

• Groupes système : ré-ajoutez les utilisateurs du groupe lxd dans incus-admin (sudo usermod -aG incus-admin <user>), sinon permission denied.
• Configuration de la CLI : recopiez ~/.config/lxc/ (ou ~/snap/lxd/common/config/) vers ~/.config/incus/ pour retrouver vos remotes.
• Suffixe DNS : le bridge lxdbr0 persiste, mais le suffixe DNS passe de .lxd à .incus. Tout nom d'hôte en dur (.lxd) dans vos configurations ou scripts est à auditer et corriger.

À retenir

• L'outil lxd-to-incus vit dans le paquet incus-extra, pas incus : à installer d'abord.
• N'initialisez pas Incus avant la migration : lxd-to-incus s'en charge, il faut juste le service démarré (la cible doit être vide).
• LXD doit être en version ≤ 5.21.99, core.trust_password désactivé, zfsutils-linux présent pour ZFS.
• La migration arrête tout et n'est pas réversible : exportez vos instances critiques d'abord.
• L'outil peut être silencieux sur des échecs : vérifiez l'état réel après.
• Retouches manuelles : groupe incus-admin, config CLI ~/.config/incus/, suffixe DNS .lxd → .incus.

FAQ : questions fréquentes sur la migration LXD vers Incus

Comment migrer de LXD vers Incus ?

Avec l'outil lxd-to-incus, livré avec Incus. On installe Incus sans l'initialiser, on s'assure que LXD est en version 5.21.99 au plus, puis on lance sudo lxd-to-incus. L'outil copie instances, images, profils, réseaux et stockage en place, y compris pour une installation LXD en cluster.

Faut-il initialiser Incus avant la migration depuis LXD ?

Non, surtout pas. L'outil lxd-to-incus copie lui-même les données et la configuration depuis LXD ; il a seulement besoin que le service Incus soit démarré, mais pas initialisé. Lancer incus admin init avant fait échouer la migration, car l'outil ne peut plus repartir d'un état vierge.

Quels sont les pièges de la migration LXD vers Incus ?

Version LXD au plus 5.21.99, core.trust_password à désactiver côté LXD, zfsutils-linux requis pour les pools ZFS.

La migration de LXD vers Incus est-elle réversible ?

Non, elle n'est pas facilement réversible et toutes les instances sont arrêtées pendant l'opération. Des cas de perte d'instances sur migration interrompue ont été rapportés.

Prochaines étapes

Importer une machine existante Migrer une VM ou un serveur physique avec incus-migrate.

Cluster Incus Monter un cluster multi-nœuds.

Incus, c'est quoi ? Le fork de LXD en un coup d'œil.

×

📖 Voir la documentation →