Environnements de démarrage ZFS avec bectl : un chemin de retour en arrière pour les mises à niveau de FreeBSD et des paquets

Objectif

Créer un environnement de démarrage ZFS avant une modification risquée sur FreeBSD 14.x avec Root-on-ZFS, en activer un autre après les tests, et supprimer les environnements devenus inutiles.

Prérequis

Une installation Root-on-ZFS (les datasets se trouvent sous zroot/ROOT, le système en cours d'exécution étant généralement dans zroot/ROOT/default) ; un accès root ; bectl(8) disponible (outil du système de base, aucune installation de paquet nécessaire).

Étapes

1. Avant une modification majeure (mise à niveau du système d'exploitation ou mise à niveau importante de paquets), créer un nouvel environnement : bectl create beforeupgrade. Le FreeBSD Handbook décrit la création d'un environnement de démarrage comme la prise d'un instantané (snapshot) puis le clonage des datasets racine, ce qui « se termine en quelques secondes et ne consomme presque aucun espace tant que les environnements ne commencent pas à diverger ». Sur une racine ZFS compatible avec les environnements de démarrage, freebsd-update install en crée aussi un automatiquement, sauf si CreateBootEnv no est défini dans /etc/freebsd-update.conf ; un environnement nommé reste toutefois plus facile à retrouver.
2. Vérifier qu'il existe et repérer l'environnement actif : bectl list. La colonne Active marque d'un N l'environnement utilisé actuellement et d'un R celui qui sera actif au prochain redémarrage.
3. Effectuer la mise à niveau comme d'habitude, avec freebsd-update install ou pkg upgrade : elle modifie l'environnement actif courant, tandis que beforeupgrade reste intact.
4. Si le système mis à niveau ne démarre pas ou se comporte mal, redémarrer et sélectionner beforeupgrade dans le menu "Boot Environments" proposé par le loader de FreeBSD ; cette sélection n'affecte que le démarrage en cours.
5. Pour rendre ce retour en arrière permanent au lieu de le resélectionner à chaque démarrage, l'activer : bectl activate beforeupgrade. D'après bectl(8), activate définit l'environnement indiqué comme système de fichiers de démarrage par défaut. bectl activate -t beforeupgrade ne l'active que pour le prochain démarrage, ce qui permet de tester un retour en arrière sur un système distant sans s'y engager définitivement.
6. Pour inspecter ou réparer un environnement inactif sans le démarrer, le monter : bectl mount beforeupgrade, travailler sous le chemin temporaire affiché, puis bectl umount beforeupgrade.
7. Une fois qu'un environnement est confirmé comme inutile, récupérer son espace : bectl destroy beforeupgrade. bectl(8) précise que cette commande détruit l'environnement « sans confirmation », contrairement à l'ancien outil beadm ; il faut donc revérifier le nom au préalable avec bectl list.

Résultat attendu

bectl list affiche le nouvel environnement immédiatement après create, avec une valeur Space de quelques kilo-octets seulement ; après activate et un redémarrage, bectl list l'affiche avec la marque NR.

Limites et base de vérification

Un environnement de démarrage ne contient que les datasets situés sous zroot/ROOT. Dans la disposition par défaut, cela inclut /usr/local et /var/db : les paquets installés reviennent donc en arrière avec le système de base, tout comme les données applicatives qui s'y trouvent (par exemple une base de données sous /var/db), que l'activation d'un environnement plus ancien ramène silencieusement à son état antérieur. Les datasets situés hors de zroot/ROOT (zroot/home, zroot/var/log, zroot/var/mail) sont partagés par tous les environnements et ne sont jamais restaurés ; le Handbook recommande de placer les données qui doivent survivre à un retour en arrière dans leur propre dataset, en dehors de zroot/ROOT. Les environnements de démarrage résident sur le même pool et ne constituent pas une sauvegarde.