Architecture

The Cluster

A StackGres cluster is basically a StatefulSet where each pod is a database instance. The StatefulSet guarantees that each pod is always bind to its own persistent volume therefore the database instance data will be mapped to the state of a patroni instance inside kubernetes.

StackGres Cluster Architecture diagram

SG Architecture

StackGres Pod Architecture diagram

We use a pattern called sidecar where a main application run in a container and other container are providing a side functionality like connection pooling, export of stats, edge proxying, logging dispatcher or database utilities.

Pod Architecture

UDS: Unix Domain Socket