Add Complete PgBouncer Docs

docs/examples/pgbouncer/autoscaling/compute/pgbouncer-autoscale.yaml

@@ -0,0 +1,23 @@
+apiVersion: kubedb.com/v1
+kind: PgBouncer
+metadata:
+  name: pgbouncer-autoscale
+  namespace: demo
+spec:
+  replicas: 1
+  version: "1.18.0"
+  database:
+    syncUsers: true
+    databaseName: "postgres"
+    databaseRef:
+      name: "ha-postgres"
+      namespace: demo
+  connectionPool:
+    poolMode: session
+    port: 5432
+    reservePoolSize: 5
+    maxClientConnections: 87
+    defaultPoolSize: 2
+    minPoolSize: 1
+    authType: md5
+  deletionPolicy: WipeOut

docs/examples/pgbouncer/autoscaling/compute/pgbouncer-autoscaler.yaml

@@ -0,0 +1,21 @@
+apiVersion: autoscaling.kubedb.com/v1alpha1
+kind: PgBouncerAutoscaler
+metadata:
+  name: pgbouncer-autoscale-ops
+  namespace: demo
+spec:
+  databaseRef:
+    name: pgbouncer-autoscale
+  compute:
+    pgbouncer:
+      trigger: "On"
+      podLifeTimeThreshold: 5m
+      resourceDiffPercentage: 20
+      minAllowed:
+        cpu: 400m
+        memory: 400Mi
+      maxAllowed:
+        cpu: 1
+        memory: 1Gi
+      controlledResources: ["cpu", "memory"]
+      containerControlledValues: "RequestsAndLimits"

docs/examples/pgbouncer/reconfigure/pb-custom-config.yaml

@@ -0,0 +1,22 @@
+apiVersion: kubedb.com/v1
+kind: PgBouncer
+metadata:
+  name: pb-custom
+  namespace: demo
+spec:
+  replicas: 1
+  version: "1.18.0"
+  database:
+    syncUsers: true
+    databaseName: "postgres"
+    databaseRef:
+      name: "ha-postgres"
+      namespace: demo
+  connectionPool:
+    poolMode: session
+    port: 5432
+    reservePoolSize: 5
+    maxClientConnections: 87
+    defaultPoolSize: 2
+    minPoolSize: 1
+  deletionPolicy: WipeOut

docs/examples/pgbouncer/reconfigure/pbops-reconfigure-apply.yaml

@@ -0,0 +1,17 @@
+apiVersion: ops.kubedb.com/v1alpha1
+kind: PgBouncerOpsRequest
+metadata:
+  name: pbops-reconfigure-apply
+  namespace: demo
+spec:
+  type: Reconfigure
+  databaseRef:
+    name: pb-custom
+  configuration:
+    pgbouncer:
+      applyConfig:
+        pgbouncer.ini: |-
+          [pgbouncer]
+          auth_type=scram-sha-256
+  timeout: 5m
+  apply: IfReady

docs/examples/pgbouncer/reconfigure/pbops-reconfigure.yaml

@@ -0,0 +1,15 @@
+apiVersion: ops.kubedb.com/v1alpha1
+kind: PgBouncerOpsRequest
+metadata:
+  name: pbops-reconfigure
+  namespace: demo
+spec:
+  type: Reconfigure
+  databaseRef:
+    name: pb-custom
+  configuration:
+    pgbouncer:
+      configSecret:
+        name: new-custom-config
+  timeout: 5m
+  apply: IfReady

docs/examples/pgbouncer/restart/ops.yaml

@@ -0,0 +1,11 @@
+apiVersion: ops.kubedb.com/v1alpha1
+kind: PgBouncerOpsRequest
+metadata:
+  name: restart-pgbouncer
+  namespace: demo
+spec:
+  type: Restart
+  databaseRef:
+    name: pgbouncer
+  timeout: 3m
+  apply: Always

docs/examples/pgbouncer/restart/pgbouncer.yaml

@@ -0,0 +1,23 @@
+apiVersion: kubedb.com/v1
+kind: PgBouncer
+metadata:
+  name: pgbouncer
+  namespace: demo
+spec:
+  replicas: 1
+  version: "1.18.0"
+  database:
+    syncUsers: true
+    databaseName: "postgres"
+    databaseRef:
+      name: "ha-postgres"
+      namespace: demo
+  connectionPool:
+    poolMode: session
+    port: 5432
+    reservePoolSize: 5
+    maxClientConnections: 87
+    defaultPoolSize: 2
+    minPoolSize: 1
+    authType: md5
+  deletionPolicy: WipeOut

docs/examples/pgbouncer/scaling/horizontal-scaling-down-ops.yaml

@@ -0,0 +1,11 @@
+apiVersion: ops.kubedb.com/v1alpha1
+kind: PgBouncerOpsRequest
+metadata:
+  name: pgbouncer-horizontal-scale-down
+  namespace: demo
+spec:
+  type: HorizontalScaling
+  databaseRef:
+    name: pb-horizontal
+  horizontalScaling:
+    replicas: 2

docs/examples/pgbouncer/scaling/horizontal-scaling-ops.yaml

@@ -0,0 +1,11 @@
+apiVersion: ops.kubedb.com/v1alpha1
+kind: PgBouncerOpsRequest
+metadata:
+  name: pgbouncer-horizontal-scale-up
+  namespace: demo
+spec:
+  type: HorizontalScaling
+  databaseRef:
+    name: pb-horizontal
+  horizontalScaling:
+    replicas: 3

docs/examples/pgbouncer/scaling/pb-horizontal.yaml

@@ -0,0 +1,23 @@
+apiVersion: kubedb.com/v1
+kind: PgBouncer
+metadata:
+  name: pb-horizontal
+  namespace: demo
+spec:
+  replicas: 1
+  version: "1.18.0"
+  database:
+    syncUsers: true
+    databaseName: "postgres"
+    databaseRef:
+      name: "ha-postgres"
+      namespace: demo
+  connectionPool:
+    poolMode: session
+    port: 5432
+    reservePoolSize: 5
+    maxClientConnections: 87
+    defaultPoolSize: 2
+    minPoolSize: 1
+    authType: md5
+  deletionPolicy: WipeOut

docs/examples/pgbouncer/scaling/pb-vertical-ops.yaml

@@ -0,0 +1,20 @@
+apiVersion: ops.kubedb.com/v1alpha1
+kind: PgBouncerOpsRequest
+metadata:
+  name: pgbouncer-scale-vertical
+  namespace: demo
+spec:
+  type: VerticalScaling
+  databaseRef:
+    name: pb-vertical
+  verticalScaling:
+    pgbouncer:
+      resources:
+        requests:
+          memory: "2Gi"
+          cpu: "1"
+        limits:
+          memory: "2Gi"
+          cpu: "1"
+  timeout: 5m
+  apply: IfReady

docs/examples/pgbouncer/scaling/pb-vertical.yaml

@@ -0,0 +1,23 @@
+apiVersion: kubedb.com/v1
+kind: PgBouncer
+metadata:
+  name: pb-vertical
+  namespace: demo
+spec:
+  replicas: 1
+  version: "1.18.0"
+  database:
+    syncUsers: true
+    databaseName: "postgres"
+    databaseRef:
+      name: "ha-postgres"
+      namespace: demo
+  connectionPool:
+    poolMode: session
+    port: 5432
+    reservePoolSize: 5
+    maxClientConnections: 87
+    defaultPoolSize: 2
+    minPoolSize: 1
+    authType: md5
+  deletionPolicy: WipeOut

docs/examples/pgbouncer/sync-users/pgbouncer-sync.yaml

@@ -0,0 +1,15 @@
+apiVersion: kubedb.com/v1
+kind: PgBouncer
+metadata:
+  name: pgbouncer-sync
+  namespace: demo
+spec:
+  version: "1.23.1"
+  replicas: 1
+  database:
+    syncUsers: true
+    databaseName: "postgres"
+    databaseRef:
+      name: "ha-postgres"
+      namespace: demo
+  deletionPolicy: WipeOut

docs/examples/pgbouncer/sync-users/secret.yaml

@@ -0,0 +1,11 @@
+apiVersion: v1
+kind: Secret
+metadata:
+  labels:
+    app.kubernetes.io/instance: ha-postgres
+    app.kubernetes.io/name: postgreses.kubedb.com
+  name: sync-secret
+  namespace: demo
+stringData:
+  password: "12345"
+  username: "john"

docs/examples/pgbouncer/update-version/pb-update.yaml

@@ -0,0 +1,23 @@
+apiVersion: kubedb.com/v1
+kind: PgBouncer
+metadata:
+  name: pb-update
+  namespace: demo
+spec:
+  replicas: 1
+  version: "1.18.0"
+  database:
+    syncUsers: true
+    databaseName: "postgres"
+    databaseRef:
+      name: "ha-postgres"
+      namespace: demo
+  connectionPool:
+    poolMode: session
+    port: 5432
+    reservePoolSize: 5
+    maxClientConnections: 87
+    defaultPoolSize: 2
+    minPoolSize: 1
+    authType: md5
+  deletionPolicy: WipeOut

docs/examples/pgbouncer/update-version/pbops-update.yaml

@@ -0,0 +1,11 @@
+apiVersion: ops.kubedb.com/v1alpha1
+kind: PgBouncerOpsRequest
+metadata:
+  name: pgbouncer-version-update
+  namespace: demo
+spec:
+  type: UpdateVersion
+  databaseRef:
+    name: pb-update
+  updateVersion:
+    targetVersion: 1.23.1

docs/guides/pgbouncer/README.md

@@ -23,14 +23,21 @@ KubeDB operator now comes bundled with PgBouncer crd to handle connection poolin
 
 ## PgBouncer Features
 
-| Features                           | Availability |
-|------------------------------------|:------------:|
-| Clustering                         |   ✓   |
-| Multiple PgBouncer Versions        |   ✓   |
-| Customizable Pooling Configuration |   ✓   |
-| Custom docker images               |   ✓   |
-| Builtin Prometheus Discovery       |   ✓   |
-| Using Prometheus operator          |   ✓   |
+| Features                                                    | Availability |
+|-------------------------------------------------------------| :----------: |
+| Multiple PgBouncer Versions                                 |   ✓   |
+| Custom Configuration                                        |   ✓   |
+| Externally manageable Auth Secret                           |   ✓   |
+| Reconfigurable Health Checker                               |   ✓   |
+| Integrate with externally managed PostgreSQL                |   ✓   |
+| Sync Postgres Users to PgBouncer                            |   ✓   |
+| Custom docker images                                        |   ✓   |
+| TLS: Add ( [Cert Manager]((https://cert-manager.io/docs/))) |   ✓   |
+| Monitoring with Prometheus & Grafana                        |   ✓   |
+| Builtin Prometheus Discovery                                |   ✓   |
+| Using Prometheus operator                                   |   ✓   |
+| Alert Dashboard                                             |   ✓   |
+| Grafana Dashboard                                           |   ✓   |
 
 ## User Guide
 

docs/guides/pgbouncer/autoscaler/_index.md

@@ -0,0 +1,10 @@
+---
+title: Autoscaling
+menu:
+  docs_{{ .version }}:
+    identifier: pb-auto-scaling
+    name: Autoscaling
+    parent: pb-pgbouncer-guides
+    weight: 46
+menu_name: docs_{{ .version }}
+---

docs/guides/pgbouncer/autoscaler/compute/_index.md

@@ -0,0 +1,10 @@
+---
+title: Compute Autoscaling
+menu:
+  docs_{{ .version }}:
+    identifier: pb-compute-auto-scaling
+    name: Compute Autoscaling
+    parent: pb-auto-scaling
+    weight: 10
+menu_name: docs_{{ .version }}
+---