reactivetechio/kubegres repository overview

Kubegres⁠ is a Kubernetes operator allowing to deploy one or many clusters of PostgreSql pods with data replication and failover enabled out-of-the box. It brings simplicity when using PostgreSql considering how complex managing stateful-set's life-cycle and data replication could be with Kubernetes.

Features

• It can manage one or many clusters of Postgres instances. Each cluster of Postgres instances is created using a YAML of "kind: Kubegres". Each cluster is self-contained and is identified by its unique name and namespace.

• It creates a cluster of PostgreSql servers with Streaming Replication⁠ enabled: it creates a Primary PostgreSql pod and a number of Replica PostgreSql pods and replicates primary's database in real-time to Replica pods.

• It manages fail-over: if a Primary PostgreSql crashes, it automatically promotes a Replica PostgreSql as a Primary.

• It has a data backup option allowing to dump PostgreSql data regularly in a given volume.

• It provides a very simple YAML with properties specialised for PostgreSql.

• It is resilient, has over 85 automatized tests⁠ cases and has been running in production.

Why to use Kubegres over other operators?

Kubegres is minimalist in terms of codebase compared to other open-source Postgres operators. It has the minimal and yet robust required features to manage a cluster of PostgreSql on Kubernetes. We aim keeping this project small and simple.

Among many reasons, there are 5 main ones why we recommend Kubegres⁠.

Getting started

If you would like to install Kubegres, please read the page Getting started⁠.

Contribute

If you would like to contribute to Kubegres, please read the page How to contribute⁠.

More details about the project

Kubegres⁠ was developed by Reactive Tech Limited⁠ and Alex Arica as the lead developer. Reactive Tech offers support services⁠ for Kubegres, Kubernetes and PostgreSql.

It was developed with the framework Kubebuilder⁠ version 3, an SDK for building Kubernetes APIs using CRDs. Kubebuilder is maintained by the official Kubernetes API Machinery Special Interest Group (SIG).