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

# Wprowadzenie

Wirtualna appliance pozwala wdrożyć cluster PostgreSQL.
Ten cluster PostgreSQL jest zwykle eksploatowany z platformami CyberElements Bastion w architekturze Cluster, aby zapewnić redundancję od końca do końca.

> **Uwaga**
>
> Zwróć uwagę, że eksploatacja i aktualizowanie wirtualnych appliance dostarczanych przez Systancia należą do obowiązków klienta, zgodnie z [cyklem życia produktu](https://docs.cyberelements.io/ProductLifeCycle/OSAndThirdPartySoftwareSupport/#virtual-appliances).

Wirtualna appliance zawiera wszystkie komponenty potrzebne do wdrożenia clustera PostgreSQL, a także narzędzie ułatwiające jego instalację. Można ją pobrać z Systancia Marketplace (wymaga utworzenia konta klienta): [Systancia Marketplace](https://www.systancia.com/en/my-systancia/marketplace/systancia-cleanroom/downloads-cleanroom/)

Cluster PostgreSQL opiera się na trzech węzłach PostgreSQL i użyciu wirtualnego adresu IP.
Użycie trzech węzłów zapewnia odporność usługi nawet przy utracie jednego węzła (minimum to dwa aktywne węzły). Działa to dzięki następującym komponentom:

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

Razem umożliwiają one zautomatyzowane zarządzanie wirtualnym adresem IP i replikacją.

Ten cluster PostgreSQL nie ma węzła wyznaczonego na stałe jako `LEADER`: `LEADER` zmienia się w zależności od okoliczności, w jakich znajdzie się cluster. Gdyby `LEADER` uległ awarii, nowy `LEADER` zostałby wybrany bezwzględną większością głosów, a wirtualny adres IP przełączyłby się na niego. Zwróć uwagę, że niezawodne wykrycie utraty `LEADER` i przełączenie wirtualnego adresu IP na nowy `LEADER` zajmuje około 20 sekund.
Węzeł `LEADER` jest jedynym z dostępem do bazy danych PostgreSQL w trybie odczytu i zapisu; węzły `REPLICA` są tylko do odczytu.

Typowa architektura clustera CyberElements Bastion opartego na clusterze PostgreSQL wygląda następująco:

```mermaid
flowchart LR
    subgraph Cloud lub 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/>węzeł 1)
            PSQL-2(PostgreSQL<br/>węzeł 2)
            PSQL-3(PostgreSQL<br/>węzeł 3)
        end
    end

    MED-M <--> |Połączenie klastrowe| 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 <--> |Połączenie klastrowe| PSQL-2 <--> |Połączenie klastrowe| PSQL-3 <--> |Połączenie klastrowe| PSQL-1
```

Aby zainstalować cluster PostgreSQL z wirtualnymi appliance CyberElements, wykonaj poniższe kroki:

- (1) Wymagania wstępne

  ---

  Określenie wymagań wstępnych clustera PostgreSQL.

  [→ Zobacz więcej](https://docs.cyberelements.io/bastion/4.6/pl/Installation/Dependencies/PostgreSQLCluster/Installation/Prerequisites/)
- (2) Import wirtualnej appliance

  ---

  Wirtualną appliance trzeba zaimportować trzy razy, aby przygotować instalację clustera PostgreSQL.

  [→ Zobacz więcej](https://docs.cyberelements.io/bastion/4.6/pl/Installation/Dependencies/PostgreSQLCluster/Installation/Importation/)
- (3) Instalacja clustera PostgreSQL

  ---

  Instrukcje konfiguracji i instalacji clustera PostgreSQL.

  [→ Zobacz więcej](https://docs.cyberelements.io/bastion/4.6/pl/Installation/Dependencies/PostgreSQLCluster/Installation/Install/)
