Custom Resource options¶

The Cluster is configured via the deploy/cr.yaml file.

`metadata`¶

The metadata part of this file contains the following keys:

name (cluster1 by default) sets the name of your Percona Distribution for PostgreSQL Cluster; it should include only URL-compatible characters , not exceed 22 characters, start with an alphabetic character, and end with an alphanumeric character;
annotations.pgv2.percona.com/custom-patroni-version Kubernetes annotation which allows turning off automatic Patroni version detection by the Operator. You can use this annotation to set the version manually (“3” for Patroni 3.x, “4” for Patroni 4.x).
finalizers.percona.com/delete-ssl if present, activates the Finalizer which deletes objects, created for SSL (Secret, certificate, and issuer) after the cluster deletion event (off by default).
finalizers.percona.com/delete-pvc if present, activates the Finalizer which deletes Persistent Volume Claims for the database cluster Pods after the deletion event (off by default).
finalizers.percona.com/delete-backups if present, activates the Finalizer which deletes all the backups of the database cluster from all configured repos on cluster deletion event (off by default). delete-backups finalizer is in tech preview state, and it is not yet recommended for production environments.

Toplevel `spec` elements¶

The spec part of the deploy/cr.yaml file contains the following:

`crVersion`¶

Version of the Operator the Custom Resource belongs to.

Value type	Example
string	`2.6.0`

`metadata.annotations`¶

The Kubernetes annotations metadata to be set at a global level for all resources created by the Operator.

Value type	Example
label	`example-annotation: value`

`metadata.labels`¶

The Kubernetes labels metadata to be set at a global level for all resources created by the Operator.

Value type	Example
label	`example-label: value`

`tlsOnly`¶

Enforce the Operator to use only Transport Layer Security (TLS) for both internal and external communications.

Value type	Example
boolean	`false`

`standby.enabled`¶

Enables or disables running the cluster in a standby mode (read-only copy of an existing cluster, useful for disaster recovery, etc).

Value type	Example
boolean	`false`

`standby.host`¶

Host address of the primary cluster this standby cluster connects to.

Value type	Example
string	`"<primary-ip>"`

`standby.port`¶

Port number used by a standby copy to connect to the primary cluster.

Value type	Example
string	`"<primary-port>"`

`openshift`¶

Set to true if the cluster is being deployed on OpenShift, set to false otherwise, or unset it for autodetection.

Value type	Example
boolean	`true`

`autoCreateUserSchema`¶

If set to true, the cluster will have automatically created schemas for the custom user defined in the spec.users subsection for all of the databases listed for this specific user.

Value type	Example
boolean	`true`

`standby.repoName`¶

Name of the pgBackRest repository in the primary cluster this standby cluster connects to.

Value type	Example
string	`repo1`

`secrets.customRootCATLSSecret.name`¶

Name of the secret with the custom root CA certificate and key for secure connections to the PostgreSQL server, see Transport Layer Security (TLS) for details.

Value type	Example
string	`cluster1-ca-cert`

`secrets.customRootCATLSSecret.items`¶

Key-value pairs of the key (a key from the secrets.customRootCATLSSecret.name secret) and the path (name on the file system) for the custom root certificate and key. See Transport Layer Security (TLS) for details.

Value type	Example
subdoc	- key: “tls.crt” path: “root.crt” - key: “tls.key” path: “root.key”

`secrets.customTLSSecret.name`¶

A secret with TLS certificate generated for external communications, see Transport Layer Security (TLS) for details.

Value type	Example
string	`cluster1-cert`

`secrets.customReplicationTLSSecret.name`¶

A secret with TLS certificate generated for internal communications, see Transport Layer Security (TLS) for details.

Value type	Example
string	`replication1-cert`

`users.name`¶

The name of the PostgreSQL user.

Value type	Example
string	`rhino`

`users.databases`¶

Databases accessible by a specific PostgreSQL user with rights to create objects in them (the option is ignored for postgres user; also, modifying it can’t be used to revoke the already given access).

Value type	Example
string	`zoo`

`users.password.type`¶

The set of characters used for password generation: can be either ASCII (default) or AlphaNumeric.

Value type	Example
string	`ASCII`

`users.options`¶

The ALTER ROLE options other than password (the option is ignored for postgres user).

Value type	Example
string	`"SUPERUSER"`

`users.secretName`¶

The custom name of the user’s Secret; if not specified, the default <clusterName>-pguser-<userName> variant will be used.

Value type	Example
string	`"rhino-credentials"`

`databaseInitSQL.key`¶

Data key for the Custom configuration options ConfigMap with the init SQL file, which will be executed at cluster creation time.

Value type	Example
string	`init.sql`

`databaseInitSQL.name`¶

Name of the ConfigMap with the init SQL file, which will be executed at cluster creation time.

Value type	Example
string	`cluster1-init-sql`

`pause`¶

Setting it to true gracefully stops the cluster, scaling workloads to zero and suspending CronJobs; setting it to false after shut down starts the cluster back.

Value type	Example
string	`false`

`unmanaged`¶

Setting it to true stops the Operator’s activity including the rollout and reconciliation of changes made in the Custom Resource; setting it to false starts the Operator’s activity back.

Value type	Example
string	`false`

`dataSource.postgresCluster.clusterName`¶

Name of an existing cluster to use as the data source when restoring backup to a new cluster.

Value type	Example
string	`cluster1`

`dataSource.postgresCluster.clusterNamespace`¶

Namespace of an existing cluster used as a data source (is needed if the new cluster will be created in a different namespace; needs the Operator deployed in multi-namespace/cluster-wide mode).

Value type	Example
string	`cluster1-namespace`

`dataSource.postgresCluster.repoName`¶

Name of the pgBackRest repository in the source cluster that contains the backup to be restored to a new cluster.

Value type	Example
string	`repo1`

`dataSource.postgresCluster.options`¶

The pgBackRest command-line options for the pgBackRest restore command.

Value type	Example
string

`dataSource.postgresCluster.tolerations.effect`¶

The Kubernetes Pod tolerations effect for data migration.

Value type	Example
string	`NoSchedule`

`dataSource.postgresCluster.tolerations.key`¶

The Kubernetes Pod tolerations key for data migration.

Value type	Example
string	`role`

`dataSource.postgresCluster.tolerations.operator`¶

The Kubernetes Pod tolerations operator for data migration.

Value type	Example
string	`Equal`

`dataSource.postgresCluster.tolerations.value`¶

The Kubernetes Pod tolerations value for data migration.

Value type	Example
string	`connection-poolers`

`dataSource.pgbackrest.stanza`¶

Name of the pgBackRest stanza to use as the data source when restoring backup to a new cluster.

Value type	Example
string	`db`

`dataSource.pgbackrest.configuration.secret.name`¶

Name of the Kubernetes Secret object with custom pgBackRest configuration, which will be added to the pgBackRest configuration generated by the Operator.

Value type	Example
string	`pgo-s3-creds`

`dataSource.pgbackrest.global`¶

Settings, which are to be included in the global section of the pgBackRest configuration generated by the Operator.

Value type	Example
subdoc	`/pgbackrest/postgres-operator/hippo/repo1`

`dataSource.pgbackrest.repo.name`¶

Name of the pgBackRest repository.

Value type	Example
string	`repo1`

`dataSource.pgbackrest.repo.s3.bucket`¶

The Amazon S3 bucket or Google Cloud Storage bucket name used for backups. Bucket name should follow Amazon naming rules or Google naming rules, and additionally, it can’t contain dots.

Value type	Example
string	`"my-bucket"`

`dataSource.pgbackrest.repo.s3.endpoint`¶

The endpoint URL of the S3-compatible storage to be used for backups (not needed for the original Amazon S3 cloud).

Value type	Example
string	`"s3.ca-central-1.amazonaws.com"`

`dataSource.pgbackrest.repo.s3.region`¶

The AWS region to use for Amazon and all S3-compatible storages.

Value type	Example
boolean	`"ca-central-1"`

`dataSource.pgbackrest.tolerations.effect`¶

The Kubernetes Pod tolerations effect for pgBackRest at data migration.

Value type	Example
string	`NoSchedule`

`dataSource.pgbackrest.tolerations.key`¶

The Kubernetes Pod tolerations key for pgBackRest at data migration.

Value type	Example
string	`role`

`dataSource.pgbackrest.tolerations.operator`¶

The Kubernetes Pod tolerations operator for pgBackRest at data migration.

Value type	Example
string	`Equal`

`dataSource.pgbackrest.tolerations.value`¶

The Kubernetes Pod tolerations value for pgBackRest at data migration.

Value type	Example
string	`connection-poolers`

`dataSource.volumes.pgDataVolume.pvcName`¶

The PostgreSQL data volume name for the Persistent Volume Claim used for data migration.

Value type	Example
string	`cluster1`

`dataSource.volumes.pgDataVolume.directory`¶

The mount point for PostgreSQL data volume used for data migration.

Value type	Example
string	`cluster1`

`dataSource.volumes.pgDataVolume.tolerations.effect`¶

The Kubernetes Pod tolerations effect for PostgreSQL data volume used for data migration.

Value type	Example
string	`NoSchedule`

`dataSource.volumes.pgDataVolume.tolerations.key`¶

The Kubernetes Pod tolerations key for PostgreSQL data volume used for data migration.

Value type	Example
string	`role`

`dataSource.volumes.pgDataVolume.tolerations.operator`¶

The Kubernetes Pod tolerations operator for PostgreSQL data volume used for data migration.

Value type	Example
string	`Equal`

`dataSource.volumes.pgDataVolume.tolerations.value`¶

The Kubernetes Pod tolerations value for PostgreSQL data volume used for data migration.

Value type	Example
string	`connection-poolers`

`dataSource.volumes.pgDataVolume.annotations`¶

The Kubernetes annotations metadata for PostgreSQL data volume used for data migration.

Value type	Example
label	`test-annotation: value`

`dataSource.volumes.pgDataVolume.labels`¶

The Kubernetes labels for PostgreSQL data volume used for data migration.

Value type	Example
label	`test-label: value`

`dataSource.volumes.pgWALVolume.pvcName`¶

The PostgreSQL write-ahead logs volume name for the Persistent Volume Claim used for data migration.

Value type	Example
string	`cluster1`

`dataSource.volumes.pgWALVolume.directory`¶

The mount point for PostgreSQL write-ahead logs volume used for data migration.

Value type	Example
string	`cluster1`

`dataSource.volumes.pgWALVolume.tolerations.effect`¶

The Kubernetes Pod tolerations effect for PostgreSQL write-ahead logs volume used for data migration.

Value type	Example
string	`NoSchedule`

`dataSource.volumes.pgWALVolume.tolerations.key`¶

The Kubernetes Pod tolerations key for PostgreSQL write-ahead logs volume used for data migration.

Value type	Example
string	`role`

`dataSource.volumes.pgWALVolume.tolerations.operator`¶

The Kubernetes Pod tolerations operator for PostgreSQL write-ahead logs volume used for data migration.

Value type	Example
string	`Equal`

`dataSource.volumes.pgWALVolume.tolerations.value`¶

The Kubernetes Pod tolerations value for PostgreSQL write-ahead logs volume used for data migration.

Value type	Example
string	`connection-poolers`

`dataSource.volumes.pgWALVolume.annotations`¶

The Kubernetes annotations metadata for PostgreSQL write-ahead logs volume used for data migration.

Value type	Example
label	`test-annotation: value`

`dataSource.volumes.pgWALVolume.labels`¶

The Kubernetes labels for PostgreSQL write-ahead logs volume used for data migration.

Value type	Example
label	`test-label: value`

`dataSource.volumes.pgBackRestVolume.pvcName`¶

The pgBackRest volume name for the Persistent Volume Claim used for data migration.

Value type	Example
string	`cluster1`

`dataSource.volumes.pgBackRestVolume.directory`¶

The mount point for pgBackRest volume used for data migration.

Value type	Example
string	`cluster1`

`dataSource.volumes.pgBackRestVolume.tolerations.effect`¶

The Kubernetes Pod tolerations effect pgBackRest volume used for data migration.

Value type	Example
string	`NoSchedule`

`dataSource.volumes.pgBackRestVolume.tolerations.key`¶

The Kubernetes Pod tolerations key for pgBackRest volume used for data migration.

Value type	Example
string	`role`

`dataSource.volumes.pgBackRestVolume.tolerations.operator`¶

The Kubernetes Pod tolerations operator for pgBackRest volume used for data migration.

Value type	Example
string	`Equal`

`dataSource.volumes.pgBackRestVolume.tolerations.value`¶

The Kubernetes Pod tolerations value for pgBackRest volume used for data migration.

Value type	Example
string	`connection-poolers`

`dataSource.volumes.pgBackRestVolume.annotations`¶

The Kubernetes annotations metadata for pgBackRest volume used for data migration.

Value type	Example
label	`test-annotation: value`

`dataSource.volumes.pgBackRestVolume.labels`¶

The Kubernetes labels for pgBackRest volume used for data migration.

Value type	Example
label	`test-label: value`

`image`¶

The PostgreSQL Docker image to use.

Value type	Example
string	`perconalab/percona-postgresql-operator:2.6.0-ppg17.4-postgres`

`imagePullPolicy`¶

This option is used to set the policy for updating PostgreSQL images.

Value type	Example
string	`Always`

`postgresVersion`¶

The major version of PostgreSQL to use.

Value type	Example
int	`16`

`port`¶

The port number for PostgreSQL.

Value type	Example
int	`5432`

`expose.annotations`¶

The Kubernetes annotations metadata for PostgreSQL primary.

Value type	Example
label	`my-annotation: value1`

`expose.labels`¶

Set labels for the PostgreSQL primary.

Value type	Example
label	`my-label: value2`

`expose.type`¶

Specifies the type of Kubernetes Service for PostgreSQL primary.

Value type	Example
string	`LoadBalancer`

`expose.loadBalancerSourceRanges`¶

The range of client IP addresses from which the load balancer should be reachable (if not set, there is no limitations).

Value type	Example
string	`"10.0.0.0/8"`

`exposeReplicas.annotations`¶

The Kubernetes annotations metadata for PostgreSQL replicas.

Value type	Example
label	`my-annotation: value1`

`exposeReplicas.labels`¶

Set labels for the PostgreSQL replicas.

Value type	Example
label	`my-label: value2`

`exposeReplicas.type`¶

Specifies the type of Kubernetes Service for PostgreSQL replicas.

Value type	Example
string	`LoadBalancer`

`exposeReplicas.loadBalancerSourceRanges`¶

The range of client IP addresses from which the load balancer should be reachable (if not set, there is no limitations).

Value type	Example
string	`"10.0.0.0/8"`

Instances section¶

The instances section in the deploy/cr.yaml file contains configuration options for PostgreSQL instances. This section contains at least one cluster instance with a number of PostgreSQL instances in it (cluster instances are groups of PostgreSQL instances used for fine-grained resources assignment).

`instances.metadata.labels`¶

Set labels for PostgreSQL Pods.

Value type	Example
label	`pg-cluster-label: cluster1`

`instances.name`¶

The name of the PostgreSQL instance.

Value type	Example
string	`rs 0`

`instances.replicas`¶

The number of Replicas to create for the PostgreSQL instance.

Value type	Example
int	`3`

`instances.resources.limits.cpu`¶

Kubernetes CPU limits for a PostgreSQL instance.

Value type	Example
string	`2.0`

`instances.resources.limits.memory`¶

The Kubernetes memory limits for a PostgreSQL instance.

Value type	Example
string	`4Gi`

`instances.containers.replicaCertCopy.resources.limits.cpu`¶

Kubernetes CPU limits for replica-cert-copy sidecar container.

Value type	Example
string	`1.0`

`instances.containers.replicaCertCopy.resources.limits.memory`¶

The Kubernetes memory limits for replica-cert-copy sidecar container.

Value type	Example
string	`1Gi`

`instances.topologySpreadConstraints.maxSkew`¶

The degree to which Pods may be unevenly distributed under the Kubernetes Pod Topology Spread Constraints .

Value type	Example
int	`1`

`instances.topologySpreadConstraints.topologyKey`¶

The key of node labels for the Kubernetes Pod Topology Spread Constraints .

Value type	Example
string	`my-node-label`

`instances.topologySpreadConstraints.whenUnsatisfiable`¶

What to do with a Pod if it doesn’t satisfy the Kubernetes Pod Topology Spread Constraints .

Value type	Example
string	`DoNotSchedule`

`instances.topologySpreadConstraints.labelSelector.matchLabels`¶

The Label selector for the Kubernetes Pod Topology Spread Constraints .

Value type	Example
label	`postgres-operator.crunchydata.com/instance-set: instance1`

`instances.tolerations.effect`¶

The Kubernetes Pod tolerations effect for the PostgreSQL instance.

Value type	Example
string	`NoSchedule`

`instances.tolerations.key`¶

The Kubernetes Pod tolerations key for the PostgreSQL instance.

Value type	Example
string	`role`

`instances.tolerations.operator`¶

The Kubernetes Pod tolerations operator for the PostgreSQL instance.

Value type	Example
string	`Equal`

`instances.tolerations.value`¶

The Kubernetes Pod tolerations value for the PostgreSQL instance.

Value type	Example
string	`connection-poolers`

`instances.priorityClassName`¶

The Kuberentes Pod priority class for PostgreSQL instance Pods.

Value type	Example
string	`high-priority`

`instances.securityContext`¶

A custom Kubernetes Security Context for a Pod to be used instead of the default one.

Value type

Example

subdoc

fsGroup: 1001
runAsUser: 1001
runAsNonRoot: true
fsGroupChangePolicy: “OnRootMismatch”
runAsGroup: 1001
seLinuxOptions:
  type: spc_t
  level: s0:c123,c456
seccompProfile:
  type: Localhost
  localhostProfile: localhost/profile.json
supplementalGroups:
- 1001
sysctls:
- name: net.ipv4.tcp_keepalive_time
  value: “600”
- name: net.ipv4.tcp_keepalive_intvl
  value: “60”

`instances.walVolumeClaimSpec.accessModes`¶

The Kubernetes PersistentVolumeClaim access modes for the PostgreSQL Write-ahead Log storage.

Value type	Example
string	`ReadWriteOnce`

`instances.walVolumeClaimSpec.storageClassName`¶

Set the Kubernetes storage class to use with the PostgreSQL Write-ahead Log storage PersistentVolumeClaim .

Value type	Example
string	`standard`

`instances.walVolumeClaimSpec.resources.requests.storage`¶

The Kubernetes storage requests for the storage the PostgreSQL instance will use.

Value type	Example
string	`1Gi`

`instances.dataVolumeClaimSpec.accessModes`¶

The Kubernetes PersistentVolumeClaim access modes for the PostgreSQL storage.

Value type	Example
string	`ReadWriteOnce`

`instances.dataVolumeClaimSpec.storageClassName`¶

Set the Kubernetes storage class to use with PosgreSQL Cluster PersistentVolumeClaim for the PostgreSQL storage.

Value type	Example
string	`standard`

`instances.dataVolumeClaimSpec.resources.requests.storage`¶

The Kubernetes storage requests for the storage the PostgreSQL instance will use.

Value type	Example
string	`1Gi`

`instances.dataVolumeClaimSpec.resources.limits.storage`¶

The Kubernetes storage limits for the storage the PostgreSQL instance will use.

Value type	Example
string	`5Gi`

`instances.tablespaceVolumes.name`¶

Name for the custom tablespace volume.

Value type	Example
string	`user`

`instances.tablespaceVolumes.dataVolumeClaimSpec.accessModes`¶

The Kubernetes PersistentVolumeClaim access modes for the tablespace volume.

Value type	Example
string	`ReadWriteOnce`

`instances.tablespaceVolumes.dataVolumeClaimSpec.resources.requests.storage`¶

The Kubernetes storage requests for the tablespace volume.

Value type	Example
string	`1Gi`

`instances.sidecars` subsection¶

The instances.sidecars subsection in the deploy/cr.yaml file contains configuration options for custom sidecar containers which can be added to PostgreSQL Pods.

`instances.sidecars.image`¶

Image for the custom sidecar container for PostgreSQL Pods.

Value type	Example
string	`mycontainer1:latest`

`instances.sidecars.name`¶

Name of the custom sidecar container for PostgreSQL Pods.

Value type	Example
string	`testcontainer`

`instances.sidecars.imagePullPolicy`¶

This option is used to set the policy for the PostgreSQL Pod sidecar container.

Value type	Example
string	`Always`

`instances.sidecars.env`¶

The environment variables set as key-value pairs for the custom sidecar container for PostgreSQL Pods.

Value type	Example
subdoc

`instances.sidecars.envFrom`¶

The environment variables set as key-value pairs in ConfigMaps for the custom sidecar container for PostgreSQL Pods.

Value type	Example
subdoc

`instances.sidecars.command`¶

Command for the custom sidecar container for PostgreSQL Pods.

Value type	Example
array	`["/bin/sh"]`

`instances.sidecars.args`¶

Command arguments for the custom sidecar container for PostgreSQL Pods.

Value type	Example
array	`["-c", "while true; do trap 'exit 0' SIGINT SIGTERM SIGQUIT SIGKILL; done;"]`

Backup section¶

The backup section in the deploy/cr.yaml file contains the following configuration options for the regular Percona Distribution for PostgreSQL backups.

`backups.trackLatestRestorableTime`¶

Enables or disables tracking the latest restorable time for latest successful backup (on by default). It can be turned off to reduced S3 API usage.

Value type	Example
boolean	`true`

`backups.pgbackrest.metadata.labels`¶

Set labels for pgBackRest Pods.

Value type	Example
label	`pg-cluster-label: cluster1`

`backups.pgbackrest.image`¶

The Docker image for pgBackRest.

Value type	Example
string	`perconalab/percona-postgresql-operator:2.6.0-ppg17.4-pgbackrest`

`backups.pgbackrest.containers.pgbackrest.resources.limits.cpu`¶

Kubernetes CPU limits for a pgBackRest container.

Value type	Example
string	`1.0`

`backups.pgbackrest.containers.pgbackrest.resources.limits.memory`¶

The Kubernetes memory limits for a pgBackRest container.

Value type	Example
string	`1Gi`

`backups.pgbackrest.containers.pgbackrestConfig.resources.limits.cpu`¶

Kubernetes CPU limits for pgbackrest-config sidecar container.

Value type	Example
string	`1.0`

`backups.pgbackrest.containers.pgbackrestConfig.resources.limits.memory`¶

The Kubernetes memory limits for pgbackrest-config sidecar container.

Value type	Example
string	`1Gi`

`backups.pgbackrest.configuration.secret.name`¶

Name of the Kubernetes Secret object with custom pgBackRest configuration, which will be added to the pgBackRest configuration generated by the Operator.

Value type	Example
string	`cluster1-pgbackrest-secrets`

`backups.pgbackrest.jobs.priorityClassName`¶

The Kuberentes Pod priority class for pgBackRest jobs.

Value type	Example
string	`high-priority`

`backups.pgbackrest.jobs.resources.limits.cpu`¶

Kubernetes CPU limits for a pgBackRest job.

Value type	Example
int	`200`

`backups.pgbackrest.jobs.resources.limits.memory`¶

The Kubernetes memory limits for a pgBackRest job.

Value type	Example
string	`128Mi`

`backups.pgbackrest.jobs.tolerations.effect`¶

The Kubernetes Pod tolerations effect for a backup job.

Value type	Example
string	`NoSchedule`

`backups.pgbackrest.jobs.tolerations.key`¶

The Kubernetes Pod tolerations key for a backup job.

Value type	Example
string	`role`

`backups.pgbackrest.jobs.tolerations.operator`¶

The Kubernetes Pod tolerations operator for a backup job.

Value type	Example
string	`Equal`

`backups.pgbackrest.jobs.tolerations.value`¶

The Kubernetes Pod tolerations value for a backup job.

Value type	Example
string	`connection-poolers`

`backups.pgbackrest.jobs.securityContext`¶

A custom Kubernetes Security Context for a Pod to be used instead of the default one.

Value type

Example

subdoc

fsGroup: 1001
runAsUser: 1001
runAsNonRoot: true
fsGroupChangePolicy: “OnRootMismatch”
runAsGroup: 1001
seLinuxOptions:
  type: spc_t
  level: s0:c123,c456
seccompProfile:
  type: Localhost
  localhostProfile: localhost/profile.json
supplementalGroups:
- 1001
sysctls:
- name: net.ipv4.tcp_keepalive_time
  value: “600”
- name: net.ipv4.tcp_keepalive_intvl
  value: “60”

`backups.pgbackrest.global`¶

Settings, which are to be included in the global section of the pgBackRest configuration generated by the Operator.

Value type

Example

subdoc

repo1-retention-full: “14”
repo1-retention-full-type: time
repo1-path: /pgbackrest/postgres-operator/cluster1/repo1
repo1-cipher-type: aes-256-cbc
repo1-s3-uri-style: path
repo2-path: /pgbackrest/postgres-operator/cluster1-multi-repo/repo2
repo3-path: /pgbackrest/postgres-operator/cluster1-multi-repo/repo3
repo4-path: /pgbackrest/postgres-operator/cluster1-multi-repo/repo4

`backups.pgbackrest.repoHost.priorityClassName`¶

The Kuberentes Pod priority class for pgBackRest repo.

Value type	Example
string	`high-priority`

`backups.pgbackrest.repoHost.topologySpreadConstraints.maxSkew`¶

The degree to which Pods may be unevenly distributed under the Kubernetes Pod Topology Spread Constraints .

Value type	Example
int	`1`

`backups.pgbackrest.repoHost.topologySpreadConstraints.topologyKey`¶

The key of node labels for the Kubernetes Pod Topology Spread Constraints .

Value type	Example
string	`my-node-label`

`backups.pgbackrest.repoHost.topologySpreadConstraints.whenUnsatisfiable`¶

What to do with a Pod if it doesn’t satisfy the Kubernetes Pod Topology Spread Constraints .

Value type	Example
string	`ScheduleAnyway`

`backups.pgbackrest.repoHost.topologySpreadConstraints.labelSelector.matchLabels`¶

The Label selector for the Kubernetes Pod Topology Spread Constraints .

Value type	Example
label	`postgres-operator.crunchydata.com/pgbackrest: ""`

`backups.pgbackrest.repoHost.affinity.podAntiAffinity`¶

Pod anti-affinity, allows setting the standard Kubernetes affinity constraints of any complexity.

Value type	Example
subdoc

`backups.pgbackrest.repoHost.tolerations.effect`¶

The Kubernetes Pod tolerations effect for pgBackRest repo.

Value type	Example
string	`NoSchedule`

`backups.pgbackrest.repoHost.tolerations.key`¶

The Kubernetes Pod tolerations key for pgBackRest repo.

Value type	Example
string	`role`

`backups.pgbackrest.repoHost.tolerations.operator`¶

The Kubernetes Pod tolerations operator for pgBackRest repo.

Value type	Example
string	`Equal`

`backups.pgbackrest.repoHost.tolerations.value`¶

The Kubernetes Pod tolerations value for pgBackRest repo.

Value type	Example
string	`connection-poolers`

‘backups.pgbackrest.repoHost.securityContext’¶

A custom Kubernetes Security Context for a Pod to be used instead of the default one.

Value type

Example

subdoc

fsGroup: 1001
runAsUser: 1001
runAsNonRoot: true
fsGroupChangePolicy: “OnRootMismatch”
runAsGroup: 1001
seLinuxOptions:
  type: spc_t
  level: s0:c123,c456
seccompProfile:
  type: Localhost
  localhostProfile: localhost/profile.json
supplementalGroups:
- 1001
sysctls:
- name: net.ipv4.tcp_keepalive_time
  value: “600”
- name: net.ipv4.tcp_keepalive_intvl
  value: “60”

`backups.pgbackrest.manual.repoName`¶

Name of the pgBackRest repository for on-demand backups.

Value type	Example
string	`repo1`

`backups.pgbackrest.manual.options`¶

The on-demand backup command-line options which will be passed to pgBackRest for on-demand backups.

Value type	Example
string	`--type=full`

`backups.pgbackrest.repos.name`¶

Name of the pgBackRest repository for backups.

Value type	Example
string	`repo1`

`backups.pgbackrest.repos.schedules.full`¶

Scheduled time to make a full backup specified in the crontab format .

Value type	Example
string	`0 0 \* \* 6`

`backups.pgbackrest.repos.schedules.differential`¶

Scheduled time to make a differential backup specified in the crontab format .

Value type	Example
string	`0 0 \* \* 6`

`backups.pgbackrest.repos.volume.volumeClaimSpec.accessModes`¶

The Kubernetes PersistentVolumeClaim access modes for the pgBackRest Storage.

Value type	Example
string	`ReadWriteOnce`

`backups.pgbackrest.repos.volume.volumeClaimSpec.storageClassName`¶

Set the Kubernetes Storage Class to use with the Percona Operator for PosgreSQL backups stored on Persistent Volume.

Value type	Example
string	`standard`

`backups.pgbackrest.repos.volume.volumeClaimSpec.resources.requests.storage`¶

The Kubernetes storage requests for the pgBackRest storage.

Value type	Example
string	`1Gi`

`backups.pgbackrest.repos.s3.bucket`¶

The Amazon S3 bucket name used for backups

Value type	Example
string	`"my-bucket"`
.

`backups.pgbackrest.repos.s3.endpoint`¶

The endpoint URL of the S3-compatible storage to be used for backups (not needed for the original Amazon S3 cloud).

Value type	Example
string	`"s3.ca-central-1.amazonaws.com"`

`backups.pgbackrest.repos.s3.region`¶

The AWS region to use for Amazon and all S3-compatible storages.

Value type	Example
string	`"ca-central-1"`

`backups.pgbackrest.repos.gcs.bucket`¶

The Google Cloud Storage bucket name used for backups.

Value type	Example
string	`"my-bucket"`

`backups.pgbackrest.repos.azure.container`¶

Name of the Azure Blob Storage container for backups.

Value type	Example
string	`my-container`

`backups.restore.tolerations.effect`¶

The Kubernetes Pod tolerations effect for the backup restore job.

Value type	Example
string	`NoSchedule`

`backups.restore.tolerations.key`¶

The Kubernetes Pod tolerations key for the backup restore job.

Value type	Example
string	`role`

`backups.restore.tolerations.operator`¶

The Kubernetes Pod tolerations operator for the backup restore job.

Value type	Example
string	`Equal`

`backups.restore.tolerations.value`¶

The Kubernetes Pod tolerations value for the backup restore job.

Value type	Example
string	`connection-poolers`

PMM section¶

The pmm section in the deploy/cr.yaml file contains configuration options for Percona Monitoring and Management.

`pmm.enabled`¶

Enables or disables monitoring Percona Distribution for PostgreSQL cluster with PMM .

Value type	Example
boolean	`false`

`pmm.image`¶

Percona Monitoring and Management (PMM) Client Docker image.

Value type	Example
string	`percona/pmm-client:2.44.0`

`pmm.imagePullPolicy`¶

This option is used to set the policy for updating PMM Client images.

Value type	Example
string	`IfNotPresent`

`pmm.pmmSecret`¶

Name of the Kubernetes Secret object for the PMM Server password.

Value type	Example
string	`cluster1-pmm-secret`

`pmm.serverHost`¶

Address of the PMM Server to collect data from the cluster.

Value type	Example
string	`monitoring-service`

`pmm.querySource`¶

Query source to track PostgreSQL statistics. Either pg_stat_monitor (pgstatmonitor, the default value) or pg_stat_statements (pgstatstatements) can be used.

Value type	Example
string	`pgstatmonitor`

Proxy section¶

The proxy section in the deploy/cr.yaml file contains configuration options for the pgBouncer connection pooler for PostgreSQL.

`proxy.pgBouncer.metadata.labels`¶

Set labels for pgBouncer Pods.

Value type	Example
label	`pg-cluster-label: cluster1`

`proxy.pgBouncer.replicas`¶

The number of the pgBouncer Pods to provide connection pooling.

Value type	Example
int	`3`

`proxy.pgBouncer.image`¶

Docker image for the pgBouncer connection pooler.

Value type	Example
string	`perconalab/percona-postgresql-operator:2.6.0-ppg17.4-pgbouncer`

`proxy.pgBouncer.exposeSuperusers`¶

Enables or disables exposing superuser user through pgBouncer.

Value type	Example
boolean	`false`

`proxy.pgBouncer.resources.limits.cpu`¶

Kubernetes CPU limits for a pgBouncer container.

Value type	Example
string	`200m`

`proxy.pgBouncer.resources.limits.memory`¶

The Kubernetes memory limits for a pgBouncer container.

Value type	Example
string	`128Mi`

`proxy.pgBouncer.containers.pgbouncerConfig.resources.limits.cpu`¶

Kubernetes CPU limits for pgbouncer-config sidecar container.

Value type	Example
string	`1.0`

`proxy.pgBouncer.containers.pgbouncerConfig.resources.limits.memory`¶

The Kubernetes memory limits for pgbouncer-config sidecar container.

Value type	Example
string	`1Gi`

`proxy.pgBouncer.expose.type`¶

Specifies the type of Kubernetes Service for pgBouncer.

Value type	Example
string	`ClusterIP`

`proxy.pgBouncer.expose.annotations`¶

The Kubernetes annotations metadata for pgBouncer.

Value type	Example
label	`pg-cluster-annot: cluster1`

`proxy.pgBouncer.expose.labels`¶

Set labels for the pgBouncer Service.

Value type	Example
label	`pg-cluster-label: cluster1`

`proxy.pgBouncer.expose.loadBalancerSourceRanges`¶

The range of client IP addresses from which the load balancer should be reachable (if not set, there is no limitations).

Value type	Example
string	`"10.0.0.0/8"`

`proxy.pgBouncer.affinity.podAntiAffinity`¶

Pod anti-affinity, allows setting the standard Kubernetes affinity constraints of any complexity.

Value type	Example
subdoc

‘proxy.pgBouncer.securityContext’¶

A custom Kubernetes Security Context for a Pod to be used instead of the default one.

Value type

Example

subdoc

fsGroup: 1001
runAsUser: 1001
runAsNonRoot: true
fsGroupChangePolicy: “OnRootMismatch”
runAsGroup: 1001
seLinuxOptions:
  type: spc_t
  level: s0:c123,c456
seccompProfile:
  type: Localhost
  localhostProfile: localhost/profile.json
supplementalGroups:
- 1001
sysctls:
- name: net.ipv4.tcp_keepalive_time
  value: “600”
- name: net.ipv4.tcp_keepalive_intvl
  value: “60”

`proxy.pgBouncer.config`¶

Custom configuration options for pgBouncer. Please note that configuration changes are automatically applied to the running instances without validation, so having an invalid config can make the cluster unavailable.

Value type	Example
subdoc	global: pool_mode: transaction

proxy.pgBouncer.sidecars subsection¶

The proxy.pgBouncer.sidecars subsection in the deploy/cr.yaml file contains configuration options for custom sidecar containers which can be added to pgBouncer Pods.

`proxy.pgBouncer.sidecars.image`¶

Image for the custom sidecar container for pgBouncer Pods.

Value type	Example
string	`mycontainer1:latest`

`proxy.pgBouncer.sidecars.name`¶

Name of the custom sidecar container for pgBouncer Pods.

Value type	Example
string	`testcontainer`

`proxy.pgBouncer.sidecars.imagePullPolicy`¶

This option is used to set the policy for the pgBouncer Pod sidecar container.

Value type	Example
string	`Always`

`proxy.pgBouncer.sidecars.env`¶

The environment variables set as key-value pairs for the custom sidecar container for pgBouncer Pods.

Value type	Example
subdoc

`proxy.pgBouncer.sidecars.envFrom`¶

The environment variables set as key-value pairs in ConfigMaps for the custom sidecar container for pgBouncer Pods.

Value type	Example
subdoc

`proxy.pgBouncer.sidecars.command`¶

Command for the custom sidecar container for pgBouncer Pods.

Value type	Example
array	`["/bin/sh"]`

`proxy.pgBouncer.sidecars.args`¶

Command arguments for the custom sidecar container for pgBouncer Pods.

Value type	Example
array	`["-c", "while true; do trap 'exit 0' SIGINT SIGTERM SIGQUIT SIGKILL; done;"]`

Patroni Section¶

The patroni section in the deploy/cr.yaml file contains configuration options to customize the PostgreSQL high-availability implementation based on Patroni .

Value type	Example
int	`3`

`patroni.syncPeriodSeconds`¶

How often to perform liveness/readiness probes for the patroni container (in seconds).

Value type	Example
int	`3`

`patroni.leaderLeaseDurationSeconds`¶

Initial delay for liveness/readiness probes for the patroni container (in seconds).

`patroni.dynamicConfiguration`¶

Custom PostgreSQL configuration options. Please note that configuration changes are automatically applied to the running instances without validation, so having an invalid config can make the cluster unavailable.

Value type	Example
subdoc	postgresql: parameters: max_parallel_workers: 2 max_worker_processes: 2 shared_buffers: 1GB work_mem: 2MB

`patroni.switchover.enabled`¶

Enables or disables manual change of the cluster primary instance.

Value type	Example
string	true

`patroni.switchover.targetInstance`¶

The name of the Pod that should be set as the new primary. When not specified, the new primary will be selected randomly.

Value type	Example
string

Custom extensions Section¶

The extensions section in the deploy/cr.yaml file contains configuration options to manage PostgreSQL extensions.

`extensions.image`¶

Image for the custom PostgreSQL extension loader sidecar container.

Value type	Example
string	`percona/percona-postgresql-operator:2.6.0`

`extensions.imagePullPolicy`¶

Policy for the custom extension sidecar container.

Value type	Example
string	`Always`

`extensions.storage.type`¶

The cloud storage type used for backups. Only s3 type is currently supported.

Value type	Example
string	`s3`

`extensions.storage.bucket`¶

The Amazon S3 bucket name for prepackaged PostgreSQL custom extensions.

Value type	Example
string	`pg-extensions`

`extensions.storage.region`¶

The AWS region to use.

Value type	Example
string	`eu-central-1`

`extensions.storage.endpoint`¶

The S3 endpoint to use.

Value type	Example
string	`s3.eu-central-1.amazonaws.com`

`extensions.storage.secret.name`¶

The Kubernetes secret for the custom extensions storage. It should contain AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY keys.

Value type	Example
string	`cluster1-extensions-secret`

`extensions.builtin.pg_stat_monitor`¶

Enable or disable pg_stat_monitor PostgreSQL extension.

Value type	Example
boolean	`true`

`extensions.builtin.pg_audit`¶

Enable or disable PGAudit PostgreSQL extension.

Value type	Example
boolean	`true`

`extensions.builtin.pgvector`¶

Enable or disable pgvector PostgreSQL extension. This extension is not compatible with PostgreSQL 12!

Value type	Example
boolean	`false`

`extensions.custom.name`¶

Name of the PostgreSQL custom extension.

Value type	Example
string	`pg_cron`

`extensions.custom.version`¶

Version of the PostgreSQL custom extension.

Value type	Example
string	`1.6.1`

Last update: 2025-04-07

Custom Resource options¶

metadata¶

Toplevel spec elements¶

crVersion¶

metadata.annotations¶

metadata.labels¶

tlsOnly¶

standby.enabled¶

standby.host¶

standby.port¶

openshift¶

autoCreateUserSchema¶

standby.repoName¶

secrets.customRootCATLSSecret.name¶

secrets.customRootCATLSSecret.items¶

secrets.customTLSSecret.name¶

secrets.customReplicationTLSSecret.name¶

users.name¶

users.databases¶

users.password.type¶

users.options¶

users.secretName¶

databaseInitSQL.key¶

databaseInitSQL.name¶

pause¶

unmanaged¶

dataSource.postgresCluster.clusterName¶

dataSource.postgresCluster.clusterNamespace¶

dataSource.postgresCluster.repoName¶

dataSource.postgresCluster.options¶

dataSource.postgresCluster.tolerations.effect¶

dataSource.postgresCluster.tolerations.key¶

dataSource.postgresCluster.tolerations.operator¶

dataSource.postgresCluster.tolerations.value¶

dataSource.pgbackrest.stanza¶

dataSource.pgbackrest.configuration.secret.name¶

dataSource.pgbackrest.global¶

dataSource.pgbackrest.repo.name¶

dataSource.pgbackrest.repo.s3.bucket¶

dataSource.pgbackrest.repo.s3.endpoint¶

dataSource.pgbackrest.repo.s3.region¶

dataSource.pgbackrest.tolerations.effect¶

dataSource.pgbackrest.tolerations.key¶

dataSource.pgbackrest.tolerations.operator¶

dataSource.pgbackrest.tolerations.value¶

dataSource.volumes.pgDataVolume.pvcName¶

dataSource.volumes.pgDataVolume.directory¶

dataSource.volumes.pgDataVolume.tolerations.effect¶

dataSource.volumes.pgDataVolume.tolerations.key¶

dataSource.volumes.pgDataVolume.tolerations.operator¶

dataSource.volumes.pgDataVolume.tolerations.value¶

dataSource.volumes.pgDataVolume.annotations¶

dataSource.volumes.pgDataVolume.labels¶

dataSource.volumes.pgWALVolume.pvcName¶

dataSource.volumes.pgWALVolume.directory¶

dataSource.volumes.pgWALVolume.tolerations.effect¶

dataSource.volumes.pgWALVolume.tolerations.key¶

dataSource.volumes.pgWALVolume.tolerations.operator¶

dataSource.volumes.pgWALVolume.tolerations.value¶

dataSource.volumes.pgWALVolume.annotations¶

dataSource.volumes.pgWALVolume.labels¶

dataSource.volumes.pgBackRestVolume.pvcName¶

dataSource.volumes.pgBackRestVolume.directory¶

dataSource.volumes.pgBackRestVolume.tolerations.effect¶

dataSource.volumes.pgBackRestVolume.tolerations.key¶

dataSource.volumes.pgBackRestVolume.tolerations.operator¶

dataSource.volumes.pgBackRestVolume.tolerations.value¶

dataSource.volumes.pgBackRestVolume.annotations¶

dataSource.volumes.pgBackRestVolume.labels¶

image¶

imagePullPolicy¶

postgresVersion¶

port¶

expose.annotations¶

expose.labels¶

expose.type¶

expose.loadBalancerSourceRanges¶

exposeReplicas.annotations¶

exposeReplicas.labels¶

exposeReplicas.type¶

`metadata`¶

Toplevel `spec` elements¶

`crVersion`¶

`metadata.annotations`¶

`metadata.labels`¶

`tlsOnly`¶

`standby.enabled`¶

`standby.host`¶

`standby.port`¶

`openshift`¶

`autoCreateUserSchema`¶

`standby.repoName`¶

`secrets.customRootCATLSSecret.name`¶

`secrets.customRootCATLSSecret.items`¶

`secrets.customTLSSecret.name`¶

`secrets.customReplicationTLSSecret.name`¶

`users.name`¶

`users.databases`¶

`users.password.type`¶

`users.options`¶

`users.secretName`¶

`databaseInitSQL.key`¶

`databaseInitSQL.name`¶

`pause`¶

`unmanaged`¶

`dataSource.postgresCluster.clusterName`¶

`dataSource.postgresCluster.clusterNamespace`¶

`dataSource.postgresCluster.repoName`¶

`dataSource.postgresCluster.options`¶

`dataSource.postgresCluster.tolerations.effect`¶

`dataSource.postgresCluster.tolerations.key`¶

`dataSource.postgresCluster.tolerations.operator`¶

`dataSource.postgresCluster.tolerations.value`¶

`dataSource.pgbackrest.stanza`¶

`dataSource.pgbackrest.configuration.secret.name`¶

`dataSource.pgbackrest.global`¶

`dataSource.pgbackrest.repo.name`¶

`dataSource.pgbackrest.repo.s3.bucket`¶

`dataSource.pgbackrest.repo.s3.endpoint`¶

`dataSource.pgbackrest.repo.s3.region`¶

`dataSource.pgbackrest.tolerations.effect`¶

`dataSource.pgbackrest.tolerations.key`¶

`dataSource.pgbackrest.tolerations.operator`¶

`dataSource.pgbackrest.tolerations.value`¶

`dataSource.volumes.pgDataVolume.pvcName`¶

`dataSource.volumes.pgDataVolume.directory`¶

`dataSource.volumes.pgDataVolume.tolerations.effect`¶

`dataSource.volumes.pgDataVolume.tolerations.key`¶

`dataSource.volumes.pgDataVolume.tolerations.operator`¶

`dataSource.volumes.pgDataVolume.tolerations.value`¶

`dataSource.volumes.pgDataVolume.annotations`¶

`dataSource.volumes.pgDataVolume.labels`¶

`dataSource.volumes.pgWALVolume.pvcName`¶

`dataSource.volumes.pgWALVolume.directory`¶

`dataSource.volumes.pgWALVolume.tolerations.effect`¶

`dataSource.volumes.pgWALVolume.tolerations.key`¶

`dataSource.volumes.pgWALVolume.tolerations.operator`¶

`dataSource.volumes.pgWALVolume.tolerations.value`¶

`dataSource.volumes.pgWALVolume.annotations`¶

`dataSource.volumes.pgWALVolume.labels`¶

`dataSource.volumes.pgBackRestVolume.pvcName`¶

`dataSource.volumes.pgBackRestVolume.directory`¶

`dataSource.volumes.pgBackRestVolume.tolerations.effect`¶

`dataSource.volumes.pgBackRestVolume.tolerations.key`¶

`dataSource.volumes.pgBackRestVolume.tolerations.operator`¶

`dataSource.volumes.pgBackRestVolume.tolerations.value`¶

`dataSource.volumes.pgBackRestVolume.annotations`¶

`dataSource.volumes.pgBackRestVolume.labels`¶

`image`¶

`imagePullPolicy`¶

`postgresVersion`¶

`port`¶

`expose.annotations`¶

`expose.labels`¶

`expose.type`¶

`expose.loadBalancerSourceRanges`¶

`exposeReplicas.annotations`¶

`exposeReplicas.labels`¶

`exposeReplicas.type`¶

`exposeReplicas.loadBalancerSourceRanges`¶