Tutorial de Debian 13 / Diagnosticar errores de APT, Backports y prioridades Pin
Diagnostique los errores de APT en Debian 13 comprobando los procesos que mantienen los bloqueos, el espacio disponible y los inodos, los estados incompletos de dpkg y después las versiones candidatas y las dependencias. Inspeccione el proceso real y los cambios propuestos en lugar de eliminar archivos de bloqueo o mezclar repositorios de otra versión de Debian. Use backports y pinning solo para una necesidad definida de selección de versión después de identificar el problema original.
Registrar el error y el estado actual del paquete
No repita ciegamente el mismo comando; registre el comando fallido y el último error. Registrar el estado del servidor y los registros de APT ayudan a delimitar cuándo y qué ha cambiado. La siguiente es una consulta que no cambia paquetes.
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
No obtener salida de dpkg --audit significa que esta verificación no tiene un estado de paquete incompleto que informar; no prueba que todas las aplicaciones funcionen. Una marca hold retiene un paquete para impedir sus cambios automáticos habituales. Investigue por qué se definió antes de retirarla. Verifique tanto la capacidad en bytes como los inodos libres, que son los objetos del sistema de archivos necesarios para representar archivos y directorios. Si /var es un sistema de archivos separado, inspeccione ese sistema de archivos en lugar de asumir que el espacio libre en / es suficiente.
| Pistas de error | Objetivos para verificar primero | No usar como un atajo |
|---|---|---|
| Could not get lock: no se pudo obtener el bloqueo | Apt, dpkg, actualizaciones automáticas en curso | Eliminar archivo de bloqueo |
| No space left on device: espacio o inodos agotados | Espacio e inodos en el sistema de archivos de destino | Eliminar archivos del sistema de causa desconocida |
| dpkg was interrupted: operación interrumpida | Interrupción, resultados de auditoría y registros | Editar archivos de base de datos directamente |
| unmet dependencies / held broken packages: dependencias no satisfechas | Versiones candidatas, repositorios, prioridades Pin y marcas hold | Agregar arbitrariamente repositorios testing o unstable |
Identificar el proceso que mantiene un bloqueo
Las herramientas de paquete usan bloqueos mantenidos por procesos para evitar cambios simultáneos en la misma base de datos. La existencia de un archivo de bloqueo en el disco no demuestra que un proceso actualmente sostenga su bloqueo. La Preguntas frecuentes de dpkg de Debian explica por qué borrar archivos de bloqueo no es una solución correcta.
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 muestra los bloqueos y los identificadores de proceso (PID), y -u evita truncar rutas largas. Estas opciones se verificaron con util-linux 2.41.5 en la VM del curso original. Verifique /var/lib/dpkg/lock-frontend, /var/lib/dpkg/lock, y las rutas de bloqueo de la lista y el archivo de APT y compárelas con el PID mostrado en el error.
read -r -p 'PID reported by the error or lock listing: ' lock_pid
ps -fp "$lock_pid"
Si una actualización normal está en progreso, espere hasta que termine. No asuma que la instalación se ha detenido solo porque la pantalla parece congelada; revise los registros, el estado del proceso y el tiempo de ejecución juntos. La terminación forzada es una decisión de recuperación separada que considera la posibilidad de finalización normal y el alcance del impacto, y kill -9 no se ejecuta como un primer paso simple.
En el ensayo original, en lugar del bloqueo real de dpkg, se creó un bloqueo de proceso en un archivo temporal separado. Las colisiones con otros procesos fueron rechazadas y visibles en lslocks, y se confirmó que el bloqueo podía obtenerse nuevamente al cerrarlo sin eliminar el archivo. El ensayo original no interrumpió una operación real de dpkg para reproducir errores.
Examinar configuraciones interrumpidas y reparación de dependencias
Solo revise lo siguiente después de que hayan finalizado otras operaciones de paquetes y haya confirmado que hay suficiente espacio, y solo si la auditoría y los registros indican una configuración detenida.
sudo dpkg --configure -a
sudo apt-get check
sudo apt-get -s -f install
dpkg --configure -a procesa paquetes que están desempaquetados pero aún no configurados. Dado que pueden ejecutarse scripts de gestión de paquetes y operaciones de servicio, no es un comando de consulta simple. Si los errores persisten, lea cuál script del paquete falló y resuelva las causas relacionadas con disco, configuración o dependencias.
apt-get check inspecciona las dependencias, y -s -f install simula un plan para reparar dependencias rotas. Si los servicios requeridos, núcleos o herramientas administrativas están incluidos en el objetivo de eliminación, no lo apruebe. Solo ejecute con sudo apt-get -f install si comprende el plan y ha verificado copias de seguridad e impactos. La VM del ensayo original estaba en estado normal: la comprobación y la simulación no propusieron cambios. Este registro no demuestra una recuperación de una base de datos dañada.
Para problemas con candidatos que no se encuentran, revise Installed, Candidate y Source con apt-cache policy package-name. Una versión solicitada explícitamente puede estar ausente en el repositorio actual. Una solicitud de práctica apt-get -s install tmux=0.invalid.0 fue rechazada con Version was not found (versión no encontrada), y el paquete no se instaló. Este error es diferente a una base de datos de paquetes corrupta.
Decidir si se necesitan Backports
Backports proporciona paquetes más recientes seleccionados reconstruidos para la versión estable, generalmente derivados de Debian testing. Se diferencia de agregar directamente el repositorio testing. Mantenga el paquete estable cuando cumpla con sus necesidades. Antes de elegir una versión más reciente, identifique la función necesaria, los cambios en dependencias, las diferencias de configuración y quién la mantendrá.
Las instrucciones de Debian Backports recomiendan seleccionar los paquetes particulares que necesita. La FAQ de seguridad de Backports describe correcciones según la disponibilidad de los mantenedores de cada paquete, en lugar del mismo compromiso de soporte de seguridad que la versión estable. No trate a los backports como una política para reemplazar todo el sistema estable.
Lo siguiente es una práctica comparando candidatos e instalación simulada en una VM dedicada donde tmux no está instalado. Tmux es un programa que gestiona múltiples sesiones de trabajo dentro de un mismo terminal. Esta práctica no implica eliminar ni reemplazar el tmux operativo 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
Deténgase si alguno de los archivos de configuración nombrados ya existe o si tmux ya está instalado. Use una VM de laboratorio limpia y separada en lugar de eliminar un paquete tmux operativo para coincidir con este ejemplo. Para el archivo nuevo, pegue la definición completa a continuación. Siga la guía de respaldo y deb822 en el laboratorio de configuración de repositorios 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
En la comparación original del curso, la versión estable era 3.5a-3 con prioridad 500, y la versión de backports era 3.7c-1~bpo13+1 con prioridad 100. La solicitud predeterminada utilizó la versión estable, mientras que la solicitud simulada que especificaba la rama de destino con -t seleccionó la versión de backports. Dado que el paquete libevent requerido también se indicó en el plan, no debe limitarse a leer y aprobar la entrada de tmux. El momento de disponibilidad por versión y arquitectura puede diferir, así que decida según la salida real de apt-cache policy en su sistema.
Si se necesita una instalación real, revise todo el plan de dependencias y luego elimine -s del comando simulado correspondiente. La verificación en este texto solo llegó hasta la comparación de candidatos y la instalación simulada, y no indica que se haya instalado un nuevo tmux. La opción -t especifica la rama objetivo para esa solicitud, por lo que también puede afectar la selección de dependencias.
Comparar candidatos con una prioridad Pin limitada a un paquete
El pinning ajusta las prioridades de selección de paquetes o versiones en las preferencias de APT. En este ejemplo, Pin selecciona un origen por su nombre en clave; no fija tmux en un número de versión exacto. Lea las reglas en el manual de preferencias de APT y aplíquelas de manera limitada. No asigne altas prioridades a todos los paquetes con la esperanza de que un número mayor resuelva un problema no relacionado.
sudo nano /etc/apt/preferences.d/lf-course-tmux.pref
Ingrese las siguientes tres líneas en un archivo nuevo. El campo Package debe indicar solo tmux; n corresponde al nombre en clave en los metadatos Release.
Package: tmux
Pin: release n=trixie-backports
Pin-Priority: 600
apt-cache policy tmux
sudo apt-get -s install tmux
En el ensayo original, tmux de backports se evaluó en 600, por lo que el candidato para la solicitud regular también cambió a 3.7c. Ahora cambie solo el 600 en el mismo archivo a 50 y vuelva a verificar.
sudo nano /etc/apt/preferences.d/lf-course-tmux.pref
apt-cache policy tmux
sudo apt-get -s install tmux
| Condición: tmux no está instalado | Prioridad de backports | Candidato predeterminado observado |
|---|---|---|
| Sin pin del usuario | 100 | Versión estable 3.5a |
| Prioridad Pin de tmux definida como 600 | 600 | backports 3.7c |
| Cambiar el mismo pin a 50 | 50 | Versión estable 3.5a |
Esta es una comparación donde un valor se cambia en el mismo repositorio y el mismo paquete no instalado. Si ya ha instalado la versión backports, reducir la prioridad o eliminar el repositorio no restaurará automáticamente la versión anterior. Debido a las reglas de degradación y dependencias de APT, no se determina por una simple comparación numérica. No fuerce prioridades por encima de 1000 simplemente para intentar una degradación.
Eliminar solo la configuración del laboratorio y comprobar el estado
Elimine únicamente los dos archivos creados recientemente para este laboratorio. Inspeccione primero sus rutas exactas y conserve cualquier registro de comparación que necesite. Deje sin cambios los repositorios existentes y los archivos pin de otros 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
En la VM del ensayo original, la limpieza restauró la versión candidata inicial de tmux. La lista completa de paquetes, versiones y estados permaneció idéntica byte a byte. Si realmente se instalaron backports, esta limpieza por sí sola no revertirá al estado anterior a la instalación. Si se necesita recuperación, cree un plan separado basado en los paquetes y datos modificados.
Los criterios de finalización para resolver errores no consisten en ocultar los mensajes de advertencia, sino en poder explicar quién posee el bloqueo, asegurarse de que el espacio requerido y los estados del paquete sean normales, y confirmar que las fuentes, los candidatos y los planes de dependencias sean los previstos. Después de la modificación, vuelva a verificar las tareas que originalmente fallaron dentro del alcance afectado.




