| title | keiailab/postgres-operator |
|---|---|
| description | MIT-licensed PostgreSQL Kubernetes Operator — independent new implementation with no embedded external backend |
This operator is an independent new implementation that builds a self-built distributed SQL layer on top of vanilla PostgreSQL 18+ in a K8s native fashion (ADR-0001 keystone). No external PostgreSQL operator runtime is embedded into the product or repackaged as a wrapper. External backend dependencies (AGPL/BUSL/CSL/SSPL) are permanently forbidden (ADR-0003).
If you are curious about the why behind the design decisions, read ADR-0001 first. For deployment, see the deployment guide.
- Declarative PostgresCluster: the operator creates the StatefulSet, Service, instance RBAC, and network policy.
- K8s lease-based HA (RFC-0007): no third-party HA agent. Uses the K8s API as the DCS.
- Self-managed ShardRange metadata (RFC-0002): the K8s CRD is the source of truth — no external KV layer or third-party distributed-node catalog required.
- Stateless QueryRouter (RFC-0004): horizontal scaling via HPA, PgBouncer integration, lossless Pod restart targeted.
- Distributed transactions (RFC-0005): self-built 2PC + saga — independent of backend extensions.
- Architecture — System design overview
- ADRs — Architecture Decision Records
- RFCs — Per-phase design RFCs
- Runbooks — Operational procedures
- Deployment — Installation and deployment
- Upgrading — Version migration guide
- Gap Analysis — CNPG feature comparison and migration roadmap
MIT © 2026 keiailab.