Debian 13 : tutoriel / Diagnostiquer les erreurs APT et comparer Backports et les priorités Pin

Pour diagnostiquer une erreur APT sous Debian 13, vérifiez les processus détenant les verrous, l’espace et les inodes disponibles, les configurations dpkg inachevées, puis les versions candidates et leurs dépendances. Examinez le processus réel et le plan proposé ; ne supprimez pas les fichiers de verrouillage et ne mélangez pas des dépôts d’autres versions de Debian pour contourner l’erreur. Backports et les priorités Pin répondent à un besoin précis de sélection de version, après identification du problème initial.

Enregistrer l'erreur et l'état actuel des paquets

Ne répétez pas aveuglément la même commande ; enregistrez la commande échouée et la dernière erreur. L'enregistrement du statut du serveur et des journaux APT aident à déterminer ce qui a changé et à quel moment. La requête suivante ne modifie pas les paquets.

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

Aucune sortie de dpkg --audit signifie que cette vérification n'a aucun état de paquet incomplet à signaler ; cela ne prouve pas que toutes les applications fonctionnent. Un hold est un marquage qui retient un paquet pour empêcher ses changements automatiques habituels. Vérifiez pourquoi il a été défini avant de le retirer. Vérifiez à la fois la capacité en octets et les inodes libres, les objets du système de fichiers nécessaires pour représenter les fichiers et les répertoires. Si /var est un système de fichiers séparé, inspectez ce système de fichiers plutôt que de supposer que l'espace libre sur / est suffisant.

Indices d'erreur Cibles à vérifier en premier Ne pas utiliser comme raccourci
Could not get lock : impossible d’obtenir le verrou apt, dpkg, mises à jour automatiques en cours Supprimer le fichier de verrou
No space left on device : espace ou inodes épuisés Espace et inodes sur le système de fichiers cible Supprimer des fichiers système d'une cause inconnue
dpkg was interrupted : opération interrompue Interruption, résultats de l'audit et journaux Modifier directement les fichiers de la base de données
unmet dependencies / held broken packages : dépendances non satisfaites Versions candidates, dépôts, priorités Pin et marquages hold Ajouter arbitrairement des dépôts de test ou instables

Identifier le processus tenant un verrou

Les outils de gestion de paquets utilisent des verrous détenus par les processus pour empêcher des modifications simultanées de la même base de données. La présence d'un fichier de verrou sur le disque ne prouve pas qu'un processus détient actuellement ce verrou. La FAQ Debian dpkg explique pourquoi la suppression des fichiers de verrou n'est pas une solution correcte.

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 liste les verrous détenus et les identifiants de processus (PID), et -u empêche le tronquage des chemins longs. Ces options ont été vérifiées avec util-linux 2.41.5 dans la VM du cours d’origine. Vérifiez /var/lib/dpkg/lock-frontend, /var/lib/dpkg/lock, ainsi que les chemins de verrouillage de la liste et de l'archive APT et comparez-les avec le PID affiché dans l'erreur.

read -r -p 'PID reported by the error or lock listing: ' lock_pid
ps -fp "$lock_pid"

Si une mise à jour normale est en cours, attendez qu'elle se termine. Ne supposez pas que l'installation s'est arrêtée simplement parce que l'écran semble figé ; vérifiez les journaux, le statut du processus et le temps d'exécution ensemble. La terminaison forcée est une décision de récupération distincte qui prend en compte la possibilité d'une complétion normale et l'étendue de l'impact, et kill -9 n'est pas exécuté comme une première étape simple.

Dans le test du cours d’origine, au lieu du verrou dpkg réel, un verrou de processus a été créé sur un fichier temporaire séparé. Les collisions avec d'autres processus ont été rejetées et visibles dans lslocks, et il a été confirmé que le verrou pouvait être obtenu à nouveau lorsqu'il était fermé sans supprimer le fichier. Nous n'avons pas intentionnellement interrompu une opération dpkg en cours pour reproduire des erreurs.

Examiner une configuration interrompue et la réparation des dépendances

Ne passez en revue ce qui suit qu'après la fin des autres opérations de paquet et après avoir confirmé qu'il y a suffisamment d'espace, et uniquement si l'audit et les journaux indiquent une configuration arrêtée.

sudo dpkg --configure -a
sudo apt-get check
sudo apt-get -s -f install

dpkg --configure -a traite les paquets qui sont décompressés mais non encore configurés. Comme les scripts de gestion de paquet et les opérations de service peuvent s'exécuter, ce n'est pas une simple commande de requête. Si les erreurs persistent, lisez quel script de paquet a échoué et résolvez les causes liées au disque, à la configuration ou aux dépendances.

apt-get check examine les dépendances, et -s -f install simule un plan pour réparer les dépendances cassées. Si les services requis, les noyaux ou les outils administratifs sont inclus dans la cible de suppression, ne l'approuvez pas. Exécutez uniquement avec sudo apt-get -f install si vous comprenez le plan et avez vérifié les sauvegardes et les impacts. La VM du test d’origine était dans un état normal : le contrôle et la simulation n’ont proposé aucun changement. Ce relevé ne démontre pas la réparation d’une base de données endommagée.

Pour les problèmes où les candidats ne sont pas trouvés, vérifiez Installed, Candidate et Source avec apt-cache policy package-name. Une version explicitement demandée peut être absente du dépôt actuel. Une demande de pratique apt-get -s install tmux=0.invalid.0 a été rejetée avec Version was not found (version introuvable), et le paquet n'a pas été installé. Cette erreur est différente d'une base de données de paquets corrompue.

Déterminer si des paquets Backports sont nécessaires

Backports fournit une sélection de paquets plus récents recompilés pour la version stable, généralement issus de Debian testing. Cela diffère de l'ajout direct du dépôt testing. Conservez le paquet stable lorsque celui-ci répond à vos besoins. Avant de choisir une version plus récente, identifiez les fonctionnalités nécessaires, les changements de dépendances, les différences de configuration et qui assurera la maintenance.

Les instructions Debian Backports recommandent de sélectionner les paquets particuliers dont vous avez besoin. La FAQ de sécurité Backports décrit des correctifs fournis selon les moyens des mainteneurs, sans le même engagement de suivi de sécurité que pour stable. Ne considérez pas les rétroportages comme une politique de remplacement de l'ensemble du système stable.

Ce qui suit est un exercice comparant des candidats et une installation simulée sur une VM dédiée où tmux n'est pas installé. Tmux est un programme qui gère plusieurs sessions de travail au sein d'un même terminal. Cet exercice n'implique pas de supprimer ou de remplacer le tmux opérationnel existant.

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

Arrêtez si l'un des fichiers de configuration nommés existe déjà ou si tmux est déjà installé. Utilisez une VM de laboratoire propre et séparée plutôt que de supprimer un paquet tmux utilisé en exploitation pour correspondre à cet exemple. Pour le nouveau fichier, collez la définition complète ci-dessous. Suivez les instructions de sauvegarde et deb822 dans le laboratoire de configuration des dépôts 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

Dans la comparaison du cours d’origine, la version stable était 3.5a-3 avec une priorité de 500, et la version backports était 3.7c-1~bpo13+1 avec une priorité de 100. La demande par défaut utilisait la version stable, tandis que la demande simulée spécifiant la branche cible avec -t sélectionnait la version backports. Puisque le paquet libevent requis était également indiqué dans le plan, vous ne devez pas simplement lire et approuver l'entrée tmux. Le moment de disponibilité selon la version et l'architecture peut différer, donc basez-vous sur les résultats de votre propre politique.

Si une installation réelle est nécessaire, passez en revue l'ensemble du plan de dépendances, puis retirez -s de la commande simulée correspondante. La vérification dans ce texte ne s'est limitée qu'à la comparaison des candidats et à l'installation simulée, et cela n'indique pas qu'un nouveau tmux a été installé. L'option -t spécifie la branche cible pour cette requête, elle peut donc également affecter la sélection des dépendances.

Comparer les candidats avec une priorité Pin limitée à un paquet

Le pinning ajuste la priorité de sélection des paquets ou de leurs versions dans les préférences APT. Cet exemple sélectionne une origine par son nom de code ; il ne verrouille pas tmux sur un numéro de version précis. Lisez les règles dans le manuel des préférences APT et appliquez-les de manière limitée. N'attribuez pas de haute priorité à chaque paquet dans l'espoir qu'un nombre plus important résolve un problème non lié.

sudo nano /etc/apt/preferences.d/lf-course-tmux.pref

Entrez les trois lignes suivantes dans un nouveau fichier. Le champ Package ne doit désigner que tmux ; n correspond au nom de code dans les métadonnées Release.

Package: tmux
Pin: release n=trixie-backports
Pin-Priority: 600
apt-cache policy tmux
sudo apt-get -s install tmux

Dans le test d’origine, tmux provenant des backports a été évalué à 600, donc le candidat pour la demande régulière est également passé à 3.7c. Changez maintenant uniquement le 600 dans le même fichier à 50 et vérifiez à nouveau.

sudo nano /etc/apt/preferences.d/lf-course-tmux.pref
apt-cache policy tmux
sudo apt-get -s install tmux
Condition : tmux reste non installé Priorité des backports Candidat par défaut observé
Aucune priorité Pin personnalisée 100 Version stable 3.5a
Priorité Pin de tmux fixée à 600 600 backports 3.7c
Même priorité Pin ramenée à 50 50 Version stable 3.5a

Ceci est une comparaison où une valeur est modifiée dans le même dépôt et le même paquet non installé. Si vous avez déjà installé la version backports, baisser la priorité ou supprimer le dépôt ne fera pas automatiquement rétrograder à la version précédente. En raison des règles de rétrogradation et des dépendances d'APT, cela n'est pas déterminé par une simple comparaison numérique. Ne forcez pas des priorités supérieures à 1000 simplement pour tenter une rétrogradation.

Supprimez uniquement les paramètres du laboratoire et revérifiez l'état

Supprimez uniquement les deux fichiers nouvellement créés pour ce laboratoire. Inspectez d'abord leurs chemins exacts et conservez tous les enregistrements de comparaison nécessaires. Laissez intacts les dépôts existants et les fichiers pin des autres administrateurs.

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

Dans la VM du test d’origine, le nettoyage a rétabli la version candidate initiale de tmux. La liste complète des paquets, versions et états est restée identique octet par octet. Si des backports ont réellement été installés, ce nettoyage seul ne ramènera pas l'état d'avant l'installation. Si une récupération est nécessaire, créez un plan séparé basé sur les paquets et les données modifiés.

Les critères de réussite pour résoudre les erreurs ne consistent pas à masquer les messages d'avertissement, mais à être capable d'expliquer le détenteur du verrou, à s'assurer que l'espace requis et les états des paquets sont normaux, et à confirmer que les sources, les candidats et les plans de dépendance sont tels qu'ils sont prévus. Après modification, re-vérifiez les tâches initialement échouées dans le périmètre affecté.