97 lines
4.7 KiB
Markdown
97 lines
4.7 KiB
Markdown
# Postgres Operator
|
|
|
|
|
|
|
|
[](https://coveralls.io/github/zalando/postgres-operator?branch=master)
|
|
|
|
<img src="docs/diagrams/logo.png" width="200">
|
|
|
|
The Postgres Operator delivers an easy to run highly-available [PostgreSQL](https://www.postgresql.org/)
|
|
clusters on Kubernetes (K8s) powered by [Patroni](https://github.com/zalando/patroni).
|
|
It is configured only through Postgres manifests (CRDs) to ease integration into automated CI/CD
|
|
pipelines with no access to Kubernetes API directly, promoting infrastructure as code vs manual operations.
|
|
|
|
### Operator features
|
|
|
|
* Rolling updates on Postgres cluster changes, incl. quick minor version updates
|
|
* Live volume resize without pod restarts (AWS EBS, PVC)
|
|
* Database connection pooling with PGBouncer
|
|
* Support fast in place major version upgrade. Supports global upgrade of all clusters.
|
|
* Pod protection during boostrap phase and configurable maintenance windows
|
|
* Restore and cloning Postgres clusters on AWS, GCS and Azure
|
|
* Additionally logical backups to S3 or GCS bucket can be configured
|
|
* Standby cluster from S3 or GCS WAL archive
|
|
* Configurable for non-cloud environments
|
|
* Basic credential and user management on K8s, eases application deployments
|
|
* Support for custom TLS certificates
|
|
* UI to create and edit Postgres cluster manifests
|
|
* Compatible with OpenShift
|
|
|
|
### PostgreSQL features
|
|
|
|
* Supports PostgreSQL 17, starting from 13+
|
|
* Streaming replication cluster via Patroni
|
|
* Point-In-Time-Recovery with
|
|
[pg_basebackup](https://www.postgresql.org/docs/17/app-pgbasebackup.html) /
|
|
[WAL-G](https://github.com/wal-g/wal-g) or [WAL-E](https://github.com/wal-e/wal-e) via [Spilo](https://github.com/zalando/spilo)
|
|
* Preload libraries: [bg_mon](https://github.com/CyberDem0n/bg_mon),
|
|
[pg_stat_statements](https://www.postgresql.org/docs/17/pgstatstatements.html),
|
|
[pgextwlist](https://github.com/dimitri/pgextwlist),
|
|
[pg_auth_mon](https://github.com/RafiaSabih/pg_auth_mon)
|
|
* Incl. popular Postgres extensions such as
|
|
[decoderbufs](https://github.com/debezium/postgres-decoderbufs),
|
|
[hypopg](https://github.com/HypoPG/hypopg),
|
|
[pg_cron](https://github.com/citusdata/pg_cron),
|
|
[pg_repack](https://github.com/reorg/pg_repack),
|
|
[pg_partman](https://github.com/pgpartman/pg_partman),
|
|
[pg_stat_kcache](https://github.com/powa-team/pg_stat_kcache),
|
|
[pg_audit](https://github.com/pgaudit/pgaudit),
|
|
[pgfaceting](https://github.com/cybertec-postgresql/pgfaceting),
|
|
[pgq](https://github.com/pgq/pgq),
|
|
[pgvector](https://github.com/pgvector/pgvector),
|
|
[plpgsql_check](https://github.com/okbob/plpgsql_check),
|
|
[plproxy](https://github.com/plproxy/plproxy),
|
|
[postgis](https://postgis.net/),
|
|
[roaringbitmap](https://github.com/ChenHuajun/pg_roaringbitmap),
|
|
[set_user](https://github.com/pgaudit/set_user) and
|
|
[timescaledb](https://github.com/timescale/timescaledb)
|
|
|
|
The Postgres Operator has been developed at Zalando and is being used in
|
|
production for over five years.
|
|
|
|
## Supported Postgres & K8s versions
|
|
|
|
| Release | Postgres versions | K8s versions | Golang |
|
|
| :-------- | :---------------: | :---------------: | :-----: |
|
|
| v1.15.0 | 13 → 17 | 1.27+ | 1.25.3 |
|
|
| v1.14.0 | 13 → 17 | 1.27+ | 1.23.4 |
|
|
| v1.13.0 | 12 → 16 | 1.27+ | 1.22.5 |
|
|
| v1.12.0 | 11 → 16 | 1.27+ | 1.22.3 |
|
|
| v1.11.0 | 11 → 16 | 1.27+ | 1.21.7 |
|
|
| v1.10.1 | 10 → 15 | 1.21+ | 1.19.8 |
|
|
|
|
## Getting started
|
|
|
|
For a quick first impression follow the instructions of this
|
|
[tutorial](docs/quickstart.md).
|
|
|
|
## Supported setups of Postgres and Applications
|
|
|
|
|
|
|
|
|
|
## Documentation
|
|
|
|
There is a browser-friendly version of this documentation at
|
|
[postgres-operator.readthedocs.io](https://postgres-operator.readthedocs.io)
|
|
|
|
* [How it works](docs/index.md)
|
|
* [Installation](docs/quickstart.md#deployment-options)
|
|
* [The Postgres experience on K8s](docs/user.md)
|
|
* [The Postgres Operator UI](docs/operator-ui.md)
|
|
* [DBA options - from RBAC to backup](docs/administrator.md)
|
|
* [Build, debug and extend the operator](docs/developer.md)
|
|
* [Configuration options](docs/reference/operator_parameters.md)
|
|
* [Postgres manifest reference](docs/reference/cluster_manifest.md)
|
|
* [Command-line options and environment variables](docs/reference/command_line_and_environment.md)
|