Como construir um ambiente de desktop Debian como um sistema imutável baseado em OStree

Exemplo de cenário: Imagine que Maya mantém um desktop Debian 13 usado para desenvolvimento e deseja atualizações de sistema que possam ser revertidas como uma versão completa. Ela pode usar esse objetivo para avaliar uma distribuição Debian baseada em OSTree, mas não deve executar um comando em sua instalação atual e esperar que ela se torne imutável. O OSTree precisa de uma árvore de sistema operacional, integração de inicialização e um processo de atualização projetado para implantações.

O OSTree armazena árvores completas do sistema de arquivos como commits versionados e organiza implantações inicializáveis. Uma nova implantação pode ser selecionada para a próxima inicialização, enquanto uma anterior permanece disponível para reversão. Isso altera a forma como o sistema operacional é construído e atualizado; não transforma automaticamente o gerenciamento de pacotes Debian comum em um sistema atômico. ostree-bootO pacote atual do Debian é descrito como uma integração para um derivado do Debian e requer um initramfs compilado com dracut, além de um carregador de inicialização compatível. Portanto, as etapas a seguir descrevem um fluxo de trabalho derivado testável, e não uma conversão suportada com um único comando de um desktop Debian instalado.

O que a OSTree muda — e o que ela não muda.

O OSTree é um sistema de implantação e atualização de sistemas operacionais, não um substituto para o repositório de pacotes ou o resolvedor de dependências do Debian. Um processo de compilação ainda precisa instalar pacotes e montar um sistema de arquivos raiz completo. O OSTree então registra e implanta essa árvore. Para atualizações, o processo de compilação cria um novo commit da árvore completa, e o cliente alterna para ele como uma implantação. É por isso que um desktop OSTree precisa de uma maneira repetível de construir sua imagem de sistema; executar apt upgradea partir da raiz ativa não é o mesmo modelo de atualização.

"Imutável" também é uma abreviação útil, em vez de afirmar que todos os arquivos no computador são somente leitura. Em uma implantação típica, a árvore do sistema é tratada como somente leitura, enquanto o diretório `/etc/ /etcsystem` contém a configuração da máquina e o diretório /var`/etc/system` contém o estado mutável. Os arquivos do usuário normalmente residem fora da árvore versionada do sistema operacional, frequentemente em `/etc/ /homesystem`. O gerenciamento desses caminhos e das entradas de inicialização pelo OSTree faz parte do projeto do sistema. Alterações feitas no diretório `/etc/system` da implantação /usrnão são um substituto permanente para a criação de uma nova imagem.

1. Decida se essa abordagem se adequa ao seu ambiente de trabalho Debian.

Para Maya, a primeira questão é se ela quer um projeto de aprendizado ou um sistema operacional para uso diário. O OSTree pode tornar as atualizações e reversões mais controladas, mas o Debian não oferece um fluxo de trabalho pronto para uso do tipo "converter esta estação de trabalho" na descrição do pacote. Um desenvolvedor precisa preparar a árvore do sistema operacional, criar seu initramfs, integrar o carregador de inicialização, decidir como as atualizações de pacotes se tornam novos commits e testar o hardware. Uma distribuição conhecida baseada em OSTree pode ser mais adequada para um desktop onde o usuário deseja uma experiência com suporte contínuo e pronta para instalar.

Verifique a cadeia de inicialização antes de investir tempo. ostree-bootA página do pacote Trixie no Debian lista o dracut como requisito para o initramfs e o GRUB 2, syslinux/extlinux ou U-Boot como famílias de carregadores de inicialização suportadas. Essa lista não garante que todas as configurações de firmware, configurações de Inicialização Segura, configurações de criptografia de disco ou menus de inicialização específicos do fornecedor funcionarão sem integração adicional. Em particular, teste a máquina em si ou uma configuração de máquina virtual semelhante antes de mexer no disco interno.

Liste também os recursos da área de trabalho que devem permanecer funcionais: drivers gráficos, firmware Wi-Fi, suspensão e retomada, áudio, impressoras, armazenamento criptografado, múltiplos monitores e quaisquer módulos do kernel externos à árvore de código-fonte. A inicialização bem-sucedida em uma interface gráfica é apenas o começo. Se o Maya depender de um driver proprietário ou de um módulo específico do kernel, ele deverá estar disponível na imagem compilada e ser compatível com o kernel e o initramfs.

2. Crie um ambiente de construção e teste seguro.

Comece com uma máquina virtual descartável usando uma distribuição Debian e arquitetura compatíveis com o sistema de destino. Faça um snapshot da máquina virtual antes de experimentar. Faça backup do diretório home do seu computador principal, perfis de navegador, chaves SSH, arquivos de recuperação de senhas do gerenciador de senhas e quaisquer dados que ainda não estejam sincronizados em outro local. Mantenha o backup separado do disco da máquina virtual. Não reparticione nem formate o computador que você usa diariamente como parte do primeiro teste.

Use um diretório de compilação separado e uma imagem de disco de destino separada. Mantenha anotações sobre a versão do Debian, arquitetura, lista de pacotes, versão do kernel, carregador de inicialização e alterações feitas na árvore. Um registro de compilação reproduzível ajuda o Maya a distinguir uma alteração real na imagem de uma alteração de configuração específica da máquina. Se o objetivo é manter a área de trabalho existente exatamente, uma nova árvore base não fará isso automaticamente: pacotes instalados, contas de usuário, configurações de hardware e configurações precisam ser transferidos ou recriados manualmente.

3. Instale as ferramentas OSTree no construtor.

Em um ambiente Debian Trixie, instale as ferramentas OSTree disponíveis, a integração de inicialização e os pacotes dracut:

sudo apt update
sudo apt install ostree ostree-boot dracut

A disponibilidade e as dependências dos pacotes podem variar de acordo com a versão e a arquitetura do Debian, portanto, confirme-as com o APT no computador de instalação. Este procedimento instala apenas ferramentas na máquina; ele não altera o processo de inicialização da máquina nem torna seu sistema de arquivos raiz imutável. A descrição do pacote Debian afirma explicitamente que ostree-bootele fornece componentes para inicializar uma distribuição derivada do Debian.

4. Crie uma árvore raiz Debian limpa.

Prepare um sistema de arquivos raiz completo com as ferramentas de pacote da versão ou um sistema de criação de imagens Debian. Inclua o kernel, systemd, ambiente de desktop, firmware e drivers necessários para o alvo, além da integração de inicialização OSTree e seu suporte a initramfs. Configure usuários, localidade, rede, serviços e padrões de desktop intencionalmente. Por exemplo, uma árvore mínima que inicializa em um console ainda não é um desktop, e uma árvore criada para uma máquina pode não incluir drivers para outra.

Antes de confirmar a árvore de diretórios, certifique-se de que ela esteja em conformidade com o layout de implantação do OSTree. O guia de adaptação original indica que a configuração padrão deve estar em `/etc/default/default` /usr/etc, em vez de uma árvore raiz tradicional /etc; o OSTree usa essa árvore como base para o arquivo `/etc/default/default` mutável por implantação /etc. A árvore também deve incluir o kernel e um initramfs compatível em locais reconhecidos pela versão do OSTree escolhida e pela integração de inicialização. O pacote de inicialização específico do Debian e o guia original devem ser lidos em conjunto: uma árvore de diretórios válida por si só não garante uma implantação inicializável do Debian.

Não copie cegamente todo o diretório do host ativo /para um commit. Isso pode capturar arquivos transitórios, estado específico da máquina, estado do gerenciador de pacotes no local errado e configurações que pressupõem o processo de inicialização antigo. O OSTree espera que o construtor da imagem defina como os pacotes são montados e como as atualizações são produzidas. Esse pipeline de construção de imagem é o principal trabalho de engenharia em uma conversão para o ambiente de desktop Debian.

5. Envie a árvore preparada para um repositório local.

Após preparar a árvore raiz, crie um repositório local e confirme as alterações em um branch com um nome descritivo. Neste exemplo, `<root>` /srv/debian-rooté a árvore preparada; não é a raiz do host em execução.

sudo mkdir -p /srv/ostree/repo
sudo ostree --repo=/srv/ostree/repo init --mode=archive
sudo ostree --repo=/srv/ostree/repo commit \
  --branch=debian/trixie/desktop \
  --subject="Debian Trixie desktop test image" \
  /srv/debian-root
sudo ostree --repo=/srv/ostree/repo refs

O commit registra os arquivos na árvore e o branch aponta para essa versão. Ele não configura um disco, não cria uma entrada de inicialização de firmware nem comprova que o initramfs consegue encontrar a implantação. Mantenha o repositório e os parâmetros de compilação disponíveis para que a próxima imagem possa ser reconstruída e comparada. Para um serviço de atualização robusto, também é necessário projetar um transporte seguro, controles de acesso ao repositório, commits assinados quando apropriado e um processo de lançamento documentado.

6. Provisione um disco de teste com integração de inicialização OSTree.

Provisione um novo disco de máquina virtual por meio de um instalador ou fluxo de trabalho de criação de imagens que saiba como criar um sysroot OSTree e configurar seu carregador de inicialização. admin init-fsO comando do OSTree inicializa um sistema de arquivos raiz físico vazio, e um administrador pode inicializar um stateroot e implantar um commit, mas esses comandos são blocos de construção — não uma receita de instalação completa para todos os desktops Debian. Eles não eliminam a necessidade de configurar partições, instalar arquivos de inicialização de firmware, gerar um initramfs compatível e organizar as configurações de firmware e carregador de inicialização.

Utilize a família de carregadores de inicialização (bootloader) suportada pelo pacote de integração do Debian e verifique se a entrada de inicialização passa a referência de implantação do OSTree para o initramfs. A documentação de implantação do OSTree explica que as entradas de inicialização incluem um ostree=argumento do kernel, que o initramfs utiliza para localizar a implantação selecionada. Para sistemas com criptografia, LVM, RAID, Inicialização Segura (Secure Boot) ou armazenamento incomum, certifique-se de que o initramfs contenha os módulos e chaves necessários antes de testar. Não assuma que uma entrada de inicialização convencional do Debian funcionando inicializará automaticamente uma implantação do OSTree.

Para a primeira implantação, siga as instruções do instalador ou do criador de imagens para o seu caminho de inicialização exato. Um comando simples como este ostree admin deployapenas enfileira um commit como a implantação padrão em um sistema OSTree já configurado; ele não transforma a instalação Debian em execução nesse sistema.

7. Inicialize, inspecione e teste o rollback.

Inicie a máquina virtual na nova implantação e confirme mais do que apenas a tela de login: verifique a conectividade de rede, a aceleração gráfica, o som, a suspensão e a retomada, as montagens de armazenamento, as atualizações e o comportamento do aplicativo. Em seguida, inspecione a lista de implantações:

sudo ostree admin status

O comando lista as implantações disponíveis e marca aquela que está sendo inicializada no momento. Mantenha a implantação anterior, que funciona corretamente, durante os testes. Se a nova imagem falhar, use o menu de inicialização para escolher a implantação anterior ou utilize o fluxo de trabalho de reversão do OSTree documentado para a versão instalada. Confirme se a área de trabalho anterior inicia e se os dados do usuário permanecem intactos. O OSTree versiona a árvore do sistema operacional; ele não restaura automaticamente arquivos pessoais nem reverte todas as alterações de aplicativos em dados compartilhados /var.

8. Defina o processo de atualização e manutenção.

Para um ambiente de trabalho de fácil manutenção, cada atualização do sistema operacional deve vir de um novo commit na árvore de distribuição, passível de revisão. Defina quem irá compilá-la, como as atualizações de pacotes Debian serão incorporadas à árvore, como as atualizações de kernel e firmware serão testadas, como os commits chegarão aos usuários e por quanto tempo as versões anteriores serão mantidas. Se os usuários precisarem de aplicativos adicionais, escolha um método de distribuição de aplicativos compatível — como o Flatpak, quando apropriado — em vez de alterar silenciosamente o sistema operacional base com comandos APT comuns.

Planeje o estado com cuidado. Uma implantação mais recente pode manter /etcedições locais, mas as alterações de configuração ainda podem precisar de revisão do administrador. Os dados /varsão compartilhados entre as implantações, portanto, reverter o sistema operacional não necessariamente reverte o esquema do banco de dados ou o formato dos dados do aplicativo. Os arquivos do usuário devem ter seu próprio plano de backup e recuperação. Arquivos de sistema imutáveis ​​melhoram a capacidade de alternar entre versões do sistema operacional; eles não tornam todo o estado da máquina transacional.

Lista de verificação de prontidão prática

• A compilação é reproduzível e tem como alvo a versão e arquitetura Debian pretendidas.
• A árvore raiz utiliza o layout de configuração esperado do OSTree, inclui um kernel e um initramfs correspondentes e possui os drivers de desktop necessários.
• O sistema utiliza a integração do dracut e do carregador de inicialização suportada pelo Debian, testada em uma máquina virtual antes da instalação do hardware.
• Uma nova implantação inicia no ambiente de trabalho, e uma implantação anterior pode ser selecionada e iniciada.
• Os backups abrangem tanto os dados do usuário quanto qualquer estado que uma reversão do sistema operacional não consiga restaurar.
• Existe um processo documentado para atualizações de pacotes, reconstrução de imagens, assinatura ou verificação de versões e teste de alterações no kernel.

Para o hipotético desktop de Maya, o resultado prático é uma imagem OSTree derivada do Debian testada e um método repetível para sua próxima implantação — não uma instalação Debian intocada que magicamente se torna imutável. Comece em uma máquina virtual, mantenha o pipeline de atualização simples e migre para hardware físico somente depois que a integração de inicialização, os drivers de desktop e o caminho de reversão estiverem funcionando corretamente na máquina pretendida.

Documentação principal

• Detalhes do pacote ostree-boot do Debian Trixie — limites de integração de inicialização e carregadores de inicialização suportados.
• Visão geral do OSTree — commits, árvores e a relação com os gerenciadores de pacotes.
• Adaptação de distribuições existentes — considerações sobre o layout do sistema de arquivos, initramfs, gerenciamento de usuários e gerenciador de pacotes.
• Implantações do OSTree — /etc, /var, kernels e entradas de inicialização.
• Manual do administrador do Debian ostree init-fs e manual do administrador do Debian ostree deploy — escopo do comando e comportamento de implantação.
• Manual do dracut do Debian — módulos initramfs e parâmetros de inicialização.