percona · nastena1606 · Dec 25, 2025 · Dec 22, 2025 · Dec 23, 2025 · Dec 23, 2025
@@ -33,7 +33,7 @@ After applying it as usual, by running `kubectl apply -f deploy/upgrade.yaml` co
 3. Jobs are created to migrate the data,
 4. The cluster starts up after the upgrade finishes.
 
-Check official documentation for [more details](../update.md#major-version-upgrade), including ones about tracking the upgrade process and side effects for users with custom extensions.
+Check official documentation for [more details](../update-database.md#major-version-upgrade), including ones about tracking the upgrade process and side effects for users with custom extensions.
 
 ## Supporting PostgreSQL tablespaces 
 

@@ -54,8 +54,8 @@ spec:
 ## Improvements
 
 * {{ k8spgjira(630) }}: A new `backups.trackLatestRestorableTime` Custom Resource option allows to disable latest restorable time tracking for users who need reducing S3 API calls usage
-* {{ k8spgjira(605) }} and {{ k8spgjira(593) }}: Documentation now includes information about [upgrading the Operator via Helm](../update.md#upgrade-via-helm) and [using databaseInitSQL commands](../initsql.md)
-* {{ k8spgjira(598) }}: Database major version upgrade now [supports custom images](../update.md#major-version-upgrade)
+* {{ k8spgjira(605) }} and {{ k8spgjira(593) }}: Documentation now includes information about [upgrading the Operator via Helm](../update-operator.md#upgrade-via-helm) and [using databaseInitSQL commands](../initsql.md)
+* {{ k8spgjira(598) }}: Database major version upgrade now [supports custom images](../update-database.md#major-version-upgrade)
 * {{ k8spgjira(560) }}: A `pg-restore` Custom Resource is now automatically created at [bootstrapping a new cluster from an existing backup](../backups-restore.md#restore-to-a-new-postgresql-cluster)
 * {{ k8spgjira(555) }}: The Operator now creates separate Secret with CA certificate for each cluster
 * {{ k8spgjira(553) }}: Users can provide the Operator with their own [root CA certificate](../TLS.md#generate-custom-certificates-for-the-operator-yourself)

@@ -26,7 +26,7 @@ PostgreSQL 17 is now supported by the Operator in addition to versions 13 - 16.
 
 PostgreSQL 17 is currently not recommended for production environments due to the [known limitation](#known-limitations).
 
-_Update from April 1, 2025_: We have added PostgreSQL 17.4 image and database cluster components based on this image. It is now production ready and we recommend updating the database cluster from PostgreSQL 17.2 to 17.4. Check the [upgrade instructions](../update.md#minor-version-upgrade) for steps
+_Update from April 1, 2025_: We have added PostgreSQL 17.4 image and database cluster components based on this image. It is now production ready and we recommend updating the database cluster from PostgreSQL 17.2 to 17.4. Check the [upgrade instructions](../update-database.md#minor-version-upgrade) for steps
 
 ### `pgvector` is added to the PostgreSQL image
 
@@ -81,7 +81,7 @@ To support you with your AI journey, we've added the `pgvector` extension to the
 
 ## Supported platforms
 
-The Operator {{ release }} is developed, tested and based on:
+The Operator 2.6.0 is developed, tested and based on:
 
 * PostgreSQL 13.20, 14.17, 15.12, 16.8, 17.2 and 17.4 as the database. Other versions may also work but have not been tested. 
 * pgBouncer for connection pooling:
@@ -98,7 +98,7 @@ The Operator {{ release }} is developed, tested and based on:
 
 Percona Operators are designed for compatibility with all [CNCF-certified :octicons-link-external-16:](https://www.cncf.io/training/certification/software-conformance/) Kubernetes distributions. 
 
-Our release process includes targeted testing and validation on major cloud provider platforms and OpenShift, as detailed below for Operator version {{release}}:
+Our release process includes targeted testing and validation on major cloud provider platforms and OpenShift, as detailed below for Operator version 2.6.0:
 
 * [Google Kubernetes Engine (GKE) :octicons-link-external-16:](https://cloud.google.com/kubernetes-engine) 1.29 - 1.31
 * [Amazon Elastic Container Service for Kubernetes (EKS) :octicons-link-external-16:](https://aws.amazon.com) 1.29 - 1.32

@@ -156,7 +156,7 @@ Read more about these troubleshooting methods in the [documentation](../manage-m
     All Custom Resource manifests now include the registry name in image paths. This enables you to successfully install the Operator using the default manifests from Git repositories. If you upgrade the Operator and the database cluster via the command line interface, add the `docker.io` registry name to image paths for all components in the format:
 
     ```
-    "docker.io/percona/percona-postgresql-operator:{{release}}-ppg{{postgresrecommended}}-postgres"
+    "docker.io/percona/percona-postgresql-operator:2.7.0-ppg{{postgresrecommended}}-postgres"
     ```
 
     Follow our [upgrade documentation](../update.md) for update guidelines.
@@ -180,7 +180,7 @@ The Operator {{ release }} is developed, tested and based on:
 
 Percona Operators are designed for compatibility with all [CNCF-certified :octicons-link-external-16:](https://www.cncf.io/training/certification/software-conformance/) Kubernetes distributions. 
 
-Our release process includes targeted testing and validation on major cloud provider platforms and OpenShift, as detailed below for Operator version {{release}}:
+Our release process includes targeted testing and validation on major cloud provider platforms and OpenShift, as detailed below for Operator version 2.7.0:
 
 --8<-- [start:platforms]
 

@@ -176,7 +176,7 @@ Attempting to use the Operator with other PostgreSQL versions or custom images i
 
 ## Supported software
 
-The Operator {{ release }} is developed, tested and based on:
+The Operator 2.8.0 is developed, tested and based on:
 
 --8<-- [start:software]
 
@@ -191,7 +191,7 @@ The Operator {{ release }} is developed, tested and based on:
 
 Percona Operators are designed for compatibility with all [CNCF-certified :octicons-link-external-16:](https://www.cncf.io/training/certification/software-conformance/) Kubernetes distributions. 
 
-Our release process includes targeted testing and validation on major cloud provider platforms and OpenShift, as detailed below for Operator version {{release}}:
+Our release process includes targeted testing and validation on major cloud provider platforms and OpenShift, as detailed below for Operator version 2.8.0:
 
 --8<-- [start:platforms]
 

@@ -28,7 +28,7 @@ Find PostgreSQL 18 images in the list of [Percona-certified images](#percona-cer
 
 ## Supported software
 
-The Operator {{ release }} is developed, tested and based on:
+The Operator 2.8.1 is developed, tested and based on:
 
 --8<-- [start:software]
 
@@ -59,7 +59,7 @@ The Operator {{ release }} is developed, tested and based on:
 
 Percona Operators are designed for compatibility with all [CNCF-certified :octicons-link-external-16:](https://www.cncf.io/training/certification/software-conformance/) Kubernetes distributions. 
 
-Our release process includes targeted testing and validation on major cloud provider platforms and OpenShift, as detailed below for Operator version {{release}}:
+Our release process includes targeted testing and validation on major cloud provider platforms and OpenShift, as detailed below for Operator version 2.8.1:
 
 --8<-- [start:platforms]
 

@@ -0,0 +1,79 @@
+# Percona Operator for PostgreSQL 2.8.2 ({{date.2_8_2}})
+
+[Get started with the Operator :material-arrow-right:](../quickstart.md){.md-button}
+
+## Release Highlights
+
+This release provides PostgreSQL images for the updated releases of Percona Distribution for PostgreSQL 18 rebuilt with disabled debug assertions. 
+
+You can find the latest available images in the [images list](#percona-certified-images).
+
+## Supported software
+
+This version of the Operator is developed, tested and based on:
+
+--8<-- [start:software]
+
+* PostgreSQL 18.1-3, 17.7-2, 16.11-2, 15.15-2, 14.20-2, 13.23-2 as the database. Other versions may also work but have not been tested.
+* pgBackRest 2.57.0-1 for backup and recovery
+* pgBouncer 1.25.0-1 for connection pooling
+* Patroni version 4.1.0 for high availability
+* PMM Client versions 2.44.1-1 and 3.5.0 
+* PostGIS:
+
+    * version 3.5.4 for PostgreSQL 18
+    * version 3.3.8 for PostgreSQL 17, 16, 15, 14, and 13
+
+
+--8<-- [end:software]
+
+## Supported platforms
+
+Percona Operators are designed for compatibility with all [CNCF-certified :octicons-link-external-16:](https://www.cncf.io/training/certification/software-conformance/) Kubernetes distributions. 
+
+Our release process includes targeted testing and validation on major cloud provider platforms and OpenShift, as detailed below for the current Operator version:
+
+--8<-- [start:platforms]
+
+* [Google Kubernetes Engine (GKE) :octicons-link-external-16:](https://cloud.google.com/kubernetes-engine) 1.31 - 1.33
+* [Amazon Elastic Kubernetes Service (EKS) :octicons-link-external-16:](https://aws.amazon.com) 1.31 - 1.34
+* [Azure Kubernetes Service (AKS) :octicons-link-external-16:](https://azure.microsoft.com/en-us/services/kubernetes-service/) 1.32 - 1.34
+* [OpenShift :octicons-link-external-16:](https://www.redhat.com/en/technologies/cloud-computing/openshift) 4.16 - 4.20
+* [Minikube :octicons-link-external-16:](https://github.com/kubernetes/minikube) 1.37.0 with Kubernetes v1.34.0
+
+--8<-- [end:platforms]
+
+This list only includes the platforms that the Percona Operators are specifically tested on as part of the release process. Other Kubernetes flavors and versions depend on the backward compatibility offered by Kubernetes itself.
+
+## Percona certified images
+
+Find Percona's certified Docker images that you can use with the Percona Operator for PostgreSQL in the following table.
+
+
+--8<-- [start:images]
+
+| Image                                                                 | Digest                                                           |
+|:----------------------------------------------------------------------|:-----------------------------------------------------------------|
+| percona/percona-postgresql-operator:2.8.2  (x86_64)  | 018b0063352fff83d7850d732c80ba6a938c425ac2d9ac7e9a0a270361ff3fc0 |
+| percona/percona-postgresql-operator:2.8.2 (ARM64)  | ce7e6f612d4cef4ef86f06521549f3e3c4e1fe8ecf794feff6f3205667863792 |
+| percona/percona-distribution-postgresql:18.1-3   | 940859b7c45d1217ba852e8c5e5500832daf61c6914d5af33808251cb23f0102 |
+| percona/percona-distribution-postgresql:17.7-2   | 7beb6a0d9fd4c4e8125c5cb43c48e8b189a4dca7b4f1ec1e433b49956d4203d6 |
+| percona/percona-distribution-postgresql:16.11-2    | 80882a55997c58b7a4dd5defc6482d99dc31c11fbd206f788e540a74ffab4823 |
+| percona/percona-distribution-postgresql:15.15-2       | 100ef9920d70d0ff53a0466f9b077ba3f1828c31b330a08a6e6e11802b870178 |
+| percona/percona-distribution-postgresql:14.20-2    | 011bae00abeb266352aa6c8e127396b0a3fb5877f0112f5291172624b5556120 |
+| percona/percona-distribution-postgresql:13.23-2     | 39ef40f72704e8e782ed43fb5a5072ee557fd410b85b9d2177b332ce39b888f5 |
+| percona/percona-postgresql-operator:2.8.2-ppg18.1-postgres-gis3.5.4   | a9c58611e1660a1377a579370c0684a5bc12a37df69031bdcf7dac5332d016ad |
+| percona/percona-postgresql-operator:2.8.2-ppg17.7-postgres-gis3.3.8   | 64246fa0fe2213f2321bdd565181578fd84e8d745b044553b60d45c41dbf3e5c |
+| percona/percona-postgresql-operator:2.8.2-ppg16.11-postgres-gis3.3.8  | d4467fe931e6403538a1f9831c7c97f84177027bfb226a9a7e021026506bb4d7 |
+| percona/percona-postgresql-operator:2.8.2-ppg15.15-postgres-gis3.3.8  | d9680938ae31bc0c2d1fd89cda306b1bdb9b4aef424d706896460de71a2311e2 |
+| percona/percona-postgresql-operator:2.8.2-ppg14.20-postgres-gis3.3.8  | 71947a799ea4e957bf6a9dd6a4ff055037a335d9d71186452b64e05d1ce68c38 |
+| percona/percona-postgresql-operator:2.8.2-ppg13.23-postgres-gis3.3.8  | 9b75f33ee9d7e95a0d9ea9e619533878d92814183a0ed9ad59bc69813b11a84d |
+| percona/percona-pgbouncer:1.25.0-1 (x86_64)  | bf2f325cc733b96dc360c2386c8931ed9e3513f55cb425e59033e1e56737134f |
+| percona/percona-pgbouncer:1.25.0-1 (ARM64)    | 902feac78cf98fbd6a7aece1761371dd1a43faaed88b63be0e0d54dd524b8286 |
+| percona/percona-pgbackrest:2.57.0-1  (x86_64)   | 2bf7265f84210671bc5c0928cc772202c0e6054d426eb6ecf86279d69e831b96 |
+| percona/percona-pgbackrest:2.57.0-1 (ARM64)   | 59245b25fd5d0c1a2540b465e846b69f4c91b6cd183c3bfd96aa856d3e7ffbf3 |
+| percona/pmm-client:2.44.1-1         | 52a8fb5e8f912eef1ff8a117ea323c401e278908ce29928dafc23fac1db4f1e3 |
+| percona/pmm-client:3.5.0 (x86_64)   | 352aee74f25b3c1c4cd9dff1f378a0c3940b315e551d170c09953bf168531e4a |
+| percona/pmm-client:3.5.0 (ARM64)    | cbbb074d51d90a5f2d6f1d98a05024f6de2ffdcb5acab632324cea4349a820bd |
+
+--8<-- [end:images]
@@ -1,5 +1,7 @@
 # Percona Operator for PostgreSQL Release Notes
 
+* [Percona Operator for PostgreSQL 2.8.2 ({{date.2_8_2}})](Kubernetes-Operator-for-PostgreSQL-RN2.8.2.md)
+
 * [Percona Operator for PostgreSQL 2.8.1 ({{date.2_8_1}})](Kubernetes-Operator-for-PostgreSQL-RN2.8.1.md)
 
 * [Percona Operator for PostgreSQL 2.8.0 ({{date.2_8_0}})](Kubernetes-Operator-for-PostgreSQL-RN2.8.0.md)

@@ -6,8 +6,8 @@
 <img src="assets/images/PerconaLogostackedlightbackground.svg" />
 </p>
 
-<h1>Operator for PostgreSQL 2.8.1</h1>
-<h2>(December 16, 2025)</h2>
+<h1>Operator for PostgreSQL 2.8.2</h1>
+<h2>(December 25, 2025)</h2>
 
 <!--<h3>Percona Technical Documentation Team</h3>-->
 

@@ -6,6 +6,7 @@ Cluster components:
 
 | Operator | [PostgreSQL :octicons-link-external-16:](https://www.postgresql.org/) | [pgBackRest :octicons-link-external-16:](https://pgbackrest.org/) | [pgBouncer :octicons-link-external-16:](http://pgbouncer.github.io/) |
 |:---------|:--------|:-----|:-------|
+| [2.8.2](ReleaseNotes/Kubernetes-Operator-for-PostgreSQL-RN2.8.2.md) | 13 - 18 | 2.57.0 | 1.25.0 |
 | [2.8.1](ReleaseNotes/Kubernetes-Operator-for-PostgreSQL-RN2.8.1.md) | 13 - 18 | 2.57.0 | 1.25.0 |
 | [2.8.0](ReleaseNotes/Kubernetes-Operator-for-PostgreSQL-RN2.8.0.md) | 13 - 17 | 2.56.0 | 1.24.1 |
 | [2.7.0](ReleaseNotes/Kubernetes-Operator-for-PostgreSQL-RN2.7.0.md) | 13 - 17 | 2.55.0 | 1.24.1 |
@@ -32,6 +33,7 @@ Platforms:
 
 | Operator | [GKE :octicons-link-external-16:](https://cloud.google.com/kubernetes-engine)         | [EKS :octicons-link-external-16:](https://aws.amazon.com)         | [Openshift :octicons-link-external-16:](https://www.redhat.com/en/technologies/cloud-computing/openshift) | [Azure Kubernetes Service (AKS) :octicons-link-external-16:](https://azure.microsoft.com/en-us/services/kubernetes-service/) | [Minikube :octicons-link-external-16:](https://github.com/kubernetes/minikube)                          |
 |:--------|:------------|:------------|:------------|:------------|:----------------------------------|
+| [2.8.2](ReleaseNotes/Kubernetes-Operator-for-PostgreSQL-RN2.8.2.md) | 1.31 - 1.33 | 1.31 - 1.34 | 4.16 - 4.20| 1.32 - 1.34 | 1.37.0 |
 | [2.8.1](ReleaseNotes/Kubernetes-Operator-for-PostgreSQL-RN2.8.1.md) | 1.31 - 1.33 | 1.31 - 1.34 | 4.16 - 4.20| 1.32 - 1.34 | 1.37.0 |
 | [2.8.0](ReleaseNotes/Kubernetes-Operator-for-PostgreSQL-RN2.8.0.md) | 1.31 - 1.33 | 1.31 - 1.34 | 4.16 - 4.20| 1.32 - 1.34 | 1.37.0 |
 | [2.7.0](ReleaseNotes/Kubernetes-Operator-for-PostgreSQL-RN2.7.0.md) |1.30 - 1.32 | 1.30 - 1.33 | 4.15 - 4.19| 1.30 - 1.33 | 1.36.0 |

@@ -270,6 +270,7 @@ nav:
           - "Trademark policy": trademark-policy.md
     - Release Notes:
           - "Release notes index": ReleaseNotes/index.md
+          - ReleaseNotes/Kubernetes-Operator-for-PostgreSQL-RN2.8.2.md
           - ReleaseNotes/Kubernetes-Operator-for-PostgreSQL-RN2.8.1.md
           - ReleaseNotes/Kubernetes-Operator-for-PostgreSQL-RN2.8.0.md
           - ReleaseNotes/Kubernetes-Operator-for-PostgreSQL-RN2.7.0.md

@@ -1,16 +1,16 @@
 # Variables used across the documentation
 
 
-release: 2.8.1
+release: 2.8.2
 #pruned_version: 
 
 # Supported software
 
 pmm3recommended: 3.5.0
 commandName: 'kubectl'
-postgres18recommended: '18.1-1'
-postgresrecommended: '17.7-1'
-postgres16recommended: '16.11-1'
+postgres18recommended: '18.1-3'
+postgresrecommended: '17.7-2'
+postgres16recommended: '16.11-2'
 pgversiongis: 17.7
 certmanagerrecommended: '1.19.1.1'
 pgbouncerrecommended: '1.25.0-1'
@@ -22,6 +22,7 @@ k8s_monitor_tag: 'v0.1.1'
 
 
 date:
+  2_8_2: "2025-12-25"
   2_8_1: "2025-12-16"
   2_8_0: "2025-11-13"
   2_7_0: "2025-07-18"