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

# Johdanto

Virtuaalisen appliance-laitteen avulla voi ottaa käyttöön PostgreSQL-klusterin.
Tätä PostgreSQL-klusteria käytetään tyypillisesti Cluster-arkkitehtuurin CyberElements Bastion -alustojen kanssa päästä päähän -redundanssin varmistamiseksi.

> **Huomautus**
>
> Huomaa, että Systancian tarjoamien virtuaalisten appliance-laitteiden käyttö ja päivittäminen ovat asiakkaan vastuulla, kuten [tuotteen elinkaaressa](https://docs.cyberelements.io/ProductLifeCycle/OSAndThirdPartySoftwareSupport/#virtual-appliances) on määritelty.

Virtuaalinen appliance sisältää kaikki PostgreSQL-klusterin käyttöönottoon tarvittavat komponentit sekä työkalun, joka helpottaa sen asennusta. Sen voi ladata Systancia Marketplace -sivustolta (edellyttää asiakastilin luomista): [Systancia Marketplace](https://www.systancia.com/en/my-systancia/marketplace/systancia-cleanroom/downloads-cleanroom/)

PostgreSQL-klusteri perustuu kolmeen PostgreSQL-solmuun ja virtuaalisen IP-osoitteen käyttöön.
Kolmen solmun käyttö varmistaa palvelun vikasietoisuuden myös yhden solmun menetyksessä (kaksi aktiivista solmua on vähimmäismäärä). Tämä toimii seuraavien komponenttien avulla:

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

Yhdessä ne mahdollistavat virtuaalisen IP-osoitteen ja replikoinnin automatisoidun hallinnan.

Tässä PostgreSQL-klusterissa ei ole pysyvästi `LEADER`-solmuksi määritettyä solmua: `LEADER` vaihtuu klusterin kohtaamien olosuhteiden mukaan. Jos `LEADER` vikaantuisi, uusi `LEADER` valittaisiin ehdottomalla äänten enemmistöllä ja virtuaalinen IP-osoite siirtyisi sille. Huomaa, että `LEADER`-solmun menetyksen luotettava havaitseminen ja virtuaalisen IP-osoitteen siirtäminen uudelle `LEADER`-solmulle kestää noin 20 sekuntia.
`LEADER`-solmu on ainoa, jolla on luku- ja kirjoitusoikeus PostgreSQL-tietokantaan; `REPLICA`-solmut ovat vain luettavissa.

PostgreSQL-klusteriin perustuvan CyberElements Bastion -klusterin tyypillinen arkkitehtuuri on seuraavanlainen:

```mermaid
flowchart LR
    subgraph Cloud tai 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/>solmu 1)
            PSQL-2(PostgreSQL<br/>solmu 2)
            PSQL-3(PostgreSQL<br/>solmu 3)
        end
    end

    MED-M <--> |Cluster-yhteenliitäntä| 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 <--> |Cluster-yhteenliitäntä| PSQL-2 <--> |Cluster-yhteenliitäntä| PSQL-3 <--> |Cluster-yhteenliitäntä| PSQL-1
```

Asenna PostgreSQL-klusteri CyberElementsin virtuaalisilla appliance-laitteilla seuraavien vaiheiden mukaan:

- (1) Edellytykset

  ---

  PostgreSQL-klusterin edellytysten määrittely.

  [→ Lue lisää](https://docs.cyberelements.io/bastion/4.6/fi/Installation/Dependencies/PostgreSQLCluster/Installation/Prerequisites/)
- (2) Virtuaalisen appliance-laitteen tuonti

  ---

  Virtuaalinen appliance on tuotava kolme kertaa PostgreSQL-klusterin asennuksen valmistelemiseksi.

  [→ Lue lisää](https://docs.cyberelements.io/bastion/4.6/fi/Installation/Dependencies/PostgreSQLCluster/Installation/Importation/)
- (3) PostgreSQL-klusterin asennus

  ---

  Ohjeet PostgreSQL-klusterin määrittämiseen ja asentamiseen.

  [→ Lue lisää](https://docs.cyberelements.io/bastion/4.6/fi/Installation/Dependencies/PostgreSQLCluster/Installation/Install/)
