Repository files navigation

Kubegres is a Kubernetes operator allowing to deploy one or many clusters of PostgreSql pods with datareplication and failover enabled out-of-the box. It brings simplicity when using PostgreSql considering how complex managingstateful-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 isidentified by its unique name and namespace.

• It creates a cluster of PostgreSql servers withStreaming Replication enabled: it creates a Primary PostgreSql pod and anumber 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 over99 automatized tests cases andhas been running in production.

How does Kubegres differentiate itself?

Kubegres is fully integrated with Kubernetes' lifecycle as it runs as an operator written in Go.
It is minimalist in terms of codebase compared to other open-source Postgres operators. It has the minimal andyet robust required features to manage a cluster of PostgreSql on Kubernetes. We aim keeping this project small and simple.

Among many reasons, there are5 main ones why we recommend Kubegres.

Getting started

If you would like to install Kubegres, please read the pageGetting started.

Sponsor

Kubegres is sponsored byEtikbeewhich is using Kubegres in production with over 25 clusters of Postgres.Etikbee is a UK based marketplace which promotes reuse by allowing merchantsto list their products for rent, for sale and advertise services such as product repair.

Contribute

If you would like to contribute to Kubegres, please read the pageHow to contribute.

More details about the project

Kubegres was developed byReactive Tech Limited and AlexArica as the lead developer. Reactive Tech offerssupport services for Kubegres,Kubernetes and PostgreSql.

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

Support

Reactive Tech Limited offers support for organisations using Kubegres. And we prioritisenew features requested by organisations paying supports as long the new features would benefit the Open Source community.We start working on the implementation of new features within 24h of the request from organisations paying supports.More details in thesupport page.

Interesting links

• A webinar about Kubegres was hosted by PostgresConf on 25 May 2021.Watch the recorded video.
• The availability of Kubegres was published onPostgreSql's official website.
• Google talked about Kubegres in theirKubernetes Podcast #146.