Point de départ
Ce plan a été rédigé à partir d’une inspection en lecture seule du serveur source. Rien n’y a été modifié. Il s’adresse à un administrateur système qui n’a jamais vu la machine.
Source
- Serveur
- serveur V4,
services.monentreprise.bj - Système d’exploitation
- Ubuntu 22.04.5 LTS
- Applications
- une pile Docker Swarm de 28 services, sur un seul nœud
- Bases de données
- PostgreSQL 16.15, MongoDB 6.0.29 et Redis 6.0.16, installés sur la machine et non dans des conteneurs
- Entrée web
- HAProxy 2.4, qui répartit neuf noms de domaine vers les services
Cible
- Système d’exploitation
- Ubuntu Server 24.04 LTS
- Disque système
- 100 Go au minimum
- Disque de données
- 6 To au minimum, en ext4, monté sur
/opt - Taille de la machine
- voir la page Besoins en serveurs
- Périmètre
- la plateforme de production et ses données ; ni les anciennes sauvegardes, ni les outils d’exploitation de la source
Deux points décident du calendrier, et aucun des deux n’est visible dans le fichier de la pile.
Le certificat est un certificat générique (*.monentreprise.bj). Pour en émettre un, il faut pouvoir écrire dans la zone DNS du domaine, pas seulement sur le serveur. Confirmez cet accès avant de commencer : sans lui, le nouveau serveur n’a pas de certificat valable le jour de la bascule.
Les images des 28 services viennent d’un dépôt privé. Vous n’avez pas besoin d’un compte pour ce transfert : l’étape 10 les copie directement d’une machine à l’autre. Mais gardez le fichier produit hors de la machine : sans compte, c’est votre seule copie.
Lancez chaque copie depuis la nouvelle machine, en tirant les données vers elle, afin que rien de volumineux ne soit créé sur la source.
1 · Ce que vous transférez
Neuf éléments. Tout ce qui ne figure pas dans cette liste reste sur place.
| Élément | Où il se trouve | Taille | Comment le déplacer |
|---|---|---|---|
| Les neuf bases PostgreSQLdossiers, processus, registre des entreprises, statistiques, comptes | sur la machine, hors conteneur | 1 208 Go | copie physique, puis réplication continue : étape 13 |
| Le stockage des objetsdocuments déposés, certificats délivrés, impressions, fichiers du registre | /opt/volumes/minio, et un stockage d’archive distinct | 2,0 To218 Go sur la machine, et 1,8 To de fichiers de plus de 90 jours sur le stockage d’archive | copie de fichiers en plusieurs passes, puis rapatriement de l’archive : étape 11 |
| Les bases MongoDBdéfinitions des formulaires, index documentaire, journalisation | sur la machine, hors conteneur | 19 Go | export puis import : étape 14 |
| Les images des 28 services | le dépôt d’images local de la source | 16 Go | copie directe, sans compte de registre : étape 10 |
| Les fichiers du registre de données | /opt/volumes/gdb | 6,1 Go | copie de fichiers : étape 12 |
| Les fichiers déposés sur les pages publiques | /opt/volumes/public-pages-backend, /opt/volumes/benin2-pp | 71 Mo | copie de fichiers : étape 12 |
| La configuration de la pileun seul fichier, et la liste des 29 secrets qu’il attend | le dépôt de configuration | 300 Ko | copie, puis trois corrections : étapes 15 à 17 |
| La configuration du proxyle fichier HAProxy et sa liste d’adresses autorisées | /etc/haproxy | deux fichiers | copie, puis adaptation : étape 20 |
| Les journaux techniquesce ne sont pas les dossiers des usagers : ce sont les traces d’exécution des services | /opt/volumes/opensearch/data | 520 Go | à vous de décider : voir la section 3 |
Soit 3,3 To sans les journaux techniques, 3,8 To avec. Le disque de données de la source contient 8,9 millions de fichiers et de répertoires, pour l’essentiel dans le stockage des objets : c’est le nombre de fichiers, et non leur poids, qui fait la durée de cette copie.
2 · Durée de la copie
Mesurez le débit réel entre les deux machines avant de fixer une date (étape 9). Les durées ci-dessous supposent que la liaison est le facteur limitant, ce qui est vrai pour les bases de données ; pour les millions de petits fichiers du stockage des objets, comptez davantage, et lancez plusieurs copies en parallèle.
| Débit mesuré | 3,3 To, sans les journaux | 3,8 To, avec les journaux |
|---|---|---|
| 100 Mbit/s | 77 heures | 89 heures |
| 200 Mbit/s | 38 heures | 44 heures |
| 500 Mbit/s | 15 heures 30 | 18 heures |
| 1 Gbit/s | 7 heures 45 | 9 heures |
Cette durée n’est pas une interruption de service. La première copie se fait pendant que le système fonctionne normalement. Le jour de la bascule, vous ne transférez plus que les différences accumulées depuis la dernière passe, ce qui prend quelques minutes.
3 · À confirmer avant de commencer
- Le chemin réseau entre les deux machines.
La nouvelle machine doit pouvoir joindre la source par SSH, et par le port 5432 pour la réplication de PostgreSQL. Demandez à l’administrateur de la source trois choses : un compte de réplication, l’autorisation de s’y connecter depuis l’adresse de votre nouvelle machine, et un slot de réplication réservé à ce transfert. Sans ce slot, la source n’a aucune raison de conserver ses journaux de transaction, et une copie interrompue ne peut pas reprendre.
- Le disque de données.
Il faut 3,3 To pour les données, plus la place nécessaire aux restaurations et à la croissance. Prévoyez 6 To en ext4 sur un disque distinct du disque système, monté sur
/opt, comme sur la source. Les bases de données y sont placées par un lien symbolique, pas par un montage : l’étape 4 le refait. - La version de MongoDB : le seul point où le nouveau système ne peut pas reproduire l’ancien.
La source utilise MongoDB 6.0. Pour Ubuntu 24.04, l’éditeur ne publie que les versions 8.0 et suivantes. Or le service de journalisation installé ne prend MongoDB en charge que jusqu’à la série 7. Les deux contraintes ne se recoupent pas : aucune version de MongoDB installable par paquet sur Ubuntu 24.04 n’est prise en charge par ce service.
La solution : faites tourner MongoDB dans un conteneur, avec l’image officielle. La base devient alors indépendante de la version du système, et ses données restent sur le disque de données. C’est ce que fait l’étape 5. Deux choix se présentent : la série 6.0, identique à la source, qui ne change rien d’autre pendant le transfert ; ou la série 7.0, la seule version à être à la fois encore suivie par l’éditeur et acceptée par le service de journalisation. Si vous voulez ne traiter la question qu’une fois, prenez 7.0, et testez avant la bascule les trois applications qui utilisent cette base : les formulaires, l’interface documentaire et la journalisation. Le changement de série ne concerne pas que la journalisation, même si c’est elle qui fixe le plafond.
Ce qui reste à planifier : la série 6.0 ne reçoit plus de correctifs. Faites monter ensemble MongoDB et le service de journalisation, en une opération distincte, après la bascule. Changer de version de base de données et de machine en même temps rend les pannes impossibles à attribuer.
- Le sort des journaux techniques.
Ils occupent 520 Go, soit environ 15 % du transfert. Ce ne sont pas les dossiers des usagers, mais les traces d’exécution des services. Vous pouvez les reprendre, ou démarrer avec un index vide et ne garder que l’historique à partir de la bascule. Décidez selon vos propres règles de conservation. Si vous les laissez, retirez-les du calendrier de copie : le transfert passe de 3,8 à 3,3 To.
- Le sort des anciennes sauvegardes.
La source conserve 888 Go d’archives nocturnes. Elles ne font pas partie de la plateforme : ce sont des copies de ce que vous transférez par ailleurs. Décidez si vous en reprenez une partie comme historique. Elles ne sont pas comptées dans les 3,3 To.
- L’accès à la zone DNS.
Neuf noms de domaine pointent vers le serveur source, et le certificat les couvre tous parce qu’il est générique. Un certificat générique ne peut être émis qu’en prouvant la maîtrise de la zone DNS. Confirmez qui peut y écrire, et prévoyez le module correspondant à votre fournisseur DNS pour que le renouvellement soit automatique. La durée de vie actuelle des enregistrements est d’une heure : l’étape 25 l’abaisse avant la bascule.
- Qui administre le nom principal du domaine.
Les noms
monentreprise.bjetwww.monentreprise.bjne pointent pas vers le serveur source : ils sont servis par une autre machine, à l’adresse 37.27.8.11. Ils ne font donc pas partie de ce transfert. Identifiez qui administre cette machine avant la bascule, car c’est elle que voient les usagers qui tapent le nom du domaine. - Les liaisons vers l’extérieur.
La plateforme appelle quatre services qui ne sont pas sur la machine : un catalogue de traductions (
translations.eregistrations.org), une passerelle de paiement (proxy.fedapay.com), un guichet d’investissement (services.guichet.investbenin.bj) et un relais de messagerie sur le port 587. La nouvelle machine doit pouvoir les joindre, et quelqu’un doit détenir les comptes correspondants. Le premier est hébergé hors du Bénin : prévoyez de le rapatrier, car après le transfert il reste la seule pièce de la plateforme que vous n’administrez pas. L’étape 23 les vérifie une par une. - Des mots de passe, selon leur origine.
La pile attend 29 secrets. Trois cas : quinze sont inscrits dans les données copiées (mots de passe des bases, clés d’authentification entre services, mots de passe de Camunda et de Formio) : gardez la valeur de la production jusqu’à la bascule, puis changez-les une par une ; deux sont délivrés par un prestataire (le relais de messagerie et la passerelle de paiement) : reprenez aussi la valeur de la production ; tous les autres : créez des valeurs neuves. La phase 3 donne la liste.
4 · Ce qui ne se copie pas
Le stockage du courtier de messages — 47 Go
Ce dossier contient des messages en transit, pas des données conservées. Ne le copiez pas : repartez d’un stockage vide. Avant la bascule, vérifiez simplement que les files d’attente sont vides ; si elles ne le sont pas, arrêtez les dépôts de nouveaux dossiers et laissez les traitements en cours se terminer.
Le cache Redis
Il contient une centaine de milliers de clés, toutes à durée de vie limitée : des résultats mis en cache et des sessions. Rien à copier. Après la bascule, les personnes connectées devront simplement se reconnecter.
Les outils d’exploitation de la source
La source porte un agent de supervision, une interface de gestion des conteneurs et une pile de métriques. Ils appartiennent à l’exploitation de l’ancienne machine et n’ont pas à être repris. N’installez que les outils que vous exploiterez vous-mêmes, et choisissez-les après la bascule.
Le reste du dépôt de configuration
Ne copiez que le fichier de la pile du Bénin, docker-stack.yml, et la liste des secrets qui l’accompagne. Vous n’avez besoin de rien d’autre pour déployer.
5 · Phase 1 — Préparer la nouvelle machine
Huit étapes, sans dépendance à la source. Faites-les avant de demander quoi que ce soit à l’équipe qui administre le serveur actuel.
- Installez le système et les deux systèmes de fichiers
Ubuntu Server 24.04 LTS, architecture x86_64, comme la source. Un disque système de 100 Go au minimum pour
/, et un disque de données de 6 To au minimum, formaté en ext4 et monté sur/opt. Réglez l’horloge sur UTC, comme la source : les horodatages des dossiers déjà enregistrés sont en UTC. - Réglez le paramètre noyau exigé par le moteur de recherche des journaux
Sans lui, le service de journalisation refuse de démarrer.
echo 'vm.max_map_count=262144' | sudo tee /etc/sysctl.d/99-opensearch.conf sudo sysctl --system - Installez Docker, puis initialisez le mode Swarm
Prenez les paquets du dépôt officiel Docker pour Ubuntu 24.04, pas ceux de l’archive Ubuntu.
sudo docker swarm init --advertise-addr <adresse-de-la-nouvelle-machine>Cette commande crée le réseau
ingressdont la pile a besoin. Le réseaubridgeexiste déjà. La pile n’en demande aucun autre. - Installez PostgreSQL 16, et placez ses données sur le disque de données
La même version majeure que la source est obligatoire : l’étape 13 copie les fichiers de la base, et non un export de texte. Le dépôt PGDG fournit
postgresql-16pour Ubuntu 24.04. Refaites ensuite le même lien symbolique que sur la source.sudo systemctl stop postgresql sudo mkdir -p /opt/databases sudo mv /var/lib/postgresql /opt/databases/postgresql sudo ln -s /opt/databases/postgresql /var/lib/postgresqlGardez
max_connections = 500, comme la source. Dimensionnezshared_buffersd’après la mémoire de la machine ; la valeur usuelle est le quart de la mémoire. Laissez la base n’écouter que sur127.0.0.1et sur l’adresse du pont Docker,172.17.0.1: c’est par là que les conteneurs l’atteignent. - Installez MongoDB dans un conteneur, données sur le disque de données
Voir la section 3, point 3, pour le choix de la version. Le conteneur ne doit écouter que sur l’adresse du pont Docker.
sudo docker run -d --name mongo --restart unless-stopped \ -p 172.17.0.1:27017:27017 \ -v /opt/databases/mongodb:/data/db \ -e MONGO_INITDB_ROOT_USERNAME=<compte-administrateur> \ -e MONGO_INITDB_ROOT_PASSWORD=<nouveau-mot-de-passe> \ mongo:7.0Remplacez l’étiquette par
mongo:6.0si vous préférez garder exactement la série de la source. - Installez Redis et HAProxy
Les paquets d’Ubuntu 24.04 suffisent : Redis 7.0 et HAProxy 2.8, tous deux plus récents que sur la source. Cela n’a pas de conséquence : le premier ne sert que de cache, le second ne fait que router des noms de domaine. Redis, lui aussi, ne doit écouter que sur
127.0.0.1et172.17.0.1. - Créez l’arborescence des données
sudo mkdir -p /opt/volumes/minio /opt/volumes/activemq /opt/volumes/gdb/media \ /opt/volumes/opensearch/data /opt/volumes/opensearch/os_backup \ /opt/volumes/public-pages-backend/uploads /opt/volumes/benin2-pp/uploads sudo chown -R 1000:1000 /opt/volumes/opensearchLe moteur de recherche des journaux tourne sous l’identifiant 1000 à l’intérieur de son conteneur ; sans ce propriétaire, il ne peut pas écrire. Si un autre service se plaint de ne pas pouvoir écrire au premier démarrage, ajustez le propriétaire du dossier correspondant de la même façon.
- Fermez tout, sauf trois ports
Depuis l’extérieur, seuls 80, 443 et le port SSH doivent répondre. Tous les ports des services (de 3001 à 9999, plus 61613, 61616 et 12201) ne doivent être joignables que depuis la machine elle-même. Les trois bases de données ne doivent jamais être joignables depuis Internet : limitez 5432, 27017 et 6379 à
127.0.0.1et172.17.0.1, et bloquez-les au pare-feu. Elles n’ont besoin de rien d’autre.
6 · Phase 2 — Copier les données
Six étapes, pendant que le système continue de fonctionner. Chaque copie est relançable : elle ne transfère que ce qui a changé.
- Mesurez le débit réel entre les deux machines
Un gigaoctet suffit. La commande affiche le débit obtenu ; reportez-le dans le tableau de la section 2 pour fixer la date de la bascule.
ssh <source> 'dd if=/dev/zero bs=1M count=1024 2>/dev/null' | dd of=/dev/null bs=1M - Copiez les images des 28 services, sans compte de registre
Les images sont transférées directement d’une machine à l’autre, en flux, sans fichier intermédiaire. Cela évite d’avoir à ouvrir un compte sur le dépôt privé, et garantit que vous démarrez avec exactement les mêmes versions.
# sur la source : la liste des images réellement utilisées sudo docker service ls --format '{{.Image}}' | sort -u > /tmp/images.txt # depuis la nouvelle machine ssh <source> "sudo docker save \$(tr '\n' ' ' < /tmp/images.txt)" | sudo docker loadFaites-en aussi un fichier que vous gardez hors de la machine (
docker save -o images.tar). Sans compte de registre, c’est votre seule copie : voir l’avertissement de la section 10 sur le nettoyage automatique des images. - Copiez le stockage des objets — 218 Go, puis 1,8 To d’archive
C’est la copie la plus longue, parce qu’elle porte sur des millions de petits fichiers. Lancez-la depuis la nouvelle machine, puis répétez-la : chaque passe ne transfère que les différences.
rsync -a --delete --info=progress2 <source>:/opt/volumes/minio/ /opt/volumes/minio/Pour aller plus vite, lancez une commande par compartiment, en parallèle. Il y en a six : les documents déposés, les certificats délivrés, les impressions, les fichiers du registre de données, et deux compartiments de fichiers de la bibliothèque de médias.
Les fichiers de plus de 90 jours ne sont pas sur ce disque. Le stockage des objets les déplace vers un stockage d’archive distinct, et ne garde sur la machine qu’une petite fiche par fichier. Le rsync ci-dessus copie ces fiches, pas le contenu. Le contenu, 1,8 To, se rapatrie séparément, à travers le stockage des objets de la source, qui lit l’archive. L’administrateur de la source s’en charge, avant la bascule.
- Copiez les autres fichiers — 6,2 Go
rsync -a --delete <source>:/opt/volumes/gdb/ /opt/volumes/gdb/ rsync -a --delete <source>:/opt/volumes/public-pages-backend/ /opt/volumes/public-pages-backend/ rsync -a --delete <source>:/opt/volumes/benin2-pp/ /opt/volumes/benin2-pp/ - Copiez PostgreSQL — 1 208 Go, par réplication
N’exportez pas 1,2 To en texte : la restauration reconstruirait tous les index, ce qui prend beaucoup plus longtemps que la copie elle-même. Copiez les fichiers de la base, puis laissez la nouvelle machine suivre la source en continu jusqu’à la bascule. Lancez la commande depuis la nouvelle machine, avec le compte et le slot de réplication obtenus à la section 3.
# le répertoire de données doit être vide : l’installation en a créé un sudo systemctl stop postgresql sudo -u postgres rm -rf /opt/databases/postgresql/16/main/* sudo -u postgres pg_basebackup -h <source> -U <compte-de-replication> \ -S <nom-du-slot> -X stream -c fast -P -R \ -D /opt/databases/postgresql/16/mainL’option
-Récrit la configuration du serveur en veille. Démarrez PostgreSQL : la nouvelle machine rejoue désormais les transactions de la source au fur et à mesure. Surveillez le retard accumulé ; il doit rester proche de zéro.sudo -u postgres psql -Atc "select now() - pg_last_xact_replay_timestamp();"Si la réplication ne peut pas être autorisée, la solution de repli est un export base par base (
pg_dump -Fd -j 8) pendant une fenêtre d’arrêt. Prévoyez alors une interruption de plusieurs heures, et non de quelques minutes. - Copiez MongoDB — 19 Go
Exportez les trois bases utilisées, puis importez-les sur la nouvelle machine.
mongodump --uri="mongodb://<compte>@<source>:27017/?authSource=admin" \ --gzip --archive=/opt/tmp/mongo.gz mongorestore --uri="mongodb://<compte>@172.17.0.1:27017/?authSource=admin" \ --gzip --archive=/opt/tmp/mongo.gzRecréez ensuite à la main les trois comptes applicatifs — celui des formulaires, celui de l’interface documentaire et celui de la journalisation — avec de nouveaux mots de passe. Ces mots de passe doivent être les mêmes que ceux des secrets correspondants, à l’étape 16.
7 · Phase 3 — Remonter l’application
Six étapes. À la fin, la plateforme tourne sur la nouvelle machine, mais le DNS n’a pas encore bougé.
- Copiez la configuration de la pile
Un seul fichier décrit les 28 services, leurs images, leurs ports locaux, leurs dossiers de données et les 29 secrets qu’ils attendent. Copiez-le, ainsi que la liste des secrets qui l’accompagne.
rsync -a <source>:/opt/eregistrations/Conf-LIVE/compose/monentreprise-benin/ ~/stack-benin/ - Créez les 29 secrets : la valeur de la production pour dix-sept, des valeurs neuves pour les autres
Les 29 noms attendus sont listés à la fin du fichier de la pile. L’administrateur de la source vous indique où lire les valeurs de la production. Créez-les un par un.
printf '<valeur>' | sudo docker secret create BPA_DB_PASSWORD -Quinze secrets gardent la valeur de la production jusqu’à la bascule. Les mots de passe des bases sont inscrits dans la réplique PostgreSQL, qui copie les comptes tels quels. Les clés d’authentification entre services et les mots de passe de Camunda et de Formio sont inscrits dans les données de Keycloak, de Camunda et de MongoDB. Une valeur neuve est refusée à la connexion. Les quinze :
BPA_DB_PASSWORD,CAMUNDA_DB_PASSWORD,CASHIER_DB_PASSWORD,DS_DB_PASSWORD,GDB_DB_PASSWORD,KEYCLOAK_DB_PASSWORD,STATS_DB_PASSWORD,STRAPI_DB_PASSWORD_BENIN2,BPA_BE_OAUTH_SECRET,CAMUNDA_OAUTH_SECRET,DS_OAUTH_SECRET,GDB_OAUTH_SECRET,STATS_BE_OAUTH_SECRET,CAMUNDA_PASSWORD,FORMIO_PASSWORD. Changez-les une par une après la bascule.Deux autres ne peuvent pas être inventés : le mot de passe du relais de messagerie et la clé de la passerelle de paiement. Un prestataire les délivre. Reprenez la valeur de la production, ou demandez-la au prestataire.
Ne reprenez pas la valeur de la production pour les trois adresses MongoDB (
FORMIO_MONGODB_URI,GRAYLOG_MONGODB_URI,RESTHEART_MONGO_URI) : elles désignent la base de la production. Créez-les avec l’adresse de votre base. Leur mot de passe doit correspondre au compte MongoDB du même nom : changez les deux ensemble. Les autres secrets reçoivent des valeurs neuves. - Corrigez les trois adresses fixées dans le fichier de la pile
Trois noms y sont associés à une adresse en dur. Deux désignent le pont Docker de la machine et ne changent pas :
docserver_mongoetpostgres_hostrestent sur172.17.0.1— c’est ainsi que les conteneurs joignent les bases installées sur la machine. Le troisième,login.monentreprise.bj, est fixé à l’adresse du serveur source : remplacez-la par celle de la nouvelle machine, sinon l’authentification continuera d’interroger l’ancien serveur. - Figez les cinq étiquettes d’images qui ne sont pas versionnées
Vingt-trois services sont attachés à une version précise. Cinq pointent vers une étiquette mouvante : un redéploiement pourrait donc changer de version sans que personne l’ait demandé. Remplacez ces cinq étiquettes par l’empreinte exacte de l’image que vous venez de copier.
unctad/graylog:RC@sha256:c3f506d866fb14882d5eaf88617ff26820c29a70d9cc6c8cb9c34fc451ae6ac2 unctad/statistics-backend:DEV@sha256:0447cc312341d1796d267357c3a20369d76034ae7b30a85e46636d5f6b6c73cf unctad/statistics-frontend:DEV@sha256:e2f7a7ef46cbc01df0592f2af0b92cf8035b60e0b97d6c56d2f3536548755e1b minio/minio:latest@sha256:14cea493d9a34af32f524e538b8346cf79f3321eff8e708c1e2960462bd8936e minio/mc:latest@sha256:a7fe349ef4bd8521fb8497f55c6042871b2ae640607cf99d9bede5e9bdf11727 - Déployez la pile
cd ~/stack-benin sudo docker stack deploy -c docker-stack.yml eregistrations sudo docker stack services eregistrationsAttendez que chaque service affiche le nombre de répliques attendu : quatre pour le service d’intégration, le service de transformation et le générateur de PDF, deux pour le service d’intégration propre au Bénin, une pour les autres. Deux services restent volontairement à zéro : l’outil de miroir du stockage des objets, qui ne se lance qu’à la demande, et un second service de pages publiques qui n’est pas utilisé.
- Montez le proxy et votre propre certificat
Copiez
/etc/haproxy/haproxy.cfget sa liste d’adresses autorisées. Le fichier route neuf noms de domaine vers les ports locaux des services ; il fonctionne tel quel dès lors que les services écoutent sur les mêmes ports, ce qui est le cas si vous avez déployé le fichier de la pile sans le modifier. Émettez ensuite votre certificat, puis construisez le fichier unique que HAProxy attend.sudo certbot certonly --manual --preferred-challenges dns \ -d 'monentreprise.bj' -d '*.monentreprise.bj' sudo sh -c 'cat /etc/letsencrypt/live/monentreprise.bj/fullchain.pem \ /etc/letsencrypt/live/monentreprise.bj/privkey.pem \ > /etc/letsencrypt/live/monentreprise.bj/haproxy.crt'Ajoutez dans
/etc/letsencrypt/renewal-hooks/deploy/un script qui reconstruit ce fichier et recharge HAProxy. Sans lui, le certificat expirera au bout de 90 jours sans avertissement visible. Utilisez le module DNS de votre fournisseur plutôt que--manualpour que le renouvellement se fasse sans intervention. Enfin, une règle du proxy protège une vue de données du registre en n’autorisant qu’une seule adresse IP : remplacez-la par celle de votre choix, ou retirez la règle.
8 · Phase 4 — Vérifier avant de basculer
Quatre étapes. Seul le parcours complet attend la promotion de PostgreSQL : la réplique est en lecture seule, et les services d’authentification et de processus ne démarrent pas sur une base qui refuse les écritures. Les trois autres se font dès maintenant. Rien n’atteint les usagers tant que le DNS n’a pas changé.
- Dirigez un poste de travail vers la nouvelle machine
Ajoutez les neuf noms dans le fichier
hostsde votre poste, avec l’adresse de la nouvelle machine. Votre navigateur verra la nouvelle plateforme ; tous les autres continueront de voir l’ancienne.<adresse-de-la-nouvelle-machine> services.monentreprise.bj login.monentreprise.bj \ bpa.monentreprise.bj gdb.monentreprise.bj stats.monentreprise.bj \ graylog.monentreprise.bj admin-home.monentreprise.bj \ home-new.monentreprise.bj admin-home-new.monentreprise.bj - Déroulez un parcours complet : après la promotion, avant le DNS
Cette étape se fait dans la fenêtre, entre la promotion de PostgreSQL et le changement de DNS (phase 5). Avant la promotion, les services ne démarrent pas et rien ne peut être testé. Pour répéter avant la fenêtre : prenez un instantané LVM du volume de la réplique, promouvez cette copie sur un autre port, et pointez une copie de la pile vers elle. La réplique elle-même n’est pas touchée.
Dans cet ordre, parce que chaque étape dépend de la précédente : connectez-vous (serveur d’authentification) ; ouvrez un formulaire (service de formulaires) ; déposez un dossier avec une pièce jointe (stockage des objets, puis analyse antivirus) ; traitez-le côté agent (moteur de processus et services d’intégration, qui passent par le courtier de messages) ; imprimez un certificat (générateur de PDF) ; consultez une vue du registre de données ; ouvrez le tableau de bord des statistiques ; vérifiez enfin qu’une adresse en
/verify/renvoie bien vers l’archive, qui est déjà sur votre propre serveur. - Testez les quatre liaisons vers l’extérieur
Depuis la nouvelle machine : le service de traductions, la passerelle de paiement, le guichet d’investissement, et l’envoi d’un courriel par le relais de messagerie sur le port 587. Une liaison bloquée par le pare-feu ne se voit pas à l’écran : elle se voit dans les journaux, parfois des heures plus tard.
- Vérifiez l’espace disque et une restauration
Contrôlez que
/opta la place nécessaire à la croissance, puis faites un essai de restauration : une sauvegarde qui n’a jamais été restaurée n’est pas une sauvegarde. C’est le bon moment, car la plateforme n’est pas encore en service.
9 · Phase 5 — Basculer
Quatre étapes. L’interruption perçue par les usagers tient dans la durée du dernier rattrapage, soit moins d’une heure si les passes précédentes ont été faites.
- Vingt-quatre heures avant : abaissez la durée de vie des enregistrements DNS
Elle est aujourd’hui d’une heure. Ramenez-la à cinq minutes sur les neuf noms. Sans cela, certains usagers continueront d’être envoyés vers l’ancien serveur pendant une heure après la bascule.
- Pendant la fenêtre : arrêtez, rattrapez, promouvez
Dans cet ordre : annoncez l’indisponibilité ; arrêtez la pile sur la source pour que plus rien n’écrive ; vérifiez que les files d’attente du courtier de messages sont vides ; relancez une dernière passe de copie des fichiers ; faites un dernier export de MongoDB ; puis seulement promouvez la base PostgreSQL de la nouvelle machine.
sudo -u postgres psql -Atc "select pg_promote();"La promotion doit venir après l’arrêt des écritures sur la source, jamais avant : sinon les dernières transactions sont perdues. Démarrez ensuite la pile sur la nouvelle machine, et vérifiez les 28 services. Déroulez ensuite le parcours complet de la phase 4 par le fichier
hostsde votre poste, puis seulement passez au DNS. - Basculez les neuf enregistrements DNS
Pointez les neuf noms vers l’adresse de la nouvelle machine, puis vérifiez-les un par un. Rétablissez la durée de vie d’une heure une fois la bascule confirmée.
- Gardez l’ancien serveur en lecture seule pendant 30 jours
C’est votre retour arrière : si un problème apparaît dans les premiers jours, il suffit de remettre le DNS sur l’ancienne adresse. Ne laissez cependant plus rien y écrire, sans quoi les deux copies divergeraient. Passé ce délai, le serveur source peut être restitué.
10 · Après la bascule
Montez votre propre chaîne de sauvegarde
Quatre éléments à sauvegarder : les bases PostgreSQL, les bases MongoDB, le stockage des objets et la configuration (le fichier de la pile, le fichier du proxy, les secrets). Écrivez les sauvegardes hors de la machine : une copie qui vit sur le même disque que la donnée ne protège de rien. Puis testez une restauration complète, et refaites ce test une fois par an.
Attention au nettoyage automatique des images
La commande docker system prune -a supprime toutes les images qu’aucun conteneur n’utilise à cet instant. Comme vos images ont été chargées à la main et non téléchargées, elles ne pourraient pas être récupérées sans compte de registre. Si vous programmez un nettoyage, ne mettez pas l’option -a, et gardez de toute façon le fichier images.tar hors de la machine.
Ce qui vieillit, et qu’il faut planifier
Trois éléments ne reçoivent plus de correctifs de sécurité et devront être remplacés ou mis à niveau : la version de MongoDB, le serveur d’authentification (génération 16) et la version d’Ubuntu de la source, que vous n’emportez pas. Traitez-les une fois la plateforme stabilisée, jamais pendant le transfert : une migration et une montée de version en même temps rendent les pannes impossibles à attribuer.
Un plafond à connaître avant toute mise à jour : le service de journalisation installé n’accepte ni moteur de recherche au-delà de la série 2.15, ni MongoDB au-delà de la série 7. Faites-le monter lui en premier. Mettre à jour ces deux briques sans lui le met hors service.
Surveillez la croissance des deux plus gros postes
L’historique du moteur de processus occupe 660 Go, et les journaux techniques 520 Go : ensemble, plus de la moitié du disque. Ce sont aussi les deux postes qui grossissent le plus vite. Ni l’un ni l’autre ne contient les dossiers des usagers. Fixez une durée de conservation pour chacun, selon vos propres règles, et surveillez l’espace libre de /opt.
11 · Les six points qui font échouer ce genre de transfert
1. Le certificat générique. Il ne s’obtient qu’avec un accès à la zone DNS. Réglez ce point avant tout le reste : c’est le seul qui ne dépend pas de vous.
2. Le slot de réplication. Sans lui, la source ne garde pas ses journaux de transaction, et une copie de 1,2 To interrompue repart de zéro.
3. L’ordre de la bascule. Promouvoir la base avant d’avoir arrêté les écritures sur la source fait perdre les dernières transactions.
4. L’adresse fixée pour l’authentification. Le fichier de la pile contient l’adresse de l’ancien serveur ; oubliée, elle renvoie silencieusement les connexions vers lui.
5. Les bases de données exposées. PostgreSQL, MongoDB et Redis n’ont aucune raison d’être joignables depuis Internet. Limitez-les à la machine et au pont Docker.
6. Les images sans registre. Elles sont copiées de machine à machine : gardez-en un exemplaire ailleurs, et n’effacez pas les images non utilisées.