Histórico da Página
| Nota | ||
|---|---|---|
| ||
Para prosseguir com a configuração, assegure-se que:
|
Repmgr é uma ferramenta de código aberto para gerenciamento de replicação PostgreSQL. Ele fornece um conjunto abrangente de recursos para gerenciamento de clusters de replicação, incluindo:
- Monitoramento: RepManager pode monitorar a saúde do seu cluster de replicação e alertá-lo sobre quaisquer problemas.
- Gerenciamento: RepManager pode ser usado para criar, iniciar, parar e promover secundários de replicação.
- Failover: RepManager pode ser usado para failover para um novo primário em caso de falha do primário.
RepManager é uma ferramenta poderosa que pode tornar muito mais fácil gerenciar a replicação PostgreSQL. É uma escolha popular para organizações que usam PostgreSQL para aplicativos críticos.
Aqui estão alguns dos benefícios do uso do RepManager:
- Redução da complexidade: simplifica o gerenciamento da replicação PostgreSQL, tornando mais fácil para os administradores gerenciar clusters de replicação complexos.
- Melhoria da confiabilidade: ajuda a melhorar a confiabilidade do seu cluster de replicação PostgreSQL fornecendo recursos de monitoramento e failover, é usada para criar, iniciar, parar e promover secundários de replicação.
- Redução do tempo de inatividade: RepManager pode ajudar a reduzir o tempo de inatividade automatizando o processo de failover.
...
Como fazer?
Inicie com a configuração assíncrona da replicação do Postgresql, conforme documentação
...
Vamos manter o mesmo modelo de exemplo utilizado para replica Assincrona, porém, agora com apoio da ferramenta RepMgr.
Segue estrutura usada no exemplo:
Instalação do Postgresql
/data01/pgsql/15/data
Arquivos de Dados:
/data02
Arquivos de Indices:
/data03
Servidor Primário
Realize a instalação do
...
repmgr pelo sistema operacional:
| Bloco de código |
|---|
sudo dnf -y install repmgr_15.x86_64 |
...
No servidor primário
...
Altere os seguintes parâmetros diretamente no
...
banco de dados, ou no arquivo de configuração postgresql.conf:
| Bloco de código |
|---|
...
wal_level: replica
hot_standby: on
max_wal_senders: 10
max_replication_slots: 10
wal_level: replica
archive_command: 'bin/true'
shared_preload_libraries: 'repmgr'
wal_log_hints: on
|
Ou diretamente pelo banco de dados, conectado ao psql ou ao pgAdmin:
...
ALTER SYSTEM SET max_wal_senders = 10;
ALTER SYSTEM SET max_replication_slots= 10;
ALTER SYSTEM SET wal_level= replica;
ALTER SYSTEM SET hot_standby= on;
ALTER SYSTEM SET archive_command= 'bin/true';
ALTER SYSTEM SET shared_preload_libraries= 'repmgr';
ALTER SYSTEM SET wal_log_hints= on; |
| Bloco de código |
|---|
- Realizar a criação do usuário para replicação. Ao criar o usuário para replicação, você pode escolher o nome desejado. Nós o designamos como "repmgr".
No Sistema Operacional:
su - postgres createuser -s repmgr |
Verificar métodos de autenticação Postgresql.
O usuário para a replicação foi inicialmente configurado como superusuário, conforme indicado na documentação oficial do repmgr. No entanto, é possível optar por conceder permissões específicas de replicações, acompanhadas de algumas restrições.
Criação Database:
No Sistema Operacional:
| Bloco de código |
|---|
su - postgres
createdb repmgr -O repmgr |
- Adicionar o range de IPs com liberação e usuário no arquivo hba.conf:
Arquivo de configuração: /data01/pgsql/15/data/pg_hba.conf
...
| ||
wal_level: replica
hot_standby: on
max_wal_senders: 10
max_replication_slots: 10
wal_level: replica
archive_command: 'bin/true'
shared_preload_libraries: 'repmgr'
wal_log_hints: on |
Crie um usuário para a replicação. Este usuário deve ter as permissões listadas no documento de referência (em inglês) ou estar configurado como superusuário.
| Nota | ||
|---|---|---|
| ||
Verifique com sua equipe de segurança a melhor configuração para o usuário do repmgr. Algumas funcionalidades do repmgr precisarão ser executadas com a flag -S / --superuser caso o usuário designado não possua a permissão de superusuário. |
Após isso, dê a permissão para o usuário designado para replicação no arquivo pg_hba.conf. Troque "<usuario-de-replicacao>" pelo usuário que irá fazer a replicação, "<range-de-ip>" pela faixa de IPs ou pelo IP do servidor secundário, e <metodo-de-autenticacao>" pelo método de autenticação que será utilizado pelo usuário de replicação.
| Bloco de código |
|---|
#replication
|
...
host replication all ::1/128 trust |
...
host replication |
...
<usuario-de-replicacao> <range-de-ip> <metodo-de-autenticacao> #repmgr local repmgr |
...
<usuario-de-replicacao> <metodo-de-autenticacao> host repmgr |
...
<usuario-de-replicacao> 127.0.0.1/32 |
...
<metodo-de-autenticacao> host repmgr |
...
<usuario-de-replicacao> <range-de-ip> <metodo-de-autenticacao> |
Crie o arquivo de
...
configuração repmgr.
...
Com usuário postgres criamos o arquivo no seguinte path: /data01/pgsql/15/repmgr.conf e alteramos com editor de textos vim:
Sistema Operacional
conf no diretório de instalação do PostgreSQL.
| Bloco de código |
|---|
# repmgr.conf
node_id=1
node_name=primary
conninfo='host= |
...
<ip-servidor-primario> dbname= |
...
<banco-de-dados> user= |
...
<usuario-de-replicacao> connect_timeout=2' data_directory=' |
...
<diretorio-de-dados-postgres>' failover=automatic promote_command='/usr/pgsql-15/bin/repmgr standby promote -f |
...
<diretorio-instalacao-postgres>/repmgr.conf --log-to-file' follow_command='/usr/pgsql-15/bin/repmgr standby follow -f |
...
<diretorio-instalacao-postgres>/repmgr.conf --log-to-file --upstream-node-id=%n' pg_bindir='/usr/pgsql-15/bin/' log_file=' |
...
<diretorio-instalacao-postgres>/repmgr.log' |
Para que as alterações fiquem válidas, reinicie o Serviço do Postgresql.
...
| Bloco de código |
|---|
sudo systemctl restart postgresql-15.service |
...
Registre o Cluster primário no Repmgr:
Sistema Operacional
| Bloco de código |
|---|
su - postgres
cd /usr/pgsql-15/bin
./repmgr -f /data01/pgsql/15/repmgr.conf primary register
### Consultar a inclusão no repmgr:
./repmgr -f |
...
<diretorio-instalacao-postgres>/repmgr.conf cluster show ./repmgr -f |
...
<diretorio-instalacao-postgres>/repmgr.conf cluster show |
Resultado da consulta:
No servidor secundário
Realize a instalação do
...
repmgr pelo sistema operacional:
| Bloco de código |
|---|
sudo dnf -y install repmgr_15.x86_64 |
...
Pare o serviço do PostgreSQL.
...
| Bloco de código |
|---|
sudo systemctl stop postgresql-15.service |
- Com usuário Postgres do Sistema Operacional, apagar os paths exclusivamente relacionados ao Postgres. Como temos somente arquivos postgres nessas unidades, rodamos o comando a seguir:
É crucial lembrar que o comando a seguir apaga 'tudo no path indicado'. Certifique-se de estar no path correto, pois o comando não solicitará nenhuma confirmação.
Sistema Operacional
su - postgres
rm -rf /data01/pgsql/15/*
rm -rf /data03/*
rm -rf /data02/*
Crie o arquivo de
...
configuração repmgr.
Com usuário postgres
...
, crie o arquivo no seguinte path:
...
<diretorio-instalacao-postgres>/repmgr.conf
...
:
Sistema Operacional
| Bloco de código |
|---|
# repmgr.conf - Standby
node_id=2
node_name=standby
conninfo='host= |
...
<host-secundario> dbname= |
...
<banco-de-dados> user= |
...
<usuario-de-replicacao> connect_timeout=2' data_directory=' |
...
<diretorio-de-dados-postgres>' failover=automatic promote_command='/usr/pgsql-15/bin/repmgr standby promote -f |
...
<diretorio-instalacao-postgres>/repmgr.conf --log-to-file' follow_command='/usr/pgsql-15/bin/repmgr standby follow -f |
...
<diretorio-instalacao-postgres>/repmgr.conf --log-to-file --upstream-node-id=%n' pg_bindir='/usr/pgsql-15/bin/' log_file=' |
...
<diretorio-instalacao-postgres>/repmgr.log' |
Realize o clone do banco de dados primário:
Sistema Operacional
| Bloco de código |
|---|
su - postgres
cd /usr/pgsql-15/bin
## Realizar o clone dos Dados
./repmgr -h |
...
<host-primario> -U repmgr -f |
...
<diretorio-instalacao-postgres>/repmgr.conf standby clone ## Inicie o postgres systemctl start postgresql-15.service ## Registre o Servidor Standby no Cluster su - postgres cd /usr/pgsql-15/bin ./repmgr -h |
...
<host-primario> -U |
...
<usuario-de-replicacao> -f |
...
<diretorio-instalacao-postgres>/repmgr.conf standby register ## Consultar a inclusão no repmgr: su - postgres cd /usr/pgsql-15/bin ./repmgr -f |
...
<diretorio-instalacao-postgres>/repmgr.conf cluster show |
Resultado da Consulta:
Testando a Réplica
Acesse o postgres no servidor primário, rodamos o seguinte comando para criar uma tabela de exemplo e popular:
| Bloco de código |
|---|
create table repmgr(r_e_c_n_o_ int, d_e_l_e_t_ bpchar (20)); |
| Bloco de código |
|---|
DO $$
DECLARE
BEGIN
FOR i IN 1..10000 LOOP
INSERT INTO repmgr(r_e_c_n_o_ , d_e_l_e_t_) VALUES (random() * 10000 + 1,'Campo' || i );
END LOOP;
END;
$$; |
Ao consultar essa tabela no servidor secundário temos o seguinte resultado:
Ao tentar realizar um drop na tabela no servidor secundário, temos o seguinte retorno:
Para consultar o status da replicação verifique a seguinte view no servidor primário:
| Bloco de código |
|---|
#para tabular
\x
##query de consulta:
select * from pg_stat_replication; |
Resultado:
| Informações |
|---|
O servidor secundário é usado somente para leitura. Não pode realizar a inclusão ou deleção de objetos no banco de dados. |
...
Mais detalhes: https://www.postgresql.org/docs/current/monitoring-stats.html#MONITORING-PG-STAT-REPLICATION-VIEW
...
Confira mais detalhes neste link. |
Caso ocorra um problema no servidor primário, o Repmgr realizará failover automático para a réplica.
Se acompanharmos o log do repmgr:
Vamos verificar onde esta o log.
| Bloco de código |
|---|
cd /usr/pgsql-15/bin
./repmgrd -f /data01/pgsql/15/repmgr.conf
[2023-12-21 00:22:02] [NOTICE] redirecting logging output to "/data01/pgsql/15/repmgr.log"
tail -f /data01/pgsql/15/repmgr.log |
...
A partir do momento em que o servidor primário
...
para de responder,
...
o repmgr
...
transformará a réplica
...
em servidor principal.
...
A partir
...
deste momento
...
, será necessário recriar a conexão com o servidor primário quando este for restabelecido. Os procedimentos abaixo demonstram como transformar o servidor secundário em primário,
...
e o primário original em réplica:
| Bloco de código |
|---|
#validar o resultado do comando com --dry-run
cd /usr/pgsql-15/bin
./repmgr node rejoin -f |
...
<diretorio-instalacao-postgres>/repmgr.conf -d 'host= |
...
<host-secundario> user= |
...
<usuario-de-replicacao> dbname= |
...
<banco-de-dados>' --force-rewind --config-files=postgresql.conf,postgresql.local.conf --verbose --dry-run #remover o |
...
primario antigo e transformar em |
...
secundario ./repmgr node rejoin -f |
...
<diretorio-instalacao-postgres>/repmgr.conf -d 'host= |
...
<host-secundario> user= |
...
<usuario-de-replicacao> dbname= |
...
<banco-de-dados>' --force-rewind --config-files=postgresql.conf,postgresql.local.conf --verbose ## Agora o servidor |
...
replica se torna do primário do Cluster, e o antigo Primario |
...
vira a |
...
replica, recebendo agora os dados, se tornando o servidor |
...
replica. cd /usr/pgsql-15/bin ./repmgr -f |
...
<diretorio-instalacao-postgres>/repmgr.conf cluster show |
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas