Tutorial de Debian 13 / Actualizar Debian 12 a Debian 13 y verificar paquetes, arranque y servicios
Al actualizar de Debian 12 a 13, cambie el repositorio a trixie y luego ejecute la actualización mínima y la actualización completa en orden. La finalización no se determina únicamente por los mensajes de terminación de APT, sino también verificando el arranque del nuevo kernel, las nuevas conexiones SSH, la red y los datos de los servicios, y el funcionamiento de archivos temporales y configuraciones del kernel.
Prepare el acceso y una sesión de terminal persistente
Este procedimiento se dirige a un servidor amd64 con Debian 12 que ha completado las comprobaciones previas y la preparación de la recuperación. Si aún no ha verificado la restauración, el inicio de sesión por consola o el reinicio normal, complete primero la preparación. Para repositorios externos, otras arquitecturas o servidores de bases de datos o correo, revise también las guías de transición de esos productos.
El entorno de verificación era una VM separada de VirtualBox ejecutando Debian 12.15, kernel 6.1.0-55-amd64, 3 GiB de memoria y un disco virtual de 30 GiB. Realizamos la instalación en dos etapas y los reinicios. El código del servicio Python y los datos fueron respaldados y las respuestas HTTP se registraron como referencia, y este entorno no se utilizó para probar una actualización de versión mayor de una base de datos en funcionamiento.
Si tmux no está instalado en Bookworm, instálelo con sudo apt install tmux antes de cambiar el repositorio. Con una consola separada abierta, cree la siguiente sesión y comience a grabar. Los registros pueden contener configuraciones sensibles; manténgalos privados. tmux conserva una sesión de terminal a través de desconexiones de red, mientras que script registra la salida del terminal.
Verifique si la ruta de la transcripción ya existe antes de comenzar: script -a añade información a un archivo existente. Elija un nombre de archivo nuevo específico para la tarea si es necesario, de modo que ejecuciones no relacionadas no se mezclen. Ejecute los comandos de actualización posteriores dentro de la shell abierta por script.
tmux new-session -s debian13-upgrade
umask 077
script -a -f "$HOME/debian13-upgrade.typescript"
Una vez que la conexión SSH se desconecte, puede reconectarse y volver mediante tmux attach-session -t debian13-upgrade. Primero, verifique si APT está en funcionamiento, y no ejecute la misma actualización de manera redundante. tmux es una herramienta para prepararse para la desconexión de SSH y no garantiza que una tarea sobreviva a un reinicio o fallo de energía.
Verifique los repositorios y escriba la configuración deb822 completa
Este ejemplo es para un servidor de práctica donde la entrada oficial de bookworm existe solo en un archivo, /etc/apt/sources.list, y sources.list.d no contiene archivos en absoluto. Primero, lea el archivo real y gestione por separado los repositorios externos existentes, backports y configuraciones de pin. Si no se cumplen los requisitos previos a continuación, adapte el ejemplo a la configuración real del repositorio en lugar de realizar un reemplazo masivo de cadenas.
sudo cat /etc/apt/sources.list
sudo find /etc/apt/sources.list.d -maxdepth 1 -type f -print
sudo bash <<'ROOT'
set -euo pipefail
. /etc/os-release
test "$VERSION_ID" = 12
test -z "$(dpkg --audit)"
test -z "$(find /etc/apt/sources.list.d -maxdepth 1 -type f -print -quit)"
test -f /usr/share/keyrings/debian-archive-keyring.gpg
dest=/var/backups/debian13-upgrade
test ! -e "$dest"
install -d -m 700 "$dest"
cp -a /etc/apt/sources.list "$dest/sources.list.bookworm"
mv /etc/apt/sources.list "$dest/sources.list.disabled"
cat > /etc/apt/sources.list.d/debian.sources <<'SOURCES'
Types: deb
URIs: https://deb.debian.org/debian
Suites: trixie trixie-updates
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
Types: deb
URIs: https://security.debian.org/debian-security
Suites: trixie-security
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
SOURCES
ROOT
sudo apt update
apt-cache policy apt systemd linux-image-amd64 openssh-server
main non-free-firmware es la configuración utilizada en esta VM. Si el servidor existente requiere contrib o non-free, revise los paquetes y políticas y agregue los componentes. Los entornos de desarrollo que requieren deb-src también deben considerarse por separado. Signed-By apunta al llavero real del archivo de paquetes de Debian, y no debe agregar una opción para ignorar errores de firma. deb822 utiliza secciones basadas en campos separadas por líneas en blanco; los archivos .sources utilizan este formato. El formato se puede encontrar en el manual sources.list de Debian.
Si el bloque de root con comprobaciones previas falla, deténgase antes de apt update e inspeccione qué archivos se movieron o crearon. No asuma que un ejemplo de múltiples comandos revierte automáticamente los cambios parciales. Si la actualización muestra errores de repositorio o firma, deténgase en lugar de instalar con metadatos obsoletos o no confiables.
Asegúrese de que la actualización de la lista se complete sin errores y que la versión candidata provenga de la serie Trixie. En este punto, dado que los paquetes de Debian 13 aún no se han instalado, si descubre una selección incorrecta del repositorio, puede desactivar el archivo nuevo y restaurar el archivo archivado de Bookworm para actualizar nuevamente. Después de iniciar la instalación, no asuma que simplemente revertir el repositorio restaurará completamente el sistema.
Complete la actualización mínima y revise los cambios de la actualización completa
apt -s upgrade --without-new-pkgs
sudo apt upgrade --without-new-pkgs
sudo dpkg --audit
apt -s full-upgrade
El primer paso es actualizar lo que sea posible sin instalar paquetes nuevos ni eliminar los existentes. Tener paquetes restantes no constituye inmediatamente un fallo. En la máquina virtual de verificación, se actualizaron 222 elementos en el paso mínimo, y no hubo nuevas instalaciones ni eliminaciones. Los reemplazos de bibliotecas requeridos por el paso completo se manejarán en el siguiente paso.
Compare los nombres de los paquetes programados para eliminación en la simulación con sus paquetes de reemplazo. Por ejemplo, en esta VM, 25 elementos como libssl3 aparecieron como candidatos para eliminación, y paquetes posteriores como libssl3t64 se instalaron de nuevo. Esto no justifica automáticamente todas las eliminaciones. Si desaparecen paquetes que soportan SSH, red, almacenamiento o aplicaciones sin reemplazos, detenga el procedimiento. Como se explica en el manual de APT, una actualización completa puede implicar eliminaciones.
La revisión incluye no solo la lista de eliminación, sino también el tamaño de descarga, el aumento del espacio usado tras instalar, los paquetes pendientes y las dependencias externas. Si otra operación de APT está en ejecución, espere hasta que termine; no elimine el archivo de bloqueo ni termine forzosamente el proceso del paquete.
Ejecute la actualización completa y revise las opciones del archivo de configuración
sudo apt full-upgrade
sudo dpkg --audit
sudo apt-get check
sudo /usr/sbin/sshd -t
systemctl --failed --no-pager
Lea y apruebe si el resumen real de cambios coincide con la lista revisada. Si se abre la guía de apt-listchanges, lea el contenido y ciérrela para continuar con la instalación. Cuando dpkg o ucf pregunte cómo manejar los archivos de configuración modificados, primero verifique cuáles son esos archivos y qué cambios hizo usted mismo.
| Situación de selección | Juicio y verificación posterior |
|---|---|
| Hay cambios locales intencionales como autenticación, puertos o red | Verifique las diferencias y conserve los cambios necesarios. Confirme si la sintaxis conservada también es válida en la nueva versión. |
| No ha cambiado la configuración predeterminada de la distribución o hay cambios esenciales en la nueva versión | Revise la guía del paquete y los nuevos valores predeterminados. No trate automáticamente la preservación de archivos existentes como la respuesta correcta. |
| No se pueden determinar las diferencias en configuraciones importantes | Verifique las explicaciones y las diferencias mientras mantiene la consola y la copia de seguridad. No se apresure a reiniciar. |
| Entorno de instalación automatizado | Pruebe las políticas de selección con anticipación. Una sola variable no interactiva no resuelve todas las preguntas y la compatibilidad. |
La VM de verificación de este curso guardó registros y códigos de salida en una sesión tmux separada y estableció una política para preservar la configuración personalizada existente basada en una configuración mínima del servidor sin cambios. El procedimiento del lector anterior es una ejecución interactiva en la que lee las preguntas y elige las respuestas. No guía la aplicación directa de la opción de aprobación automática de los ejercicios a todo el servidor de producción.
Si la instalación termina con un error, primero verifique los registros, el espacio en disco y el estado de los paquetes. Revise los cambios sugeridos por sudo dpkg --configure -a o sudo apt --fix-broken install solo si no hay operaciones APT en curso y la causa ha sido resuelta. No use reinicios a mitad de la instalación ni eliminación masiva/sobrescritura forzada como una solución general.
Verifique el kernel, la interfaz de red y SSH antes del reinicio
dpkg-query -W linux-image-amd64 'linux-image-*'
ls -l /vmlinuz /initrd.img
sudo ls -lh /boot
sudo /usr/sbin/sshd -t
ip -brief link
sudo udevadm test-builtin net_setup_link /sys/class/net/enp0s3
sudo efibootmgr -v
enp0s3 es la interfaz de la VM de verificación. Cambie esto al nombre real y compárelo con ID_NET_NAME y la interfaz de configuración de red actual. En algunos equipos, el nombre puede cambiar, por lo que se requiere una consola. Los sistemas BIOS verifican el método de arranque y el estado de instalación de GRUB en lugar de usar efibootmgr.
Incluso si se instala un nuevo kernel y initramfs, el uname -r actual muestra el kernel previo al reinicio. Abra una nueva ventana SSH para verificar realmente la autenticación y el acceso sudo, y no asuma que todo está bien con solo una conexión abierta. El nombre de la interfaz de la VM de verificación no ha cambiado, y la nueva conexión SSH antes del reinicio fue exitosa.
sudo reboot
Si el arranque se retrasa, revise en la consola en qué paso se encuentra: cargador de arranque, kernel o servicios. En lugar de apagar inmediatamente o desactivar la verificación de la clave del host, consulte el estado real del arranque y la huella digital original.
Verifique los servicios y los datos en el nuevo sistema operativo
cat /etc/os-release
uname -r
sudo dpkg --audit
sudo apt-get check
ip -brief address
ip route
getent ahostsv4 deb.debian.org
systemctl --failed --no-pager
sudo /usr/sbin/sshd -t
En la prueba original, la VM reconectada utilizaba Debian 13.7 y el kernel 6.12.117+deb13-amd64. Estas versiones identifican aquella prueba y no la revisión más reciente disponible. Los servicios existentes estaban habilitados y activos, se comparó el contenido HTTP con los valores de referencia preestablecidos, y SHA-256 de los programas y datos era idéntico. En sus propios servicios, verifique de la siguiente manera con nombres, direcciones y archivos reales. Use verificaciones de solo lectura contra el servicio correcto y los archivos base; no elimine ni sobrescriba datos de producción mientras adapta el ejemplo.
systemctl is-enabled lf-upgrade33.service
systemctl is-active lf-upgrade33.service
curl --noproxy '*' -fsS http://127.0.0.1:8080/
sudo sha256sum -c /var/backups/lf-debian13-upgrade33/service-files-before.sha256
El servicio anterior existe solo en la máquina virtual de verificación para pre-controles. En un servidor regular, se comparan el estado, los puertos, las respuestas de lectura y las conexiones de la base de datos del servicio real. Para los servicios con funcionalidad de escritura, también se verifican la escritura y la nueva consulta utilizando datos de prueba aislados antes de reanudar las escrituras reales.
Verifique /tmp y los cambios en la configuración de sysctl
findmnt --target /tmp -o TARGET,SOURCE,FSTYPE,OPTIONS
df -hT /tmp
sudo /usr/lib/systemd/systemd-sysctl --cat-config
sysctl kernel.printk_ratelimit
Después de reiniciar, la VM de verificación cambió /tmp a tmpfs. El límite de tamaño de tmpfs no significa que esta cantidad de memoria esté reservada de antemano. Los archivos que estaban en /tmp en el sistema de archivos raíz anterior pueden estar ocultos bajo el nuevo montaje. Si necesita encontrar los archivos anteriores, cree un punto de montaje temporal vacío y use un montaje por enlace regular para ver solo la raíz. No use --rbind, lo que también reproduciría submontajes como el tmpfs que lo cubre.
sudo bash <<'ROOT'
set -euo pipefail
view=$(mktemp -d /mnt/old-root-view.XXXXXX)
trap 'mountpoint -q "$view" && umount "$view"; rmdir "$view"' EXIT
mount --bind / "$view"
find "$view/tmp" -mindepth 1 -maxdepth 2 -printf '%p\n'
umount "$view"
rmdir "$view"
trap - EXIT
ROOT
Este comando solo muestra una lista. En un servidor real, no elimine todo el directorio temporal de una vez; en su lugar, juzgue el propietario y la necesidad de los archivos. Los marcadores anteriores en la VM de verificación no eran visibles incluso al ver la raíz, y la presencia inmediatamente después del último arranque antes de la actualización no se registró, por lo que la pérdida de archivos no se atribuyó a la actualización. El principio de ocultación en sí se confirmó en un pequeño directorio de práctica con un espacio de nombres de montaje separado donde tmpfs cubría archivos existentes, y en una vista regular de enlace de la raíz, los archivos eran visibles. Esa prueba de visibilidad controlada es separada del seguimiento de un marcador previo a la actualización a través de la actualización de lanzamiento real.
El systemd-sysctl de Debian 13 no lee directamente /etc/sysctl.conf. Gestione la configuración local en archivos individuales /etc/sysctl.d/ y compare sus valores previstos con los valores reales en tiempo de ejecución. En la práctica, se confirmó que kernel.printk_ratelimit=7 de un complemento independiente se aplicó incluso después de un nuevo arranque del kernel, y tras la verificación, solo se eliminó el complemento dedicado al laboratorio, y el valor de tiempo de ejecución original se restauró explícitamente. Eliminar solo el archivo de configuración no revierte un valor ya aplicado al kernel. Si se vuelven a aplicar descuidadamente todos los ajustes, puede afectar otros valores como la red, por lo que se debe definir el alcance de la aplicación. El manual de systemd-sysctl explica los métodos de selección y aplicación de archivos.
Finalice la validación y decida si necesita recuperación
Después de la validación, escriba exit para cerrar la consola de grabación de scripts y verificar que la transcripción se haya guardado. Cierre o separe la sesión de tmux solo después de confirmar que no hay tareas de paquetes aún en ejecución.
Si hubo monitoreo, tareas programadas o temporizadores de APT que se interrumpieron, restaúrelos a sus estados originalmente registrados. En la VM de verificación, los dos temporizadores de APT se devolvieron a estados habilitados y activos. Los paquetes innecesarios se revisan en apt -s autoremove después de la verificación completa, y no se deben eliminar apresuradamente los núcleos anteriores o las dependencias de servicios requeridas para el arranque normal.
Si la verificación del servicio o de los datos falla, se conservan los registros y las pruebas de la falla sin reanudar nuevas escrituras. Si el paquete ya ha sido reemplazado, la recuperación no se logra simplemente cambiando al repositorio bookworm. Utilice la copia de seguridad del estado completo pre-verificado y del servicio para determinar el alcance de la reparación, y si hay nuevos datos después del cambio, planifique su preservación y reaplicación por separado. Consulte Procedimiento Oficial de Actualización de Debian y Cambios Conocidos en trixie junto con la documentación de transición para el servicio correspondiente.




