Debian 13 : tutoriel / Mettre à niveau Debian 12 vers Debian 13 et vérifier le système après redémarrage

Lors de la mise à niveau de Debian 12 vers 13, changez le dépôt pour trixie, puis exécutez la mise à niveau minimale et la mise à niveau complète dans l'ordre. L'achèvement est déterminé non seulement par les messages de terminaison d'APT, mais aussi en vérifiant le démarrage du nouveau noyau, les nouvelles connexions SSH, les données réseau et des services, ainsi que le fonctionnement des fichiers temporaires et des paramètres du noyau.

Préparer l'accès et une session de terminal persistante

Ceci cible un serveur Debian 12 amd64 qui a terminé les vérifications préalables à la mise à niveau et la préparation de la récupération. Si la restauration de sauvegarde, la connexion à la console ou le redémarrage correct n'ont pas encore été vérifiés, complétez d'abord les préparations. Pour les environnements avec des dépôts externes, d'autres architectures, ou des serveurs de bases de données/de messagerie, examinez également les directives de transition pour ces produits.

L'environnement de vérification était une VM VirtualBox distincte exécutant Debian 12.15, noyau 6.1.0-55-amd64, 3 Gio de mémoire et un disque virtuel de 30 Gio. Nous avons effectué l'installation en deux étapes et les redémarrages. Le code du service Python et les données ont été sauvegardés et les réponses HTTP ont été enregistrées comme références, et cet environnement n'a pas été utilisé pour tester une mise à niveau majeure d'une base de données en cours d'exécution.

Si tmux n'est pas installé dans Bookworm, installez-le avec sudo apt install tmux avant de changer le dépôt. Avec une console séparée ouverte, créez la session suivante et commencez l'enregistrement. Les journaux peuvent contenir des configurations sensibles ; gardez-les privés. tmux préserve une session de terminal lors de déconnexions réseau, tandis que script enregistre la sortie du terminal.

Vérifiez si le chemin de transcription existe déjà avant de commencer : script -a ajoute à un fichier existant. Choisissez un nouveau nom de fichier spécifique à la tâche si nécessaire afin que les exécutions non liées ne soient pas mélangées. Exécutez les commandes de mise à jour suivantes dans le shell ouvert par script.

tmux new-session -s debian13-upgrade
umask 077
script -a -f "$HOME/debian13-upgrade.typescript"

Une fois la connexion SSH déconnectée, vous pouvez vous reconnecter et revenir à tmux attach-session -t debian13-upgrade. Tout d'abord, vérifiez si APT est en cours d'exécution, et n'exécutez pas la même mise à jour de manière redondante. tmux est un outil pour se préparer à la déconnexion SSH et ne garantit pas qu'une tâche survive à un redémarrage ou à une panne de courant.

Vérifiez les dépôts et écrivez la configuration complète deb822

Cet exemple est pour un serveur de pratique où l’entrée officielle bookworm n’existe que dans un seul fichier, /etc/apt/sources.list, et sources.list.d ne contient aucun fichier. Tout d'abord, lisez le fichier réel et gérez séparément les dépôts externes existants, les backports et les paramètres de pinning. Si les prérequis ci-dessous ne sont pas remplis, modifiez selon la configuration réelle des dépôts au lieu d’effectuer un remplacement en masse de chaînes.

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 est la configuration utilisée sur cette VM. Si le serveur existant nécessite contrib ou non-free, examinez les paquets et les politiques et ajoutez les composants. Les environnements de développement nécessitant deb-src doivent également être considérés séparément. Signed-By pointe vers le trousseau de clés réel de l’archive Debian, et vous ne devez pas ajouter une option pour ignorer les erreurs de signature. deb822 utilise des blocs de champs séparées par des lignes vides ; les fichiers .sources utilisent ce format. Le format peut être trouvé dans manuel Debian sources.list.

Si le bloc root comportant les vérifications préalables échoue, arrêtez-vous avant apt update et vérifiez quels fichiers ont été déplacés ou créés. Ne supposez pas qu'un exemple multi-commandes inverse automatiquement les changements partiels. Si la mise à jour signale une erreur de dépôt ou de signature, arrêtez-vous plutôt que d'installer avec des métadonnées périmées ou non fiables.

Assurez-vous que la mise à jour de la liste se termine sans erreurs et que la version candidate provient de la série Trixie. À ce stade, puisque les paquets Debian 13 n'ont pas encore été installés, si vous découvrez une sélection de dépôt incorrecte, vous pouvez désactiver le nouveau fichier et restaurer le fichier Bookworm archivé pour mettre à jour à nouveau. Après avoir démarré l'installation, ne supposez pas que le simple fait de revenir au dépôt restaurera complètement le système.

Complétez la mise à niveau minimale et examinez les modifications de la mise à niveau complète

apt -s upgrade --without-new-pkgs
sudo apt upgrade --without-new-pkgs
sudo dpkg --audit
apt -s full-upgrade

La première étape consiste à mettre à jour ce qui est possible sans installer de nouveaux paquets ni supprimer ceux existants. Avoir des paquets restants ne constitue pas immédiatement un échec. Sur la VM de vérification, 222 éléments ont été mis à jour lors de l'étape minimale, et il n'y a eu aucune nouvelle installation ni suppression. Les remplacements de bibliothèques requis par l'étape complète seront traités à l'étape suivante.

Comparez les noms des paquets programmés pour suppression dans la simulation avec leurs paquets de remplacement. Par exemple, sur cette VM, 25 éléments tels que libssl3 sont apparus comme candidats à la suppression, et des paquets suivants comme libssl3t64 ont été nouvellement installés. Cela ne justifie pas automatiquement toutes les suppressions. Si des paquets supportant SSH, le réseau, le stockage ou les applications disparaissent sans remplacements, arrêtez la procédure. Comme expliqué dans le manuel APT, une mise à niveau complète peut impliquer des suppressions.

L'examen inclut non seulement la liste de suppression mais aussi la taille de téléchargement, l’augmentation de l’espace disque utilisé après installation, les paquets en attente et les dépendances externes. Si une autre opération APT est en cours, attendez qu'elle se termine ; ne supprimez pas le fichier de verrouillage et ne terminez pas de force le processus du paquet.

Exécuter la mise à niveau complète et examiner les choix du fichier de configuration

sudo apt full-upgrade
sudo dpkg --audit
sudo apt-get check
sudo /usr/sbin/sshd -t
systemctl --failed --no-pager

Lire et approuver si le résumé réel des modifications correspond à la liste examinée. Si les conseils d'apt-listchanges s'ouvrent, lire le contenu et le fermer pour continuer l'installation. Lorsque dpkg ou ucf demande comment gérer les fichiers de configuration modifiés, vérifier d'abord quels fichiers ils sont et quelles modifications vous avez apportées vous-même.

Situation de sélection Jugement et vérification ultérieure
Il y a des modifications locales prévues telles que l'authentification, les ports ou le réseau Vérifier les différences et conserver les modifications nécessaires. Vérifier si la syntaxe conservée est également valide dans la nouvelle version.
Vous n'avez pas modifié les paramètres par défaut de la distribution ou il y a des changements essentiels dans la nouvelle version Examinez le guide du paquet et les nouvelles valeurs par défaut. Ne considérez pas automatiquement la conservation des fichiers existants comme la bonne réponse.
Impossible de déterminer les différences dans les paramètres importants Vérifiez les explications et les différences tout en gardant la console et la sauvegarde. Ne vous précipitez pas pour redémarrer.
Environnement d'installation automatisé Testez les politiques de sélection à l'avance. Une seule variable non interactive ne résout pas toutes les questions et la compatibilité.

La VM de vérification pour ce cours a sauvegardé les journaux et les codes de sortie dans une session tmux séparée et a défini une politique pour préserver les paramètres personnalisés existants basée sur une configuration minimale du serveur sans modifications. La procédure proposée au lecteur ci-dessus est une exécution interactive où vous lisez les questions et faites des sélections. Elle ne guide pas l'application de l'option d'approbation automatique des exercices directement sur l'ensemble du serveur de production.

Si l'installation se termine par une erreur, vérifiez d'abord les journaux, l'espace disque et l'état des paquets. Passez en revue les modifications suggérées par sudo dpkg --configure -a ou sudo apt --fix-broken install uniquement s'il n'y a pas d'opérations APT en cours et que la cause a été résolue. N'utilisez pas les redémarrages en cours d'installation ni la suppression massive / écrasement forcé comme solution générale.

Vérifiez le noyau, l'interface réseau et SSH avant de redémarrer

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 est l'interface de la VM de vérification. Changez-la pour le nom réel et comparez-la avec ID_NET_NAME et l'interface des paramètres réseau actuels. Sur certains matériels, le nom peut changer, donc une console est nécessaire. Les systèmes BIOS vérifient la méthode de démarrage et l'état de l'installation de GRUB au lieu d'utiliser efibootmgr.

Même si un nouveau noyau et initramfs sont installés, l'actuel uname -r montre le noyau avant le redémarrage. Ouvrez une nouvelle fenêtre SSH pour vérifier réellement l'authentification et l'accès sudo, et ne supposez pas que tout va bien avec une seule connexion ouverte. Le nom de l'interface de la VM de vérification n'a pas changé, et la nouvelle connexion SSH avant redémarrage a réussi.

sudo reboot

Si le démarrage est retardé, vérifiez sur la console à quelle étape il se trouve : chargeur d'amorçage, noyau ou services. Au lieu de couper immédiatement l'alimentation ou de désactiver la vérification de la clé hôte, vérifiez l'état réel du démarrage et l'empreinte originale.

Vérifiez les services et les données sur le nouveau système d'exploitation

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

Lors de la vérification d’origine, Debian 13.7 et le noyau 6.12.117+deb13-amd64 ont été confirmés sur la VM reconnectée. Les services existants étaient activés et actifs, le contenu HTTP a été comparé avec les valeurs de référence prédéfinies, et les valeurs SHA-256 des programmes et des données étaient identiques. Pour vos propres services, vérifiez comme suit avec les noms, adresses et fichiers réels. Utilisez des vérifications en lecture seule par rapport au service correct et aux fichiers de référence ; ne supprimez ni n'écrasez les données de production lors de l'adaptation de l'exemple.

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

Le service ci-dessus existe uniquement sur la machine virtuelle de vérification pour les pré-contrôles. Sur un serveur normal, le statut, les ports, les réponses en lecture et les connexions à la base de données du service réel sont comparés. Pour les services avec fonctionnalité d'écriture, l'écriture et la nouvelle requête sont également vérifiées en utilisant des données de test isolées avant de reprendre les écritures réelles.

Vérifier /tmp et les modifications de configuration sysctl

findmnt --target /tmp -o TARGET,SOURCE,FSTYPE,OPTIONS
df -hT /tmp
sudo /usr/lib/systemd/systemd-sysctl --cat-config
sysctl kernel.printk_ratelimit

Après le redémarrage, la VM de vérification utilisait tmpfs, un système de fichiers en mémoire, pour /tmp. La limite de taille de tmpfs ne signifie pas que cette quantité de mémoire est réservée à l'avance. Les fichiers qui étaient dans /tmp sur le système de fichiers racine précédent peuvent être cachés sous le nouveau montage. Si vous devez trouver les fichiers précédents, créez un point de montage temporaire vide et utilisez un montage de liaison régulier pour voir uniquement la racine. N'utilisez pas --rbind, ce qui reproduirait également les sous-montages tels que le tmpfs couvrant.

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

Cette commande n'affiche qu'une liste. Sur un serveur réel, ne supprimez pas tout le répertoire temporaire d'un coup ; jugez plutôt du propriétaire et de la nécessité des fichiers. Les marqueurs précédents sur la VM de vérification n'étaient pas visibles même en visualisant le root, et la présence immédiatement après le dernier démarrage avant la mise à niveau n'a pas été enregistrée, donc la perte de fichiers n'a pas été attribuée à la mise à niveau. Le principe de masquage lui-même a été confirmé dans un petit répertoire de pratique avec un espace de montage séparé où tmpfs recouvrait les fichiers existants, et dans une vue bind régulière du root, les fichiers étaient visibles. Ce test de visibilité contrôlée est séparé du suivi d'un marqueur pré-mise à niveau à travers la véritable mise à niveau de version.

Le systemd-sysctl de Debian 13 ne lit pas directement /etc/sysctl.conf. Gérez les paramètres locaux dans des fichiers /etc/sysctl.d/ individuels et comparez leurs valeurs prévues aux valeurs effectives au moment de l'exécution. En pratique, il a été confirmé que kernel.printk_ratelimit=7 d'un drop-in séparé a été appliqué même après un redémarrage du noyau, et après vérification, seul le drop-in dédié au laboratoire a été supprimé, et la valeur d’exécution originale a été explicitement restaurée. Supprimer le fichier de configuration seul ne rétablit pas la valeur déjà appliquée dans le noyau. Si l'ensemble des paramètres est réappliqué sans précaution, cela peut affecter d'autres valeurs telles que le réseau, il est donc nécessaire de définir la portée d'application. Le manuel de systemd-sysctl explique la sélection et les méthodes d'application des fichiers.

Terminer la validation et décider si une récupération est nécessaire

Après validation, tapez exit pour fermer la console d'enregistrement de script et vérifier que la transcription a été sauvegardée. Fermez ou détachez la session tmux seulement après avoir confirmé qu'aucune tâche de paquet n'est encore en cours d'exécution.

Si des tâches de surveillance, des tâches planifiées ou des minuteries APT ont été interrompues, restaurez-les à leurs états enregistrés à l'origine. Dans la VM de vérification, les deux minuteries APT ont été rétablies aux états activés et actifs. Les paquets inutiles sont revus dans apt -s autoremove après la vérification complète, et ne supprimez pas précipitamment les noyaux précédents ou les dépendances de services nécessaires au démarrage normal.

Si la vérification du service ou des données échoue, les journaux et les preuves de l'échec sont conservés sans reprendre de nouvelles écritures. Si le paquet a déjà été remplacé, la récupération n'est pas réalisée simplement en passant au dépôt bookworm. Utilisez la sauvegarde de l'état complet pré-vérifié et le service pour déterminer l'étendue de la réparation, et s'il y a de nouvelles données après le changement, prévoyez une conservation et une réapplication séparées. Consultez Procédure officielle de mise à niveau Debian et Changements connus dans trixie ainsi que la documentation de transition pour le service concerné.