Replicación síncrona y failover automático con Patroni en PostgreSQL
Introducción a la alta disponibilidad en PostgreSQL
PostgreSQL es uno de los sistemas de bases de datos relacionales más potentes y confiables, pero por sí solo no ofrece mecanismos nativos de failover automático ni replicación síncrona gestionada. En entornos de producción críticos, donde la pérdida de datos no es tolerable y el tiempo de inactividad debe ser mínimo, se requiere una solución integral. Aquí entra Patroni: un orquestador de alta disponibilidad que, combinado con herramientas como etcd o Consul, permite gestionar clústeres de PostgreSQL con replicación síncrona y failover automático.
¿Qué es Patroni y cómo funciona?
Patroni es un demonio escrito en Python que envuelve a PostgreSQL y lo dota de capacidades de alta disponibilidad. Su función principal es mantener un clúster con un nodo primario y múltiples réplicas, monitorizando constantemente la salud del sistema. Si el primario falla, Patroni elige automáticamente una nueva réplica como primario mediante un consenso distribuido (normalmente con etcd).
La replicación síncrona garantiza que cada transacción confirmada en el primario se confirme también en al menos una réplica síncrona antes de devolver el control al cliente. Esto elimina el riesgo de pérdida de datos en caso de fallo repentino del primario.
Componentes del clúster
- etcd: Almacén clave-valor distribuido que actúa como cerebro del clúster. Almacena la configuración y el estado de cada nodo.
- Patroni: Demonio en cada nodo que gestiona la instancia de PostgreSQL y se comunica con etcd.
- PostgreSQL: Base de datos con replicación nativa (flujo de registros).
- HAProxy o pgBouncer: Balanceador de carga (opcional pero recomendado) para redirigir tráfico al primario.
Configuración de replicación síncrona con Patroni
Para activar la replicación síncrona en un clúster Patroni, se debe definir en la configuración del nodo primario el parámetro synchronous_commit y especificar las réplicas síncronas mediante synchronous_standby_names. Patroni automatiza esto mediante su archivo de configuración YAML.
Ejemplo de configuración básica de Patroni
scope: postgres-cluster namespace: /service/ name: pg-node1restapi: listen: 0.0.0.0:8008 connect_address: 192.168.1.10:8008
etcd: host: 192.168.1.100:2379
bootstrap: dcs: ttl: 30 loop_wait: 10 retry_timeout: 10 maximum_lag_on_failover: 1048576 postgresql: use_pg_rewind: true parameters: wal_level: replica hot_standby: ‘on’ max_wal_senders: 5 max_replication_slots: 5 wal_keep_segments: 8 synchronous_commit: ‘on’ synchronous_standby_names: ‘FIRST 1 (pg-node2, pg-node3)’
postgresql: listen: 0.0.0.0:5432 connect_address: 192.168.1.10:5432 data_dir: /var/lib/postgresql/14/main bin_dir: /usr/lib/postgresql/14/bin pg_hba: - host replication replicator 192.168.1.0/24 md5 - host all all 0.0.0.0/0 md5 authentication: replication: username: replicator password: secret superuser: username: postgres password: secret
En este ejemplo, synchronous_commit: 'on' y synchronous_standby_names: 'FIRST 1 (pg-node2, pg-node3)' indican que al menos una de las dos réplicas debe confirmar sincrónicamente. Patroni ajusta automáticamente estos valores si un nodo cae.
Failover automático: cómo funciona
Cuando el nodo primario falla (por ejemplo, por un corte de energía o caída del proceso PostgreSQL), Patroni detecta la ausencia de latido a través de etcd. Inicia un proceso de elección donde el resto de nodos votan. El nodo con los datos más actualizados (menor lag) es promovido a primario.
Este proceso ocurre típicamente en menos de 30 segundos, dependiendo de la configuración de TTL y loop_wait. Durante ese tiempo, las conexiones de escritura fallan, pero las lecturas pueden seguir sirviéndose desde las réplicas si se usa un balanceador.
Comandos útiles para monitorizar el clúster
# Ver estado del clúster desde cualquier nodo patronictl listForzar failover manual (útil para pruebas)
patronictl failover —master pg-node1 —candidate pg-node2
Restaurar nodo después de reparación
patronictl reinit pg-node1
Ver historial de cambios en etcd
etcdctl get /service/postgres-cluster/ —prefix —keys-only
Integración con HAProxy para enrutamiento inteligente
Para que las aplicaciones no tengan que cambiar la IP del primario tras un failover, se recomienda usar HAProxy configurado con la API REST de Patroni. Esta API expone endpoints como /master y /replica.
Ejemplo de configuración de HAProxy:
frontend postgres_front bind *:5000 default_backend pg_backend
backend pg_backend option httpchk GET /master server pg-node1 192.168.1.10:5432 check port 8008 inter 3s fall 3 rise 2 server pg-node2 192.168.1.11:5432 check port 8008 inter 3s fall 3 rise 2 server pg-node3 192.168.1.12:5432 check port 8008 inter 3s fall 3 rise 2
HAProxy verifica periódicamente el endpoint /master de cada nodo. Solo el nodo que Patroni marca como primario responde HTTP 200, por lo que el tráfico de escritura se redirige correctamente.
Consideraciones de rendimiento y consistencia
La replicación síncrona introduce latencia adicional, ya que cada transacción debe esperar la confirmación de la réplica. En redes de baja latencia (sub-milisegundo dentro del mismo centro de datos), el impacto suele ser menor al 10%. Sin embargo, en entornos geográficamente distribuidos puede ser significativo.
Para mitigar esto, Patroni permite configurar synchronous_commit = remote_write o remote_apply, que ofrecen diferentes niveles de consistencia. remote_apply espera a que los datos se apliquen en la réplica, siendo el más estricto.
Prueba de failover con simulación de fallo
Para verificar que todo funciona, se puede simular un fallo del primario:
# En el nodo primario pg-node1 sudo systemctl stop postgresqlEn otro nodo, ver la elección
patronictl list
Observar cómo pg-node2 es promovido a primario
Reconectar aplicaciones a través de HAProxy (si se usa)
Si la replicación es síncrona, no debería haber pérdida de datos confirmados. Sin embargo, es posible perder transacciones en curso que aún no se confirmaron.
Mejores prácticas para entornos de producción
- Usar un número impar de nodos etcd (3 o 5) para evitar split-brain.
- Configurar pg_rewind para que un nodo antiguo pueda reincorporarse como réplica sin necesidad de un volcado completo.
- Monitorear el lag de replicación con
patronictl listo Prometheus. - Realizar failovers periódicos de forma planificada para probar la resiliencia.
- Ajustar el TTL según la criticidad: valores bajos (10-20 segundos) para failover rápido, pero pueden causar falsos positivos.
Conclusión
Patroni, combinado con replicación síncrona, ofrece una solución robusta y madura para alta disponibilidad en PostgreSQL. Aunque la configuración inicial requiere planificación, el resultado es un sistema que tolera fallos de nodos sin pérdida de datos y con tiempos de recuperación mínimos. Para administradores de sistemas que buscan garantizar SLAs estrictos, es una herramienta indispensable.
No olvides probar exhaustivamente en un entorno de staging antes de pasar a producción, y mantener un monitoreo constante de la salud del clúster. Con Patroni, la alta disponibilidad de PostgreSQL deja de ser un desafío para convertirse en un proceso automatizado y fiable.