Cómo solucionar fallos comunes en la gestión de paquetes (APT/YUM)

Los fallos del gestor de paquetes suelen llegar en el peor momento: durante una actualización de seguridad, un despliegue o una sesión rápida de "solo instala esta herramienta" en un host que normalmente no tocas. APT, YUM y DNF suelen indicar qué está mal, pero la salida puede ser ruidosa. La tarea es reducir la velocidad, identificar qué capa falló y evitar forzar la base de datos a un estado peor.

APT es común en sistemas Debian y Ubuntu. YUM y DNF son comunes en sistemas de la familia Red Hat, y DNF reemplaza a YUM en muchas versiones más recientes. Los ejemplos a continuación se centran en los fallos que los administradores realmente ven: transacciones rotas, problemas de metadatos del repositorio, conflictos de dependencias, bloqueos, errores GPG y problemas en la base de datos de paquetes.

Antes de cambiar algo, capture el comando exacto y el error. Si es un servidor de producción, verifique también si hay otro proceso de actualización en ejecución. Dos gestores de paquetes compitiendo por la misma base de datos pueden convertir un problema pequeño en una reparación larga.

Fallos comunes de APT y solución de problemas

APT es conocido por sus capacidades integrales de resolución de dependencias. Sin embargo, aún pueden surgir problemas, a menudo relacionados con dependencias rotas, descargas interrumpidas o problemas de repositorio.

1. Paquetes rotos o dependencias no satisfechas

Este es quizás el error más común de APT. Ocurre cuando un paquete está instalado, pero sus dependencias faltan, están rotas o son incompatibles. El mensaje de error a menudo se ve así:

Error: dpkg was interrupted, you might need to run 'sudo dpkg --configure -a' to correct the problem.

Unpacking ... (reading database ... xxxx files and directories currently installed.)

Preparing to unpack .../some-package_version_arch.deb ...

Unpacking some-package (version) ...

dpkg: error processing archive /var/cache/apt/archives/some-package_version_arch.deb (--unpack):

 trying to overwrite '/path/to/file', which is also in package other-package:amd64

Errors were encountered while processing:

 some-package
 E: Sub-process /usr/bin/dpkg returned an error code (1)

Pasos para solucionar problemas:

Configurar paquetes pendientes: Si dpkg fue interrumpido, el primer paso es intentar solucionarlo:
```
sudo dpkg --configure -a
```
Este comando intenta configurar todos los paquetes que están desempaquetados pero aún no configurados.
Reparar dependencias rotas: Si lo anterior no lo resuelve, puede intentar reparar las dependencias rotas:
```
sudo apt --fix-broken install
```
Este comando intentará descargar e instalar las dependencias faltantes o eliminar los paquetes problemáticos.
Eliminar paquetes problemáticos: A veces, un paquete específico puede causar problemas persistentes. Puede intentar eliminarlo:
```
sudo apt remove <nombre-del-paquete>
```
Si el paquete no se puede eliminar normalmente, es posible que deba forzar su eliminación (úsese con precaución):
```
sudo dpkg --remove --force-remove-reinstreq <nombre-del-paquete>
```
Limpiar la caché de APT: Una caché corrupta también puede provocar errores:
```
sudo apt clean
sudo apt update
```
apt clean elimina los archivos de paquetes descargados de /var/cache/apt/archives/, y apt update actualiza la lista de paquetes.

2. Problemas de repositorio

Pueden ocurrir errores si no se pueden recuperar las listas de paquetes de los repositorios configurados. Esto puede deberse a problemas de red, una URL de repositorio no válida o que el repositorio no esté disponible temporalmente.

Ejemplos de error:

E: Failed to fetch http://archive.ubuntu.com/ubuntu/dists/jammy/InRelease  Temporary failure resolving 'archive.ubuntu.com'
E: Some index files failed to download. They have been ignored, or old ones used instead.

Pasos para solucionar problemas:

Verificar DNS y conectividad de red: Los fallos de DNS son comunes en servidores recién creados y rutas VPN rotas.
```
getent hosts archive.ubuntu.com
curl -I http://archive.ubuntu.com/ubuntu/
```
Verificar las fuentes del repositorio: Verifique el contenido de /etc/apt/sources.list y los archivos en /etc/apt/sources.list.d/. Asegúrese de que las URL sean correctas y accesibles.
- Busque errores tipográficos.
- Comente o elimine las entradas de repositorio sospechosas.
Probar con un mirror diferente: Si un mirror específico está caído, APT podría probar automáticamente con otro. Si no, edite manualmente sources.list para seleccionar un mirror diferente.
Actualizar las listas de paquetes: Después de realizar cualquier cambio, ejecute siempre:
```
sudo apt update
```

Si apt update se queja de las firmas, no deshabilite la verificación de firmas como atajo. La firma del repositorio lo protege de instalar paquetes manipulados. Verifique si el proveedor del repositorio cambió su clave, si el paquete keyring está desactualizado o si un repositorio de terceros antiguo ya no se mantiene.

3. Instalaciones o actualizaciones interrumpidas

Si un proceso de apt install o apt upgrade se interrumpe (por ejemplo, por un corte de energía o reinicio del sistema), puede dejar el sistema en un estado inconsistente.

Pasos para solucionar problemas:

Ejecutar sudo dpkg --configure -a: Como se mencionó anteriormente, este es el primer paso para intentar solucionar cualquier problema de configuración de dpkg.
Ejecutar sudo apt --fix-broken install: Esto puede resolver problemas de dependencia que surgen de la interrupción.
Volver a ejecutar el comando: A veces, simplemente volver a ejecutar el comando que falló puede resolver el problema si fue un problema transitorio.

Fallos comunes de YUM/DNF y solución de problemas

YUM y DNF son herramientas potentes para gestionar paquetes en sistemas basados en Red Hat. Al igual que APT, los fallos a menudo se deben a problemas de dependencia, problemas de repositorio o caché corrupta.

1. Errores de dependencia

Los errores de dependencia en YUM/DNF ocurren cuando un paquete solicitado requiere otro paquete que no está instalado, es una versión incompatible o no se puede encontrar en los repositorios configurados.

Ejemplo de error (YUM):

Error: Package: some-package-1.0-1.el8.x86_64 (epel)

Requires: another-package >= 2.0

You could try: rpm -e --nodeps some-package

Ejemplo de error (DNF):

Error: 
 Problem: cannot install the best candidate for this package (root means installing process)
  - nothing provides dependency 'another-package >= 2.0' needed by 'some-package-1.0-1.el8.x86_64'

Pasos para solucionar problemas:

Actualizar la información del paquete: Asegúrese de que su caché local de paquetes esté actualizada:
```
sudo yum makecache # Para YUM
sudo dnf makecache # Para DNF
```
Instalar dependencias manualmente: Si conoce la dependencia requerida, intente instalarla explícitamente:
```
sudo yum install another-package # Para YUM
sudo dnf install another-package # Para DNF
```

Usar herramientas de limpieza con cuidado: Estas utilidades a veces pueden ayudar a identificar paquetes duplicados o huérfanos.

sudo yum install yum-utils
sudo package-cleanup --cleandupes # Limpiar paquetes duplicados
sudo package-cleanup --orphans # Eliminar paquetes huérfanos

sudo dnf install dnf-plugins-core
sudo dnf clean all

Evitar rpm -e --nodeps a menos que tenga un plan de reversión: Puede eliminar un paquete dejando los paquetes dependientes instalados, lo que puede satisfacer el comando pero romper el sistema.

2. Problemas de configuración del repositorio

Los problemas con los repositorios de YUM/DNF pueden impedir que se encuentren o instalen paquetes.

Pasos para solucionar problemas:

Verificar archivos de repositorio: Las definiciones de repositorio generalmente se encuentran en /etc/yum.repos.d/. Examine estos archivos .repo para:
- Entradas baseurl o mirrorlist correctas.
- Repositorios habilitados (enabled=1).
- Problemas de verificación de clave GPG (a menudo indicados por gpgcheck=1).
Verificar acceso a la red: Similar a APT, asegúrese de que su sistema pueda llegar a los servidores del repositorio.
```
ping <dirección-del-servidor-del-repositorio>
```
Verificar claves GPG: Si ve errores relacionados con claves GPG, es posible que deba importar o reimportar la clave pública del repositorio.
```
# Ejemplo para importar una clave
sudo rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-su-repo
```
Evite establecer gpgcheck=0 en sistemas de producción. Cambia una tarea de reparación por un riesgo en la cadena de suministro.
Limpiar caché: Una caché corrupta puede causar problemas:
```
sudo yum clean all
sudo dnf clean all
```
Luego, actualice los metadatos:
```
sudo yum makecache
sudo dnf makecache
```

3. Errores de transacción incompleta

Estos errores ocurren cuando se interrumpe un proceso de instalación, actualización o eliminación de paquetes.

Pasos para solucionar problemas:

Volver a ejecutar la transacción: A menudo, simplemente volver a ejecutar el comando (yum update, dnf install, etc.) puede resolver el problema si fue un fallo temporal.
Limpiar la caché: Como se indicó anteriormente, limpiar la caché puede ayudar:
```
sudo yum clean all
sudo dnf clean all
```
Verificar paquetes retenidos: Aunque es menos común con YUM/DNF que con APT, algunas configuraciones pueden impedir que los paquetes se actualicen. Esto generalmente se gestiona mediante configuraciones de complementos en lugar de comandos de 'retención' directos.
Examinar registros: Verifique /var/log/yum.log (para YUM) o /var/log/dnf.log (para DNF) para obtener mensajes de error detallados.

Bloqueos y procesos de paquetes atascados

Los errores de bloqueo no son realmente errores de dependencia. Por lo general, significan que otro proceso de paquetes se está ejecutando o murió sin limpiar.

En Debian o Ubuntu, puede ver mensajes sobre /var/lib/dpkg/lock-frontend o /var/lib/apt/lists/lock. En sistemas de la familia Red Hat, puede ver otro proceso dnf o yum manteniendo el bloqueo de la base de datos RPM.

Primero, verifique si hay un proceso activo:

ps aux | grep -E 'apt|dpkg|dnf|yum|rpm' | grep -v grep

Si unattended upgrades o cloud-init se está ejecutando, espere. Matar una transacción de paquetes real puede dejar paquetes medio configurados. Si está seguro de que el proceso ha desaparecido y solo queda un bloqueo obsoleto, repare la base de datos de paquetes con las herramientas normales:

sudo dpkg --configure -a
sudo apt --fix-broken install

Para sistemas basados en RPM:

sudo dnf clean all
sudo rpm --rebuilddb

rpm --rebuilddb no es una primera respuesta para cada problema de DNF. Úselo cuando la base de datos RPM en sí parezca dañada, no cuando una URL de repositorio sea incorrecta.

Conflictos de versiones de repositorios de terceros

Muchos fallos graves de paquetes provienen de repositorios mixtos: un repositorio de proveedor, EPEL, un repositorio de tiempo de ejecución de lenguaje, un repositorio de Kubernetes o un mirror interno antiguo. El gestor de paquetes puede estar haciendo exactamente lo que se le indicó, pero las versiones disponibles no pueden satisfacerse entre sí.

En sistemas APT, inspeccione la política:

apt-cache policy <nombre-del-paquete>
apt-cache madison <nombre-del-paquete>

En sistemas DNF:

dnf repoquery --show-duplicates <nombre-del-paquete>
dnf repolist --enabled

Si un repositorio de terceros es el problema, desactívelo temporalmente y vuelva a intentar la transacción:

sudo dnf --disablerepo='nombre-del-repo' update

Para APT, comente la entrada sospechosa en /etc/apt/sources.list.d/, ejecute sudo apt update y pruebe de nuevo. No deje el sistema en un estado misterioso; documente qué repositorio se deshabilitó y por qué.

Cuando falla una actualización de versión o una actualización importante

Las actualizaciones importantes merecen más precaución que una instalación de paquete normal. Antes de volver a intentarlo, asegúrese de saber si el sistema está entre versiones, si los repositorios antiguos aún están habilitados y si las indicaciones de configuración fueron interrumpidas.

En Debian o Ubuntu, verifique los archivos de versión y los paquetes retenidos:

cat /etc/os-release
apt-mark showhold
sudo dpkg --audit

En sistemas basados en DNF, verifique los repositorios habilitados y el comportamiento de sincronización de distribución:

cat /etc/os-release
dnf repolist --enabled
sudo dnf distro-sync

distro-sync puede degradar o reemplazar paquetes para que coincidan con los repositorios habilitados, así que lea la transacción propuesta antes de aceptarla. En sistemas importantes, tome una instantánea o haga una copia de seguridad primero. Los gestores de paquetes son buenos en matemáticas de dependencias, pero no pueden saber de qué archivos de configuración locales, módulos del kernel o agentes de proveedores depende su negocio.

Consejos generales para solucionar problemas

Independientemente del gestor de paquetes, algunas prácticas generales pueden ahorrarle tiempo y dolores de cabeza:

Lea los mensajes de error con atención: La salida de apt o yum/dnf a menudo contiene pistas específicas sobre el problema.
Verifique los registros del sistema: /var/log/apt/history.log y /var/log/apt/term.log para APT, y /var/log/yum.log o /var/log/dnf.log para YUM/DNF, pueden proporcionar un historial detallado de transacciones e información de errores.
Actualice regularmente: Mantenga su sistema y listas de paquetes actualizados para minimizar la posibilidad de encontrar dependencias obsoletas o problemas de repositorio.
Use sudo: Siempre ejecute comandos de gestión de paquetes con privilegios de superusuario.
Haga una copia de seguridad de los datos críticos: Antes de realizar actualizaciones o instalaciones importantes del sistema, haga una copia de seguridad de los datos críticos. Esta es una red de seguridad si algo sale terriblemente mal.
Aísle el problema: Si fallan varios paquetes, intente actualizarlos o instalarlos uno por uno para identificar el paquete específico que causa el problema.
Lea la transacción propuesta antes de escribir sí: Las eliminaciones importan. Si un gestor de paquetes quiere eliminar un servidor de base de datos, un paquete del kernel, un servidor SSH o un tiempo de ejecución central, deténgase y comprenda por qué.
Prefiera las correcciones de repositorio sobre las banderas de fuerza: La mayoría de los fallos de paquetes provienen de metadatos, repositorio o estado de dependencia. Las banderas de fuerza pueden ocultar el síntoma mientras dificultan el mantenimiento del sistema.

El orden de solución de problemas más seguro es consistente: verifique si hay otro proceso de paquetes en ejecución, actualice los metadatos, repare las transacciones interrumpidas, inspeccione los repositorios, luego aborde los conflictos de dependencia. Reserve las eliminaciones forzadas y las omisiones de firma para casos excepcionales en los que comprenda el radio de explosión y tenga una ruta de reversión.