Tutorial do Debian 13 / Verificar atualizações de segurança e configurar unattended-upgrades

Aplique as atualizações de segurança do Debian 13 após verificar as versões candidatas, suas origens no repositório e as mudanças propostas nos pacotes. Para automatizá-las, configure separadamente as origens, os intervalos e a política de reinício do unattended-upgrades. Instalar o pacote ou habilitar um timer não prova que as correções foram instaladas: inspecione a execução simulada, as versões reais, os logs e os requisitos de reinício.

Diferencie atualizações de segurança de atualizações gerais

Primeiro, as configurações dos repositórios e das chaves de assinatura devem estar corretas, e a lista trixie-security deve ser recuperável. apt update apenas atualiza as listas e não instala pacotes. Um apt upgrade geral utiliza os candidatos dos repositórios configurados, portanto, não é o mesmo que um comando que seleciona e aplica automaticamente apenas as fontes de segurança.

sudo apt update
apt list --upgradable
apt-cache policy zlib1g
sudo apt-get -s upgrade

Confira as versões Installed (instalada) e Candidate (candidata), e o endereço do repositório e o ramo do candidato. No momento do exercício, tanto o candidato do repositório de segurança quanto o candidato tzdata de trixie-updates estavam presentes. Este é um exemplo de como diferenciar fontes reais em vez de tratar todas as atualizações como um único tipo. A lista de candidatos varia dependendo do momento da execução.

FAQ de Segurança do Debian explica como as correções de segurança são refletidas nas versões estáveis e a importância de versões exatas de pacotes do Debian e do histórico de alterações. Um número de versão upstream mais antigo por si só não indica que faltam correções de segurança do Debian. Se necessário, verifique os pacotes de origem alvo e as versões corrigidas em Anúncios de Segurança do Debian e revise todos os pacotes binários relacionados instalados.

Prepare a recuperação e aplique uma atualização controlada

Planeje uma janela de manutenção, um método de recuperação testado e acesso ao console para servidores de produção. No curso original, a VM dedicada foi desligada normalmente, um snapshot chamado before-security-lab foi criado no VirtualBox e a VM foi reiniciada. Um snapshot no mesmo armazenamento não é um backup independente que sobreviva à perda desse dispositivo.

No teste original, após confirmar que o zlib1g já está instalado e que há um novo candidato no repositório de segurança, o seguinte plano foi lido. Se este pacote estiver ausente ou o candidato for diferente, não espere os mesmos resultados e selecione novamente seu pacote-alvo.

dpkg-query -W zlib1g
sudo apt-get -s install --only-upgrade zlib1g
sudo apt install --only-upgrade zlib1g
dpkg-query -W zlib1g
systemctl is-active ssh
systemctl --failed --no-pager

A opção --only-upgrade restringe o alvo nomeado a atualizar um pacote já instalado; mesmo assim, você deve ler as mudanças de dependências e quaisquer remoções propostas antes de confirmar. No teste original com Debian 13.7, o zlib1g mudou de 1:1.3.dfsg+really1.3.1-1+b1 para o candidato do repositório de segurança 1:1.3.dfsg+really1.3.1-1+deb13u1. Nenhum pacote foi recém-instalado ou removido nessa operação. Estas são versões registradas no laboratório, não instruções para fixar uma instalação futura a elas.

Aplicar apenas este exemplo não significa que as atualizações de segurança do sistema estejam completas. Outros candidatos e itens pendentes também devem ser revisados de acordo com seu plano de gerenciamento. Mesmo que arquivos de biblioteca sejam atualizados, processos já em execução podem estar utilizando a versão anterior, então uma decisão separada para reiniciar é necessária.

Salve a política atual e instale unattended-upgrades

Antes de instalar a ferramenta de automação, faça backup da configuração atual e registre o estado do timer. Execute a primeira linha de criação de diretório separadamente e continue apenas se ela for bem-sucedida. Se esse backup já existir, escolha um nome novo e ajuste todos os caminhos relacionados. Pare em qualquer etapa falha antes de fazer alterações adicionais.

sudo test ! -e /var/backups/lf-debian13-11 && sudo install -d -m 700 /var/backups/lf-debian13-11
sudo cp -a /etc/apt/apt.conf.d /var/backups/lf-debian13-11/
systemctl list-timers --all --no-pager apt-daily.timer apt-daily-upgrade.timer
sudo apt-get -s install --no-install-recommends unattended-upgrades
sudo apt install --no-install-recommends unattended-upgrades

No teste original, unattended-upgrades 2.12 e os pacotes necessários python3-dbus e python3-distro-info foram adicionados. Em servidores onde esses pacotes já estão instalados, você deve primeiro ler a política atual. Não sobrescreva listas de permissão operacionais existentes ou políticas de múltiplos repositórios com o exemplo.

cat /etc/apt/apt.conf.d/50unattended-upgrades
apt-config dump | grep -E 'Origins-Pattern|Allowed-Origins|Automatic-Reboot|APT::Periodic'
sudo test ! -e /etc/apt/apt.conf.d/99-lf-security

A configuração padrão do pacote Debian inclui permissões não apenas para o ramo de segurança, mas também para os repositórios comuns da versão atual. O seguinte exemplo destina-se a aprender uma política explícita que automatiza apenas a fonte trixie-security. Se deve manter a política padrão ou também permitir atualizações da versão estável regular deve ser determinado de acordo com os requisitos operacionais.

Defina as origens permitidas, os intervalos e a política de reinício

Se /etc/apt/apt.conf.d/99-lf-security não existir, crie-o com sudo nano /etc/apt/apt.conf.d/99-lf-security e coloque o seguinte conteúdo completo nele. Se 99-lf-security já existir, não o substitua sem uma revisão separada.

#clear Unattended-Upgrade::Origins-Pattern;
#clear Unattended-Upgrade::Allowed-Origins;
Unattended-Upgrade::Origins-Pattern {
  "origin=Debian,codename=trixie-security,label=Debian-Security";
};
Unattended-Upgrade::Automatic-Reboot "false";
Unattended-Upgrade::Remove-Unused-Dependencies "false";
Unattended-Upgrade::Remove-New-Unused-Dependencies "false";
APT::Periodic::Update-Package-Lists "1";
APT::Periodic::Unattended-Upgrade "1";

O #clear aqui é uma diretiva de configuração do APT, não um prompt de terminal. Apenas adicionar uma nova lista não remove entradas anteriores. As duas diretivas #clear limpam as listas de configuração existentes antes de definir esta política; elas não deletam arquivos. O manual do apt.conf explica a inicialização de listas e a ordem de leitura dos arquivos de configuração. Não omita aspas, ponto e vírgula ou chaves.

Seleção Efeito Itens a serem julgados separadamente
Correspondência de fonte, codinome e rótulo Permitir apenas candidatos que correspondam a trixie-security Itens em espera devido a dependências e atualizações de outras fontes
Update-Package-Lists 1 Condições de atualização diária da lista Execução do temporizador, rede, status de falha de atualização
Unattended-Upgrade 1 Condições de atualização automática diária Políticas permitidas e logs reais de instalação
Automatic-Reboot false Reinício automático não permitido Reinício dos serviços pelo administrador e reinício programado do sistema
Limpeza automática de pacotes de dependência falsa Escopo de exclusão automática reduzido na prática A revisão manual e a limpeza posterior permanecem como tarefas separadas

Devido a restrições rígidas de origem de segurança, as atualizações podem ser adiadas se as combinações de dependências necessárias não corresponderem. Examine as dependências dos candidatos e as regras de permissão; não libere todos os repositórios externos apenas para eliminar um adiamento. Esta configuração também não constitui uma política para mudar automaticamente para uma nova versão principal do Debian.

Inspecione a simulação e compare o estado dos pacotes

Após salvar, primeiro leia as configurações mescladas e execute uma simulação. A simulação não instala realmente os pacotes, mas pode operar na lista, no cache e nos logs. Execute-a em horários que não coincidam com outras operações de gerenciamento de pacotes e não prossiga forçosamente removendo arquivos de bloqueio.

apt-config dump | grep -E 'Origins-Pattern|Allowed-Origins|Automatic-Reboot|APT::Periodic'
dpkg-query -W -f='${binary:Package}\t${Version}\t${db:Status-Status}\n' | sudo tee /var/backups/lf-debian13-11/packages-before-dry.tsv > /dev/null
sudo unattended-upgrade --dry-run --debug
dpkg-query -W -f='${binary:Package}\t${Version}\t${db:Status-Status}\n' | sudo tee /var/backups/lf-debian13-11/packages-after-dry.tsv > /dev/null
sudo diff -u /var/backups/lf-debian13-11/packages-before-dry.tsv /var/backups/lf-debian13-11/packages-after-dry.tsv

Leia as origens permitidas e os pacotes de destino para verificar se a política de permissão corresponde à intenção. No teste original, apenas candidatos do repositório de segurança permitido foram selecionados, e o tzdata de trixie-updates não foi selecionado. A lista de pacotes permaneceu a mesma antes e depois da simulação. Como frases de resultado como All upgrades installed (todas as atualizações instaladas) podem aparecer no registro da simulação, apenas esta frase não é usada para determinar se os pacotes foram realmente instalados.

O manual do unattended-upgrade explica a opção --dry-run e o caminho do log. Após verificar as configurações, você pode usar sudo unattended-upgrade --verbose durante o tempo de manutenção para executá-lo uma vez de verdade, mas tenha em mente que este comando realmente atualiza os alvos permitidos, portanto não o confunda com o comando dry-run. No teste original, somente a atualização controlada de zlib1g foi realmente aplicada. A parte automática verificou a política e a simulação; ela não comprova a instalação automática de todos os candidatos.

Verifique os temporizadores, os logs e a necessidade de reiniciar

A execução periódica em um ambiente systemd está vinculada ao temporizador APT. Não verifique apenas se o unattended-upgrades.service está habilitado, mas também verifique o temporizador APT e as configurações periódicas.

systemctl is-enabled apt-daily.timer apt-daily-upgrade.timer
systemctl is-active apt-daily.timer apt-daily-upgrade.timer
systemctl cat apt-daily-upgrade.timer
systemctl list-timers --all --no-pager apt-daily.timer apt-daily-upgrade.timer
sudo journalctl -u apt-daily-upgrade.service -b --no-pager -n 50
sudo tail -n 40 /var/log/unattended-upgrades/unattended-upgrades.log

No teste original, apt-daily-upgrade.timer definia um horário às 06:00, um atraso aleatório de até 60 minutos e Persistent=true, para recuperar uma execução perdida quando o temporizador voltasse a ficar ativo. Essas configurações não garantem a conclusão às 06:00: a execução real depende do estado do timer e do sistema. Para habilitar os timers sob a política escolhida, execute sudo systemctl enable --now apt-daily.timer apt-daily-upgrade.timer e verifique a próxima execução agendada e os registros de execução subsequentes.

Se não houver registros, diferencie entre os casos em que ele ainda não foi executado e problemas com o caminho ou permissões do log. Registros detalhados do processo de instalação também podem ser verificados em /var/log/unattended-upgrades/unattended-upgrades-dpkg.log. Se você apenas realizou uma execução de teste, não espere que os logs de instalação reais estejam preenchidos. Mesmo que você tenha configurado notificações por e-mail, é necessário um ambiente separado de envio de e-mails funcionando.

Se você atualizou o pacote do kernel, verifique o kernel em execução separadamente com uname -r. Instalar um novo arquivo de kernel não altera imediatamente o kernel atual. A presença de /run/reboot-required pode ser observada, mas a ausência desse arquivo não significa que todas as reinicializações são desnecessárias. Verifique as condições de aplicação para bibliotecas, serviços e o kernel.

O registro do curso original confirma uma reinicialização bem-sucedida e uma nova conexão SSH após atualizar zlib na VM dedicada. Se houver serviços de produção, não se limite a verificar conexões após a reinicialização; inspecione as respostas dos serviços, o acesso a dados, logs e tarefas agendadas de acordo com os padrões normais de cada serviço.

Interrompa a instalação automática e entenda os limites da recuperação

Para parar temporariamente a instalação automática durante a prática, altere a configuração de APT::Periodic::Unattended-Upgrade "1"; para "0" e consulte novamente o valor combinado. Simplesmente excluir um arquivo personalizado pode fazer com que as configurações ativas de outros arquivos sejam reaplicadas.

sudo nano /etc/apt/apt.conf.d/99-lf-security
apt-config dump | grep 'APT::Periodic::Unattended-Upgrade'

Ao final do teste original, a instalação automática foi definida como 0 para evitar mudanças inesperadas nos exercícios seguintes; os temporizadores foram restaurados ao estado ativo inicial. Em servidores reais, não deixe lacunas na manutenção de segurança e defina o período de parada, a pessoa responsável pelas atualizações manuais e o cronograma.

Ao reverter as configurações para uma política anterior, compare o backup com os arquivos atuais e restaure apenas o escopo que você adicionou. A recuperação da política não significa reverter pacotes já instalados para uma versão anterior. Restaurar um snapshot de uma VM dedicada também pode resultar na perda de alterações subsequentes em configurações, arquivos e dados, portanto, primeiro separe os dados que você deseja preservar e, em servidores de produção, utilize backups verificados e planos de recuperação para cada serviço.