Debian 13 : tutoriel / Migrer un service vers un nouveau serveur Debian 13 et vérifier le retour arrière

Lors de la migration des services vers un nouveau serveur Debian, vous devez d'abord préparer l'environnement d'exécution et les comptes, puis restaurer la sauvegarde finale effectuée lorsque les écritures étaient arrêtées, et enfin comparer la fonctionnalité et les données. La migration n'est pas terminée simplement en changeant l'accès, et vous devez décider comment préserver toutes les données générées sur le nouveau serveur afin de pouvoir revenir en toute sécurité au serveur d'origine.

Définir le périmètre de la migration et identifier chaque serveur

Cet exercice migre un petit service HTTP en lecture seule créé avec Python entre deux machines virtuelles Debian 13 (VM). Il fournit le programme, les données et l'unité systemd, et ne répond que sur 127.0.0.1:8085. Comme décrit dans la documentation Python http.server, ce n'est pas un exemple d'utilisation comme serveur de production accessible depuis Internet. La migration du schéma de base de données, les changements réels de système de noms de domaine (DNS, Domain Name System) et les transitions de la configuration du protocole de sécurité TLS (Transport Layer Security) ne sont pas inclus dans cet exercice.

Rôles Connexion à l'exercice À vérifier
Source old-server Hôte 127.0.0.1:22212 → VM d'origine SSH Réponse de référence, sauvegarde finale, arrêter et redémarrer
Cible new-server Hôte 127.0.0.1:22213 → VM cible SSH Compte dédié · Restauration · Réponse de service · Redémarrage
Ordinateur de travail SSH/SCP qui vérifie individuellement les clés hôtes des deux serveurs Transfert de sauvegarde, comparaison de hash, sélection de la cible de connexion

Même si la même adresse 10.0.2.15 apparaît à l'intérieur des deux machines virtuelles utilisant la traduction d’adresses réseau (NAT, Network Address Translation), elles ne sont pas le même serveur. Dans cet exemple, différents ports de boucle locale de l'hôte ont été connectés via VirtualBox Network → NAT → Avancé → Redirection de port. Remplacez par l'adresse et le port réels de votre serveur, et vérifiez séparément l'identité et la clé hôte de chaque serveur. Pendant l'exercice, le démarrage de la machine virtuelle cible a été bloqué, donc elle a été redémarrée après un arrêt ACPI normal, et la restauration n'a été effectuée qu'après avoir confirmé que la cible pouvait se connecter avec succès.

Sur l'ordinateur Linux de travail, vous pouvez configurer un alias comme suit sur ~/.ssh/config. Remplacez le chemin de la clé privée par le vôtre, et ne copiez pas les mots de passe ou les contenus de clé privée dans du texte ou des journaux.

Host old-server
    HostName 127.0.0.1
    Port 22212
    User lfstudent
    IdentityFile ~/.ssh/id_ed25519

Host new-server
    HostName 127.0.0.1
    Port 22213
    User lfstudent
    IdentityFile ~/.ssh/id_ed25519

Chaque serveur nécessite Python 3, curl et tar. Si ce n'est pas installé, préparez-les avec sudo apt install python3 curl tar, et installez les clients SSH et SCP sur l'ordinateur de travail. L'exemple original ci-dessous suppose le compte lfstudent existant avec l'identifiant utilisateur (UID) et l'identifiant de groupe (GID) 1000 du tutoriel. Si vous utilisez un autre compte, adaptez également les directives User et Group ainsi que les propriétaires des fichiers. Utilisez un nouvel environnement de pratique qui ne remplace pas les répertoires ou services existants portant le même nom.

Créez le service source complet et effectuez une sauvegarde pendant l'arrêt

Exécutez sur le serveur source. Ce bloc crée des programmes, des données et des unités, compare les réponses, puis arrête le service. Au moment de créer l’archive tar finale, le service en lecture seule de cet exercice est déjà arrêté. Les autres services ou fichiers de pratique de mise à niveau existants ne sont pas ciblés.

sudo bash <<'ROOT'
set -euo pipefail
for p in /opt/lf-migrate35 /var/lib/lf-migrate35 /var/backups/lf-migrate35 /etc/systemd/system/lf-migrate35.service; do test ! -e "$p"; done
test "$(id -u lfstudent)" = 1000
test -z "$(ss -H -ltn 'sport = :8085')"
install -d -m 755 /opt/lf-migrate35
install -d -m 750 -o lfstudent -g lfstudent /var/lib/lf-migrate35
install -d -m 700 /var/backups/lf-migrate35
cat > /opt/lf-migrate35/app.py <<'PY'
from http.server import BaseHTTPRequestHandler, HTTPServer
from pathlib import Path

class Handler(BaseHTTPRequestHandler):
    def do_GET(self):
        if self.path != '/':
            self.send_error(404)
            return
        try:
            body = Path('/var/lib/lf-migrate35/message.txt').read_bytes()
            status = 200
        except OSError:
            body = b'data unavailable\n'
            status = 503
        self.send_response(status)
        self.send_header('Content-Type', 'text/plain; charset=utf-8')
        self.send_header('Content-Length', str(len(body)))
        self.end_headers()
        self.wfile.write(body)

HTTPServer(('127.0.0.1', 8085), Handler).serve_forever()
PY
cat > /etc/systemd/system/lf-migrate35.service <<'UNIT'
[Unit]
Description=LF migration lab 35
After=network.target

[Service]
Type=exec
User=lfstudent
Group=lfstudent
ExecStart=/usr/bin/python3 /opt/lf-migrate35/app.py
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true

[Install]
WantedBy=multi-user.target
UNIT
printf 'migration payload 35\n' > /var/lib/lf-migrate35/message.txt
chown lfstudent:lfstudent /var/lib/lf-migrate35/message.txt
chmod 640 /var/lib/lf-migrate35/message.txt
systemctl daemon-reload
systemctl enable --now lf-migrate35.service
sleep .4
curl -fsS http://127.0.0.1:8085/ > /var/backups/lf-migrate35/before.txt
cmp /var/lib/lf-migrate35/message.txt /var/backups/lf-migrate35/before.txt
systemctl stop lf-migrate35.service
tar --numeric-owner -cpf /var/backups/lf-migrate35/service.tar -C / opt/lf-migrate35 var/lib/lf-migrate35 etc/systemd/system/lf-migrate35.service
cd /var/backups/lf-migrate35
sha256sum service.tar > service.sha256
sha256sum -c service.sha256
echo SOURCE_STOPPED_FINAL_SAMPLE_BACKUP_READY
ROOT

Si le bref délai de démarrage est insuffisant et que curl échoue, inspectez sudo systemctl status lf-migrate35.service et sudo journalctl -u lf-migrate35.service -n 30. Vérifiez les chemins, la propriété et les conflits de ports, puis réessayez la requête échouée et la comparaison après que le système soit prêt. Ne relancez pas le bloc de création sur des ressources partiellement créées et ne créez pas l'archive finale avant d'arrêter la source. Assurez-vous que les requêtes locales curl contournent tout proxy configuré.

Le résultat attendu est service.tar: OK et un message de préparation de sauvegarde. La réponse normale est une seule ligne migration payload 35. S'il n'y a pas de données ou si elles sont illisibles, ce service renvoie 503, et il ne révèle pas les listes de fichiers ni ne lit d'autres chemins.

Pour les services réels de base de données ou de téléversement de fichiers, vous devez juger si l'arrêt d'un seul processus est suffisant. Arrêtez les travaux batch, les consommateurs de files d'attente, les écritures sur d'autres serveurs, ou utilisez les méthodes de dump cohérentes ou de sauvegarde en ligne du produit. Si vous resynchronisez les modifications finales après la copie initiale en masse, enregistrez les deux points dans le temps ainsi que les intervalles d'arrêt d'écriture.

Transférez la sauvegarde via le poste de travail

Exécutez le bloc d'exportation sur le serveur source en tant que lfstudent. Arrêtez si le répertoire d'exportation existe déjà ou si une copie échoue. Sur le poste de travail, arrêtez si mkdir migration35, la vérification du checksum ou la création du répertoire d'importation cible échoue ; ne laissez pas les commandes scp ultérieures réutiliser un ancien répertoire.

Copiez uniquement les deux fichiers de l’exercice : l’archive et son fichier de somme de contrôle que vous venez de créer, sans exposer la sauvegarde réservée à root de la source, dans un répertoire dédié pour le compte de pratique. Pour les sauvegardes de service réelles, appliquez des politiques séparées de chiffrement et de stockage selon qu'elles contiennent des informations confidentielles.

test ! -e "$HOME/lf-migrate35-export"
install -d -m 700 "$HOME/lf-migrate35-export"
sudo install -m 600 -o "$(id -un)" -g "$(id -gn)" /var/backups/lf-migrate35/service.tar /var/backups/lf-migrate35/service.sha256 "$HOME/lf-migrate35-export/"

Exécutez sur le poste de travail Linux. Confirmez que les alias SSH pointent vers les serveurs prévus, puis recevez les fichiers dans un nouveau répertoire local dédié.

ssh old-server hostname
ssh new-server hostname
mkdir -m 700 migration35
scp old-server:lf-migrate35-export/service.tar old-server:lf-migrate35-export/service.sha256 migration35/
cd migration35
sha256sum -c service.sha256
tar -tvf service.tar
ssh new-server 'test ! -e "$HOME/lf-migrate35-import" && install -d -m 700 "$HOME/lf-migrate35-import"'
scp service.tar service.sha256 new-server:lf-migrate35-import/

Le hachage doit correspondre, et la liste ne doit inclure que opt/lf-migrate35, var/lib/lf-migrate35 et l'unité de service pertinente. Accordez les autorisations de restauration uniquement aux archives de confiance que vous avez créées, et arrêtez-vous s'il y a des chemins absolus, des chemins remontant vers un répertoire parent avec .. ou des liens inattendus. La somme de contrôle sert à vérifier les dommages pendant le transfert et ne remplace pas la fiabilité de la source. Les options SCP et les méthodes de transfert peuvent être trouvées dans le manuel OpenSSH de scp.

Restaurer vers la cible avec un compte dédié

Exécuter sur le serveur cible. Confirmez d'abord que /opt/lf-migrate35, /var/lib/lf-migrate35, /var/backups/lf-migrate35 et /etc/systemd/system/lf-migrate35.service sont absents et que getent passwd lf-migrate35 ne trouve aucun compte existant. Si sudo ss -ltn indique que le port8085 est occupé, arrêtez et enquêtez.

Toutes les vérifications d'absence de cible précédentes sont obligatoires : le bloc de restauration suppose qu'elles ont réussi. Confirmez également que getent group lf-migrate35 ne trouve aucun groupe existant. Le chemin d'importation suppose que le répertoire personnel du compte de connexion est /home/lfstudent ; remplacez-le de manière cohérente si le vôtre est différent. L'assertion finale UID-non-1000 démontre des ID différents dans ce laboratoire ; la réussite du mappage en production est définie par l'identité cible prévue, et non par une différence numérique universellement requise.

L’archive est d’abord extraite dans un répertoire de préparation, puis seuls les fichiers nécessaires sont installés. Après avoir confirmé l’absence de l’unité cible, le bloc crée uniquement celle de cet exercice ; il ne remplace pas globalement le /etc de la cible. Au lieu de copier l'UID numérique original, il réinitialise la propriété des données au nom de compte dédié de la cible.

sudo bash <<'ROOT'
set -euo pipefail
install -d -m 700 /var/backups/lf-migrate35
mv -- /home/lfstudent/lf-migrate35-import/service.tar /home/lfstudent/lf-migrate35-import/service.sha256 /var/backups/lf-migrate35/
rmdir /home/lfstudent/lf-migrate35-import
chown root:root /var/backups/lf-migrate35/service.tar /var/backups/lf-migrate35/service.sha256
chmod 600 /var/backups/lf-migrate35/service.tar /var/backups/lf-migrate35/service.sha256
cd /var/backups/lf-migrate35
sha256sum -c service.sha256
mkdir -m 700 staging
tar -xpf service.tar -C staging
useradd --system --user-group --home-dir /var/lib/lf-migrate35 --no-create-home --shell /usr/sbin/nologin lf-migrate35
install -d -m 755 /opt/lf-migrate35
install -m 644 staging/opt/lf-migrate35/app.py /opt/lf-migrate35/app.py
install -d -m 750 -o lf-migrate35 -g lf-migrate35 /var/lib/lf-migrate35
install -m 640 -o lf-migrate35 -g lf-migrate35 staging/var/lib/lf-migrate35/message.txt /var/lib/lf-migrate35/message.txt
cat > /etc/systemd/system/lf-migrate35.service <<'UNIT'
[Unit]
Description=LF migration lab 35
After=network.target

[Service]
Type=exec
User=lf-migrate35
Group=lf-migrate35
ExecStart=/usr/bin/python3 /opt/lf-migrate35/app.py
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true

[Install]
WantedBy=multi-user.target
UNIT
systemctl daemon-reload
systemctl enable --now lf-migrate35.service
sleep .4
curl -fsS http://127.0.0.1:8085/ > after.txt
cmp after.txt staging/var/lib/lf-migrate35/message.txt
cmp /opt/lf-migrate35/app.py staging/opt/lf-migrate35/app.py
test "$(stat -c %U /var/lib/lf-migrate35/message.txt)" = lf-migrate35
test "$(id -u lf-migrate35)" != 1000
id lf-migrate35
stat -c '%U:%G:%a' /var/lib/lf-migrate35/message.txt
systemctl show lf-migrate35.service -p User -p Group -p NoNewPrivileges -p ProtectSystem -p MainPID
systemctl restart lf-migrate35.service
sleep .3
curl -fsS http://127.0.0.1:8085/ | cmp - after.txt
echo TARGET_RESTORED_BY_ACCOUNT_NAME_BYTES_AND_RESTART_PASSED
ROOT

Le propriétaire initial des données de la VM de vérification était UID 1000, et le compte dédié cible était UID et GID 988. Les permissions des données étaient définies sur lf-migrate35:lf-migrate35:640, et les octets du code, les réponses HTTP et les réponses après le redémarrage du service étaient les mêmes. NoNewPrivileges et la protection en lecture seule du système sont des limites de cet exemple selon les paramètres d’environnement d’exécution de systemd. Appliquer la même unité directement à un service en écriture peut également bloquer l'écriture nécessaire des données, donc les permissions doivent être conçues séparément pour chaque chemin.

Dans les applications réelles, les versions d'exécution, les modules d'extension, les clients de base de données, les variables d'environnement, les certificats et les chemins de téléversement sont également comparés. Ne supposez pas que les formats de fichiers et les comportements sont identiques simplement parce que la version du système d'exploitation est la même ; exécutez les outils de vérification et les demandes de fonctionnalités pris en charge par le produit sur la cible.

Tester le basculement, le retour en arrière et le basculement à nouveau

Actuellement, le service d'origine est arrêté et le service cible répond. Sur l'ordinateur de travail, utilisez la variable pour sélectionner la cible de connexion afin de vérifier la lecture. Cela sert à sélectionner la destination SSH et n'est pas une opération qui modifie le DNS, le répartiteur de charge ou les adresses web publiques.

active=new-server
ssh "$active" 'curl --noproxy "*" -fsS http://127.0.0.1:8085/'
  1. Exécutez sudo systemctl stop lf-migrate35.service sur la cible.
  2. Exécutez sudo systemctl start lf-migrate35.service sur l'original.
  3. Sur l'ordinateur de travail, effectuez la lecture sur l'original comme indiqué ci-dessous et vérifiez si la réponse est la même.
active=old-server
ssh "$active" 'curl --noproxy "*" -fsS http://127.0.0.1:8085/'

Pour revenir à la cible, arrêtez d'abord la source, puis démarrez le service cible et vérifiez avec active=new-server. Nous avons comparé toutes les réponses de la restauration/redémarrage de la cible sur les deux VM, le retour en arrière de la source et le basculement de la cible avec le fichier de référence. Ce petit service est en lecture seule, donc il ne reflète pas un scénario où de nouveaux conflits d'écriture se produisent après le basculement.

Décisions supplémentaires à prendre avant un véritable basculement en production

Élément Critères de jugement
DNS et répartiteur de charge Prenez en compte le cache actuel, les connexions existantes, les vérifications de santé et les délais de propagation. La diminution du durée de vie (TTL, Time to Live) du DNS seule ne redirige pas immédiatement toutes les requêtes.
Reprise des écritures et restauration Avant la synchronisation finale, bloquez les écritures vers la source et déterminez si les données générées dans la cible peuvent être réappliquées à la source. Évitez une simple restauration si le schéma n'est pas rétrocompatible.
Tâches planifiées, e-mail, file d'attente Si les deux serveurs fonctionnent simultanément, n'activez qu'un seul pour les tâches qui seraient autrement dupliquées. Vérifiez séparément du basculement des requêtes web.
Jugement de succès Comparez le processus, le port, la réponse, les données, les fonctions principales et les taux d'erreur individuellement. La simple lecture réussie ne compte pas comme une écriture normale.

Définissez la fenêtre de restauration et la période de rétention avant de supprimer la source ou les sauvegardes. Consultez le manuel Debian GNU tar pour connaître le comportement de propriété numérique et d'extraction, et suivez les procédures officielles spécifiques aux produits pour les bases de données ou la migration de données de version majeure.

Nettoyez uniquement les ressources du laboratoire

Après vérification, nettoyez uniquement les ressources du laboratoire que vous avez créées sur chaque serveur. Arrêtez et désactivez le service, supprimez exactement les trois fichiers et retirez uniquement les répertoires vides. Conservez les sauvegardes et préservez le compte existant du serveur source lfstudent.

sudo systemctl disable --now lf-migrate35.service
sudo rm -- /etc/systemd/system/lf-migrate35.service /opt/lf-migrate35/app.py /var/lib/lf-migrate35/message.txt
sudo rmdir /opt/lf-migrate35 /var/lib/lf-migrate35
sudo systemctl daemon-reload

Sur la cible, supprimez le compte dédié nouvellement créé avec sudo userdel lf-migrate35 seulement après que ses processus se sont terminés et que ses données de laboratoire ont été supprimées. Appliquez votre politique de rétention aux deux fichiers de transfert exacts sur la source et le poste de travail. Pour une migration en production, conservez la sauvegarde finale vérifiée et les enregistrements de bascule jusqu'à la fin de la fenêtre de récupération.