Tutorial do Debian 13 / Atualizar do Debian 12 para o Debian 13 e verificar o sistema após reiniciar
Ao atualizar do Debian 12 para o 13, altere o repositório para trixie e, em seguida, execute a atualização mínima e a atualização completa na ordem. A conclusão é determinada não apenas pelas mensagens de término do APT, mas também verificando a inicialização do novo kernel, novas conexões SSH, a rede e os dados dos serviços, e o funcionamento de arquivos temporários e configurações do kernel.
Preparar o acesso e uma sessão de terminal persistente
Isso é direcionado a um servidor Debian 12 amd64 que concluiu as verificações prévias e a preparação da recuperação. Se a restauração de backup, login no console ou reinicialização correta ainda não foram verificadas, complete primeiro as preparações. Para ambientes com repositórios externos, outras arquiteturas ou servidores de banco de dados/ e-mail, revise adicionalmente as diretrizes de transição para esses produtos.
O ambiente de verificação era uma VM separada do VirtualBox executando Debian 12.15, kernel 6.1.0-55-amd64, 3 GiB de memória e um disco virtual de 30 GiB. Realizamos a instalação em duas etapas e reinicializações. Foram feitos backups do código do serviço Python e dos dados e as respostas HTTP foram registradas como referência, e este ambiente não foi usado para testar uma atualização de versão principal de um banco de dados em execução.
Se o tmux não estiver instalado no bookworm, instale-o com sudo apt install tmux antes de alternar o repositório. Com um console separado aberto, crie a seguinte sessão e comece a gravação. Os logs podem conter configurações sensíveis; mantenha-os privados. O tmux preserva uma sessão de terminal durante desconexões de rede, enquanto o script registra a saída do terminal.
Verifique se o caminho da transcrição já existe antes de começar: script -a acrescenta a um arquivo existente. Escolha um novo nome de arquivo específico para a tarefa, se necessário, para que execuções não relacionadas não se misturem. Execute os comandos de atualização subsequentes dentro do shell aberto pelo script.
tmux new-session -s debian13-upgrade
umask 077
script -a -f "$HOME/debian13-upgrade.typescript"
Uma vez que a conexão SSH seja desconectada, você pode reconectar e retornar ao tmux attach-session -t debian13-upgrade. Primeiro, verifique se o APT está em execução e não execute a mesma atualização de forma redundante. O tmux é uma ferramenta para se preparar para a desconexão do SSH e não garante que uma tarefa sobreviverá a um reinício ou falha de energia.
Verificar os repositórios e escrever a configuração deb822 completa
Este exemplo é para um servidor de prática onde a entrada oficial bookworm existe apenas em um arquivo, /etc/apt/sources.list, e sources.list.d não contém arquivos. Primeiro, leia o arquivo real e trate separadamente os repositórios externos existentes, backports e configurações de pinagem. Se os pré-requisitos abaixo não forem atendidos, modifique conforme a configuração real do repositório em vez de realizar uma substituição em massa de strings.
sudo cat /etc/apt/sources.list
sudo find /etc/apt/sources.list.d -maxdepth 1 -type f -print
sudo bash <<'ROOT'
set -euo pipefail
. /etc/os-release
test "$VERSION_ID" = 12
test -z "$(dpkg --audit)"
test -z "$(find /etc/apt/sources.list.d -maxdepth 1 -type f -print -quit)"
test -f /usr/share/keyrings/debian-archive-keyring.gpg
dest=/var/backups/debian13-upgrade
test ! -e "$dest"
install -d -m 700 "$dest"
cp -a /etc/apt/sources.list "$dest/sources.list.bookworm"
mv /etc/apt/sources.list "$dest/sources.list.disabled"
cat > /etc/apt/sources.list.d/debian.sources <<'SOURCES'
Types: deb
URIs: https://deb.debian.org/debian
Suites: trixie trixie-updates
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
Types: deb
URIs: https://security.debian.org/debian-security
Suites: trixie-security
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
SOURCES
ROOT
sudo apt update
apt-cache policy apt systemd linux-image-amd64 openssh-server
main non-free-firmware é a configuração usada nesta VM. Se o servidor existente exigir contrib ou non-free, revise os pacotes e políticas e adicione os componentes. Ambientes de desenvolvimento que exigem deb-src também devem ser considerados separadamente. Signed-By aponta para o chaveiro real do arquivo de pacotes Debian, e você não deve adicionar uma opção para ignorar erros de assinatura. deb822 usa blocos de campos separadas por linhas em branco; arquivos .sources usam este formato. O formato pode ser encontrado no manual do sources.list do Debian.
Se o bloco root com verificações prévias falhar, pare antes de apt update e verifique quais arquivos foram movidos ou criados. Não presuma que um exemplo de múltiplos comandos reverta automaticamente alterações parciais. Se a atualização indicar erros de repositório ou de assinatura, interrompa o procedimento, em vez de instalar com metadados desatualizados ou não confiáveis.
Certifique-se de que a atualização da lista seja concluída sem erros e que a versão candidata seja da série Trixie. Neste ponto, como os pacotes do Debian 13 ainda não foram instalados, se você descobrir uma seleção incorreta de repositório, pode desativar o novo arquivo e restaurar o arquivo arquivado do Bookworm para atualizar novamente. Após iniciar a instalação, não presuma que simplesmente reverter o repositório restaurará completamente o sistema.
Concluir a atualização mínima e revisar a atualização completa
apt -s upgrade --without-new-pkgs
sudo apt upgrade --without-new-pkgs
sudo dpkg --audit
apt -s full-upgrade
O primeiro passo é atualizar o que for possível sem instalar novos pacotes ou remover os existentes. Ter pacotes restantes não constitui imediatamente uma falha. Na VM de verificação, 222 itens foram atualizados na etapa mínima, e não houve novas instalações ou exclusões. Substituições de bibliotecas necessárias para a etapa completa serão tratadas no próximo passo.
Compare os nomes dos pacotes programados para exclusão na simulação com seus pacotes de substituição. Por exemplo, nesta VM, 25 itens como libssl3 apareceram como candidatos à exclusão, e pacotes subsequentes como libssl3t64 foram recém-instalados. Isso não justifica automaticamente todas as exclusões. Se pacotes que suportam SSH, rede, armazenamento ou aplicativos desaparecerem sem substitutos, interrompa o procedimento. Como explicado no manual APT, um upgrade completo pode envolver exclusões.
A revisão inclui não apenas a lista de remoção, mas também o tamanho do download, aumento do espaço em disco usado após a instalação, pacotes pendentes e dependências externas. Se outra operação do APT estiver em execução, espere até que termine; não remova o arquivo de bloqueio nem encerre forçadamente o processo do pacote.
Executar a atualização completa e revisar os arquivos de configuração
sudo apt full-upgrade
sudo dpkg --audit
sudo apt-get check
sudo /usr/sbin/sshd -t
systemctl --failed --no-pager
Leia e aprove se o resumo real das alterações corresponde à lista revisada. Se a orientação do apt-listchanges abrir, leia o conteúdo e feche-o para continuar a instalação. Quando dpkg ou ucf perguntarem como lidar com arquivos de configuração modificados, primeiro verifique quais arquivos são e quais alterações você mesmo fez.
| Situação de Seleção | Julgamento e Verificação Posterior |
|---|---|
| Existem alterações locais intencionais, como autenticação, portas ou rede | Verifique as diferenças e preserve as alterações necessárias. Verifique se a sintaxe preservada também é válida na nova versão. |
| Você não alterou as configurações padrão de distribuição ou há mudanças essenciais na nova versão | Revise o guia do pacote e os novos padrões. Não trate automaticamente a preservação de arquivos existentes como a resposta correta. |
| Não é possível determinar diferenças em configurações importantes | Verifique explicações e diferenças enquanto mantém o console e o backup. Não tenha pressa em reiniciar. |
| Ambiente de instalação automatizado | Teste as políticas de seleção com antecedência. Uma única variável não interativa não resolve todas as questões e compatibilidade. |
A VM de verificação deste curso salvou logs e códigos de saída em uma sessão tmux separada e definiu uma política para preservar configurações personalizadas existentes com base em uma configuração mínima do servidor sem alterações. O procedimento do leitor acima é uma execução interativa onde você lê perguntas e faz seleções. Ele não orienta a aplicação da opção de aprovação automática dos exercícios diretamente em todo o servidor de produção.
Se a instalação terminar com um erro, primeiro verifique os logs, o espaço em disco e o status dos pacotes. Revise as alterações sugeridas por sudo dpkg --configure -a ou sudo apt --fix-broken install somente se não houver operações APT em andamento e a causa tiver sido resolvida. Não use reinicializações durante a instalação ou remoção em massa/substituição forçada como solução geral.
Verificar o kernel, a interface de rede e o SSH antes de reiniciar
dpkg-query -W linux-image-amd64 'linux-image-*'
ls -l /vmlinuz /initrd.img
sudo ls -lh /boot
sudo /usr/sbin/sshd -t
ip -brief link
sudo udevadm test-builtin net_setup_link /sys/class/net/enp0s3
sudo efibootmgr -v
enp0s3 é a interface da VM de verificação. Altere para o nome real e compare com ID_NET_NAME e a interface de configurações de rede atual. Em alguns hardwares, o nome pode mudar, então é necessário um console. Sistemas BIOS verificam o método de inicialização e o status da instalação do GRUB em vez de usar o efibootmgr.
Mesmo que um novo kernel e initramfs sejam instalados, o uname -r atual mostra o kernel antes da reinicialização. Abra uma nova janela SSH para realmente verificar a autenticação e o acesso sudo, e não presuma que tudo está certo apenas com uma conexão aberta. O nome da interface da VM de verificação não mudou, e a nova conexão SSH antes da reinicialização foi bem-sucedida.
sudo reboot
Se a inicialização estiver atrasada, verifique no console em qual etapa ela está: bootloader, kernel ou serviços. Em vez de desligar imediatamente ou desabilitar a verificação da chave do host, verifique o status real da inicialização e a impressão digital original.
Verificar os serviços e os dados no novo sistema operacional
cat /etc/os-release
uname -r
sudo dpkg --audit
sudo apt-get check
ip -brief address
ip route
getent ahostsv4 deb.debian.org
systemctl --failed --no-pager
sudo /usr/sbin/sshd -t
Na verificação original, a VM reconectada usava Debian 13.7 e kernel 6.12.117+deb13-amd64. Essas versões identificam aquele teste e não a revisão mais recente disponível. Serviços existentes foram habilitados e estão ativos, o conteúdo HTTP foi comparado com os valores de referência pré-definidos, e o SHA-256 de programas e dados eram idênticos. Nos seus próprios serviços, verifique conforme a seguir usando nomes, endereços e arquivos reais. Use verificações apenas de leitura contra o serviço correto e arquivos de referência; não exclua ou substitua dados de produção ao adaptar o exemplo.
systemctl is-enabled lf-upgrade33.service
systemctl is-active lf-upgrade33.service
curl --noproxy '*' -fsS http://127.0.0.1:8080/
sudo sha256sum -c /var/backups/lf-debian13-upgrade33/service-files-before.sha256
O serviço acima existe apenas na VM de verificação para pré-verificações. Em um servidor normal, o status, portas, respostas de leitura e conexões de banco de dados do serviço real são comparados. Para serviços com funcionalidade de escrita, a escrita e a reconsulta também são verificadas usando dados de teste isolados antes de retomar as escritas reais.
Verificar as alterações em /tmp e na configuração sysctl
findmnt --target /tmp -o TARGET,SOURCE,FSTYPE,OPTIONS
df -hT /tmp
sudo /usr/lib/systemd/systemd-sysctl --cat-config
sysctl kernel.printk_ratelimit
Após reiniciar, a VM de verificação passou a usar tmpfs, um sistema de arquivos em memória, em /tmp. O limite de tamanho do tmpfs não significa que essa quantidade de memória seja reservada antecipadamente. Arquivos que estavam em /tmp no sistema de arquivos raiz anterior podem estar ocultos sob o novo ponto de montagem. Se você precisar encontrar os arquivos anteriores, crie um ponto de montagem temporário vazio e use uma montagem bind normal para ver apenas a raiz. Não use --rbind , que também reproduziria submontagens, como o tmpfs sobreposto.
sudo bash <<'ROOT'
set -euo pipefail
view=$(mktemp -d /mnt/old-root-view.XXXXXX)
trap 'mountpoint -q "$view" && umount "$view"; rmdir "$view"' EXIT
mount --bind / "$view"
find "$view/tmp" -mindepth 1 -maxdepth 2 -printf '%p\n'
umount "$view"
rmdir "$view"
trap - EXIT
ROOT
Este comando apenas mostra uma lista. Em um servidor real, não exclua todo o diretório temporário de uma vez; em vez disso, julgue o proprietário e a necessidade dos arquivos. Marcadores anteriores na VM de verificação não eram visíveis mesmo ao visualizar o root, e a presença imediatamente após a última inicialização antes da atualização não foi registrada, então a perda de arquivos não foi atribuída à atualização. O próprio princípio de ocultação foi confirmado em um pequeno diretório de prática com um namespace de montagem separado, onde o tmpfs cobria arquivos existentes, e em uma visualização normal de root bind, os arquivos eram visíveis. Esse teste de visibilidade controlada é separado do rastreamento de um marcador pré-atualização através da atualização real da versão.
O systemd-sysctl do Debian 13 não lê diretamente o /etc/sysctl.conf. Gerencie as configurações locais em arquivos /etc/sysctl.d/ individuais e compare seus valores pretendidos com os valores reais em tempo de execução. Na prática, foi confirmado que o kernel.printk_ratelimit=7 de um drop-in separado foi aplicado mesmo após a inicialização de um novo kernel, e após a verificação, apenas o drop-in dedicado do laboratório foi removido, e o valor de execução original foi explicitamente restaurado. Remover apenas o arquivo de configuração não desfaz um valor já aplicado no kernel. Se todas as configurações forem aplicadas de maneira descuidada, isso pode afetar outros valores, como a rede, portanto, defina o escopo de aplicação. O manual de systemd-sysctl explica os métodos de seleção e aplicação de arquivos.
Concluir a validação e decidir se a recuperação é necessária
Após a validação, digite exit para fechar o shell de gravação do script e verifique se a transcrição foi salva. Feche ou desanexe a sessão tmux apenas após confirmar que nenhuma tarefa de pacote ainda está em execução.
Se houver monitoramento, tarefas agendadas ou temporizadores APT que tenham sido interrompidos, restaure-os aos estados originalmente registrados. Na VM de verificação, os dois temporizadores APT foram retornados aos estados habilitado e ativo. Pacotes desnecessários são revisados em apt -s autoremove após a verificação completa, e não remova precipitadamente kernels anteriores ou dependências de serviço necessárias para a inicialização normal.
Se a verificação do serviço ou dos dados falhar, os logs e as evidências da falha são preservados sem retomar novas gravações. Se o pacote já tiver sido substituído, a recuperação não é alcançada simplesmente mudando para o repositório bookworm. Use o backup do estado completo pré-verificado e do serviço para determinar o escopo do reparo, e se houver novos dados após a mudança, planeje a preservação e a reaplicação separadas. Verifique Procedimento Oficial de Atualização do Debian e Mudanças Conhecidas no trixie juntamente com a documentação de transição do serviço relevante.




