Configuration

The Cluster resource is the heart of Keldon. Everything about a PostgreSQL cluster — replicas, storage, credentials, tuning, backups — is declared in a single manifest.

Minimal cluster

apiVersion: postgresql.cnb.io/v1
kind: Cluster
metadata:
  name: prod
spec:
  instances: 3
  storage:
    size: 100Gi
    storageClass: fast-ssd

PostgreSQL parameters

Override any postgresql.conf parameter directly:

spec:
  postgresql:
    parameters:
      max_connections: "400"
      shared_buffers: "2GB"
      work_mem: "32MB"
      effective_cache_size: "6GB"

The operator validates parameters before applying them and rolls out changes safely.

Resource limits

Set CPU and memory per instance:

spec:
  resources:
    requests:
      cpu: "2"
      memory: "4Gi"
    limits:
      cpu: "4"
      memory: "8Gi"

Bootstrap modes

Three ways to initialize a cluster:

Credentials

Secrets for application users are generated automatically. Access them via:

kubectl get secret prod-app -o jsonpath='{.data.password}' | base64 -d