PostgreSQL 026 – Replication : mise en place

TL;DR

La haute disponibilité PostgreSQL combine réplication, promotion, détection, consensus opérationnel, routage client et prévention du split brain. Cet épisode cherche à construire une reprise contrôlée sans exposer deux primaires en écriture. La vidéo est intégrée dans l’article et les références ont été actualisées pour éviter de présenter une pratique historique comme une recommandation actuelle.

La vidéo de référence

Vidéo: https://www.youtube.com/watch?v=-OjhYXNJPYM

Playlist complète: https://www.youtube.com/playlist?list=PLn6POgpklwWonHjoGXXSIXJWYzPSy2FeJ

Cet article correspond à l’épisode 26 sur 34. Le chapitre GitLab associé est 25-promote. Les fichiers utiles détectés sont: 25-promote/slides.md.

Définition simple : Replication : mise en place

La haute disponibilité PostgreSQL combine réplication, promotion, détection, consensus opérationnel, routage client et prévention du split brain.

Pour raisonner correctement, séparez toujours la configuration déclarée, l’état réellement appliqué et la preuve observée. Une commande terminée sans erreur ne prouve pas à elle seule la disponibilité, la sécurité, la persistance ou la capacité de restauration.

Quel problème cet épisode résout-il ?

Le besoin concret consiste à construire une reprise contrôlée sans exposer deux primaires en écriture. Le sujet doit être replacé dans son contexte: taille de l’environnement, version, niveau de criticité, dépendances et compétences de l’équipe.

Une bonne validation part d’un exemple minimal, observe les objets créés, provoque un changement contrôlé puis vérifie le résultat avec un outil indépendant de la commande de création.

Points clés du support Xavki

• création d’une db sur le slave = rejet
• création d’une db sur le master = ok = réplication
• une table système permet de vérifier l’état de la réplication
• test d’arrêt du master = rien (prochaines vidéos) => failover manuel
• promotion d’un slave en master
• trigger file : déclencheur de la progression
• suppression des datas du slave

Ces éléments viennent du dépôt lorsqu’un chapitre correspondant existe. Ils servent de point de départ; la documentation officielle citée plus bas précise le comportement des versions actuelles.

Mise à jour par rapport à la vidéo

recovery.conf a disparu depuis PostgreSQL 12. Réplication et promotion ne suffisent pas sans fencing et stratégie de reconnexion.

Avant d’utiliser une commande en production, vérifiez la version installée, les notes de migration et les paramètres devenus obsolètes. Les exemples de formation restent utiles pour comprendre le modèle, mais une option ou une architecture peut avoir évolué.

Commandes et éléments pratiques

pg_basebackup -h 192.168.60.4 -D /var/lib/postgresql/11/main/ -P -U replication --wal-method=fetch

Les commandes extraites peuvent contenir des valeurs de lab. Adaptez chemins, adresses, credentials, versions et noms de ressources. Ne placez jamais un secret réel dans un dépôt, une variable affichée ou un state non protégé.

Méthode de diagnostic

1. Noter la version exacte et la configuration effective.
2. Vérifier le service, le processus ou l’objet cible avant le client applicatif.
3. Lire les logs au moment précis du test.
4. Contrôler réseau, permissions, stockage et dépendances séparément.
5. Produire une preuve positive, puis tester un cas d’échec contrôlé.
6. Documenter la procédure de retour arrière ou de restauration.

Cette méthode évite les diagnostics circulaires où le même outil crée et valide sa propre configuration. Pour une plateforme distribuée, contrôlez aussi quorum, réplication, latence, capacité et comportement pendant une perte partielle.

Pièges fréquents

• copier une commande ancienne sans vérifier la version actuelle;
• considérer le succès d’une commande comme une preuve de résilience;
• mélanger lab, développement et exigences de production;
• ignorer les données persistantes, secrets ou états intermédiaires;
• ajouter de la haute disponibilité sans tester le split brain ou la restauration;
• optimiser avant d’avoir défini une métrique et un objectif.

Bonnes pratiques

• versionner les fichiers de configuration et conserver un historique lisible;
• épingler les versions importantes et suivre les notes de publication;
• séparer accès administrateur et accès applicatif;
• appliquer le moindre privilège;
• sauvegarder les données et tester les restaurations;
• superviser la plateforme avec des signaux indépendants;
• automatiser uniquement après avoir compris le chemin manuel minimal.

Mini-lab conseillé

Reproduisez le scénario avec des noms dédiés au lab. Capturez l’état initial, appliquez une modification unique et comparez l’état final. Supprimez ou arrêtez ensuite une dépendance pour observer le comportement dégradé, puis restaurez le service avec la procédure documentée.

Références externes

• postgresql.org/docs/18/high-availability.html
• repmgr.org/docs/current
• patroni.readthedocs.io/en/latest
• haproxy.com/documentation/haproxy-configuration-tutorials/proxying-essentials/database/postgresql

Ces références sont volontairement limitées à des sources officielles ou primaires. Elles complètent la vidéo et le dépôt sans multiplier les liens génériques.

Liens Xavki

• Vidéo de cet épisode
• Playlist PostgreSQL
• Dépôt GitLab tutorials-postgresql

Continuer la série

• Épisode précédent: PostgreSQL 025 – Restoration : pg_restore et psql
• Épisode suivant: PostgreSQL 027 – Replication : resynchronisation manuel…

FAQ

Cet article remplace-t-il la documentation officielle ?

Non. Il fournit un chemin pédagogique en français, relie la vidéo au support Xavki et signale les évolutions importantes. La référence comportementale reste la documentation de la version réellement installée.

Puis-je reprendre directement les commandes en production ?

Non sans adaptation. Vérifiez versions, chemins, permissions, réseau, secrets, capacité et stratégie de retour arrière. Commencez par un environnement de test représentatif.

Comment savoir si le lab est réellement réussi ?

Définissez une preuve avant le test: état attendu, requête, métrique, log, donnée persistante ou comportement lors d’une panne. Vérifiez ensuite cette preuve avec un outil indépendant.

Pourquoi conserver plusieurs liens externes ?

La vidéo explique la progression, le dépôt fournit les artefacts et les références externes documentent la version actuelle. Cette triangulation améliore la fiabilité pour le lecteur, les moteurs de recherche et les systèmes de recherche assistée par LLM.

Conclusion

L’épisode 26/34, Replication : mise en place, apporte une étape précise au parcours PostgreSQL. Retenez surtout le modèle mental, la preuve attendue et les limites de version. Une pratique devient fiable lorsqu’elle est reproductible, observable et restaurable.