Rocky Linux 10 : tutoriel / Migrer les services de Rocky Linux 9 vers 10 avec une nouvelle installation
Lors du passage de Rocky Linux 9 à 10, vous vous préparez en installant un nouveau serveur Rocky Linux 10 et en migrant les configurations et données nécessaires. Le projet Rocky Linux ne prend pas en charge officiellement les mises à niveau sur place entre différentes versions majeures. En validant le nouvel environnement tout en conservant le serveur existant, il est plus facile de détecter les problèmes avant le basculement et de définir les conditions de restauration.
Distinguer les mises à jour mineures d'une migration de Rocky 9 à 10
Mettre à jour vers la dernière version mineure de la branche 9.x et changer la version majeure de 9 à 10 sont des tâches différentes. Le document officiel de migration de version de Rocky Linux guide à travers un processus de nouvelle installation, la préparation des comptes nécessaires, des dépôts, des paquets, et la restauration des sauvegardes. Simplement changer les chiffres dans les adresses de dépôts ou utiliser dnf --releasever=10 n'est pas considéré comme une méthode de migration officielle standard.
Le but de préparer un nouveau serveur n'est pas de reproduire l'ensemble du système existant. Il s'agit d'adapter les données et les paramètres nécessaires au service par-dessus les paramètres par défaut et les politiques de sécurité du nouveau système d'exploitation. Simplement déplacer le noyau, les bibliothèques et les RPM de l'ancien serveur vers le nouveau serveur peut entraîner des dépendances incompatibles et une portée de support différente.
| Cible de Migration | Tâches sur le Nouveau Serveur | Critères de Vérification |
|---|---|---|
| Comptes Utilisateur et Service | Créer les comptes nécessaires et définir les UID et GID correspondants. | Les comptes prévus doivent pouvoir lire et écrire les données migrées. |
| Paquets et environnement d’exécution | Installez les versions requises depuis le dépôt Rocky 10. | Les programmes et modules d'extension doivent fonctionner sur le nouvel environnement d'exécution. |
| Configuration | Réappliquez les modifications nécessaires en fonction des nouveaux fichiers par défaut. | Les vérifications de configuration et le démarrage des services doivent réussir. |
| Fichiers·Données DB | Restaurer des sauvegardes cohérentes vers un chemin séparé. | Vérifiez le contenu, les permissions et les fonctions métier ensemble. |
| Cibles d'accès·Tâches planifiées | Déterminez l'ordre de conversion et les méthodes pour éviter l'exécution en double. | Les requêtes des utilisateurs doivent aller sur le serveur prévu, et les tâches ne doivent être traitées qu'une seule fois. |
Si un seul appareil doit être réinstallé, vous ne pouvez pas maintenir le serveur existant en même temps, il est donc plus important d'avoir des sauvegardes externes qui ont passé les tests de restauration et des moyens de retour avant la réinstallation. Si possible, entraînez-vous d'abord sur une nouvelle VM ou un serveur séparé, et déterminez le temps d'arrêt et les critères d'échec pour la conversion réelle.
Sécurisez la liste de configuration requise à partir du serveur existant
Sur le serveur Rocky 9 existant, commencez par examiner l'état de l'installation et les dépendances des services. Ce qui suit est un exemple de création d'un nouveau répertoire d'investigation depuis le shell administrateur. Les listes de comptes et la configuration réseau peuvent contenir des informations opérationnelles, il convient donc de restreindre l'accès et de ne pas les copier directement dans des journaux ou publications publics.
sudo -i
set -euo pipefail
umask 077
test ! -e /root/migration-inventory
mkdir /root/migration-inventory
cd /root/migration-inventory
cat /etc/rocky-release > release.txt
getent passwd > users.txt
getent group > groups.txt
rpm -qa --qf '%{NAME}-%{VERSION}-%{RELEASE}.%{ARCH}\n' | sort > packages.txt
dnf repolist --enabled > repositories.txt
dnf module list --enabled > modules.txt
systemctl list-unit-files --state=enabled > enabled-units.txt
ss -lntup > listening-ports.txt
ip -br address > addresses.txt
ip route > routes.txt
exit
Cette liste n'est pas un script d'installation à exécuter tel quel sur le nouveau serveur. Elle sert de référence pour sélectionner les éléments nécessaires au service et vérifier les noms, la disponibilité du support et les paquets de remplacement dans Rocky 10. Pour les services sur Rocky 9 utilisant les flux de modules, il est particulièrement nécessaire d'examiner la version d'exécution et de ne pas supposer que le choix peut être transféré directement à la commande de module dans Rocky 10.
Pour les services web et DB, en plus des chemins de données, vérifiez les comptes DB et les méthodes de vidage, les fichiers téléversés, les API externes, le courrier, le stockage, les certificats, les tâches planifiées et les tâches de sauvegarde. Exécuter les mêmes tâches planifiées à la fois sur les nouveaux serveurs et sur les serveurs existants simultanément peut entraîner l'envoi de mails en double ou le traitement de données en double. Les mots de passe opérationnels et les clés secrètes doivent être transmis par des procédures protégées distinctes et ne doivent pas être copiés inutilement dans des fichiers pour la comparaison de configuration.
Préparation du nouveau serveur et domaine de pratique
Installez Rocky Linux 10 sur le nouveau serveur, effectuez les mises à jour, configurez les comptes de gestion, vérifiez l'accès SSH et vérifiez d'abord les paramètres de base du pare-feu et de SELinux. Si l'environnement est x86-64, vérifiez également les exigences du processeur pour Rocky 10. Ne supposez pas que les exigences de la nouvelle version sont respectées simplement parce que le serveur existant exécute Rocky 9.
Lors du transfert d'un programme réel, au lieu de copier l'environnement virtuel Python ou le répertoire des modules d'extension compilés tel quel, recréez-le sur le nouveau serveur en utilisant le runtime et les dépendances pris en charge là-bas. Pour les formats de fichiers DB et la compatibilité des plugins, suivez les procédures de migration pour chaque version du produit. Ne mélangez pas les paramètres par défaut et les fichiers système en remplaçant entièrement /etc, /usr et /var sur le nouveau serveur.
Le laboratoire source a déplacé un petit service en lecture seule de l'espace utilisateur du conteneur Rocky 9.8 vers Python sur une machine virtuelle Rocky 10.2 . Le Python source était en version 3.9.25 et le Python de destination en version 3.12.15. Les deux environnements partageaient le noyau de l'hôte Rocky 10, donc le test n'a pas migré un noyau Rocky 9, le processus de démarrage ni systemd. Un fichier d'adresses local a simulé le basculement et le retour arrière sans modifier une base de données de production ou le DNS public.
Exécutez l’exercice avec l’utilisateur normal lfstudent et préparez Podman, Python, tar et curl. L’UID et le GID de ce compte de pratique étaient 1000 ; cela ne décrit pas toutes les identités de la VM. Construisez une image séparée à partir de l'image officielle docker.io/library/rockylinux décrite dans le guide Podman de Rocky Linux. Les services de production réels doivent gérer séparément le cycle de vie des conteneurs et les effets de la déconnexion ; ici, l'exercice est réalisé dans la même session de connexion du début à la fin.
Préparation de l'espace utilisateur sur Rocky 9
Exécutez les commandes dans le shell d'une VM d'entraînement Rocky 10 dédiée en tant qu'utilisateur régulier, pas sur le serveur existant. Utilisez un nouveau chemin et un nom d'image locale séparé. Si vous disposez de matériaux d'entraînement existants, arrêtez-vous et vérifiez d'abord l'état sauvegardé.
set -euo pipefail
umask 077
test ! -e "$HOME/lf-course31"
mkdir -m 700 "$HOME/lf-course31"
cd "$HOME/lf-course31"
if podman image exists localhost/lf-course31-source9-updated:20261112; then
printf 'The local lab image tag already exists. Stop and inspect it.\n' >&2
exit 1
else
image_status=$?
test "$image_status" -eq 1
fi
podman pull docker.io/library/rockylinux:9
base=$(podman image inspect docker.io/library/rockylinux:9 \
--format '{{index .RepoDigests 0}}')
printf '%s\n' "$base" > base.ref
printf 'FROM %s\nRUN dnf -y upgrade && dnf -y install python3 tar && dnf clean all\n' \
"$base" > Containerfile
podman build --tag localhost/lf-course31-source9-updated:20261112 \
--file Containerfile .
podman run --rm localhost/lf-course31-source9-updated:20261112 \
/bin/bash -lc 'cat /etc/rocky-release; python3 --version; uname -r'
Ne supposez pas la version réelle simplement en regardant le tag. L'image basée sur :9 reçue lors de la pratique était étiquetée 9.3, et après une mise à jour complète de la série 9 à l'intérieur de l'image source, le laboratoire a confirmé la version 9.8 et Python 3.9.25. Cette mise à jour a été effectuée uniquement à l'intérieur de l'image isolée. Enregistrez le digest de l'image de base dans base.ref, en notant que le même tag peut ultérieurement faire référence à une image différente.
À l'intérieur d'un conteneur, uname -r montre le noyau de l'hôte Rocky 10. Confirmez la version de l'espace utilisateur du système d'exploitation en utilisant /etc/rocky-release ou /etc/os-release, et distinguez-la de la version du noyau. La préparation de l'image ou la première cartographie de l'utilisateur peut prendre du temps, donc ne créez pas à plusieurs reprises des conteneurs avec le même nom. En cas d'interruption, vérifiez d'abord l'état réel en utilisant podman ps -a et podman inspect.
Création d'un service original en lecture seule et d'une sauvegarde de migration
Le programme complet suivant utilise un fichier de configuration JSON et un fichier de données JSON contenant deux éléments. /health représente l'environnement d'exécution, et /items renvoie les données à transférer. Les fonctions comme POST ne sont pas fournies, et le répertoire original est également connecté en lecture seule. Dans un service d'écriture réel, cette partie devrait être changée en mode maintenance et une procédure de sauvegarde finale cohérente devrait être mise en place.
SOURCE_LISTENERS=$(ss -H -lnt 'sport = :18031')
TARGET_LISTENERS=$(ss -H -lnt 'sport = :18032')
test -z "$SOURCE_LISTENERS"
test -z "$TARGET_LISTENERS"
mkdir -m 700 source target
mkdir -m 700 source/data
printf '{"site":"LF31 migration lab"}\n' > source/config.json
printf '[{"id":1,"name":"alpha"},{"id":2,"name":"beta"}]\n' > source/data/items.json
cat > source/app.py <<'PY'
import json, platform, sys
from pathlib import Path
from http.server import BaseHTTPRequestHandler, HTTPServer
root = Path(sys.argv[1])
class Handler(BaseHTTPRequestHandler):
def do_GET(self):
try:
if self.path == '/health':
release = dict(line.split('=', 1) for line in
Path('/etc/os-release').read_text().splitlines() if '=' in line)
data = {'os': release['VERSION_ID'].strip('"'),
'python': platform.python_version()}
elif self.path == '/items':
config = json.loads((root/'config.json').read_text())
data = {'site': config['site'],
'items': json.loads((root/'data/items.json').read_text())}
else:
self.send_error(404)
return
body = (json.dumps(data, sort_keys=True) + '\n').encode()
self.send_response(200)
content_type = 'application/json'
except (OSError, ValueError, KeyError):
body = b'Cannot read migration data\n'
self.send_response(500)
content_type = 'text/plain; charset=utf-8'
self.send_header('Content-Type', content_type)
self.end_headers()
self.wfile.write(body)
HTTPServer((sys.argv[2], int(sys.argv[3])), Handler).serve_forever()
PY
chmod 640 source/app.py source/config.json source/data/items.json
uid=$(id -u)
gid=$(id -g)
source_id=$(podman run -d --init --name lf-course31-source --label lf.course=31 \
--userns=keep-id --user "$uid:$gid" \
-p 127.0.0.1:18031:8080 -v "$PWD/source:/work:ro,Z" \
localhost/lf-course31-source9-updated:20261112 \
python3 /work/app.py /work 0.0.0.0 8080)
printf '%s\n' "$source_id" > source-container.id
sleep 2
podman exec "$source_id" id
curl --fail --silent --max-time 10 http://127.0.0.1:18031/health
curl --fail --silent --max-time 10 http://127.0.0.1:18031/items > source-response.json
--userns=keep-id permet de maintenir l'ID numérique d'un utilisateur régulier même à l'intérieur du conteneur. :ro,Z connecte l'original en mode lecture seule et applique une étiquette SELinux dédiée. Ce changement d'étiquette n'est pas appliqué de manière générale aux répertoires de données publics. Si la réponse initiale échoue, podman inspect "$source_id" et podman logs "$source_id" sont vérifiés et l'ID du conteneur enregistré est confirmé avant de reprendre. Le processus ne passe pas à l'étape suivante sans vérifier l'original en cours d'exécution.
Si la réponse et l'original sont confirmés comme normaux, une sauvegarde du chemin relatif est créée à l'intérieur du conteneur et copiée sur l'hôte. La sauvegarde inclut uniquement ce petit programme, les paramètres et les données.
podman exec "$source_id" tar --numeric-owner -cpf /tmp/lf31-migration.tar -C /work .
podman cp "$source_id":/tmp/lf31-migration.tar backup.tar
sha256sum backup.tar > backup.tar.sha256
sha256sum -c backup.tar.sha256
tar --numeric-owner -tvf backup.tar
La somme de contrôle devrait être OK, et la liste de fichiers devrait afficher app.py, config.json et data/items.json. La sauvegarde tar standard dans cet exemple cible le contenu des fichiers et les permissions de base. Si vous voulez préserver les ACL et les attributs étendus, vous devriez ajouter des vérifications pour ces options et attributs comme le tutoriel sur la sauvegarde et la vérification réelle de la restauration pour des paramètres et données utilisateur . En particulier, les labels SELinux dédiés aux conteneurs ne doivent pas être utilisés tels quels pour la politique de déploiement d’un nouveau serveur.
Restauration sur Rocky 10 et comparaison des résultats d'exécution
Après avoir vérifié à nouveau que le target préparé est vide, restaurez uniquement la sauvegarde que vous avez créée vous-même. Puisque la restauration est effectuée avec le même compte général sur le même hôte, la correspondance numérique de propriété dans cet exemple est la même. S'il s'agit d'un serveur réel différent, vous devez d'abord aligner l'UID et le GID du nouveau compte ou planifier les conversions de propriété nécessaires.
TARGET_ENTRIES=$(find target -mindepth 1 -print -quit)
test -z "$TARGET_ENTRIES"
sha256sum -c backup.tar.sha256
tar -xpf backup.tar -C target
python3 - <<'PY'
from pathlib import Path
import hashlib, stat
source, target = Path('source'), Path('target')
for p in sorted(source.rglob('*')):
if not p.is_file():
continue
q = target/p.relative_to(source)
if p.read_bytes() != q.read_bytes():
raise SystemExit('FAIL: content differs')
if (p.stat().st_uid != q.stat().st_uid or
p.stat().st_gid != q.stat().st_gid or
stat.S_IMODE(p.stat().st_mode) != stat.S_IMODE(q.stat().st_mode)):
raise SystemExit('FAIL: owner or mode differs')
print(p.relative_to(source), hashlib.sha256(q.read_bytes()).hexdigest())
print('PASS: file content, numeric ownership and modes match')
PY
python3 target/app.py "$PWD/target" 127.0.0.1 18032 > target-service.log 2>&1 &
target_pid=$!
sleep 1
curl --fail --silent --max-time 10 http://127.0.0.1:18032/health
curl --fail --silent --max-time 10 http://127.0.0.1:18032/items > target-response.json
cmp source-response.json target-response.json
Si le contenu et les permissions des trois fichiers sont les mêmes et que cmp se termine avec le statut 0 sans sortie, les réponses de données dans cet exemple correspondent. Sur la destination /health, le nouvel espace utilisateur et la version d'exécution sont apparus comme suit.
{"os": "10.2", "python": "3.12.15"}
/items La réponse doit inclure à la fois alpha et beta et avoir la même valeur site. Si la réponse est 500, vérifiez target-service.log, le chemin du fichier, la syntaxe JSON et les permissions du compte d'exécution. Ce petit serveur est destiné à la pratique pour vérifier le fonctionnement sur le loopback et n'est pas utilisé comme serveur web de production externe.
Le succès dans un petit exemple ne signifie pas que toutes les dépendances du service réel sont compatibles. Dans un environnement de production, les opérations de connexion, de consultation/écriture, de téléchargement de fichiers, les jeux de caractères et fuseaux horaires de la base de données, les tâches planifiées, les intégrations externes, les certificats et les opérations de sauvegarde doivent être vérifiés pour chaque service. Si possible, vérifiez que les mêmes résultats se produisent même après le redémarrage du nouveau serveur, et vérifiez aux adresses et chemins où les utilisateurs se connectent normalement.
Tester la modification de la cible de connexion et le retour en arrière avec les mêmes données
Dans cet exercice, client.url est un fichier standard qui stocke l'adresse à laquelle envoyer les requêtes. Sans modifier le DNS public ni le trafic réel des utilisateurs, vous pouvez observer la séquence de l'environnement existant → nouvel environnement → environnement existant → nouvel environnement.
printf 'http://127.0.0.1:18031\n' > client.url
curl --fail --silent --max-time 10 "$(cat client.url)/health"
printf 'http://127.0.0.1:18032\n' > client.url
curl --fail --silent --max-time 10 "$(cat client.url)/health"
curl --fail --silent --max-time 10 "$(cat client.url)/items" | cmp - source-response.json
printf 'http://127.0.0.1:18031\n' > client.url
curl --fail --silent --max-time 10 "$(cat client.url)/health"
curl --fail --silent --max-time 10 "$(cat client.url)/items" | cmp - source-response.json
printf 'http://127.0.0.1:18032\n' > client.url
curl --fail --silent --max-time 10 "$(cat client.url)/items" | cmp - source-response.json
Le laboratoire source a vérifié l'origine 9.8/3.9.25, la destination 10.2/3.12.15, puis de nouveau l'origine 9.8/3.9.25, et la réponse pour chaque donnée était la même. Comme l'original était défini en lecture seule et que le nouvel environnement n'avait pas de fonctionnalité d'écriture, dans cet exemple, la comparaison ne pouvait que rétablir la cible de connexion sans avoir besoin de fusionner à nouveau les données.
Dans le service d'écriture actuel, les données qui entrent dans le nouveau serveur après la transition sont cruciales. Si vous ne faites que revenir à l'adresse sans refléter cela sur le serveur existant, vous pourriez perdre de nouvelles commandes, des téléchargements, des modifications de compte, etc. Avant la migration, définissez le temps de suspension d’écriture, le point de synchronisation final, les conditions dans lesquelles l’écriture est autorisée sur le nouveau serveur, et la méthode pour récupérer les données en cas de retour en arrière. Vérifiez également si une restauration inverse est possible entre différentes versions de la base de données.
La transition opérationnelle modifie les paramètres DNS, proxy/équilibreur de charge ou de connexion selon la méthode choisie. En raison du cache DNS et des connexions existantes, tous les utilisateurs ne passent pas simultanément au nouveau serveur. Après la transition, observez les taux d'erreur, les journaux et les vérifications clés de l'activité, et ne reprenez pas les écritures ou les tâches planifiées de manière redondante sur le serveur existant.
Nettoyez le laboratoire et décidez quand mettre hors service l'ancien serveur
Ne terminez que les deux processus démarrés dans la pratique. target_pid et source_id ci-dessous sont des cibles démarrées directement dans la session actuelle. Si la session a été déconnectée, vérifiez l'ID du conteneur sauvegardé et le processus/port réel pour confirmer qu'il s'agit de la même cible avant le nettoyage, et ne terminez aucun autre processus Python arbitraire.
kill "$target_pid"
wait "$target_pid" || test "$?" = 143
podman stop "$source_id"
podman inspect "$source_id" --format '{{.State.Status}} {{.State.ExitCode}}'
podman rm "$source_id"
ss -lnt 'sport = :18031'
ss -lnt 'sport = :18032'
sudo restorecon -RF "$HOME/lf-course31/source"
sha256sum -c backup.tar.sha256
--init place un petit processus initial dans le conteneur qui est responsable, entre autres, de la transmission des signaux. Dans une vérification de terminaison séparée appliquée à ceci, exited 143 est apparu sans avertissement de terminaison forcée, et dans cet exercice, c'était un état de terminaison selon SIGTERM. Vérifiez également que les deux ports sont fermés et si la somme de contrôle de sauvegarde est OK. La restauration du contexte SELinux ne s'applique qu'au chemin d'origine de cet exercice que le conteneur a fini d'utiliser, tout en conservant le contenu et les permissions par défaut.
Le serveur existant est arrêté après que le nouveau serveur a terminé la vérification des fonctions métier, de l'accès opérationnel, de la sauvegarde et de la restauration, ainsi que des tâches planifiées, et après avoir respecté la période d'observation et les conditions de retour établies. Avant l'arrêt, l'emplacement et la méthode de restauration de la dernière sauvegarde, les différences de configuration du nouveau serveur et les éléments qui n'ont pas encore été vérifiés sont transmis. La fin de la migration est jugée par le comportement des services vérifiés et l'intégrité des données, plutôt que par la date d'installation du nouveau serveur.




