Boot environments ZFS com bectl: um caminho de rollback para atualizações do FreeBSD e de pacotes

Objetivo

Criar um boot environment ZFS antes de uma alteração arriscada no FreeBSD 14.x com Root-on-ZFS, ativar outro depois de testar e remover os ambientes que já não são necessários.

Pré-requisitos

Uma instalação Root-on-ZFS (os datasets ficam em zroot/ROOT, e o sistema em execução costuma estar em zroot/ROOT/default); acesso root; bectl(8) disponível (ferramenta do sistema base, não exige instalar pacotes).

Passos

1. Antes de uma mudança importante, como a atualização do sistema operacional ou uma grande atualização de pacotes, crie um novo ambiente: bectl create beforeupgrade. O FreeBSD Handbook descreve a criação de um boot environment como um snapshot seguido de clone dos datasets raiz, que "completes in seconds and consumes almost no space until the environments start to diverge" (ou seja, conclui-se em segundos e quase não ocupa espaço até que os ambientes comecem a divergir). Num root ZFS com suporte a boot environments, o freebsd-update install também cria um automaticamente, a menos que CreateBootEnv no esteja definido em /etc/freebsd-update.conf; ainda assim, um ambiente com nome próprio é mais fácil de encontrar.
2. Confirme que ele existe e veja qual ambiente está ativo: bectl list. A coluna Active marca com N o ambiente em uso agora e com R o que estará ativo no próximo reinício.
3. Faça a atualização como de costume, com freebsd-update install ou pkg upgrade. Isso altera o ambiente atualmente ativo, enquanto beforeupgrade permanece intocado.
4. Se o sistema atualizado não inicializar ou se comportar mal, reinicie e selecione beforeupgrade no menu "Boot Environments" apresentado pelo loader do FreeBSD; a seleção feita ali vale apenas para o boot atual.
5. Para tornar esse rollback permanente, em vez de selecioná-lo a cada boot, ative-o: bectl activate beforeupgrade. O bectl(8) documenta que o activate define o ambiente indicado como o sistema de arquivos de boot padrão. bectl activate -t beforeupgrade ativa-o apenas para o próximo boot, o que é útil para testar um rollback num sistema remoto sem se comprometer com ele.
6. Para inspecionar ou reparar um ambiente inativo sem inicializá-lo, monte-o: bectl mount beforeupgrade, trabalhe no caminho temporário exibido e depois execute bectl umount beforeupgrade.
7. Quando tiver certeza de que um ambiente não é mais necessário, recupere o espaço dele: bectl destroy beforeupgrade. O bectl(8) observa que isso destrói o ambiente "without confirmation" (sem confirmação), ao contrário da antiga ferramenta beadm; por isso, confira antes o nome com bectl list.

Resultado esperado

bectl list mostra o novo ambiente logo após o create, com um valor de Space de apenas alguns kilobytes; depois de activate e de reiniciar, bectl list o mostra marcado como NR.

Limites e base de verificação

Um boot environment contém apenas os datasets em zroot/ROOT. No layout padrão, isso inclui /usr/local e /var/db; por isso, os pacotes instalados voltam atrás junto com o sistema base. O mesmo acontece com os dados de aplicações guardados ali (por exemplo, um banco de dados em /var/db): ao ativar um ambiente mais antigo, eles regressam silenciosamente ao estado antigo. Os datasets fora de zroot/ROOT (zroot/home, zroot/var/log, zroot/var/mail) são compartilhados por todos os ambientes e nunca sofrem rollback; o Handbook recomenda colocar os dados que precisam sobreviver a um rollback num dataset próprio, fora de zroot/ROOT. Os boot environments ficam no mesmo pool e não são um backup.