patrón es un marco de gestión de clústeres avanzado y de código abierto que proporciona alta disponibilidad real a PostgreSQL entornos. Fue desarrollado originalmente por Zalando para abordar la complejidad de administrar clústeres de bases de datos distribuidas y garantizar una operación sin interrupciones. conmutación por error, replicacióny el ámbito consistencia de los datos en múltiples nodos. Con el tiempo, Patroni se ha convertido en una de las herramientas más fiables y ampliamente adoptadas para construir sistemas resilientes. PostgreSQL infraestructuras tanto en ecosistemas locales como nativos de la nube.
A diferencia de las configuraciones de replicación tradicionales que dependen de procedimientos manuales de conmutación por error o scripts personalizados, Patroni introduce una capa de orquestación inteligente que automatiza todo el proceso de coordinación del clúster. Supervisa continuamente el estado de todos los nodos, identifica fallos en tiempo real y promueve las réplicas en espera a roles primarios cuando es necesario, todo ello sin intervención humana. Esta automatización minimiza el tiempo de inactividad, preserva la integridad de los datos y garantiza un servicio ininterrumpido incluso durante interrupciones inesperadas o tareas de mantenimiento.
Patroni está diseñado pensando en la flexibilidad y la extensibilidad. Se integra perfectamente con sistemas de configuración distribuida como Etc., Consul o guardián del zoológico, que actúan como la columna vertebral para la elección del líder y la sincronización del estado del clúster. Su funcionalidad integrada REST API permite que las herramientas externas y los sistemas de monitorización interactúen fácilmente con el clúster, al tiempo que ofrece soporte para HAProxy además PgBouncer Garantiza un equilibrio de carga y un enrutamiento de conexiones eficientes.
Gracias a su fiabilidad, transparencia y sólido apoyo de la comunidad, Patroni se ha convertido en el estándar de facto para lograr alta disponibilidad PostgreSQL despliegues. Ya sea que administre bases de datos de misión crítica en infraestructura empresarial o escale cargas de trabajo en entornos contenerizados como KubernetesPatroni ofrece las herramientas y la automatización que necesita para mantener sus sistemas consistentes, tolerantes a fallos y siempre en línea.
Cómo funciona un grupo de Patroni
Un clúster Patroni consta de varios componentes que interactúan entre sí:
- Primaria (maestra) – el principal PostgreSQL Servidor que gestiona las solicitudes de escritura.
- Réplica (en espera) – réplica(s) que reciben datos a través de replicación de flujo continuo.
- DCS (Almacén de configuración distribuida) – un almacén externo de configuración y estado del clúster (por ejemplo, Etc., Consul o guardián del zoológico).
- Agentes de Patroni – procesos que se ejecutan en cada nodo y que gestionan PostgreSQL y coordinar sus acciones a través del DCS.
Cada nodo del clúster ejecuta su propio proceso. demonio Patroni, cuales:
- Monitorea el estado de PostgreSQL.
- Consulta al DCS para obtener el líder actual (primario).
- Puede ascender a líder principal si el líder actual no está disponible.
Cómo funciona Patroni
El funcionamiento de Patroni se basa en el concepto de elección de líder a través del DCS.
- Un nodo obtiene el “liderazgo” — se convierte en el primaria.
- Otros nodos sincronizan sus datos con el nodo primario mediante PostgreSQLreplicación integrada.
- Si el líder falla (por ejemplo, si el servidor no está disponible o no responde), Patroni realiza una conmutación por error automática:
- Se selecciona un nuevo líder de entre las réplicas disponibles.
- El clúster actualiza su información en el DCS.
- Las aplicaciones redirigen las solicitudes al nuevo servidor primario (a través de HAProxy, PgBouncer u otro middleware).
Esto asegura tiempo de inactividad mínimo además disponibilidad continua de la base de datos.
Características y beneficios de Patroni
- Failover automático El cambio de roles entre nodos se produce automáticamente en caso de fallo, sin intervención del administrador.
- Integración con sistemas externos Patroni es compatible con DCS (Etcd, Consul, ZooKeeper) para coordinar el estado del clúster.
- Configuración de replicación flexible Puedes usar tanto métodos síncronos como asíncronos. PostgreSQL replicación.
- REST API Cada nodo expone un API para la gestión, el monitoreo y la integración con herramientas externas.
- Compatibilidad con balanceadores de carga externos Patroni se integra fácilmente con HAProxy o PgBouncer para enrutar las conexiones de los clientes al servidor primario actual.
Ejemplo de una topología de Patroni
Una configuración sencilla de un clúster Patroni podría tener este aspecto:
+------------------+
| HAProxy |
| (balancer) |
+--------+---------+
|
+---------+---------+
| |
+------+-----+ +-------+------+
| PostgreSQL | | PostgreSQL |
| (Primary) | | (Replica) |
+------+-----+ +-------+------+
| |
+----+----+ +----+----+
| Patroni | | Patroni |
+----+----+ +----+----+
| |
+---------+---------+
|
+------+------+
| Etcd / |
| Consul |
+-------------+Instalación y configuración de Patroni
Patroni se puede instalar mediante un gestor de paquetes o desde el código fuente:
pip install patroni[etcd]Ejemplo de configuración mínima (/etc/patroni.yml):
scope: pg_cluster
name: db-node-01
restapi:
listen: 0.0.0.0:8010
connect_address: 10.0.0.11:8010
etcd:
host: 10.0.0.100:2380
postgresql:
listen: 0.0.0.0:5433
connect_address: 10.0.0.11:5433
data_dir: /var/lib/postgresql/15/data
authentication:
replication:
username: repl_user
password: repl_secret
superuser:
username: pg_admin
password: super_secure
parameters:
max_connections: 150
shared_buffers: 512MB
wal_level: replica
hot_standby: on
Una vez configurados todos los nodos e iniciado Patroni, el proceso de coordinación y replicación comienza automáticamente.
Conclusión: Consejos prácticos
El patronímico es más que una simple capa encima de PostgreSQL — Es un sistema de gestión del ciclo de vida completo para clústeres de bases de datos. Combina replicación, conmutación por error automática y configuración dinámica, lo que lo hace esencial para entornos de producción donde el tiempo de inactividad es inaceptable.
Desde una perspectiva técnica, Patroni actúa como un “coordinador” entre PostgreSQL los nodos, sincronizando su estado mediante un almacenamiento distribuido (Etcd, Consul o ZooKeeper). Esto le permite:
- Supervisar el estado de los nodos: cada réplica informa periódicamente de su estado al DCS (Almacén de Configuración Distribuida);
- Elija un líder: si el nodo principal falla, se promueve automáticamente uno nuevo sin intervención manual;
- Actualización de la configuración del clúster sin tiempo de inactividad: los cambios se aplican dinámicamente mediante la API REST de Patroni. API;
- Integración con sistemas de orquestación, por ejemplo, Patroni. Kubernetes El operador permite ejecutar aplicaciones de alta disponibilidad. PostgreSQL en entornos contenerizados;
- Ajuste la sincronización de réplicas: elija entre el modo síncrono y el modo asíncrono según los datos. SLA • Requisitos.
Para una mayor resiliencia de la producción, se recomienda:
- Despliegue al menos tres PostgreSQL nodos y tres nodos DCS (por ejemplo, Etcd);
- Configure HAProxy o PgBouncer para enrutar las conexiones de los clientes;
- Realizar pruebas de conmutación por error periódicas y copias de seguridad de los archivos WAL;
- Monitorización mediante Prometheus Exporter, incluido con Patroni.
Patroni funciona a la perfección con herramientas como pgBackRest, Grafana, Ansible y Kubernetes, formando una base sólida para las infraestructuras modernas en la nube.
Preguntas Frecuentes
- ¿Se puede usar Patroni sin Etcd o Consul? No. Patroni requiere un DCS (como Etcd, ZooKeeper o Consul) para almacenar metadatos y realizar elecciones de líder.
- ¿Se requiere un servidor independiente para el DCS? Sí, el DCS debería implementarse independientemente de PostgreSQL nodos para evitar un único punto de fallo.
- ¿Admite Patroni la replicación síncrona? Sí, puedes configurar réplicas síncronas configurando modo_síncrono: verdadero.
- ¿Cómo puedo monitorizar el clúster? A través del REST API (/patroni) o herramientas externas como Prometheus + Grafana.
- ¿Puede correr Patroni en Docker? Sí, los entornos contenerizados son oficialmente compatibles; existen imágenes listas para usar y un gráfico de Helm para Kubernetes.
Serverspace Base de Conocimientos
En el Serverspace Base de ConocimientosDescubrirás una amplia colección de materiales educativos diseñados para ayudar a ingenieros, administradores y desarrolladores a dominar las tecnologías modernas de la nube y DevOps. Además de artículos sobre PostgreSQL además patrónNuestra biblioteca incluye guías detalladas paso a paso sobre la implementación y la gestión. Kubernetes clústeres: desde la configuración inicial hasta escenarios de orquestación avanzados. Puede aprender a configurarlos. Los espacios de nombres, Vainasy el ámbito Conjuntos con estado, optimizar la asignación de recursos e implementar canalizaciones CI/CD seguras y automatizadas utilizando herramientas populares como Argo CD además GitLab CI.
Para los usuarios que buscan mejorar la resiliencia del sistema, también ofrecemos artículos sobre integración. Prometheus además Grafana para la observabilidad y el monitoreo, configurando administrador de alertasy la creación de paneles de control que ofrecen visibilidad en tiempo real del rendimiento del clúster. Si su enfoque está en la entrega de aplicaciones, encontrará materiales prácticos sobre Docker optimización de imágenes, utilizando Casco para despliegues con control de versiones e implementación de descubrimiento de servicios con Consul además Istio.
Nuestra base de conocimientos abarca una amplia gama de temas relacionados con la gestión y automatización de infraestructuras: desde la configuración Terraform Scripts para la gestión de entornos multi-nube Ansible Guías prácticas para el aprovisionamiento escalable de servidores. Cada artículo se centra en la aplicación práctica, proporcionando ejemplos de configuración, fragmentos de código y buenas prácticas que reflejan escenarios de producción reales.
Tanto si estás empezando tu andadura en entornos contenerizados como si ya gestionas entornos complejos Kubernetes clústeres en producción, los Serverspace La base de conocimientos ofrece información valiosa para guiar su desarrollo. Al explorar nuestros materiales, que se actualizan periódicamente, se mantendrá al día sobre las últimas tecnologías, patrones de arquitectura en la nube y metodologías DevOps, lo que le ayudará a crear sistemas más rápidos, seguros y fiables en la nube.
