wils@web ~ $ cat ~/ajuda/como-realizar-a-configuracao-de-high-availability-no-postgresql-15-com-patroni.md

Banco de Dados

Como realizar a configuração de high availability no PostgreSQL 15 com Patroni

atualizado em 11/08/2026

Este manual aborda a configuração de alta disponibilidade (high availability) no PostgreSQL 15 utilizando o Patroni, uma ferramenta que facilita a criação e gerenciamento de clusters PostgreSQL.

Introdução

Com o aumento da necessidade de sistemas resilientes, a alta disponibilidade se torna essencial. O Patroni, em conjunto com o etcd ou Consul, oferece uma solução robusta para gerenciar a replicação e failover do PostgreSQL.

Pré-requisitos

  • PostgreSQL 15 instalado em todos os nós.
  • Patroni instalado em todos os nós.
  • etcd ou Consul configurado e em funcionamento.
  • Python 3.6 ou superior.

Passo a Passo

1. Instalação do Patroni

pip install patroni[etcd]

2. Configuração do etcd

Instale o etcd e inicie o serviço:

sudo apt-get install etcd
sudo systemctl start etcd

3. Configuração do Patroni

Criar um arquivo de configuração para o Patroni:

sudo nano /etc/patroni.yml

Um exemplo de configuração:

scope: postgres
name: postgres-node1
restapi:
  listen: 0.0.0.0:8008
  connect_address: postgres-node1:8008
etcd:
  host: localhost:2379
bootstrap:
  dcs:
    ttl: 30
    loop_wait: 10
    retry_timeout: 10
    maximum_lag_on_failover: 1048576
  initdb:
    - encoding: UTF8
    - locale: en_US.UTF-8
    - data-checksums: true
  pg_hba:
    - host all all 0.0.0.0/0 md5
  users:
    admin:
      password: admin_password
      options:
        - superuser
        - createdb

4. Iniciar o Patroni

Inicie o Patroni com a configuração criada:

patroni /etc/patroni.yml

5. Verificação do Status

Verifique o status do cluster:

curl http://localhost:8008/patroni

6. Testar Failover

Para simular um failover, pare o serviço PostgreSQL em um nó e verifique se o Patroni promove outro nó:

sudo systemctl stop postgresql

Conclusão

A configuração de alta disponibilidade com PostgreSQL e Patroni é uma solução eficiente para garantir a continuidade dos serviços. É recomendável monitorar o cluster e realizar testes periódicos de failover.

Dica: Considere implementar um sistema de monitoramento para alertas em caso de falhas ou degradação de desempenho do cluster.

Precisa de ajuda com isso no seu servidor? A gente resolve pra você.

falar no WhatsApp

// deu erro ou não funcionou?

Achou algo errado neste manual?

Conta pra gente o que deu errado ou qual erro apareceu — a gente corrige. Se quiser retorno, deixe seu contato.