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

# Introduction

Une appliance virtuelle peut être utilisée pour déployer un cluster PostgreSQL.
Ce cluster PostgreSQL est généralement exploité avec des plateformes CyberElements Bastion avec l'architecture cluster afin d'assurer la redondance de bout en bout.

> **Note**
>
> Il est rappelé que l'exploitation et la mise à jour des appliances virtuelles mises à disposition par Systancia sont à la responsabilité du Client tel que défini dans [le cycle de vie produit](https://docs.cyberelements.io/ProductLifeCycle/OSAndThirdPartySoftwareSupport/#appliances-virtuelles).

L'appliance virtuelle embarque l'ensemble des composants nécessaires au déploiement d'un cluster PostgreSQL ainsi qu'un utilitaire facillitant son installation. Elle est téléchargeable depuis la Marketplace de Systancia (nécessite la création d'un compte client) : [Systancia Marketplace](https://www.systancia.com/my-systancia/marketplace/systancia-cleanroom/telechargements-cleanroom/)

Le cluster PostgreSQL repose sur 3 nœuds PostgreSQL et l'utilisation d'une adresse IP virtuelle.
L'exploitation de 3 nœuds apporte la résilience du service même s'il perd un nœud (2 nœuds actifs étant le minimum). Ceci fonctionnant à l'aide des composants suivants :

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

A eux trois, ils permettent une gestion automatisée de l’IP virtuelle ainsi que de la réplication.

Ce cluster PostgreSQL ne possède pas un nœud comme étant `LEADER` en toute circonstance, le `LEADER` alterne suivant les aléas rencontrés par le cluster. Si le `LEADER` venait à tomber en panne, alors un nouveau `LEADER` serait élu à la majorité absolue et l’IP virtuelle basculera vers ce dernier. A noter qu’un délai de 20 secondes environ est nécessaire pour identifier de manière certaine la perte du `LEADER` et basculer l’IP virtuelle sur le nouveau `LEADER`.
Le nœud `LEADER` est le seul à avoir la base de données PostgreSQL en lecture/écriture ; les nœuds `REPLICA` étant en lecture seule.

L'architecture typique d'un cluster CyberElements Bastion s'appuyant sur un cluster PostgreSQL est la suivante :

```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œud 1)
            PSQL-2(PostgreSQL<br/>nœud 2)
            PSQL-3(PostgreSQL<br/>nœud 3)
        end
    end

    MED-M <--> |Interconnexion 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 <--> |Interconnexion de cluster| PSQL-2 <--> |Interconnexion de cluster| PSQL-3 <--> |Interconnexion de cluster| PSQL-1
```

Pour installer un cluster PostgreSQL avec les appliances virtuelles CyberElements, veuillez suivre les étapes ci-dessous :

- (1) Prérequis

  ---

  Définition des prérequis du cluster PostgreSQL.

  [→ Consulter](https://docs.cyberelements.io/bastion/4.6/fr/Installation/Dependencies/PostgreSQLCluster/Installation/Prerequisites/)
- (2) Importation de l'appliance virtuelle

  ---

  L'appliance virtuelle doit être importée 3 fois pour préparer l'installation du cluster PostgreSQL.

  [→ Consulter](https://docs.cyberelements.io/bastion/4.6/fr/Installation/Dependencies/PostgreSQLCluster/Installation/Importation/)
- (3) Installation du cluster PostgreSQL

  ---

  Instructions pour paramétrer et installer le cluster PostgreSQL.

  [→ Consulter](https://docs.cyberelements.io/bastion/4.6/fr/Installation/Dependencies/PostgreSQLCluster/Installation/Install/)
