Tutorial de Debian 13 / Preparar la actualización de Debian 12 a Debian 13 con copias y recuperación

Antes de actualizar de Debian 12 a Debian 13, debe estabilizar el sistema actual y preparar una copia de seguridad que pueda ser restaurada, junto con una consola que pueda ser accedida incluso si se desconecta SSH. No termine la preparación solo guardando la lista de paquetes o creando una instantánea de VM; también verifique la restauración de los datos de los servicios y el acceso después del reinicio.

Defina el alcance de la actualización y las condiciones de parada

Este artículo cubre los pasos de preparación para un servidor mínimo amd64 Debian 12. No cambia el repositorio a trixie ni instala paquetes de Debian 13. Las versiones anteriores como Debian 11 requieren un procedimiento separado para primero actualizar a Debian 12. No actualice un servidor i386 en el lugar con este procedimiento: Debian 13 ya no proporciona un kernel o instalador i386 oficial. Evalúe una instalación fresca de amd64 en hardware compatible o su retiro en su lugar.

Se utilizó una VM separada en VirtualBox 7.2 para practicar. Se instaló Debian 12.15 con 3 GiB de memoria, un disco virtual de 30 GiB, UEFI, raíz en ext4 y una partición EFI separada. Después de actualizar bookworm, el kernel era 6.1.0-55-amd64. Este es el entorno de observación y no representa una guía general sobre la capacidad requerida. Según la versión 12.15 de Debian, esta versión puntual es la última actualización regular para Debian 12, y el soporte futuro requiere consultar la cobertura de arquitecturas y paquetes del soporte a largo plazo (LTS, Long Term Support).

Condiciones para continuar Estados para detenerse y resolver primero
El inicio de sesión en la consola, sudo y las nuevas conexiones SSH están funcionando Confiarse en una única sesión SSH existente o no disponer de medios de recuperación
Auditoría del paquete normal, razones identificadas para paquetes mantenidos en hold y paquetes externos Paquetes no configurados, retenidos por causas desconocidas, repositorios mezclados
Restauración real de la copia de seguridad y verificación de lectura del servicio completada Sólo se verificó la existencia de archivos o sumas de verificación
Acuerdo sobre el tiempo de inactividad del servicio, detención de escritura de datos y punto de restauración Después de la actualización, los datos nuevos serán sobrescritos por instantáneas antiguas

Registre la versión actual, los paquetes y los repositorios

Guarde los archivos de resultados en un directorio que solo root pueda leer. El comando a continuación es un ejemplo de cómo ejecutarlo por primera vez; si el mismo directorio ya existe, se detendrá sin sobrescribir. En operaciones reales, distinga los nombres por la fecha de la tarea o el número de revisión.

sudo bash <<'ROOT'
set -euo pipefail
dest=/var/backups/debian13-preflight
test ! -e "$dest"
install -d -m 700 "$dest"
cat /etc/os-release > "$dest/os-release.txt"
uname -a > "$dest/kernel.txt"
dpkg --print-architecture > "$dest/architecture.txt"
dpkg-query -W -f='${binary:Package}\t${Version}\t${db:Status-Abbrev}\n' > "$dest/packages.tsv"
dpkg --get-selections '*' > "$dest/selections.txt"
apt-mark showmanual > "$dest/manual.txt"
apt-mark showhold > "$dest/holds.txt"
apt-cache policy > "$dest/apt-policy.txt"
dpkg --audit > "$dest/dpkg-audit.txt"
test ! -s "$dest/dpkg-audit.txt"
apt-get check
ROOT

dpkg --audit normalmente no produce nada si no hay problemas. Si hay resultados, lea el contenido, resuelva la causa y luego verifique de nuevo. No inicie una actualización de distribución si apt-get check termina con errores de dependencias. No retire holds indiscriminadamente; verifique el motivo de cada hold y si el paquete es compatible con Debian 13.

sudo grep -R -nE '^(deb |deb-src |Types:|URIs:|Suites:|Components:|Signed-By:)' /etc/apt/sources.list /etc/apt/sources.list.d
apt list '?narrow(?installed, ?not(?origin(Debian)))'
dpkg --print-foreign-architectures

Los errores de Grep pueden aparecer debido a un sources.list inexistente. Verifique todos los .list y .sources existentes, y también compruebe si hay backports, repositorios de terceros o configuraciones de pin además de bookworm, bookworm-updates y bookworm-security. No publique resultados si la URI contiene información de autenticación. La búsqueda de fuentes externas se basa en los metadatos actuales de APT, por lo que la falta de salida no prueba la fuente de todos los archivos de instalación.

Actualice Debian 12 y verifique el acceso después del reinicio

Después de confirmar que el repositorio actual apunta a bookworm, actualice la lista de paquetes y revise los cambios esperados. Además, verifique si los paquetes meta del núcleo están instalados. No use la aprobación automática sin revisar las eliminaciones previstas en la simulación y preparar el tratamiento de las preguntas de configuración durante la ejecución real.

sudo apt update
apt -s full-upgrade
apt-cache policy linux-image-amd64 openssh-server
sudo apt full-upgrade
sudo /usr/sbin/sshd -t
sudo reboot

Proceda a reiniciar solo después de que apt se complete correctamente y sshd -t tenga éxito. Si alguno falla, conserve la sesión y use la consola para resolver el error antes de reiniciar.

Después de que se complete el reinicio, en lugar de reutilizar la ventana existente, cree una nueva conexión SSH y verifique si también puede iniciar sesión desde la consola. En el ejercicio, la auditoría de paquetes después de la actualización fue normal, y la simulación de actualización completa de bookworm no implicó cambios en paquetes. Para actualizaciones remotas, revise las condiciones de OpenSSH en las notas de versión de trixie y sus problemas conocidos; actualice bookworm antes de intentar la transición de versión.

Registre referencias de disco, red y servicios

findmnt --target / -o TARGET,SOURCE,FSTYPE,OPTIONS
findmnt --target /boot -o TARGET,SOURCE,FSTYPE,OPTIONS
findmnt --target /boot/efi -o TARGET,SOURCE,FSTYPE,OPTIONS
findmnt --target /tmp -o TARGET,SOURCE,FSTYPE,OPTIONS
df -hT / /boot /var
df -i / /boot /var
ip -brief address
ip route
readlink -f /etc/resolv.conf
cat /etc/resolv.conf
sudo ss -lntup
systemctl --failed --no-pager

Determine si /boot es un sistema de archivos separado o parte del root, y verifique tanto la capacidad como los inodos. En un sistema BIOS sin EFI, puede omitir la verificación de /boot/efi. Si el disco es pequeño, considere espacio no solo para la caché de descargas, sino también para el nuevo kernel, initramfs y espacio temporal durante la instalación, y no elimine el kernel actualmente arrancado ni el único kernel funcional para liberar espacio.

No solo registre las direcciones; también incluya el nombre de la interfaz, la ruta predeterminada, el componente que maneja los archivos del resolvedor del Sistema de Nombres de Dominio (DNS) y las direcciones y puertos de escucha de los servicios. Para servicios web, incluya el estado HTTP y el contenido de la respuesta; para bases de datos, incluya cómo pausar las escrituras y los comandos para la copia de seguridad y restauración lógica como parte de la línea base. El mero hecho de que systemctl is-active esté activo no significa que los datos sean normales.

En Debian 13, el método de almacenamiento predeterminado /tmp y la ruta de lectura de la configuración de sysctl cambiarán. Antes, verifique si no se han colocado datos permanentes en /tmp y si los ajustes necesarios están en /etc/sysctl.d/*.conf. Registre el resultado actual de findmnt --target /tmp y los fragmentos locales de sysctl antes de actualizar, luego compárelos después del reinicio. El registro previo a la actualización no demuestra que un marcador temporal antiguo haya sobrevivido o haya sido ocultado más tarde; cualquier prueba de este tipo requiere un marcador registrado por separado y una observación controlada.

Separe las copias del estado del sistema de las pruebas de restauración

Hacer una copia de seguridad de la configuración/estado del paquete y hacer una copia de seguridad de los datos del servicio cumplen diferentes propósitos. El siguiente comando almacena el estado del sistema en el directorio seguro previamente creado. Este tar no es una imagen completa del disco, ni es una copia de seguridad consistente de una base de datos en funcionamiento. Los volcados específicos del servicio o los procedimientos de detención de escritura deben aplicarse por separado.

sudo bash <<'ROOT'
set -euo pipefail
dest=/var/backups/debian13-preflight
test -d "$dest"
test ! -e "$dest/system-state.tar"
tar --acls --xattrs --numeric-owner -cpf "$dest/system-state.tar" -C / etc var/lib/dpkg var/lib/apt/extended_states
cd "$dest"
sha256sum system-state.tar > system-state.sha256
sha256sum -c system-state.sha256
ROOT

/etc puede contener claves privadas o información de autenticación. Restringa los permisos de lectura y aplique cifrado y control de acceso al almacenarlo en dispositivos o servidores separados. Si la ruta de la copia de seguridad se encuentra solo en el mismo disco raíz, la corrupción podría causar la pérdida tanto del original como de la copia de seguridad. Por el contrario, sobrescribir solo el directorio de estado del paquete con una versión anterior no es un método para degradar el sistema operativo.

Para practicar el procedimiento de restauración directamente, use los siguientes archivos independientes pequeños en lugar de los datos operativos. Mueva los originales a otra ubicación, restáurelos desde el archivo y compare el contenido, los propietarios y los permisos. El ejemplo utiliza el ID de usuario (UID) 1000 y el ID de grupo (GID) 1000. Verifique ambos con id y ajuste cada valor de propietario/grupo si su cuenta de laboratorio es diferente.

sudo bash <<'ROOT'
set -euo pipefail
dest=/var/backups/debian13-preflight
test -d "$dest"
test ! -e /var/lib/preflight-demo
test ! -e "$dest/demo.tar"
install -d -m 750 -o 1000 -g 1000 /var/lib/preflight-demo
printf 'upgrade backup sample\n' > /var/lib/preflight-demo/message.txt
chown 1000:1000 /var/lib/preflight-demo/message.txt
chmod 640 /var/lib/preflight-demo/message.txt
stat -c '%u:%g:%a' /var/lib/preflight-demo/message.txt > "$dest/demo-mode.txt"
sha256sum /var/lib/preflight-demo/message.txt > "$dest/demo-data.sha256"
tar --acls --xattrs --numeric-owner -cpf "$dest/demo.tar" -C / var/lib/preflight-demo
mv /var/lib/preflight-demo/message.txt "$dest/demo-held.txt"
tar --acls --xattrs --numeric-owner --same-owner -xpf "$dest/demo.tar" -C / var/lib/preflight-demo/message.txt
cmp "$dest/demo-held.txt" /var/lib/preflight-demo/message.txt
test "$(stat -c '%u:%g:%a' /var/lib/preflight-demo/message.txt)" = "$(cat "$dest/demo-mode.txt")"
sha256sum -c "$dest/demo-data.sha256"
ROOT

El resultado esperado es que el comando de comparación termine sin errores y que OK aparezca en la verificación SHA-256.

Para la verificación real, transferimos los datos del servicio HTTP de práctica de esta manera, los restauramos desde la copia de seguridad y comparamos los hashes de archivos, UID, GID, permisos y respuestas HTTP. Solo los tres archivos de práctica sin secretos se copiaron por separado fuera de la VM para comprobar sus hashes y contenido, mientras que el archivo completo de configuración del sistema se mantuvo dentro de la VM. Por lo tanto, esta práctica no verifica una copia de seguridad completa del sistema que pueda soportar la pérdida total del host.

Para limpiar solo el ejercicio de archivos pequeños, después de confirmar que la restauración fue exitosa, ejecute sudo rm -- /var/lib/preflight-demo/message.txt y sudo rmdir -- /var/lib/preflight-demo. Mantenga la copia de seguridad hasta que se confirmen los resultados de la actualización y no la confunda con los archivos del servicio real.

Confirme el acceso a la consola, el arranque en frío y los límites de reversión

En VirtualBox Manager, seleccione la VM de destino, abra la consola y pruebe iniciar sesión y usar sudo. También debe poder comprobar el método de entrada del ISO de instalación o de rescate, la información de identificación de la partición root/EFI y la ubicación de la copia de seguridad fuera de SSH. Las instantáneas de una VM apagada normalmente son una forma rápida de volver al estado actual, pero dependen del mismo host y almacenamiento.

  1. Detenga las escrituras antes de empezar la actualización y realiza una copia de seguridad de los datos del servicio una última vez.
  2. Después de apagar normalmente el invitado, guarde el estado previo al cambio desde el menú de instantáneas de la VM. No asuma que la propia instantánea garantiza la consistencia de una base de datos en ejecución.
  3. Encienda la máquina virtual y verifique el arranque automático, nuevas conexiones SSH, respuestas de servicios y hashes de datos.
  4. Si falla, registre quién abrirá la consola, qué copia de seguridad se restaurará y cómo se conservarán los datos recién creados.

En el ejercicio, descubrimos un problema durante la última verificación de arranque donde el cargador de arranque existía en el directorio EFI pero no estaba registrado en el orden de arranque. Seleccionamos EFI/debian/shimx64.efi en la consola para arrancar, verificamos la entrada UEFI real, corregimos el orden y luego confirmamos nuevamente el arranque automático, nuevas conexiones SSH y respuestas de servicios después de un reinicio en frío. Dado que los números de entrada de arranque varían según el dispositivo, no copie ni aplique el número efibootmgr de otro sistema.

Después de reanudar la escritura tras la actualización, si vuelve a una instantánea antigua, los datos creados mientras tanto pueden perderse. Establezca criterios para decidir si continuar con las reparaciones o restaurar todo el estado en caso de fallos de instalación de paquetes, fallos de arranque y errores de datos del servicio. Lea tanto la guía oficial de actualización de Debian como su propia documentación del servicio, y empiece a cambiar de repositorio solo cuando no haya elementos sin resolver.