Entornos de arranque ZFS con bectl: una vía de reversión ante actualizaciones de FreeBSD y de paquetes

Objetivo

Crear un entorno de arranque ZFS antes de un cambio arriesgado en FreeBSD 14.x con Root-on-ZFS, activar otro distinto tras las pruebas y eliminar los entornos que ya no se necesitan.

Requisitos previos

Una instalación Root-on-ZFS (los datasets están bajo zroot/ROOT, y el sistema en ejecución suele estar en zroot/ROOT/default); acceso de root; bectl(8) disponible (es una herramienta del sistema base, no requiere instalar ningún paquete).

Pasos

1. Antes de un cambio importante, como una actualización del sistema operativo o una actualización grande de paquetes, cree un entorno nuevo: bectl create beforeupgrade. El FreeBSD Handbook describe la creación de un entorno de arranque como una instantánea (snapshot) y un clon de los datasets raíz, que "completes in seconds and consumes almost no space until the environments start to diverge" (se completa en segundos y casi no consume espacio hasta que los entornos empiezan a divergir). En una raíz ZFS compatible con entornos de arranque, freebsd-update install también crea uno automáticamente, salvo que /etc/freebsd-update.conf contenga CreateBootEnv no; aun así, uno con nombre propio es más fácil de localizar.
2. Compruebe que existe y vea cuál es el entorno activo: bectl list. La columna Active marca con N el entorno en uso ahora y con R el que estará activo en el próximo reinicio.
3. Realice la actualización como de costumbre, con freebsd-update install o pkg upgrade. Esto modifica el entorno activo actual, mientras que beforeupgrade queda intacto.
4. Si el sistema actualizado no arranca o se comporta mal, reinicie y seleccione beforeupgrade en el menú "Boot Environments" que muestra el loader de FreeBSD; seleccionarlo ahí afecta solo al arranque actual.
5. Para que esa reversión sea permanente, en lugar de volver a seleccionarla en cada arranque, actívelo: bectl activate beforeupgrade. bectl(8) documenta activate como el comando que establece el entorno indicado como sistema de archivos de arranque predeterminado. bectl activate -t beforeupgrade lo activa solo para el siguiente arranque, lo que resulta útil para probar una reversión en un sistema remoto sin comprometerse con ella.
6. Para inspeccionar o reparar un entorno inactivo sin arrancarlo, móntelo: bectl mount beforeupgrade, trabaje bajo la ruta temporal que se imprime y después ejecute bectl umount beforeupgrade.
7. Cuando haya confirmado que un entorno ya no hace falta, libere su espacio: bectl destroy beforeupgrade. bectl(8) indica que esto destruye el entorno "without confirmation" (sin pedir confirmación), a diferencia de la antigua herramienta beadm, así que compruebe antes el nombre con bectl list.

Resultado esperado

bectl list muestra el nuevo entorno inmediatamente después de create, con un valor de Space de solo unos kilobytes; tras activate y reiniciar, bectl list lo muestra marcado como NR.

Límites y base de verificación

Un entorno de arranque contiene únicamente los datasets que están bajo zroot/ROOT. En la disposición predeterminada eso incluye /usr/local y /var/db, de modo que los paquetes instalados se revierten junto con el sistema base; lo mismo ocurre con los datos de aplicaciones guardados ahí (por ejemplo, una base de datos en /var/db), que al activar un entorno más antiguo vuelven en silencio a su estado anterior. Los datasets fuera de zroot/ROOT (zroot/home, zroot/var/log, zroot/var/mail) son compartidos por todos los entornos y nunca se revierten; el Handbook recomienda colocar los datos que deban sobrevivir a una reversión en un dataset propio fuera de zroot/ROOT. Los entornos de arranque residen en el mismo pool y no son una copia de seguridad.