Debian 13 : tutoriel / Préparer la mise à niveau de Debian 12 vers Debian 13 et tester les sauvegardes

Avant de passer de Debian 12 à Debian 13, vous devez stabiliser le système actuel et préparer une sauvegarde restaurable ainsi qu'une console accessible même si SSH est déconnecté. Ne vous contentez pas de préparer en sauvegardant uniquement la liste des paquets ou en créant un instantané de la machine virtuelle ; vérifiez également la restauration des données des services et l'accès après le redémarrage.

Définir l'étendue de la mise à niveau et les conditions d'arrêt

Cet article couvre les étapes de préparation pour un serveur minimal amd64 Debian 12. Il ne change pas le dépôt vers trixie ni n’installe les paquets Debian 13. Les versions plus anciennes comme Debian 11 nécessitent une procédure séparée pour passer d’abord à Debian 12. Ne mettez pas à jour un serveur i386 en place avec cette procédure : Debian 13 ne fournit plus de noyau ou d’installateur i386 officiel. Évaluez plutôt une installation amd64 fraîche sur un matériel compatible ou une mise hors service.

Une VM séparée dans VirtualBox 7.2 a été utilisée pour la pratique. Debian 12.15 a été installée avec 3 GiB de mémoire, un disque virtuel de 30 GiB, UEFI, racine ext4 et une partition EFI séparée. Après la mise à jour de bookworm, le noyau était 6.1.0-55-amd64. Ceci est l'environnement d'observation et ne représente pas une directive générale pour la capacité requise. Selon l’annonce de Debian 12.15 , cette version ponctuelle est la dernière mise à jour régulière pour Debian 12, et le support futur nécessite de vérifier les architectures et les paquets couverts par le support à long terme (LTS, Long Term Support).

Conditions pour continuer États à arrêter et à résoudre en premier
La connexion console, sudo et les nouvelles connexions SSH fonctionnent toutes S'appuyer sur une seule session SSH existante ou ne pas disposer de média de récupération
Audit des paquets normal, raisons identifiées pour les paquets bloqués par hold et les paquets externes Paquets non configurés, mises en attente pour cause inconnue, dépôts mixtes
Restauration effective de la sauvegarde et vérification de lecture du service terminées Vérification uniquement de l'existence des fichiers ou des sommes de contrôle
Accord sur l'arrêt du service, l'arrêt de l'écriture des données et le point de restauration Après la mise à jour, les nouvelles données seront écrasées par les anciens instantanés

Enregistrer la version actuelle, les paquets et l'état des dépôts

Stockez les fichiers de résultat dans un répertoire que seul root peut lire. La commande ci-dessous est un exemple de son exécution pour la première fois ; si le même répertoire existe déjà, elle s'arrêtera sans écraser. Dans les opérations réelles, distinguez les noms par la date de la tâche ou le numéro de révision.

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 ne produit généralement rien s'il n'y a pas de problèmes. S'il y a des résultats, lisez le contenu, résolvez la cause, puis vérifiez à nouveau. Ne commencez pas une mise à niveau de distribution si apt-get check se termine par des erreurs de dépendances. Ne libérez pas les blocages de manière inconditionnelle ; vérifiez la raison du blocage et si le paquet est pris en charge sur 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

Les erreurs de Grep peuvent apparaître à cause d'un sources.list inexistant. Vérifiez tous les .list et .sources existants, et vérifiez également s'il existe des backports, des dépôts tiers ou des paramètres de pinning en plus de bookworm, bookworm-updates et bookworm-security. Ne publiez pas les résultats si l'URI contient des informations d'authentification. La recherche de sources externes est basée sur les métadonnées APT actuelles, donc l'absence de résultats ne prouve pas la source de tous les fichiers d'installation.

Mettre à jour Debian 12 et vérifier l'accès après le redémarrage

Après avoir confirmé que le dépôt actuel pointe vers bookworm, mettez à jour la liste des paquets et examinez les changements attendus. Vérifiez également si les méta-paquets du noyau sont installés. N'ajoutez pas l'option d'approbation automatique sans avoir vérifié la liste des suppressions ou le plan de suppression de la simulation et préparé le traitement des questions de configuration lors de l’exécution réelle.

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

Procédez au redémarrage uniquement après que apt ait terminé avec succès et que sshd -t réussisse. Si l'un ou l'autre échoue, conservez la session et utilisez la console pour résoudre l'erreur avant de redémarrer.

Après le redémarrage, au lieu de réutiliser la fenêtre existante, créez une nouvelle connexion SSH et vérifiez si vous pouvez également vous connecter depuis la console. Dans l'exercice, l'audit des paquets après la mise à jour était normal, et la simulation de mise à niveau complète de bookworm n'impliquait aucun paquet à modifier. Pour les mises à niveau à distance, consultez les conditions d'OpenSSH dans les notes de version de trixie et les problèmes connus ; mettez à jour bookworm avant de tenter la transition de version.

Enregistrez les références des disques, du réseau et des services

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

Déterminez si /boot est un système de fichiers séparé ou fait partie de la racine, et vérifiez à la fois la capacité et les inodes. Sur un système BIOS sans EFI, vous pouvez ignorer la vérification de /boot/efi. Si le disque est petit, tenez compte de l’espace non seulement pour le cache de téléchargement, mais aussi pour le nouveau noyau, l’initramfs et l’espace temporaire pendant l’installation, et ne supprimez pas le noyau actuellement démarré ni le seul noyau fonctionnel pour libérer de l’espace.

Ne vous contentez pas d'enregistrer les adresses ; incluez également le nom de l'interface, la route par défaut, le composant gérant les fichiers du résolveur du système de noms de domaine (DNS, Domain Name System), ainsi que les adresses et ports d'écoute des services. Pour les services web, incluez le statut HTTP et le contenu de la réponse ; pour les bases de données, incluez comment suspendre les écritures et les commandes pour la sauvegarde logique et la restauration dans le cadre de la ligne de base. Le simple fait que systemctl is-active soit actif ne signifie pas que les données sont normales.

Dans Debian 13, la méthode de stockage par défaut /tmp et le chemin de lecture de la configuration sysctl changeront. Au préalable, vérifiez si des données permanentes n'ont pas été placées dans /tmp et si les paramètres nécessaires sont dans /etc/sysctl.d/*.conf. Enregistrez le résultat actuel de findmnt --target /tmp et les extraits locaux de sysctl avant la mise à niveau, puis comparez-les après redémarrage. L'enregistrement avant la mise à niveau ne prouve pas qu'un ancien marqueur temporaire a survécu ou a été masqué par la suite ; tout test de ce type nécessite un marqueur enregistré séparément et une observation contrôlée.

Séparer les sauvegardes de l'état du système des tests de restauration

La sauvegarde des paramètres et de l’état des paquets et la sauvegarde des données de service ont des buts différents. La commande suivante stocke l'état du système dans le répertoire sécurisé précédemment créé. Ce tar n'est pas une image complète du disque, ni une sauvegarde cohérente d'une base de données en cours d'exécution. Les sauvegardes spécifiques au service ou les procédures d'arrêt d'écriture doivent être appliquées séparément.

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 peut contenir des clés privées ou des informations d'authentification. Restreignez les autorisations de lecture et appliquez le chiffrement et le contrôle d'accès lors du stockage sur des appareils ou serveurs séparés. Si le chemin de sauvegarde se trouve uniquement sur le même disque racine, une corruption pourrait entraîner la perte de l'original et de la sauvegarde. Inversement, écraser uniquement le répertoire de l’état des paquets avec une version plus ancienne n'est pas une méthode pour rétrograder le système d'exploitation.

Pour pratiquer la procédure de restauration directement, utilisez les petits fichiers indépendants suivants au lieu des données opérationnelles. Déplacez les originaux dans un autre emplacement, restaurez-les depuis l’archive et comparez le contenu, les propriétaires et les permissions. L’exemple utilise l’identifiant numérique de l’utilisateur (UID) 1000 et l’identifiant du groupe (GID) 1000. Vérifiez les deux avec id et ajustez chaque valeur de propriétaire/groupe si votre compte de laboratoire est différent.

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

Le résultat attendu est que la commande de comparaison se termine sans erreurs et que OK apparaisse dans la vérification SHA-256.

Pour la vérification réelle, nous avons transféré les données du service HTTP de pratique de cette manière, les avons restaurées à partir de la sauvegarde, et comparé les empreintes de fichiers, l'UID, le GID, les permissions et les réponses HTTP. Seuls les trois fichiers de l’exercice ne contenant aucune information sensible ont été copiés séparément en dehors de la VM pour vérifier leurs empreintes et leur contenu, tandis que l'archive complète de configuration du système a été conservée à l'intérieur de la VM. Par conséquent, cet exercice ne vérifie pas une sauvegarde complète du système pouvant résister à une perte totale de l'hôte.

Pour nettoyer uniquement l'exercice sur les petits fichiers, après avoir confirmé que la restauration a réussi, exécutez sudo rm -- /var/lib/preflight-demo/message.txt et sudo rmdir -- /var/lib/preflight-demo. Conservez la sauvegarde jusqu'à ce que les résultats de la mise à niveau soient confirmés et ne la confondez pas avec les fichiers de service réels.

Confirmez l'accès à la console, le démarrage à froid et les limites de restauration

Dans VirtualBox Manager, sélectionnez la VM cible, ouvrez la console et testez la connexion et sudo. Vous devriez également pouvoir vérifier l'ISO d'installation ou la méthode d'entrée de secours, les informations d'identification de la partition root/EFI et l'emplacement de sauvegarde en dehors de SSH. Les instantanés d'une VM normalement arrêtée sont un moyen rapide de revenir à l'état actuel, mais ils dépendent du même hôte et stockage.

  1. Arrêtez les écritures avant de commencer la mise à niveau et sauvegardez les données du service une dernière fois.
  2. Après avoir arrêté normalement le système invité, enregistrez l'état avant modification depuis le menu des instantanés de la VM. Ne supposez pas que l'instantané lui-même garantit la cohérence d'une base de données en cours d'exécution.
  3. Allumez la VM et vérifiez le démarrage automatique, les nouvelles connexions SSH, les réponses des services et les hachages de données.
  4. Si cela échoue, notez qui ouvrira la console, quelle sauvegarde sera restaurée et comment les données nouvellement créées seront préservées.

Lors de l'exercice, nous avons découvert un problème lors du dernier contrôle de démarrage où le chargeur d'amorçage existait dans le répertoire EFI mais n'était pas enregistré dans l'ordre de démarrage. Nous avons sélectionné EFI/debian/shimx64.efi sur la console pour démarrer, vérifié l'entrée UEFI réelle, corrigé l'ordre, puis confirmé à nouveau le démarrage automatique, les nouvelles connexions SSH et les réponses des services après un redémarrage à froid. Étant donné que les numéros des entrées de démarrage varient selon les appareils, ne copiez pas et n'appliquez pas le numéro efibootmgr d'un autre système.

Après avoir repris l'écriture après la mise à jour, si vous revenez à un ancien instantané, les données créées entre-temps peuvent être perdues. Établissez des critères pour décider de continuer les réparations ou de restaurer l'état complet en cas d'échec d'installation de paquets, de panne de démarrage et d'erreurs de données de service. Lisez à la fois le guide officiel de mise à niveau de Debian et votre propre documentation de service, et commencez le basculement des dépôts uniquement lorsqu'aucun point n'est en suspens.