https://github.com/reactive-tech/kubegres

Kubegres is a Kubernetes operator allowing to deploy one or many clusters of PostgreSql instances and manage databases replication, failover and backup.
https://github.com/reactive-tech/kubegres

kubernetes kubernetes-operator operator postgres postgres-operator postgresql

Last synced: 7 days ago
JSON representation

Kubegres is a Kubernetes operator allowing to deploy one or many clusters of PostgreSql instances and manage databases replication, failover and backup.

• Host: GitHub
• URL: https://github.com/reactive-tech/kubegres
• Owner: reactive-tech
• License: apache-2.0
• Created: 2021-04-12T20:51:59.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2024-03-26T13:22:34.000Z (10 months ago)
• Last Synced: 2024-12-29T08:07:46.328Z (14 days ago)
• Topics: kubernetes, kubernetes-operator, operator, postgres, postgres-operator, postgresql
• Language: Go
• Homepage: https://www.kubegres.io
• Size: 6.19 MB
• Stars: 1,316
• Watchers: 19
• Forks: 74
• Open Issues: 86
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-list - kubegres - tech | 293 | (Go)
• awesome-cloud-native - kubegres - Kubegres is a Kubernetes operator allowing to deploy one or many clusters of PostgreSql instances and manage databases replication, failover and backup. (Kubernetes Operators)
• awesome-k8s-resources - Kubegres - 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. (Tools and Libraries / Data Management)

README

        
[Kubegres](https://www.kubegres.io/) 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](https://wiki.postgresql.org/wiki/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 [99 automatized tests](https://github.com/reactive-tech/kubegres/tree/main/internal/test) cases and

  has 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 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](https://www.kubegres.io/#kubegres_compared).

**Getting started**

If you would like to install Kubegres, please read the page [Getting started](http://www.kubegres.io/doc/getting-started.html).

**Sponsor**

Kubegres is sponsored by [Etikbee](https://www.etikbee.com) 

which is using Kubegres in production with over 25 clusters of Postgres.

Etikbee is a UK based marketplace which promotes reuse by allowing merchants 

to 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 page [How to contribute](http://www.kubegres.io/contribute/).

**More details about the project**

[Kubegres](https://www.kubegres.io/) was developed by [Reactive Tech Limited](https://www.reactive-tech.io/)  and Alex

Arica as the lead developer. Reactive Tech offers [support services](https://www.kubegres.io/support/) for Kubegres,

Kubernetes and PostgreSql.

It was developed with the framework [Kubebuilder](https://book.kubebuilder.io/) version 3, an SDK for building Kubernetes

APIs using CRDs. Kubebuilder is maintained by the official Kubernetes API Machinery Special Interest Group (SIG).

**Support**

[Reactive Tech Limited](https://www.reactive-tech.io/) offers support for organisations using Kubegres. And we prioritise

new 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 the [support page](https://www.kubegres.io/support/).

**Interesting links**

* A webinar about Kubegres was hosted by PostgresConf on 25 May 2021. [Watch the recorded video.](https://postgresconf.org/conferences/2021_Postgres_Conference_Webinars/program/proposals/creating-a-resilient-postgresql-cluster-with-kubegres)

* The availability of Kubegres was published on [PostgreSql's official website](https://www.postgresql.org/about/news/kubegres-is-available-as-open-source-2197/).

* Google talked about Kubegres in their [Kubernetes Podcast #146](https://kubernetespodcast.com/episode/146-kubernetes-1.21/).