> Source: https://docs.cyberelements.io/bastion/4.6/pt/Installation/Dependencies/PostgreSQLCluster/PostgreSQLClusterIntroduction/

# Introdução

Uma appliance virtual pode ser utilizada para implementar um cluster PostgreSQL.
Este cluster PostgreSQL é normalmente explorado com plataformas CyberElements Bastion de arquitetura Cluster, para garantir uma redundância de ponta a ponta.

> **Nota**
>
> Tenha em conta que a exploração e a atualização das appliances virtuais fornecidas pela Systancia são da responsabilidade do cliente, tal como definido em [o ciclo de vida do produto](https://docs.cyberelements.io/ProductLifeCycle/OSAndThirdPartySoftwareSupport/#virtual-appliances).

A appliance virtual inclui todos os componentes necessários para implementar um cluster PostgreSQL, bem como um utilitário que facilita a sua instalação. Pode ser transferida do Systancia Marketplace (requer a criação de uma conta de cliente): [Systancia Marketplace](https://www.systancia.com/en/my-systancia/marketplace/systancia-cleanroom/downloads-cleanroom/)

O cluster PostgreSQL baseia-se em três nós PostgreSQL e na utilização de um endereço IP virtual.
A utilização de três nós garante a resiliência do serviço mesmo em caso de perda de um nó (dois nós ativos são o mínimo). Funciona graças aos componentes seguintes:

- [Patroni](https://github.com/patroni/patroni)
- [Etcd](https://etcd.io/)
- [Keepalived](https://keepalived.org/)

Em conjunto, permitem uma gestão automatizada do IP virtual e da replicação.

Este cluster PostgreSQL não tem um nó designado `LEADER` de forma permanente: o `LEADER` alterna em função das circunstâncias que o cluster atravessa. Se o `LEADER` falhasse, um novo `LEADER` seria eleito por maioria absoluta e o IP virtual comutaria para este último. Tenha em conta que são necessários cerca de 20 segundos para identificar de forma fiável a perda do `LEADER` e comutar o IP virtual para o novo `LEADER`.
O nó `LEADER` é o único com acesso de leitura/escrita à base de dados PostgreSQL; os nós `REPLICA` são apenas de leitura.

A arquitetura típica de um cluster CyberElements Bastion baseado num cluster PostgreSQL é a seguinte:

```mermaid
flowchart LR
    subgraph Cloud ou DMZ
        MED-M(Mediation Controller<br/>MASTER)
        MED-S(Mediation Controller<br/>SLAVE)
    end
    subgraph LAN
        GW-1(Edge Gateway 1)
        GW-2(Edge Gateway 2)
        subgraph PSQL [PostgreSQL Cluster]
            direction TB
            PSQL-1(PostgreSQL<br/>nó 1)
            PSQL-2(PostgreSQL<br/>nó 2)
            PSQL-3(PostgreSQL<br/>nó 3)
        end
    end

    MED-M <--> |Interligação de cluster| MED-S
    GW-1 & GW-2 --> |TLS| MED-M & MED-S
    MED-M & MED-S ~~~ GW-1 & GW-2
    GW-1 & GW-2 -..-> |SQL| PSQL

    PSQL-1 <--> |Interligação de cluster| PSQL-2 <--> |Interligação de cluster| PSQL-3 <--> |Interligação de cluster| PSQL-1
```

Para instalar um cluster PostgreSQL com as appliances virtuais da CyberElements, siga as etapas abaixo:

- (1) Pré-requisitos

  ---

  Definição dos pré-requisitos do cluster PostgreSQL.

  [→ Ver mais](https://docs.cyberelements.io/bastion/4.6/pt/Installation/Dependencies/PostgreSQLCluster/Installation/Prerequisites/)
- (2) Importar a appliance virtual

  ---

  A appliance virtual deve ser importada três vezes para preparar a instalação do cluster PostgreSQL.

  [→ Ver mais](https://docs.cyberelements.io/bastion/4.6/pt/Installation/Dependencies/PostgreSQLCluster/Installation/Importation/)
- (3) Instalar o cluster PostgreSQL

  ---

  Instruções de configuração e de instalação do cluster PostgreSQL.

  [→ Ver mais](https://docs.cyberelements.io/bastion/4.6/pt/Installation/Dependencies/PostgreSQLCluster/Installation/Install/)
