Tutorial do Debian 13 / Diagnosticar erros do APT, dependências, Backports e pinning
Diagnostique erros do APT no Debian 13 verificando os processos que mantêm os bloqueios (locks), o espaço disponível e os inodes, as configurações incompletas do dpkg e, depois, as versões candidatas dos pacotes e dependências. Inspecione o processo real e as alterações propostas em vez de excluir arquivos de bloqueio ou misturar repositórios de outra versão do Debian. Use backports e pinning apenas para uma necessidade definida de seleção de versão após identificar o problema original.
Registre o erro e o estado atual dos pacotes
Não repita cegamente o mesmo comando; registre o comando que falhou e o último erro. Registrar o status do servidor e os logs do APT ajudam a identificar o que mudou e em que momento. A seguir está uma consulta que não altera os pacotes.
cat /etc/os-release
sudo dpkg --audit
apt-mark showhold
df -h / /var
df -i / /var
sudo tail -n 40 /var/log/apt/history.log
sudo tail -n 40 /var/log/dpkg.log
Nenhuma saída de dpkg --audit significa que esta verificação não tem estado de pacote incompleto a relatar; isso não prova que todos os aplicativos funcionam. Um hold é uma marcação que retém um pacote para impedir suas alterações automáticas habituais. Verifique por que ele foi definido antes de removê-lo. Verifique tanto a capacidade em bytes quanto os inodes livres, os objetos do sistema de arquivos necessários para representar arquivos e diretórios. Se /var for um sistema de arquivos separado, inspecione esse sistema de arquivos em vez de assumir que o espaço livre em / é suficiente.
| Dicas de erro | Alvos para verificar primeiro | Não use como atalho |
|---|---|---|
| Could not get lock: não foi possível obter o bloqueio | apt, dpkg, atualizações automáticas em andamento | Excluir arquivo de bloqueio |
| No space left on device: espaço ou inodes esgotados | Espaço e inodes no sistema de arquivos de destino | Excluir arquivos do sistema de causa desconhecida |
| dpkg was interrupted: operação interrompida | Interrupção, resultados de auditoria e logs | Editar arquivos de banco de dados diretamente |
| unmet dependencies / held broken packages: dependências não satisfeitas | Versões candidatas, repositórios, prioridades Pin e marcações hold | Adicionar arbitrariamente repositórios testing ou unstable |
Identifique o processo que mantém o bloqueio
As ferramentas de pacotes usam bloqueios mantidos pelos processos para impedir alterações simultâneas no mesmo banco de dados. Um arquivo de bloqueio existente no disco não prova que um processo atualmente detenha seu bloqueio. O FAQ do Debian dpkg explica por que deletar arquivos de bloqueio não é uma solução correta.
sudo lslocks -u -o PID,COMMAND,TYPE,PATH
systemctl status apt-daily.service apt-daily-upgrade.service --no-pager
sudo journalctl -u apt-daily-upgrade.service -b --no-pager -n 30
lslocks lista os bloqueios e os identificadores de processos (PIDs), e -u impede truncar caminhos longos. Essas opções foram verificadas com util-linux 2.41.5 na VM do curso original. Verifique /var/lib/dpkg/lock-frontend, /var/lib/dpkg/lock e os caminhos de bloqueio de lista e arquivo do APT e compare-os com o PID mostrado no erro.
read -r -p 'PID reported by the error or lock listing: ' lock_pid
ps -fp "$lock_pid"
Se uma atualização normal estiver em andamento, espere até que termine. Não presuma que a instalação parou apenas porque a tela parece congelada; verifique os logs, o status do processo e o tempo de execução juntos. A terminação forçada é uma decisão de recuperação separada que considera a possibilidade de conclusão normal e o alcance do impacto, e kill -9 não é executado como um primeiro passo simples.
No teste original, em vez do bloqueio real do dpkg, um bloqueio de processo foi criado em um arquivo temporário separado. Conflitos com outros processos foram rejeitados e são visíveis em lslocks, e foi confirmado que o bloqueio poderia ser obtido novamente quando fechado sem excluir o arquivo. O teste original não interrompeu uma operação real do dpkg para reproduzir erros.
Examine configurações interrompidas e a correção de dependências
Considere os comandos abaixo somente depois que outras operações de pacotes tiverem sido concluídas e você tiver confirmado que há espaço suficiente, e somente se auditoria e logs indicarem uma configuração interrompida.
sudo dpkg --configure -a
sudo apt-get check
sudo apt-get -s -f install
dpkg --configure -a processa pacotes que foram descompactados mas ainda não configurados. Como scripts de gerenciamento de pacotes e operações de serviços podem ser executados, não é um comando de consulta simples. Se os erros persistirem, leia qual script de pacote falhou e resolva causas relacionadas a disco, configuração ou dependências.
apt-get check inspeciona dependências, e -s -f install simula um plano para corrigir dependências quebradas. Se serviços necessários, kernels ou ferramentas administrativas estiverem incluídos no alvo de remoção, não aprove. Execute somente com sudo apt-get -f install se você compreender o plano e tiver verificado backups e impactos. A VM do teste original estava em estado normal: a verificação e a simulação não propuseram alterações. Esse registro não demonstra a recuperação de um banco de dados corrompido.
Para problemas com candidatos não sendo encontrados, verifique Installed, Candidate e Source com apt-cache policy package-name. Uma versão explicitamente solicitada pode estar ausente do repositório atual. Um pedido prático apt-get -s install tmux=0.invalid.0 foi rejeitado com Version was not found (versão não encontrada), e o pacote não foi instalado. Este erro é diferente de um banco de dados de pacotes corrompido.
Decida se os Backports são necessários
Backports fornece pacotes mais recentes selecionados recompilados para a versão estável, geralmente do Debian testing. Difere de adicionar o repositório testing diretamente. Mantenha o pacote estável quando ele atender às suas necessidades. Antes de escolher uma versão mais nova, identifique o recurso necessário, alterações de dependência, diferenças de configuração e quem irá mantê-lo.
As instruções do Debian Backports recomendam selecionar os pacotes específicos de que você precisa. A FAQ de segurança do Backports descreve correções conforme a disponibilidade dos mantenedores de pacotes, e não o mesmo compromisso de suporte de segurança da versão estável. Não trate os backports como uma política para substituir todo o sistema estável.
A seguir está uma prática comparando candidatos e instalação simulada em uma VM dedicada onde o tmux não está instalado. O tmux é um programa que gerencia múltiplas sessões de trabalho dentro de um terminal. Esta prática não envolve remover ou substituir o tmux operacional existente.
apt-cache policy tmux
sudo test ! -e /etc/apt/sources.list.d/lf-course-backports.sources
sudo test ! -e /etc/apt/preferences.d/lf-course-tmux.pref
sudo nano /etc/apt/sources.list.d/lf-course-backports.sources
Interrompa se qualquer dos arquivos de configuração nomeados já existir ou se o tmux já estiver instalado. Use uma VM de laboratório limpa e separada em vez de remover um pacote tmux operacional para corresponder a este exemplo. Para o novo arquivo, cole a definição completa abaixo. Siga as orientações de backup e deb822 no laboratório de configuração dos repositórios deb822.
Types: deb
URIs: http://deb.debian.org/debian
Suites: trixie-backports
Components: main
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
sudo apt update
apt-cache policy tmux
sudo apt-get -s install tmux
sudo apt-get -s -t trixie-backports install tmux
Na comparação do curso original, a versão estável era 3.5a-3 com prioridade 500, e a versão backports era 3.7c-1~bpo13+1 com prioridade 100. A solicitação padrão usou a versão estável, enquanto a solicitação simulada especificando o ramo de destino com -t selecionou a versão backports. Como o pacote libevent necessário também foi indicado no plano, você não deve apenas ler e aprovar a entrada do tmux. O momento de disponibilidade por versão e arquitetura pode diferir, então baseie-se nos resultados da sua própria política.
Se uma instalação real for necessária, revise todo o plano de dependência e, em seguida, remova -s do comando simulado correspondente. A verificação neste texto foi feita apenas até a comparação de candidatos e instalação simulada, e isso não indica que um novo tmux tenha sido instalado. A opção -t especifica o ramo de destino para essa solicitação, portanto, também pode afetar a seleção de dependências.
Compare candidatos com uma prioridade Pin limitada a um pacote
O pinning ajusta as prioridades de seleção de pacotes ou versões nas preferências do APT. Neste exemplo, o Pin seleciona uma origem pelo codinome; ele não fixa tmux em um número de versão exato. Leia as regras no manual de preferências do APT e aplique-as de forma restrita. Não atribua altas prioridades a todos os pacotes na esperança de que um número maior resolva um problema não relacionado.
sudo nano /etc/apt/preferences.d/lf-course-tmux.pref
Digite as seguintes três linhas em um novo arquivo. O campo Package deve indicar somente tmux; n corresponde ao codinome nos metadados Release.
Package: tmux
Pin: release n=trixie-backports
Pin-Priority: 600
apt-cache policy tmux
sudo apt-get -s install tmux
No teste original, o tmux dos backports foi avaliado em 600, então o candidato para a solicitação regular também mudou para 3.7c. Agora, altere apenas o 600 no mesmo arquivo para 50 e verifique novamente.
sudo nano /etc/apt/preferences.d/lf-course-tmux.pref
apt-cache policy tmux
sudo apt-get -s install tmux
| Condição: tmux não está instalado | Prioridade de backports | Candidato padrão observado |
|---|---|---|
| Nenhum pin do usuário | 100 | Versão estável 3.5a |
| Prioridade Pin de tmux definida como 600 | 600 | backports 3.7c |
| Mesma prioridade Pin reduzida para 50 | 50 | Versão estável 3.5a |
Esta é uma comparação onde um valor é alterado no mesmo repositório e com o mesmo pacote ainda não instalado. Se você já instalou a versão backports, reduzir a prioridade ou remover o repositório não fará o downgrade automaticamente para a versão anterior. Por causa das regras de downgrade e dependências do APT, isso não é determinado apenas por comparação numérica simples. Não force prioridades acima de 1000 apenas para tentar um downgrade.
Remova somente as configurações do exercício e confira o estado
Remova apenas os dois arquivos recém-criados para este laboratório. Inspecione seus caminhos exatos primeiro e preserve quaisquer registros de comparação que você precisar. Deixe inalterados os repositórios existentes e os arquivos de pin de outros administradores.
sudo rm -- /etc/apt/preferences.d/lf-course-tmux.pref
sudo rm -- /etc/apt/sources.list.d/lf-course-backports.sources
sudo apt update
apt-cache policy tmux
sudo dpkg --audit
sudo apt-get check
Na VM do teste original, a limpeza restaurou a versão candidata inicial de tmux. A lista completa de pacotes, versões e estados permaneceu idêntica byte a byte. Se backports foram realmente instalados, apenas essa limpeza não reverterá para o estado anterior à instalação. Se for necessária a recuperação, crie um plano separado baseado nos pacotes e dados alterados.
Os critérios de conclusão para a resolução de erros não são ocultar as mensagens de aviso, mas ser capaz de explicar o processo que mantém o bloqueio, garantir que o espaço necessário e os estados dos pacotes estejam normais e confirmar que as fontes, candidatos e planos de dependência estão conforme o esperado. Após a modificação, verifique novamente as operações que haviam falhado dentro do escopo afetado.




