Tutorial do Rocky Linux 10 / Resolver erros de pacotes e usar o histórico DNF

Erros de pacotes no Rocky Linux 10 devem ser resolvidos após distinguir entre problemas com nomes, repositórios, metadados, dependências e arquivos de instalação. O histórico do DNF é usado para investigar o que mudou e reverter operações específicas de pacotes, mas não é um backup que restaura dados do usuário ou todo o servidor para um estado anterior.

Colete primeiro as mensagens de erro e o status atual

Quando ocorrer um erro, registre o comando inicialmente executado antes de repeti-lo ou adicionar opções forçadas, a mensagem de erro completa, o status de saída e o status atual da instalação. Se a conexão SSH for desconectada no meio do processo, a instalação real do pacote pode ter sido concluída, então verifique primeiro o estado salvo.

cat /etc/rocky-release
dnf --version
rpm -q tree
dnf repolist --enabled
sudo dnf history list
sudo dnf check

DNF (Dandified YUM) é uma ferramenta para gerenciar pacotes e dependências em repositórios, enquanto RPM (RPM Package Manager) é uma ferramenta fundamental para gerenciar informações e arquivos de pacotes instalados. O ambiente de laboratório de origem registrado era Rocky Linux 10.2, DNF 4.20.0 e RPM 4.19.1.1. O repositório padrão foi usado em uma máquina virtual (VM) dedicada, e o tree não estava instalado no início. dnf check verifica problemas de consistência, como as dependências de pacotes instalados, e o fato de não haver saída não significa que todos os serviços ou dados do usuário foram inspecionados.

Indícios representativos Problemas a distinguir primeiro
Nenhuma correspondência para o argumento Se o nome, versão e arquitetura estão corretos, e se o repositório necessário os fornece
Erros de metadados, espelho ou resolução de nome Rede, DNS, tempo, proxy, cache e status do repositório
Nada fornece, solicitações conflitantes Dependências necessárias, versões atualmente instaladas, combinações de repositório
Erros de chave de assinatura ou certificado Fonte precisa e chave oficial·tempo do sistema·verificação de certificado
Arquivos executáveis ou documentos ausentes Status da instalação·relações de propriedade de pacotes·diferenças reais de arquivos

Se for um erro de bloqueio, primeiro verifique se outra operação DNF·RPM ou atualização automática está em execução e espere ela terminar. Não faça a exclusão de arquivos de bloqueio, banco de dados RPM de forma arbitrária ou a finalização forçada de operações normais como a primeira solução.

Separe erros de nome e problemas de repositório·dependência

No laboratório de origem, uma consulta deliberada usou um nome de pacote de prática inexistente para reproduzir o seguinte erro. --assumeno não está aprovado para instalação.

sudo dnf --assumeno install lf-course-missing-package-20261112
No match for argument: lf-course-missing-package-20261112
Error: Unable to find a match: lf-course-missing-package-20261112

Neste ponto, o status de saída era 1. Verifique o nome real do pacote e a fonte de acordo com o erro.

dnf search tree
dnf info tree
dnf provides /usr/bin/tree
dnf repoquery --requires --resolve tree
sudo dnf --assumeno install tree

No mesmo ambiente, o tree foi confirmado como candidato para 2.1.0-8.el10.x86_64 no BaseOS, e havia um plano de instalação. Esta comparação é um teste para distinguir entre nomes usados incorretamente e candidatos normais. Se o pacote necessário existir apenas em um repositório adicional, use o guia dos repositórios para verificar sua função, status de habilitação e combinações suportadas. Simplesmente corrigir o nome não resolve todos os conflitos de dependência.

Para nothing provides, identifique a biblioteca ou capacidade ausente e o pacote que a requer. Verifique a versão principal do SO, a compatibilidade do repositório e candidatos em conflito. Não ignore dependências com a opção RPM --nodeps, não desative a verificação de assinaturas e não aplique --allowerasing do DNF indiscriminadamente. Revise cada remoção proposta e os serviços afetados antes de aprovar uma solução.

Aplique a limpeza do cache de acordo com a causa que você identificou.

Se a lista estiver antiga ou não puder ser consultada devido a limites de cache, primeiro verifique novamente os metadados do repositório atual.

sudo dnf --refresh info tree

No exercício de consulta de pacotes, a consulta falhou devido à falta de cache para a lista de arquivos necessária para dnf -C provides, mas quando -C foi excluído e uma consulta normal foi realizada, as informações necessárias foram obtidas. A falha ao consultar usando apenas o cache e a ausência do pacote no repositório são problemas diferentes.

Consulte o manual oficial de comandos DNF, onde clean expire-cache expira os metadados em cache para revalidação, clean metadata tem seus metadados removidos para que possam ser baixados novamente depois, e clean all limpa múltiplos caches de uma vez. Portanto, se você limpar o cache inteiro toda vez, pode apenas aumentar os downloads sem resolver a causa.

Se for detectada corrupção de metadados e a limpeza for necessária, selecione a faixa necessária como uma reconsulta de sudo dnf clean metadata e um repositório normal. Para a prática neste artigo, o cache normal não foi intencionalmente excluído, nem as verificações de repositório ou certificado foram enfraquecidas.

Encontre arquivos ausentes com RPM e restaure-os por meio da reinstalação.

Consultar o proprietário e verificar os arquivos de instalação são tarefas diferentes. rpm -qf encontra o pacote proprietário, enquanto rpm -V compara os atributos registrados no banco de dados de instalação com os arquivos atuais. O significado também pode ser confirmado em referência oficial do comando RPM , e os passos abaixo foram testados no RPM 4.19.1.1 nesta VM.

A reprodução a seguir é realizada apenas em uma VM dedicada sem dados de trabalho. Não mova arquivos deliberadamente em servidores que já utilizam tree para imitar esta falha. Primeiro, revise o plano de instalação, instale o tree e registre o ID real da transação de instalação.

sudo dnf --assumeno install tree
sudo dnf install tree
sudo dnf history info last
rpm -qf /usr/share/doc/tree/README
rpm -V tree

O ID de instalação nesta VM para esta sessão foi 6, e um tree foi instalado. Os IDs diferem em outros computadores. A reprodução abaixo move apenas um documento README pertencente a este pacote em vez de arquivos executáveis ou configurações de serviço. Se não for a versão esperada, documento ou novo local de backup, pare antes de fazer alterações.

sudo bash <<'BASH'
set -eu
test "$(rpm -qf /usr/share/doc/tree/README)" = tree-2.1.0-8.el10.x86_64
test -f /usr/share/doc/tree/README
test ! -e /root/lf-course-12-before
mkdir -m 700 /root/lf-course-12-before
mv -- /usr/share/doc/tree/README /root/lf-course-12-before/tree-README
BASH
rpm -V tree
printf 'verify exit=%s\n' "$?"

Se a sua versão for diferente ou uma pasta de backup já existir, as verificações de condição acima não são removidas para forçar a aprovação. Verifique novamente o caminho do arquivo e o status de preparação da prática. Nesta VM, os seguintes resultados e o status de saída 1 foram confirmados.

missing   d /usr/share/doc/tree/README

missing significa que um arquivo registrado no pacote está ausente do sistema de arquivos, e d indica um arquivo de documento. rpm -V apenas relata o problema e não restaura o conteúdo deste documento. Verifique se as alterações ou omissões reais foram intencionais e, em seguida, leia o plano de reinstalação.

sudo dnf --assumeno reinstall tree
sudo dnf reinstall tree
sudo cmp /root/lf-course-12-before/tree-README /usr/share/doc/tree/README
rpm -V tree
printf 'verify exit=%s\n' "$?"

Esta prática reinstalou a mesma versão do pacote tree fornecida pelo BaseOS. Os documentos recuperados eram idênticos ao backup, cmp terminou sem quaisquer diferenças, e a verificação do RPM também retornou 0 sem saída. Para reinstalar, você deve obter o RPM da versão exata atualmente instalada a partir da fonte. Arquivos de configuração podem ser tratados separadamente de acordo com a política de substituição de pacotes, portanto, comandos que sempre sobrescrevem as configurações operacionais com os originais não são generalizados.

Se a reinstalação falhar e o documento ainda estiver ausente, você pode copiar o backup /root/lf-course-12-before/tree-README feito nesta prática para o caminho original /usr/share/doc/tree/README, preservando os atributos, e verificar novamente. Mesmo neste caso, verifique primeiro se o alvo está realmente ausente para evitar sobrescrever outras alterações. Como a recuperação real neste caso foi bem-sucedida, o caminho para recopiação do backup não foi executado.

Leia as colunas de histórico e os registros detalhados juntos.

sudo dnf history list tree
sudo dnf history info last

Esta instalação foi registrada com ID 6, e a reinstalação foi registrada com ID 7. A(s) Ação(ões) para a reinstalação foi R e Alterado foi 2, mas o Reinstalar e Reinstalado na lista detalhada eram ações de substituição do mesmo pacote tree. Interpretar Alterado 2 como significando que dois programas diferentes foram instalados leva a uma conclusão incorreta.

Itens a Verificar Conteúdo a Interpretar
ID · Linha de comando · Hora Qual comando foi executado quando, e se ele corresponde à mudança atualmente em investigação
Ação(ões) Tipos de ações realizadas, como instalar, atualizar, remover, reinstalar
Alterado · Símbolo Adicional Número de ações de alteração e dicas adicionais de status. Compare com a lista detalhada de pacotes
Código de Retorno · Pacotes Alterados Status resultante e os pacotes realmente alterados · versão · fonte
Saída do scriptlet Orientações ou avisos deixados pelos scripts dos pacotes executados durante a instalação ou remoção

A coluna * para Altered pode indicar transações incompletas, # indica tarefas que terminaram em um estado diferente de zero, e E pode indicar conclusão bem-sucedida, mas com avisos ou saídas de erro. Em históricos reais de instalação de configuração do EPEL, a marca E também era visível, mas o Código de Retorno detalhado era Sucesso e o guia do script poderia ser verificado. Não conclua falha geral de instalação ou comprometimento com base em apenas um símbolo.

Indicadores de status do banco de dados como < e > também fornecem pistas para comparar ações anteriores e subsequentes e todo o histórico. Não olhe apenas para a lista filtrada pelo nome do pacote; se necessário, verifique todo o sudo dnf history list e registros detalhados para o ID relevante. Não assuma que comandos com falha são registrados no histórico da mesma forma que transações bem-sucedidas; as saídas de erro originais também devem ser mantidas.

Desfaça uma transação de instalação verificada

Este exercício reverte a instalação de um único pacote tree que foi realizada em uma VM que inicialmente não possuía tree instalado. Além disso, crie uma anotação de usuário para verificar se ela permanece separada da tarefa do pacote. Se um arquivo com o mesmo nome existir, não o substitua; use um caminho de prática novo diferente.

test ! -e ~/history-lab-note.txt && printf 'keep my notes\n' > ~/history-lab-note.txt
cat ~/history-lab-note.txt
sudo dnf history list tree

Na lista, encontre a transação isolada de instalação do pacote tree para este laboratório. Use seu ID real, não o valor de exemplo do laboratório de origem que é 6.

read -r -p 'Verified tree installation ID: ' TXID
if [[ "$TXID" =~ ^[1-9][0-9]*$ ]]; then
    sudo dnf history info "$TXID"
    sudo dnf --assumeno history undo "$TXID"
else
    printf 'Enter a positive numeric transaction ID. Stop and check the history.\n' >&2
    unset TXID
fi

Verifique se o registro detalhado mostra a instalação pretendida e apenas o pacote tree a ser removido no plano de reversão. Não é aprovado se outros programas ou pacotes de configuração estiverem incluídos, ou se for tree já em uso na inicialização. O plano de reversão para o ID 6 desta VM foi Remove 1 Package e tree, e foi aplicado após revisão.

sudo dnf history undo "${TXID:?Read and verify a positive numeric transaction ID first}"
rpm -q tree
cat ~/history-lab-note.txt
sudo dnf history info last
sudo dnf check

No resultado atual, tree voltou ao estado desinstalado, e a operação de reversão do ID 8 permaneceu como Sucesso. A nota do usuário keep my notes permaneceu inalterada. Ou seja, a operação inversa da instalação foi realizada, mas os arquivos criados pelo usuário não foram revertidos ao passado. Após verificação, apenas as notas criadas pessoalmente foram organizadas como rm -- ~/history-lab-note.txt.

O teste de origem registrado desfez apenas a instalação verificada apenas do pacote tree. Configurações anteriores do EPEL, atualizações do sistema operacional e outras transações não foram revertidas juntamente, nem foi realizado um rollback completo do servidor. Na verdade, arquivos existentes no repositório, SSH, SELinux Enforcing e o kernel em execução mais recente foram preservados.

Distinguir o escopo e os limites de recuperação de desfazer, refazer e rollback.

Tarefas de histórico Escopo e Precauções
history undo ID Tenta a ação inversa das operações incluídas na transação especificada.
history redo ID Tenta novamente as ações da transação especificada no estado atual.
history rollback ID Como este é o escopo de reverter várias transações após o ID especificado, seu impacto é mais amplo do que desfazer uma única ação.

Os comandos de histórico são limitados pelo estado atual da instalação e pela disponibilidade de pacotes. Se a versão na época tiver desaparecido do repositório ou se as dependências tiverem mudado, pode não ser possível reverter. O simples fato de um antigo ID DNF existir não significa que os RPMs e os dados de serviço necessários para a restauração estão preservados.

Alterações externas feitas por scripts de pacotes, esquemas de banco de dados, dados de usuários e configurações modificadas diretamente devem ser tratadas através dos procedimentos de recuperação e backups da aplicação. Particularmente, antes de reverter um pacote principal do SO ou uma atualização em larga escala para um único número de versão, revise os métodos de recuperação suportados e os possíveis impactos. Um pequeno sucesso em desfazer um pacote neste exercício não garante recuperação em todos os servidores.

Os critérios de conclusão para a resolução de problemas não se limitam a verificar se a mensagem de erro desapareceu. Você precisa checar se o pacote, a versão, o arquivo e o status das dependências pretendidos estão corretos, se os serviços e dados afetados estão normais, e registrar quais mudanças foram realmente feitas.