Tutorial do Debian 13 / Preparar o Debian 12 para atualização ao Debian 13 com backup e recuperação

Antes de atualizar do Debian 12 para o Debian 13, você deve estabilizar o sistema atual e preparar um backup restaurável, juntamente com um console que possa ser acessado mesmo se o SSH for desconectado. Não termine a preparação apenas salvando a lista de pacotes ou criando um snapshot da VM; também verifique a restauração dos dados do serviço e o acesso após a reinicialização.

Definir o escopo da atualização e as condições de parada

Este artigo cobre os passos de preparação para um servidor mínimo amd64 Debian 12. Ele não altera o repositório para trixie nem instala pacotes do Debian 13. Versões mais antigas, como o Debian 11, exigem um procedimento separado para primeiro atualizar para o Debian 12. Não atualize um servidor i386 no local com este procedimento: o Debian 13 não fornece mais um kernel ou instalador oficial para i386. Avalie uma instalação nova em amd64 em hardware compatível ou a aposentadoria do sistema.

Uma VM separada no VirtualBox 7.2 foi usada para prática. O Debian 12.15 foi instalado com 3 GiB de memória, um disco virtual de 30 GiB, UEFI, root em ext4 e uma partição EFI separada. Após atualizar o bookworm, o kernel era 6.1.0-55-amd64. Este é o ambiente de observação e não representa uma diretriz geral para a capacidade necessária. De acordo com o lançamento Debian 12.15 , esta versão pontual é a última atualização regular para o Debian 12, e o suporte futuro requer verificar as arquiteturas e os pacotes cobertos pelo suporte de longo prazo (LTS, Long Term Support).

Condições para prosseguir Estados para parar e resolver primeiro
Login no console, sudo e novas conexões SSH estão todos funcionando Confiar apenas em uma sessão SSH existente ou não ter mídia de recuperação
Auditoria de pacotes normal, razões identificadas para pacotes mantidos em hold e pacotes externos Pacotes não configurados, retenções de causa desconhecida, repositórios mistos
Restauração real do backup e verificação de leitura do serviço concluídas Apenas verificada a existência do arquivo ou somas de verificação
Concordado com o tempo de inatividade do serviço, suspensão de gravação de dados e ponto de restauração Após a atualização, novos dados serão sobrescritos por snapshots antigos

Registrar a versão atual, pacotes e status do repositório

Armazene os arquivos de resultado em um diretório que apenas o root possa ler. O comando abaixo é um exemplo de execução pela primeira vez; se o mesmo diretório já existir, ele irá parar sem sobrescrever. Em operações reais, diferencie os nomes pela data da tarefa ou número de revisão.

sudo bash <<'ROOT'
set -euo pipefail
dest=/var/backups/debian13-preflight
test ! -e "$dest"
install -d -m 700 "$dest"
cat /etc/os-release > "$dest/os-release.txt"
uname -a > "$dest/kernel.txt"
dpkg --print-architecture > "$dest/architecture.txt"
dpkg-query -W -f='${binary:Package}\t${Version}\t${db:Status-Abbrev}\n' > "$dest/packages.tsv"
dpkg --get-selections '*' > "$dest/selections.txt"
apt-mark showmanual > "$dest/manual.txt"
apt-mark showhold > "$dest/holds.txt"
apt-cache policy > "$dest/apt-policy.txt"
dpkg --audit > "$dest/dpkg-audit.txt"
test ! -s "$dest/dpkg-audit.txt"
apt-get check
ROOT

dpkg --audit normalmente não gera saída se não houver problemas. Se houver resultados, leia o conteúdo, resolva a causa e depois verifique novamente. Não inicie uma atualização de distribuição se apt-get check terminar com erros de dependência. Não remova holds indiscriminadamente; verifique o motivo de cada hold e se o pacote é suportado no Debian 13.

sudo grep -R -nE '^(deb |deb-src |Types:|URIs:|Suites:|Components:|Signed-By:)' /etc/apt/sources.list /etc/apt/sources.list.d
apt list '?narrow(?installed, ?not(?origin(Debian)))'
dpkg --print-foreign-architectures

Erros de grep podem aparecer devido a um sources.list inexistente. Verifique todos os .list e .sources existentes, e também verifique se há backports, repositórios de terceiros ou configurações de pin, além de bookworm, bookworm-updates e bookworm-security. Não publique resultados se o URI contiver informações de autenticação. A consulta de fontes externas é baseada nos metadados atuais do APT, portanto a falta de saída não prova a origem de todos os arquivos de instalação.

Atualizar o Debian 12 e verificar o acesso após reiniciar

Após confirmar que o repositório atual aponta para bookworm, atualize a lista de pacotes e revise as alterações esperadas. Além disso, verifique se os pacotes meta do kernel estão instalados. Não use a opção de aprovação automática sem revisar as remoções previstas na simulação e preparar o tratamento das perguntas de configuração durante a execução real.

sudo apt update
apt -s full-upgrade
apt-cache policy linux-image-amd64 openssh-server
sudo apt full-upgrade
sudo /usr/sbin/sshd -t
sudo reboot

Prossiga com o reinício apenas após o apt concluir com sucesso e sshd -t ter sucesso. Se algum deles falhar, mantenha a sessão e use o console para resolver o erro antes de reiniciar.

Após a reinicialização estar completa, em vez de reutilizar a janela existente, crie uma nova conexão SSH e verifique se você também consegue fazer login pelo console. No exercício, a auditoria de pacotes após a atualização estava normal, e a simulação de atualização completa do bookworm envolveu 0 pacotes a serem alterados. Para atualizações remotas, revise as condições do OpenSSH nas notas de versão do trixie e nos problemas conhecidos; atualize o bookworm antes de tentar a transição de versão.

Registrar referências de disco, rede e serviços

findmnt --target / -o TARGET,SOURCE,FSTYPE,OPTIONS
findmnt --target /boot -o TARGET,SOURCE,FSTYPE,OPTIONS
findmnt --target /boot/efi -o TARGET,SOURCE,FSTYPE,OPTIONS
findmnt --target /tmp -o TARGET,SOURCE,FSTYPE,OPTIONS
df -hT / /boot /var
df -i / /boot /var
ip -brief address
ip route
readlink -f /etc/resolv.conf
cat /etc/resolv.conf
sudo ss -lntup
systemctl --failed --no-pager

Determine se /boot é um sistema de arquivos separado ou parte do root, e verifique tanto a capacidade quanto os inodes. Em um sistema BIOS sem EFI, você pode pular a verificação de /boot/efi. Se o disco for pequeno, considere espaço não apenas para o cache de download, mas também para o novo kernel, initramfs e espaço temporário durante a instalação, e não exclua o kernel atualmente em uso ou o único kernel funcional para liberar espaço.

Não apenas registre os endereços; inclua também o nome da interface, a rota padrão, o componente que gerencia os arquivos do resolvedor do Sistema de Nomes de Domínio (DNS) e os endereços e portas de escuta dos serviços. Para serviços web, inclua o status HTTP e o conteúdo da resposta; para bancos de dados, inclua como pausar gravações e os comandos para backup lógico e restauração como parte da linha de base. O simples fato de que systemctl is-active está ativo não significa que os dados estão normais.

No Debian 13, o método de armazenamento padrão /tmp e o caminho de leitura de configuração do sysctl irão mudar. Antes disso, verifique se dados permanentes não foram colocados em /tmp e se as configurações necessárias estão em /etc/sysctl.d/*.conf. Registre o resultado atual de findmnt --target /tmp e os trechos locais do sysctl antes da atualização, e depois compare-os após o reinício. O registro pré-atualização não prova que um marcador temporário antigo sobreviveu ou foi posteriormente escondido; qualquer teste desse tipo requer um marcador registrado separadamente e observação controlada.

Separar backups do estado do sistema dos testes de restauração

O backup das configurações e do estado dos pacotes tem finalidade diferente do backup dos dados do serviço. O comando a seguir armazena o estado do sistema no diretório seguro criado anteriormente. Este tar não é uma imagem completa do disco, nem é um backup consistente de um banco de dados em execução. Dumps específicos do serviço ou procedimentos de parada de escrita devem ser aplicados separadamente.

sudo bash <<'ROOT'
set -euo pipefail
dest=/var/backups/debian13-preflight
test -d "$dest"
test ! -e "$dest/system-state.tar"
tar --acls --xattrs --numeric-owner -cpf "$dest/system-state.tar" -C / etc var/lib/dpkg var/lib/apt/extended_states
cd "$dest"
sha256sum system-state.tar > system-state.sha256
sha256sum -c system-state.sha256
ROOT

/etc pode conter chaves privadas ou informações de autenticação. Restrinja as permissões de leitura e aplique criptografia e controle de acesso ao armazenar em dispositivos ou servidores separados. Se o caminho do backup estiver apenas no mesmo disco raiz, a corrupção pode causar a perda tanto do original quanto do backup. Por outro lado, sobrescrever apenas o diretório do estado dos pacotes com uma versão mais antiga não é um método para rebaixar o sistema operacional.

Para praticar o procedimento de restauração diretamente, use os seguintes arquivos pequenos independentes em vez de dados operacionais. Mova os originais para outro local, restaure-os do arquivo e compare o conteúdo, proprietários e permissões. O exemplo usa o ID de usuário (UID) 1000 e o ID de grupo (GID) 1000. Verifique ambos com id e ajuste cada valor de proprietário/grupo se sua conta de laboratório for diferente.

sudo bash <<'ROOT'
set -euo pipefail
dest=/var/backups/debian13-preflight
test -d "$dest"
test ! -e /var/lib/preflight-demo
test ! -e "$dest/demo.tar"
install -d -m 750 -o 1000 -g 1000 /var/lib/preflight-demo
printf 'upgrade backup sample\n' > /var/lib/preflight-demo/message.txt
chown 1000:1000 /var/lib/preflight-demo/message.txt
chmod 640 /var/lib/preflight-demo/message.txt
stat -c '%u:%g:%a' /var/lib/preflight-demo/message.txt > "$dest/demo-mode.txt"
sha256sum /var/lib/preflight-demo/message.txt > "$dest/demo-data.sha256"
tar --acls --xattrs --numeric-owner -cpf "$dest/demo.tar" -C / var/lib/preflight-demo
mv /var/lib/preflight-demo/message.txt "$dest/demo-held.txt"
tar --acls --xattrs --numeric-owner --same-owner -xpf "$dest/demo.tar" -C / var/lib/preflight-demo/message.txt
cmp "$dest/demo-held.txt" /var/lib/preflight-demo/message.txt
test "$(stat -c '%u:%g:%a' /var/lib/preflight-demo/message.txt)" = "$(cat "$dest/demo-mode.txt")"
sha256sum -c "$dest/demo-data.sha256"
ROOT

O resultado esperado é que o comando de comparação termine sem erros e que OK apareça na verificação SHA-256.

Para verificação real, nós transferimos os dados do serviço HTTP de prática desta maneira, restauramos a partir do backup e comparamos os hashes dos arquivos, UID, GID, permissões e respostas HTTP. Apenas os três arquivos do exercício sem informações sensíveis foram copiados separadamente para fora da VM para verificar seus hashes e conteúdo, enquanto o arquivo completo de configuração do sistema foi mantido dentro da VM. Portanto, esta prática não verifica um backup completo do sistema que possa suportar a perda total do host.

Para limpar apenas o exercício de arquivos pequenos, após confirmar que a restauração foi bem-sucedida, execute sudo rm -- /var/lib/preflight-demo/message.txt e sudo rmdir -- /var/lib/preflight-demo . Mantenha o backup até que os resultados da atualização sejam confirmados e não o confunda com os arquivos reais do serviço.

Confirmar o acesso ao console, a inicialização a frio e os limites de reversão

No VirtualBox Manager, selecione a VM alvo, abra o console e teste o login e o sudo. Você também deve ser capaz de verificar o ISO de instalação ou o método de entrada de resgate, informações de identificação da partição root/EFI e o local de backup fora do SSH. Snapshots de uma VM desligada normalmente são uma maneira rápida de retornar ao estado atual, mas eles dependem do mesmo host e armazenamento.

  1. Pare as gravações antes de iniciar a atualização e faça um backup dos dados do serviço pela última vez.
  2. Depois de desligar normalmente o sistema convidado, salve o estado pré-alteração no menu de snapshots da VM. Não presuma que o snapshot em si garante a consistência de um banco de dados em execução.
  3. Ligue a máquina virtual e verifique a inicialização automática, novas conexões SSH, respostas dos serviços e hashes de dados.
  4. Se falhar, registre quem abrirá o console, qual backup será restaurado e como os dados recém-criados serão preservados.

No exercício, descobrimos um problema durante a última verificação de inicialização, onde o carregador de inicialização existia no diretório EFI, mas não estava registrado na ordem de inicialização. Selecionamos EFI/debian/shimx64.efi no console para inicializar, verificamos a entrada UEFI real, corrigimos a ordem e então confirmamos novamente a inicialização automática, novas conexões SSH e respostas dos serviços após uma reinicialização a frio. Como os números das entradas de inicialização variam conforme o dispositivo, não copie e aplique o número efibootmgr de outro sistema.

Após retomar a escrita pós-atualização, se você reverter para um snapshot antigo, os dados criados nesse meio tempo podem ser perdidos. Estabeleça critérios para decidir se deve continuar reparos ou restaurar todo o estado em casos de falhas na instalação de pacotes, falhas de inicialização e erros de dados de serviços. Leia tanto o guia oficial de atualização do Debian quanto a documentação do seu próprio serviço, e inicie a troca de repositório apenas quando não houver itens não resolvidos.