From d7b83fbc11d11c57369f4262ba02d06db2ab0ee8 Mon Sep 17 00:00:00 2001 From: Dzmitry Date: Mon, 2 Dec 2024 15:37:56 +0300 Subject: [PATCH 01/17] K8SPXC-1476 1.16.0 release --- .../Kubernetes-Operator-for-PXC-RN1.16.0.md | 60 +++++++++++++++++++ docs/ReleaseNotes/index.md | 1 + 2 files changed, 61 insertions(+) create mode 100644 docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md diff --git a/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md b/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md new file mode 100644 index 00000000..064ae3a4 --- /dev/null +++ b/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md @@ -0,0 +1,60 @@ +# *Percona Operator for MySQL based on Percona XtraDB Cluster* 1.16.0 + +* **Date** + + December XX, 2024 + +* **Installation** + + [Installing Percona Operator for MySQL based on Percona XtraDB Cluster](../System-Requirements.md#installation-guidelines) + +## Release Highlights + + +## New Features + +* {{ k8spxcjira(1421) }}: Provide documentation how to restore from xbstream file +* {{ k8spxcjira(1433) }}: Explain in which situations cluster-wide/multi-namespace installation should be used over single-namespace one +* {{ k8spxcjira(1456) }}: Custom initContainers with custom securityContext for PXC pods + +## Improvements + +* {{ k8spxcjira(1411) }}: Allow enabling/disabling TLS in a running cluster +* {{ k8spxcjira(1451) }}: Disable PVC resize by default +* {{ k8spxcjira(1503) }}: Fix exec in pitr and proxysql pods + +## Bugs Fixed + +* {{ k8spxcjira(1398) }}: Scheduled PXC backup job pod fails to complete the process successfully in randomly/sporadically fashion +* {{ k8spxcjira(1413) }}: PXC operator pod segfaults when restoring a backup without backup source populated in cr.yaml +* {{ k8spxcjira(1416) }}: allowParallel:false leads to stuck backups if there is a failed backup +* {{ k8spxcjira(1420) }}: PITR restore hung with duplicate key error +* {{ k8spxcjira(1422) }}: Cluster Endpoint Change when Uprgading +* {{ k8spxcjira(1443) }}: Operator can't survive system users "Host" part change +* {{ k8spxcjira(1444) }}: PXC cluster initial creation state changed to error if backup restore happens for too long +* {{ k8spxcjira(1396) }}: The `xtrabackup` user didn't have rights to grant privileges available in its own privilege level to other users, which caused the point-in-time recovery fail due to access denied +* {{ k8spxcjira(1454) }}: Operator generate ssl secrets as soon as it was updates to v1.15.0 +* {{ k8spxcjira(1458) }}: Fix panic when getting storage type +* {{ k8spxcjira(1464) }}: haproxy can't start after kubelet/worker node restart +* {{ k8spxcjira(1500) }}: Backup job doesn't fail and garbd doesn't stop after xbcloud upload failure + +## Supported Platforms + +The Operator was developed and tested with Percona XtraDB Cluster versions 8.0.36-28.1 and 5.7.44-31.65. Other options may also work but have not been tested. Other software components include: + +* Percona XtraBackup versions 8.0.35-30.1 and 2.4.29-1 +* HAProxy 2.8.5 +* ProxySQL 2.5.5 +* LogCollector based on fluent-bit 3.1.4 +* PMM Client 2.42.0 + +The following platforms were tested and are officially supported by the Operator +1.15.0: + +* [Google Kubernetes Engine (GKE) :octicons-link-external-16:](https://cloud.google.com/kubernetes-engine) 1.27 - 1.30 +* [Amazon Elastic Container Service for Kubernetes (EKS) :octicons-link-external-16:](https://aws.amazon.com) 1.28 - 1.30 +* [Azure Kubernetes Service (AKS) :octicons-link-external-16:](https://azure.microsoft.com/en-us/services/kubernetes-service/) 1.28 - 1.30 +* [OpenShift :octicons-link-external-16:](https://www.redhat.com/en/technologies/cloud-computing/openshift) 4.13.46 - 4.16.7 +* [Minikube :octicons-link-external-16:](https://minikube.sigs.k8s.io/docs/) 1.33.1 based on Kubernetes 1.30.0 + +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. diff --git a/docs/ReleaseNotes/index.md b/docs/ReleaseNotes/index.md index c1511051..7896067e 100644 --- a/docs/ReleaseNotes/index.md +++ b/docs/ReleaseNotes/index.md @@ -1,5 +1,6 @@ # Percona Operator for MySQL based on Percona XtraDB Cluster Release Notes +* [*Percona Operator for MySQL based on Percona XtraDB Cluster* 1.16.0 (2024-12-XX)](Kubernetes-Operator-for-PXC-RN1.16.0.md) * [*Percona Operator for MySQL based on Percona XtraDB Cluster* 1.15.1 (2024-10-16)](Kubernetes-Operator-for-PXC-RN1.15.1.md) * [*Percona Operator for MySQL based on Percona XtraDB Cluster* 1.14.1 (2024-10-16)](Kubernetes-Operator-for-PXC-RN1.14.1.md) * [*Percona Operator for MySQL based on Percona XtraDB Cluster* 1.15.0 (2024-08-20)](Kubernetes-Operator-for-PXC-RN1.15.0.md) From 26a58cc258babd31eeba6402c074b095dca9a5e3 Mon Sep 17 00:00:00 2001 From: Dmitriy Kostiuk Date: Tue, 10 Dec 2024 16:07:59 +0300 Subject: [PATCH 02/17] Update Kubernetes-Operator-for-PXC-RN1.16.0.md --- .../Kubernetes-Operator-for-PXC-RN1.16.0.md | 28 +++++++++++++++++-- 1 file changed, 26 insertions(+), 2 deletions(-) diff --git a/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md b/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md index 064ae3a4..833b3772 100644 --- a/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md +++ b/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md @@ -10,6 +10,31 @@ ## Release Highlights +### Declarative user management (technical preview) + +Before the Operator version 1.16.0 custom MySQL users had to be created manually. Now the declarative creation of custom MongoDB users [is supported](../users.md#unprivileged-users) via the `users` subsection in the Custom Resource. You can specify a new user in `deploy/cr.yaml` manifest, setting the user’s login name and host, PasswordSecretRef (a reference to a key in a Secret resource containing user’s password) and as well as databases the user is going to have access to and the appropriate permissions: + +```yaml +... +users: +- name: my-user + db: + - test1 + - test2 + hosts: + - % + - localhost + - 111.111.111.111 + passwordSecretRef: + name: my-user-password + key: my-user-password-key + withGrantOption: yes + grants: + - REPLICATION SLAVE + - ALL +``` + +See [documentation](../users.md#unprivileged-users) to find more details about this feature with additional explanations and the list of current limitations. ## New Features @@ -48,8 +73,7 @@ The Operator was developed and tested with Percona XtraDB Cluster versions 8.0.3 * LogCollector based on fluent-bit 3.1.4 * PMM Client 2.42.0 -The following platforms were tested and are officially supported by the Operator -1.15.0: +Percona Operators are designed for compatibility with all [CNCF :octicons-link-external-16:](https://www.cncf.io/) certified Kubernetes distributions. Our release process includes targeted testing and validation on major cloud provider platforms and OpenShift, as detailed below for Operator version 1.16.0: * [Google Kubernetes Engine (GKE) :octicons-link-external-16:](https://cloud.google.com/kubernetes-engine) 1.27 - 1.30 * [Amazon Elastic Container Service for Kubernetes (EKS) :octicons-link-external-16:](https://aws.amazon.com) 1.28 - 1.30 From f298b92c67aec5e6a6b6f73fc5106b20de0287f4 Mon Sep 17 00:00:00 2001 From: Dmitriy Kostiuk Date: Wed, 11 Dec 2024 14:12:14 +0300 Subject: [PATCH 03/17] Update Kubernetes-Operator-for-PXC-RN1.16.0.md --- .../Kubernetes-Operator-for-PXC-RN1.16.0.md | 24 +++++++++---------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md b/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md index 833b3772..72a249a6 100644 --- a/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md +++ b/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md @@ -18,20 +18,20 @@ Before the Operator version 1.16.0 custom MySQL users had to be created manually ... users: - name: my-user - db: - - test1 - - test2 + dbs: + - db1 + - db2 hosts: - - % - localhost - - 111.111.111.111 - passwordSecretRef: - name: my-user-password - key: my-user-password-key - withGrantOption: yes - grants: - - REPLICATION SLAVE - - ALL + grants: + - SELECT + - DELETE + - INSERT + withGrantOption: true + passwordSecretRef: + name: my-user-pwd + key: my-user-pwd-key +... ``` See [documentation](../users.md#unprivileged-users) to find more details about this feature with additional explanations and the list of current limitations. From dd88944526d1684c303995ebbf3532d4d8ed96fc Mon Sep 17 00:00:00 2001 From: Dmitriy Kostiuk Date: Fri, 13 Dec 2024 10:54:37 +0300 Subject: [PATCH 04/17] Update Kubernetes-Operator-for-PXC-RN1.16.0.md --- docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md b/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md index 72a249a6..b0285942 100644 --- a/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md +++ b/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md @@ -73,7 +73,7 @@ The Operator was developed and tested with Percona XtraDB Cluster versions 8.0.3 * LogCollector based on fluent-bit 3.1.4 * PMM Client 2.42.0 -Percona Operators are designed for compatibility with all [CNCF :octicons-link-external-16:](https://www.cncf.io/) certified Kubernetes distributions. Our release process includes targeted testing and validation on major cloud provider platforms and OpenShift, as detailed below for Operator version 1.16.0: +Percona Operators are designed for compatibility with all [CNCF :octicons-link-external-16:](https://www.cncf.io/training/certification/software-conformance/) certified Kubernetes distributions. Our release process includes targeted testing and validation on major cloud provider platforms and OpenShift, as detailed below for Operator version 1.16.0: * [Google Kubernetes Engine (GKE) :octicons-link-external-16:](https://cloud.google.com/kubernetes-engine) 1.27 - 1.30 * [Amazon Elastic Container Service for Kubernetes (EKS) :octicons-link-external-16:](https://aws.amazon.com) 1.28 - 1.30 From 636b15eb52ef6e9b0247336a2dffed03d49a363b Mon Sep 17 00:00:00 2001 From: Dima Date: Sat, 14 Dec 2024 00:11:09 +0300 Subject: [PATCH 05/17] bump versions --- .../Kubernetes-Operator-for-PXC-RN1.16.0.md | 22 +++++++++---------- docs/System-Requirements.md | 12 +++++----- docs/versions.md | 2 ++ mkdocs-base.yml | 18 ++++++++------- 4 files changed, 29 insertions(+), 25 deletions(-) diff --git a/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md b/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md index b0285942..97bec2e8 100644 --- a/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md +++ b/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md @@ -65,20 +65,20 @@ See [documentation](../users.md#unprivileged-users) to find more details about t ## Supported Platforms -The Operator was developed and tested with Percona XtraDB Cluster versions 8.0.36-28.1 and 5.7.44-31.65. Other options may also work but have not been tested. Other software components include: +The Operator was developed and tested with Percona XtraDB Cluster versions 8.4.2-2.1 (Tech preview), 8.0.39-30.1, and 5.7.44-31.65. Other options may also work but have not been tested. Other software components include: -* Percona XtraBackup versions 8.0.35-30.1 and 2.4.29-1 -* HAProxy 2.8.5 -* ProxySQL 2.5.5 -* LogCollector based on fluent-bit 3.1.4 -* PMM Client 2.42.0 +* Percona XtraBackup versions 8.4.0-1, 8.0.35-30.1 and 2.4.29 +* HAProxy 2.8.11 +* ProxySQL 2.7.1 +* LogCollector based on fluent-bit 3.2.2 +* PMM Client 2.43.2 Percona Operators are designed for compatibility with all [CNCF :octicons-link-external-16:](https://www.cncf.io/training/certification/software-conformance/) certified Kubernetes distributions. Our release process includes targeted testing and validation on major cloud provider platforms and OpenShift, as detailed below for Operator version 1.16.0: -* [Google Kubernetes Engine (GKE) :octicons-link-external-16:](https://cloud.google.com/kubernetes-engine) 1.27 - 1.30 -* [Amazon Elastic Container Service for Kubernetes (EKS) :octicons-link-external-16:](https://aws.amazon.com) 1.28 - 1.30 -* [Azure Kubernetes Service (AKS) :octicons-link-external-16:](https://azure.microsoft.com/en-us/services/kubernetes-service/) 1.28 - 1.30 -* [OpenShift :octicons-link-external-16:](https://www.redhat.com/en/technologies/cloud-computing/openshift) 4.13.46 - 4.16.7 -* [Minikube :octicons-link-external-16:](https://minikube.sigs.k8s.io/docs/) 1.33.1 based on Kubernetes 1.30.0 +* [Google Kubernetes Engine (GKE) :octicons-link-external-16:](https://cloud.google.com/kubernetes-engine) 1.28 - 1.30 +* [Amazon Elastic Container Service for Kubernetes (EKS) :octicons-link-external-16:](https://aws.amazon.com) 1.28 - 1.31 +* [Azure Kubernetes Service (AKS) :octicons-link-external-16:](https://azure.microsoft.com/en-us/services/kubernetes-service/) 1.28 - 1.31 +* [OpenShift :octicons-link-external-16:](https://www.redhat.com/en/technologies/cloud-computing/openshift) 4.14.42 - 4.17.8 +* [Minikube :octicons-link-external-16:](https://minikube.sigs.k8s.io/docs/) 1.34.0 based on Kubernetes 1.31.0 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. diff --git a/docs/System-Requirements.md b/docs/System-Requirements.md index 0fed7b64..eb357b12 100644 --- a/docs/System-Requirements.md +++ b/docs/System-Requirements.md @@ -1,17 +1,17 @@ # System requirements -The Operator was developed and tested with Percona XtraDB Cluster versions 8.0.36-28.1 and 5.7.44-31.65. Other options may also work but have not been tested. +The Operator was developed and tested with Percona XtraDB Cluster versions 8.4.2-2.1 (Tech preview), 8.0.39-30.1, and 5.7.44-31.65 Other options may also work but have not been tested. ## Supported platforms The following platforms were tested and are officially supported by the Operator {{ release }}: -* [Google Kubernetes Engine (GKE) :octicons-link-external-16:](https://cloud.google.com/kubernetes-engine) 1.27 - 1.30 -* [Amazon Elastic Container Service for Kubernetes (EKS) :octicons-link-external-16:](https://aws.amazon.com) 1.28 - 1.30 -* [Azure Kubernetes Service (AKS) :octicons-link-external-16:](https://azure.microsoft.com/en-us/services/kubernetes-service/) 1.28 - 1.30 -* [OpenShift :octicons-link-external-16:](https://www.redhat.com/en/technologies/cloud-computing/openshift) 4.13.46 - 4.16.7 -* [Minikube :octicons-link-external-16:](https://minikube.sigs.k8s.io/docs/) 1.33.1 based on Kubernetes 1.30.0 +* [Google Kubernetes Engine (GKE) :octicons-link-external-16:](https://cloud.google.com/kubernetes-engine) 1.28 - 1.30 +* [Amazon Elastic Container Service for Kubernetes (EKS) :octicons-link-external-16:](https://aws.amazon.com) 1.28 - 1.31 +* [Azure Kubernetes Service (AKS) :octicons-link-external-16:](https://azure.microsoft.com/en-us/services/kubernetes-service/) 1.28 - 1.31 +* [OpenShift :octicons-link-external-16:](https://www.redhat.com/en/technologies/cloud-computing/openshift) 4.14.42 - 4.17.8 +* [Minikube :octicons-link-external-16:](https://minikube.sigs.k8s.io/docs/) 1.34.0 based on Kubernetes 1.31.0 Other Kubernetes platforms may also work but have not been tested. diff --git a/docs/versions.md b/docs/versions.md index d596de65..44ff26c9 100644 --- a/docs/versions.md +++ b/docs/versions.md @@ -6,6 +6,7 @@ Cluster components: | Operator | [MySQL :octicons-link-external-16:](https://www.percona.com/software/mysql-database/percona-server) | [Percona XtraBackup :octicons-link-external-16:](https://www.percona.com/software/mysql-database/percona-xtrabackup) | [HA Proxy :octicons-link-external-16:](https://www.haproxy.org/) | [ProxySQL :octicons-link-external-16:](https://proxysql.com/) | |:--------|:--------|:-----|:-------|:-------| +| [1.16.0](ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md) | 8.4 (Tech preview), 8.0, 5.7 | 8.4.0-1 for MySQL 8.4, 8.0.35-30.1 for MySQL 8.0, 2.4.29 for MySQL 5.7 | 2.8.11 | 2.7.1 | | [1.15.1](ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.15.1.md) | 8.0, 5.7 | 8.0.35-30.1 for MySQL 8.0, 2.4.29-1 for MySQL 5.7 | 2.8.5 | 2.5.5 | | [1.14.1](ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.14.1.md) | 8.0, 5.7 | 8.0.35-30.1 for MySQL 8.0, 2.4.29-1 for MySQL 5.7 | 2.8.5-1 | 2.5.5-1.1 | | [1.15.0](ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.15.0.md) | 8.0, 5.7 | 8.0.35-30.1 for MySQL 8.0, 2.4.29-1 for MySQL 5.7 | 2.8.5 | 2.5.5 | @@ -28,6 +29,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) | [AKS :octicons-link-external-16:](https://azure.microsoft.com/en-us/services/kubernetes-service/) | [Minikube :octicons-link-external-16:](https://github.com/kubernetes/minikube) | |:--------|:------------|:------------|:------------|:--------------|:--------------------| +| [1.16.0](ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md) | 1.28 - 1.30 | 1.28 - 1.31 | 4.15.42 - 4.17.8 | 1.28 - 1.31 | 1.34.0 | | [1.15.1](ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.15.1.md) | 1.27 - 1.30 | 1.28 - 1.30 | 4.13.46 - 4.16.7 | 1.28 - 1.30 | 1.33.1 | | [1.14.1](ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.14.1.md) | 1.25 - 1.29 | 1.24 - 1.29 | 4.12.50 - 4.14.13 | 1.26 - 1.28 | 1.32.0 | | [1.15.0](ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.15.0.md) | 1.27 - 1.30 | 1.28 - 1.30 | 4.13.46 - 4.16.7 | 1.28 - 1.30 | 1.33.1 | diff --git a/mkdocs-base.yml b/mkdocs-base.yml index 10e5140c..d3b7cec5 100644 --- a/mkdocs-base.yml +++ b/mkdocs-base.yml @@ -136,17 +136,19 @@ extra: # Used in main.html template and can't be externalized updated_text: ' Page updated' commandName: 'kubectl' clusterName: 'cluster1' - release: '1.15.1' - apiversion: '1-15-1' + release: '1.16.0' + apiversion: '1-16-0' certmanagerversion: '1.15.2' - fluentbitrecommended: '3.1.4' - haproxyrecommended: '2.8.5' - proxysqlrecommended: '2.5.5' - pxb80recommended: '8.0.35' + fluentbitrecommended: '3.2.2' + haproxyrecommended: '2.8.11' + proxysqlrecommended: '2.7.1' + pxb84recommended: '8.4.0-1' + pxb80recommended: '8.0.35-30.1' pxb57recommended: '2.4.29' pxc57recommended: '5.7.44-31.65' - pxc80recommended: '8.0.36-28.1' - pmm2recommended: '2.42.0' + pxc80recommended: '8.0.39-30.1' + pxc84recommended: '8.4.2-2.1' + pmm2recommended: '2.43.2' gkerecommended: '1.30' version: provider: mike From b164a156d7ea9560b2c690a3bc6b704e92ac0df9 Mon Sep 17 00:00:00 2001 From: Dima Date: Sat, 14 Dec 2024 00:12:57 +0300 Subject: [PATCH 06/17] update toc --- docs/ReleaseNotes/index.md | 2 +- mkdocs-base.yml | 1 + 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/ReleaseNotes/index.md b/docs/ReleaseNotes/index.md index 7896067e..8fac14ae 100644 --- a/docs/ReleaseNotes/index.md +++ b/docs/ReleaseNotes/index.md @@ -1,6 +1,6 @@ # Percona Operator for MySQL based on Percona XtraDB Cluster Release Notes -* [*Percona Operator for MySQL based on Percona XtraDB Cluster* 1.16.0 (2024-12-XX)](Kubernetes-Operator-for-PXC-RN1.16.0.md) +* [*Percona Operator for MySQL based on Percona XtraDB Cluster* 1.16.0 (2024-12-18)](Kubernetes-Operator-for-PXC-RN1.16.0.md) * [*Percona Operator for MySQL based on Percona XtraDB Cluster* 1.15.1 (2024-10-16)](Kubernetes-Operator-for-PXC-RN1.15.1.md) * [*Percona Operator for MySQL based on Percona XtraDB Cluster* 1.14.1 (2024-10-16)](Kubernetes-Operator-for-PXC-RN1.14.1.md) * [*Percona Operator for MySQL based on Percona XtraDB Cluster* 1.15.0 (2024-08-20)](Kubernetes-Operator-for-PXC-RN1.15.0.md) diff --git a/mkdocs-base.yml b/mkdocs-base.yml index d3b7cec5..a1e291b1 100644 --- a/mkdocs-base.yml +++ b/mkdocs-base.yml @@ -247,6 +247,7 @@ nav: - "Trademark policy": trademark-policy.md - Release Notes: - "Release notes index": ReleaseNotes/index.md + - "Percona Operator for MySQL based on Percona XtraDB Cluster 1.16.0 (2024-12-18)": ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md - "Percona Operator for MySQL based on Percona XtraDB Cluster 1.15.1 (2024-10-16)": ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.15.1.md - "Percona Operator for MySQL based on Percona XtraDB Cluster 1.14.1 (2024-10-16)": ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.14.1.md - "Percona Operator for MySQL based on Percona XtraDB Cluster 1.15.0 (2024-08-20)": ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.15.0.md From 879855db9efd7b0fc45af3f20f16ea2bddb3c18f Mon Sep 17 00:00:00 2001 From: Dima Date: Sat, 14 Dec 2024 01:22:27 +0300 Subject: [PATCH 07/17] polish titles --- .../Kubernetes-Operator-for-PXC-RN1.16.0.md | 23 +++++++++---------- 1 file changed, 11 insertions(+), 12 deletions(-) diff --git a/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md b/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md index 97bec2e8..69e7080e 100644 --- a/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md +++ b/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md @@ -2,7 +2,7 @@ * **Date** - December XX, 2024 + December 18, 2024 * **Installation** @@ -12,7 +12,7 @@ ### Declarative user management (technical preview) -Before the Operator version 1.16.0 custom MySQL users had to be created manually. Now the declarative creation of custom MongoDB users [is supported](../users.md#unprivileged-users) via the `users` subsection in the Custom Resource. You can specify a new user in `deploy/cr.yaml` manifest, setting the user’s login name and host, PasswordSecretRef (a reference to a key in a Secret resource containing user’s password) and as well as databases the user is going to have access to and the appropriate permissions: +Before the Operator version 1.16.0 custom MySQL users had to be created manually. Now the declarative creation of custom MongoDB users [is supported](../users.md#unprivileged-users) via the `users` subsection in the Custom Resource. You can specify a new user in `deploy/cr.yaml` manifest, setting the user’s login name and hosts this user is allowed to connect from, PasswordSecretRef (a reference to a key in a Secret resource containing user’s password) and as well as databases the user is going to have access to and the appropriate permissions: ```yaml ... @@ -38,22 +38,21 @@ See [documentation](../users.md#unprivileged-users) to find more details about t ## New Features -* {{ k8spxcjira(1421) }}: Provide documentation how to restore from xbstream file -* {{ k8spxcjira(1433) }}: Explain in which situations cluster-wide/multi-namespace installation should be used over single-namespace one -* {{ k8spxcjira(1456) }}: Custom initContainers with custom securityContext for PXC pods +* {{ k8spxcjira(377) }}: It is now possible to create and manage users via the Custom Resource +* {{ k8spxcjira(1456) }}: Now the user can run Percona XtraDB Cluster Pods initContainers [with a security context different](../operator.md#initcontainercontainersecuritycontext) from the Pods security context, which may be useful to make customization for tuned Kubernetes environments (Thanks to Vlad Gusev for contribution) ## Improvements -* {{ k8spxcjira(1411) }}: Allow enabling/disabling TLS in a running cluster -* {{ k8spxcjira(1451) }}: Disable PVC resize by default -* {{ k8spxcjira(1503) }}: Fix exec in pitr and proxysql pods +* {{ k8spxcjira(1411) }}: Enabling/disabling TLS on a running cluster [is now possible](../TLS.md#enabling-or-disabling-tls-on-a-running-cluster) simply by toggling the appropriate Custom Resource option +* {{ k8spxcjira(1451) }}: The [automated storage scaling](../scaling.md#automated-scaling-with-volume-expansion-capability) by default and need to be explicitly enabled with the `enableVolumeExpansion` Custom Resource option +* {{ k8spxcjira(1503) }}: Logic improvement saves logs from a number of temporary non-critical errors related to ProxySQL user sync and non-presence of point-in-time recovery files (Thanks to dcaputo-harmoni for contribution) ## Bugs Fixed -* {{ k8spxcjira(1398) }}: Scheduled PXC backup job pod fails to complete the process successfully in randomly/sporadically fashion -* {{ k8spxcjira(1413) }}: PXC operator pod segfaults when restoring a backup without backup source populated in cr.yaml -* {{ k8spxcjira(1416) }}: allowParallel:false leads to stuck backups if there is a failed backup -* {{ k8spxcjira(1420) }}: PITR restore hung with duplicate key error +* {{ k8spxcjira(1398) }}: Fix a bug which sporadically prevented the scheduled backup job Pod from successfully completing the process +* {{ k8spxcjira(1413) }}: Fix the Operator Pod segfault which was occurring when restoring a backup without backup source specified in the Custom Resource +* {{ k8spxcjira(1416) }}: Fix a bug where disabling parallel backups in Custom Resource caused all backups to stuck in presence of any failed backup +* {{ k8spxcjira(1420) }}: Fix a bug where HAProxy exposed at the time of point-in-time restore could make conflicting transactions, causing the PITR Pod stuck on the duplicate key error * {{ k8spxcjira(1422) }}: Cluster Endpoint Change when Uprgading * {{ k8spxcjira(1443) }}: Operator can't survive system users "Host" part change * {{ k8spxcjira(1444) }}: PXC cluster initial creation state changed to error if backup restore happens for too long From c150c0c2a17a5102f014da008b2b63a5b99b3e8d Mon Sep 17 00:00:00 2001 From: Dima Date: Sat, 14 Dec 2024 01:27:41 +0300 Subject: [PATCH 08/17] polish titles more --- docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md b/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md index 69e7080e..1867ee3c 100644 --- a/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md +++ b/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md @@ -53,9 +53,9 @@ See [documentation](../users.md#unprivileged-users) to find more details about t * {{ k8spxcjira(1413) }}: Fix the Operator Pod segfault which was occurring when restoring a backup without backup source specified in the Custom Resource * {{ k8spxcjira(1416) }}: Fix a bug where disabling parallel backups in Custom Resource caused all backups to stuck in presence of any failed backup * {{ k8spxcjira(1420) }}: Fix a bug where HAProxy exposed at the time of point-in-time restore could make conflicting transactions, causing the PITR Pod stuck on the duplicate key error -* {{ k8spxcjira(1422) }}: Cluster Endpoint Change when Uprgading -* {{ k8spxcjira(1443) }}: Operator can't survive system users "Host" part change -* {{ k8spxcjira(1444) }}: PXC cluster initial creation state changed to error if backup restore happens for too long +* {{ k8spxcjira(1422) }}: Fix the cluster endpoint change from the external IP to the service name when upgrading the Operator +* {{ k8spxcjira(1443) }}: Operator can't survive system users "Host" part change **Needs checking** +* {{ k8spxcjira(1444) }}: Fix a bug where Percona XtraDB Cluster initial creation state was changing to "error" if the backup restore was taking too long * {{ k8spxcjira(1396) }}: The `xtrabackup` user didn't have rights to grant privileges available in its own privilege level to other users, which caused the point-in-time recovery fail due to access denied * {{ k8spxcjira(1454) }}: Operator generate ssl secrets as soon as it was updates to v1.15.0 * {{ k8spxcjira(1458) }}: Fix panic when getting storage type From c3582ed1b154865f41f3db7704a1b1877ecce5a8 Mon Sep 17 00:00:00 2001 From: Dima Date: Sat, 14 Dec 2024 01:41:04 +0300 Subject: [PATCH 09/17] polish titles more --- docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md b/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md index 1867ee3c..fabf9508 100644 --- a/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md +++ b/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md @@ -50,16 +50,13 @@ See [documentation](../users.md#unprivileged-users) to find more details about t ## Bugs Fixed * {{ k8spxcjira(1398) }}: Fix a bug which sporadically prevented the scheduled backup job Pod from successfully completing the process -* {{ k8spxcjira(1413) }}: Fix the Operator Pod segfault which was occurring when restoring a backup without backup source specified in the Custom Resource +* {{ k8spxcjira(1413) }} and {{ k8spxcjira(1458) }}: Fix the Operator Pod segfault which was occurring when restoring a backup without backupSource Custom Resource subsection or without storage specified in the backupSource * {{ k8spxcjira(1416) }}: Fix a bug where disabling parallel backups in Custom Resource caused all backups to stuck in presence of any failed backup * {{ k8spxcjira(1420) }}: Fix a bug where HAProxy exposed at the time of point-in-time restore could make conflicting transactions, causing the PITR Pod stuck on the duplicate key error * {{ k8spxcjira(1422) }}: Fix the cluster endpoint change from the external IP to the service name when upgrading the Operator * {{ k8spxcjira(1443) }}: Operator can't survive system users "Host" part change **Needs checking** * {{ k8spxcjira(1444) }}: Fix a bug where Percona XtraDB Cluster initial creation state was changing to "error" if the backup restore was taking too long -* {{ k8spxcjira(1396) }}: The `xtrabackup` user didn't have rights to grant privileges available in its own privilege level to other users, which caused the point-in-time recovery fail due to access denied -* {{ k8spxcjira(1454) }}: Operator generate ssl secrets as soon as it was updates to v1.15.0 -* {{ k8spxcjira(1458) }}: Fix panic when getting storage type -* {{ k8spxcjira(1464) }}: haproxy can't start after kubelet/worker node restart +* {{ k8spxcjira(1454) }}: Fix a bug where the Operator erroneously generated SSL secrets when upgrading from 1.14.0 to 1.15.0 with `allowUnsafeConfigurations: true`Custom Resource option * {{ k8spxcjira(1500) }}: Backup job doesn't fail and garbd doesn't stop after xbcloud upload failure ## Supported Platforms From 7dd49f5f29c0aba1aad1ec4efb2137e566d60ccc Mon Sep 17 00:00:00 2001 From: Dima Date: Sat, 14 Dec 2024 01:43:56 +0300 Subject: [PATCH 10/17] polish titles more --- docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md b/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md index fabf9508..706c0b24 100644 --- a/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md +++ b/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md @@ -46,6 +46,7 @@ See [documentation](../users.md#unprivileged-users) to find more details about t * {{ k8spxcjira(1411) }}: Enabling/disabling TLS on a running cluster [is now possible](../TLS.md#enabling-or-disabling-tls-on-a-running-cluster) simply by toggling the appropriate Custom Resource option * {{ k8spxcjira(1451) }}: The [automated storage scaling](../scaling.md#automated-scaling-with-volume-expansion-capability) by default and need to be explicitly enabled with the `enableVolumeExpansion` Custom Resource option * {{ k8spxcjira(1503) }}: Logic improvement saves logs from a number of temporary non-critical errors related to ProxySQL user sync and non-presence of point-in-time recovery files (Thanks to dcaputo-harmoni for contribution) +* {{ k8spxcjira(1500) }}: A new `backup.activeDeadlineSeconds` Custom Resource option was added to fail the backup job after the specified timeout (Thanks to Vlad Gusev for contribution) ## Bugs Fixed @@ -57,7 +58,6 @@ See [documentation](../users.md#unprivileged-users) to find more details about t * {{ k8spxcjira(1443) }}: Operator can't survive system users "Host" part change **Needs checking** * {{ k8spxcjira(1444) }}: Fix a bug where Percona XtraDB Cluster initial creation state was changing to "error" if the backup restore was taking too long * {{ k8spxcjira(1454) }}: Fix a bug where the Operator erroneously generated SSL secrets when upgrading from 1.14.0 to 1.15.0 with `allowUnsafeConfigurations: true`Custom Resource option -* {{ k8spxcjira(1500) }}: Backup job doesn't fail and garbd doesn't stop after xbcloud upload failure ## Supported Platforms From 5b5bea807cd560a0456a20c66f76a7e34ff05b6d Mon Sep 17 00:00:00 2001 From: Dima Date: Sat, 14 Dec 2024 01:49:46 +0300 Subject: [PATCH 11/17] Finalize the RN draft --- docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md b/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md index 706c0b24..6d6c09f3 100644 --- a/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md +++ b/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md @@ -46,7 +46,7 @@ See [documentation](../users.md#unprivileged-users) to find more details about t * {{ k8spxcjira(1411) }}: Enabling/disabling TLS on a running cluster [is now possible](../TLS.md#enabling-or-disabling-tls-on-a-running-cluster) simply by toggling the appropriate Custom Resource option * {{ k8spxcjira(1451) }}: The [automated storage scaling](../scaling.md#automated-scaling-with-volume-expansion-capability) by default and need to be explicitly enabled with the `enableVolumeExpansion` Custom Resource option * {{ k8spxcjira(1503) }}: Logic improvement saves logs from a number of temporary non-critical errors related to ProxySQL user sync and non-presence of point-in-time recovery files (Thanks to dcaputo-harmoni for contribution) -* {{ k8spxcjira(1500) }}: A new `backup.activeDeadlineSeconds` Custom Resource option was added to fail the backup job after the specified timeout (Thanks to Vlad Gusev for contribution) +* {{ k8spxcjira(1500) }}: A new `backup.activeDeadlineSeconds` Custom Resource option was added to fail the backup job automatically after the specified timeout (Thanks to Vlad Gusev for contribution) ## Bugs Fixed @@ -69,7 +69,7 @@ The Operator was developed and tested with Percona XtraDB Cluster versions 8.4.2 * LogCollector based on fluent-bit 3.2.2 * PMM Client 2.43.2 -Percona Operators are designed for compatibility with all [CNCF :octicons-link-external-16:](https://www.cncf.io/training/certification/software-conformance/) certified Kubernetes distributions. Our release process includes targeted testing and validation on major cloud provider platforms and OpenShift, as detailed below for Operator version 1.16.0: +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 1.16.0: * [Google Kubernetes Engine (GKE) :octicons-link-external-16:](https://cloud.google.com/kubernetes-engine) 1.28 - 1.30 * [Amazon Elastic Container Service for Kubernetes (EKS) :octicons-link-external-16:](https://aws.amazon.com) 1.28 - 1.31 From 3ba1bc615878dfa93c483a159944e03984e07cec Mon Sep 17 00:00:00 2001 From: Dmitriy Kostiuk Date: Sun, 15 Dec 2024 10:12:35 +0300 Subject: [PATCH 12/17] adress proposed fixes --- docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md b/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md index 6d6c09f3..0672bbca 100644 --- a/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md +++ b/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md @@ -12,7 +12,7 @@ ### Declarative user management (technical preview) -Before the Operator version 1.16.0 custom MySQL users had to be created manually. Now the declarative creation of custom MongoDB users [is supported](../users.md#unprivileged-users) via the `users` subsection in the Custom Resource. You can specify a new user in `deploy/cr.yaml` manifest, setting the user’s login name and hosts this user is allowed to connect from, PasswordSecretRef (a reference to a key in a Secret resource containing user’s password) and as well as databases the user is going to have access to and the appropriate permissions: +Before the Operator version 1.16.0 custom MySQL users had to be created manually. Now the declarative creation of custom MySQL users [is supported](../users.md#unprivileged-users) via the `users` subsection in the Custom Resource. You can specify a new user in `deploy/cr.yaml` manifest, setting the user’s login name and hosts this user is allowed to connect from, PasswordSecretRef (a reference to a key in a Secret resource containing user’s password) and as well as databases the user is going to have access to and the appropriate permissions: ```yaml ... @@ -39,7 +39,7 @@ See [documentation](../users.md#unprivileged-users) to find more details about t ## New Features * {{ k8spxcjira(377) }}: It is now possible to create and manage users via the Custom Resource -* {{ k8spxcjira(1456) }}: Now the user can run Percona XtraDB Cluster Pods initContainers [with a security context different](../operator.md#initcontainercontainersecuritycontext) from the Pods security context, which may be useful to make customization for tuned Kubernetes environments (Thanks to Vlad Gusev for contribution) +* {{ k8spxcjira(1456) }}: Now the user can run Percona XtraDB Cluster Pods initContainers [with a security context different](../operator.md#initcontainercontainersecuritycontext) from the Pods security context, useful to customize deployment on tuned Kubernetes environments (Thanks to Vlad Gusev for contribution) ## Improvements From 9df27f8f9297f2fa59e3b32120d263e1be597dfe Mon Sep 17 00:00:00 2001 From: Dmitriy Kostiuk Date: Tue, 17 Dec 2024 20:14:20 +0300 Subject: [PATCH 13/17] Adress comments --- docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md b/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md index 0672bbca..f2e8c237 100644 --- a/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md +++ b/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md @@ -44,18 +44,17 @@ See [documentation](../users.md#unprivileged-users) to find more details about t ## Improvements * {{ k8spxcjira(1411) }}: Enabling/disabling TLS on a running cluster [is now possible](../TLS.md#enabling-or-disabling-tls-on-a-running-cluster) simply by toggling the appropriate Custom Resource option -* {{ k8spxcjira(1451) }}: The [automated storage scaling](../scaling.md#automated-scaling-with-volume-expansion-capability) by default and need to be explicitly enabled with the `enableVolumeExpansion` Custom Resource option -* {{ k8spxcjira(1503) }}: Logic improvement saves logs from a number of temporary non-critical errors related to ProxySQL user sync and non-presence of point-in-time recovery files (Thanks to dcaputo-harmoni for contribution) +* {{ k8spxcjira(1451) }}: The [automated storage scaling](../scaling.md#automated-scaling-with-volume-expansion-capability) is now disabled by default and needs to be explicitly enabled with the `enableVolumeExpansion` Custom Resource option +* {{ k8spxcjira(1503) }}: Improved logic saves logs from the appearance of a number of temporary non-critical errors related to ProxySQL user sync and non-presence of point-in-time recovery files (Thanks to dcaputo-harmoni for contribution) * {{ k8spxcjira(1500) }}: A new `backup.activeDeadlineSeconds` Custom Resource option was added to fail the backup job automatically after the specified timeout (Thanks to Vlad Gusev for contribution) ## Bugs Fixed * {{ k8spxcjira(1398) }}: Fix a bug which sporadically prevented the scheduled backup job Pod from successfully completing the process * {{ k8spxcjira(1413) }} and {{ k8spxcjira(1458) }}: Fix the Operator Pod segfault which was occurring when restoring a backup without backupSource Custom Resource subsection or without storage specified in the backupSource -* {{ k8spxcjira(1416) }}: Fix a bug where disabling parallel backups in Custom Resource caused all backups to stuck in presence of any failed backup +* {{ k8spxcjira(1416) }}: Fix a bug where disabling parallel backups in Custom Resource caused all backups to get stuck in presence of any failed backup * {{ k8spxcjira(1420) }}: Fix a bug where HAProxy exposed at the time of point-in-time restore could make conflicting transactions, causing the PITR Pod stuck on the duplicate key error * {{ k8spxcjira(1422) }}: Fix the cluster endpoint change from the external IP to the service name when upgrading the Operator -* {{ k8spxcjira(1443) }}: Operator can't survive system users "Host" part change **Needs checking** * {{ k8spxcjira(1444) }}: Fix a bug where Percona XtraDB Cluster initial creation state was changing to "error" if the backup restore was taking too long * {{ k8spxcjira(1454) }}: Fix a bug where the Operator erroneously generated SSL secrets when upgrading from 1.14.0 to 1.15.0 with `allowUnsafeConfigurations: true`Custom Resource option From 501b41d26c305d874969b105ebdcb48cd57670d5 Mon Sep 17 00:00:00 2001 From: Dima Date: Wed, 18 Dec 2024 23:03:04 +0300 Subject: [PATCH 14/17] Update RN and date --- .../Kubernetes-Operator-for-PXC-RN1.16.0.md | 17 +++++++++++++++-- docs/ReleaseNotes/index.md | 2 +- mkdocs-base.yml | 8 ++++---- 3 files changed, 20 insertions(+), 7 deletions(-) diff --git a/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md b/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md index f2e8c237..f876b648 100644 --- a/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md +++ b/docs/ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md @@ -2,7 +2,7 @@ * **Date** - December 18, 2024 + December 19, 2024 * **Installation** @@ -36,6 +36,11 @@ users: See [documentation](../users.md#unprivileged-users) to find more details about this feature with additional explanations and the list of current limitations. +### Percona XtraDB Cluster 8.4 support (technical preview) + +Percona XtraDB Cluster based on Percona Server for MySQL 8.4 versions is now supported by the Operator in addition to 8.0 and 5.7 versions. The appropriate images for Percona XtraDB Cluster and Percona XtraBackup are included into the [list of Percona-certified images](../images.md). +Being a technical preview, Percona XtraDB Cluster 8.4 is not yet recommended for production environments. + ## New Features * {{ k8spxcjira(377) }}: It is now possible to create and manage users via the Custom Resource @@ -43,10 +48,13 @@ See [documentation](../users.md#unprivileged-users) to find more details about t ## Improvements +* {{ k8spxcjira(1230) }} and {{ k8spxcjira(1378) }}: Now the Operator assigns labels to all Kubernetes objects it creates (backups/restores, Secrets, Volumes, etc.) to make them clearly distinguishable * {{ k8spxcjira(1411) }}: Enabling/disabling TLS on a running cluster [is now possible](../TLS.md#enabling-or-disabling-tls-on-a-running-cluster) simply by toggling the appropriate Custom Resource option * {{ k8spxcjira(1451) }}: The [automated storage scaling](../scaling.md#automated-scaling-with-volume-expansion-capability) is now disabled by default and needs to be explicitly enabled with the `enableVolumeExpansion` Custom Resource option +* {{ k8spxcjira(1462) }}: A restart of Percona XtraDB Cluster Pods is now triggered by the monitor user’s password change if the user secret is used within a sidecar container, which can be useful for custom monitoring solutions (Thanks to Vlad Gusev for contribution) * {{ k8spxcjira(1503) }}: Improved logic saves logs from the appearance of a number of temporary non-critical errors related to ProxySQL user sync and non-presence of point-in-time recovery files (Thanks to dcaputo-harmoni for contribution) * {{ k8spxcjira(1500) }}: A new `backup.activeDeadlineSeconds` Custom Resource option was added to fail the backup job automatically after the specified timeout (Thanks to Vlad Gusev for contribution) +* {{ k8spxcjira(1532) }}: The peer-list tool used by the Operator was removed from standard HAProxy, ProxySQL and PXC Docker images because recent Operator versions are adding it with the initContainer approach ## Bugs Fixed @@ -58,6 +66,11 @@ See [documentation](../users.md#unprivileged-users) to find more details about t * {{ k8spxcjira(1444) }}: Fix a bug where Percona XtraDB Cluster initial creation state was changing to "error" if the backup restore was taking too long * {{ k8spxcjira(1454) }}: Fix a bug where the Operator erroneously generated SSL secrets when upgrading from 1.14.0 to 1.15.0 with `allowUnsafeConfigurations: true`Custom Resource option +## Deprecation, Rename and Removal + +Operator versions older than 1.14.1 become incompatible with new HAProxy, ProxySQL and PXC Docker images due to the absence of the peer-list tool in them. If you are still using the older Operator version, make sure to update the Operator before switching to the latest database and proxy images. You can see the [list of Percona certified images](../images.md) for the current release, and check image versions certified for previous releases in the [documentation archive :octicons-link-external-16:](https://docs.percona.com/legacy-documentation/). + + ## Supported Platforms The Operator was developed and tested with Percona XtraDB Cluster versions 8.4.2-2.1 (Tech preview), 8.0.39-30.1, and 5.7.44-31.65. Other options may also work but have not been tested. Other software components include: @@ -66,7 +79,7 @@ The Operator was developed and tested with Percona XtraDB Cluster versions 8.4.2 * HAProxy 2.8.11 * ProxySQL 2.7.1 * LogCollector based on fluent-bit 3.2.2 -* PMM Client 2.43.2 +* PMM Client 2.44.0 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 1.16.0: diff --git a/docs/ReleaseNotes/index.md b/docs/ReleaseNotes/index.md index 8fac14ae..de6a17b9 100644 --- a/docs/ReleaseNotes/index.md +++ b/docs/ReleaseNotes/index.md @@ -1,6 +1,6 @@ # Percona Operator for MySQL based on Percona XtraDB Cluster Release Notes -* [*Percona Operator for MySQL based on Percona XtraDB Cluster* 1.16.0 (2024-12-18)](Kubernetes-Operator-for-PXC-RN1.16.0.md) +* [*Percona Operator for MySQL based on Percona XtraDB Cluster* 1.16.0 (2024-12-19)](Kubernetes-Operator-for-PXC-RN1.16.0.md) * [*Percona Operator for MySQL based on Percona XtraDB Cluster* 1.15.1 (2024-10-16)](Kubernetes-Operator-for-PXC-RN1.15.1.md) * [*Percona Operator for MySQL based on Percona XtraDB Cluster* 1.14.1 (2024-10-16)](Kubernetes-Operator-for-PXC-RN1.14.1.md) * [*Percona Operator for MySQL based on Percona XtraDB Cluster* 1.15.0 (2024-08-20)](Kubernetes-Operator-for-PXC-RN1.15.0.md) diff --git a/mkdocs-base.yml b/mkdocs-base.yml index a1e291b1..6083ff91 100644 --- a/mkdocs-base.yml +++ b/mkdocs-base.yml @@ -117,7 +117,7 @@ plugins: with-pdf: output_path: "_pdf/percona-operator-for-mysql-pxc.pdf" cover_title: "Operator for MySQL based on Percona XtraDB Cluster documentation" - cover_subtitle: 1.15.1 (October 16, 2024) + cover_subtitle: 1.16.0 (December 19, 2024) author: "Percona Technical Documentation Team" cover_logo: docs/assets/images/PerconaLogostackedlightbackground.svg custom_template_path: _resource/templates @@ -138,7 +138,7 @@ extra: # Used in main.html template and can't be externalized clusterName: 'cluster1' release: '1.16.0' apiversion: '1-16-0' - certmanagerversion: '1.15.2' + certmanagerversion: '1.16.2' fluentbitrecommended: '3.2.2' haproxyrecommended: '2.8.11' proxysqlrecommended: '2.7.1' @@ -148,7 +148,7 @@ extra: # Used in main.html template and can't be externalized pxc57recommended: '5.7.44-31.65' pxc80recommended: '8.0.39-30.1' pxc84recommended: '8.4.2-2.1' - pmm2recommended: '2.43.2' + pmm2recommended: '2.44.0' gkerecommended: '1.30' version: provider: mike @@ -247,7 +247,7 @@ nav: - "Trademark policy": trademark-policy.md - Release Notes: - "Release notes index": ReleaseNotes/index.md - - "Percona Operator for MySQL based on Percona XtraDB Cluster 1.16.0 (2024-12-18)": ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md + - "Percona Operator for MySQL based on Percona XtraDB Cluster 1.16.0 (2024-12-19)": ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.16.0.md - "Percona Operator for MySQL based on Percona XtraDB Cluster 1.15.1 (2024-10-16)": ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.15.1.md - "Percona Operator for MySQL based on Percona XtraDB Cluster 1.14.1 (2024-10-16)": ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.14.1.md - "Percona Operator for MySQL based on Percona XtraDB Cluster 1.15.0 (2024-08-20)": ReleaseNotes/Kubernetes-Operator-for-PXC-RN1.15.0.md From abc76f6f9767e230a7088f1ffeda6a2c5ea2d8a2 Mon Sep 17 00:00:00 2001 From: Dima Date: Wed, 18 Dec 2024 23:15:26 +0300 Subject: [PATCH 15/17] update images and hashes --- docs/images.md | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/docs/images.md b/docs/images.md index c0d4aa30..cfa99399 100644 --- a/docs/images.md +++ b/docs/images.md @@ -6,19 +6,19 @@ Percona Operator for MySQL based on Percona XtraDB Cluster. | Image | Digest | |:-----------------------------------------------------------------------|:-----------------------------------------------------------------| | **Images released with the Operator version {{ release }}:** | | -| percona/percona-xtradb-cluster-operator:1.15.0 (x86_64) | 16a0078b5ededc4ae346168ee005aedf17f9ddddebf1eca067244d2f907bb7fa | -| percona/percona-xtradb-cluster-operator:1.15.0 (ARM64) | 862c0be9f278aed33c521dabb55986b33da5eddb52cc99e205c7bb8feac9b22f | -| percona/haproxy:2.8.5 | 941f3bd0977bff9145e904bf8f8298a1a024d7f03152edaea0cf65fd1c137340 | -| percona/proxysql2:2.5.5 | d95b0c6782447fef22adea3e8b8143e79a6a757666ffd34a8c3eddd9f82d629c | -| percona/percona-xtradb-cluster-operator:1.15.1-pxc8.0-backup-pxb8.0.35 | 6395019766db6118f61b8085c720d1d574c73511f84c9db5d222460f790649fb | -| percona/percona-xtradb-cluster-operator:1.15.1-pxc5.7-backup-pxb2.4.29 | dfe6545b83b18450a3243441e6b43c3a6ed05dcc24a464286ffb9a7328fdb13f | -| percona/percona-xtradb-cluster-operator:1.15.1-logcollector-fluentbit3.1.4 | 24b068d55559cbe5dbadc2f52e5c096f7df60374e47c6b4d1a5e331fd2a75014 | -| percona/pmm-client:2.42.0 | 14cb96de47e3bc239bf285f22ec6f170b4a1181301b19100f5b7dc22c210bf8c | +| percona/percona-xtradb-cluster-operator:1.16.0 (x86_64) | a8eeb17b0d5c36f1e67cf5e117c9b03d5d7884bd5db9a47960b8e4ee92b07fb4 | +| percona/percona-xtradb-cluster-operator:1.16.0 (ARM64) | 9ef03da5c52dd6f6d0c3e369f7c51a1873e8ea1554caea21d3c830f4dbb43a54 | +| percona/haproxy:2.8.11 | 422a210b4170a973f8582ef3d7ddcc879c32bc48f6c66fad8b3154bce4e79b84 | +| percona/proxysql2:2.7.1 | b1c5cd48b218d19386724fa823d20a8454b2de87f4ab445903e8daeb3b6b015b | +| percona/percona-xtradb-cluster-operator:1.16.0-pxc8.0-backup-pxb8.0.35 | 55281c818a78162cac0c87257915d74f321a4663f3f60457da2566c64610bf49 | +| percona/percona-xtradb-cluster-operator:1.16.0-pxc5.7-backup-pxb2.4.29 | ddcec747748dccfbf4d7a6ba9c6a34f09cb7814ab59c49e73dff239949012039 | +| percona/percona-xtradb-cluster-operator:1.16.0-logcollector-fluentbit3.2.2 | 122a103902d27890dceaf1855f175ea706a126aac940feb1089520029937f4a9 | +| percona/pmm-client:2.44.0 | 0737f73449263a14d7000fbe7cd88dfd589dfed975cbb16bd29eee06a5dbd49e | +| percona/percona-xtradb-cluster:8.0.39-30.1 | 6a53a6ad4e7d2c2fb404d274d993414a22cb67beecf7228df9d5d994e7a09966 | | percona/percona-xtradb-cluster:8.0.36-28.1 | b5cc4034ccfb0186d6a734cb749ae17f013b027e9e64746b2c876e8beef379b3 | | percona/percona-xtradb-cluster:8.0.35-27.1 | 1ef24953591ef1c1ce39576843d5615d4060fd09458c7a39ebc3e2eda7ef486b | | percona/percona-xtradb-cluster:8.0.32-24.2 | 1f978ab8912e1b5fc66570529cb7e7a4ec6a38adbfce1ece78159b0fcfa7d47a | | percona/percona-xtradb-cluster:8.0.31-23.2 | ed1ceea0b594ae34a92c891b4e42bc543d24999c82e47382cf53e33be4ae1d71 | -| percona/percona-xtradb-cluster:8.0.29-21.1 | 96c6bb8189280aeb773e74ed46aa41c01781b62947ed70c89efeb9f41c367ee7 | | percona/percona-xtradb-cluster:5.7.44-31.65 | 36fafdef46485839d4ff7c6dc73b4542b07031644c0152e911acb9734ff2be85 | | percona/percona-xtradb-cluster:5.7.42-31.65 | 9dab86780f86ec9caf8e1032a563c131904b75a37edeaec159a93f7d0c16c603 | | percona/percona-xtradb-cluster:5.7.39-31.61 | 9013170a71559bbac92ba9c2e986db9bda3a8a9e39ee1ee350e0ee94488bb6d7 | @@ -32,7 +32,7 @@ this component ("pxb8.0.35"): `operator_version-[pxc_version]-[component_name]-[component_version]` -An example looks as follows: `1.15.0-pxc8.0-backup-pxb8.0.35` +An example looks as follows: `1.16.0-pxc8.0-backup-pxb8.0.35` Percona XtraDB Cluster versions may have different detalization ("pxc" prefix with major and minor numbers, like "pxc8.0", or @@ -43,3 +43,4 @@ on, like "8.0.36-28.1"). Note, that PMM Client images have their own tags, just containing the version of PMM. + From e3af2ee9e00da1a0cf48d7b02f9a9edf82755cc1 Mon Sep 17 00:00:00 2001 From: Dima Date: Wed, 18 Dec 2024 23:22:26 +0300 Subject: [PATCH 16/17] K8SPXC-1410 Add PXC and PXB images for 8.4 --- docs/images.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/images.md b/docs/images.md index cfa99399..341431aa 100644 --- a/docs/images.md +++ b/docs/images.md @@ -10,10 +10,12 @@ Percona Operator for MySQL based on Percona XtraDB Cluster. | percona/percona-xtradb-cluster-operator:1.16.0 (ARM64) | 9ef03da5c52dd6f6d0c3e369f7c51a1873e8ea1554caea21d3c830f4dbb43a54 | | percona/haproxy:2.8.11 | 422a210b4170a973f8582ef3d7ddcc879c32bc48f6c66fad8b3154bce4e79b84 | | percona/proxysql2:2.7.1 | b1c5cd48b218d19386724fa823d20a8454b2de87f4ab445903e8daeb3b6b015b | +| percona/percona-xtradb-cluster-operator:1.16.0-pxc8.4-backup-pxb8.4.0 | 500f20baa21a7df71a517c9434d1907e4cb482fdd58784975f97976a0bce699d | | percona/percona-xtradb-cluster-operator:1.16.0-pxc8.0-backup-pxb8.0.35 | 55281c818a78162cac0c87257915d74f321a4663f3f60457da2566c64610bf49 | | percona/percona-xtradb-cluster-operator:1.16.0-pxc5.7-backup-pxb2.4.29 | ddcec747748dccfbf4d7a6ba9c6a34f09cb7814ab59c49e73dff239949012039 | | percona/percona-xtradb-cluster-operator:1.16.0-logcollector-fluentbit3.2.2 | 122a103902d27890dceaf1855f175ea706a126aac940feb1089520029937f4a9 | | percona/pmm-client:2.44.0 | 0737f73449263a14d7000fbe7cd88dfd589dfed975cbb16bd29eee06a5dbd49e | +| percona/percona-xtradb-cluster:8.4.2-2.1 | ee8be9e7e2ecc1fdfebb29141f5f15abcd15490213f6bdbe0a53a1e6cc942fa8 | | percona/percona-xtradb-cluster:8.0.39-30.1 | 6a53a6ad4e7d2c2fb404d274d993414a22cb67beecf7228df9d5d994e7a09966 | | percona/percona-xtradb-cluster:8.0.36-28.1 | b5cc4034ccfb0186d6a734cb749ae17f013b027e9e64746b2c876e8beef379b3 | | percona/percona-xtradb-cluster:8.0.35-27.1 | 1ef24953591ef1c1ce39576843d5615d4060fd09458c7a39ebc3e2eda7ef486b | From be36a9b848de625efab5f6a338a9588482213cb6 Mon Sep 17 00:00:00 2001 From: Dima Date: Thu, 19 Dec 2024 18:56:36 +0300 Subject: [PATCH 17/17] Update operator hashes --- docs/images.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/images.md b/docs/images.md index 341431aa..9f8b64cd 100644 --- a/docs/images.md +++ b/docs/images.md @@ -6,8 +6,8 @@ Percona Operator for MySQL based on Percona XtraDB Cluster. | Image | Digest | |:-----------------------------------------------------------------------|:-----------------------------------------------------------------| | **Images released with the Operator version {{ release }}:** | | -| percona/percona-xtradb-cluster-operator:1.16.0 (x86_64) | a8eeb17b0d5c36f1e67cf5e117c9b03d5d7884bd5db9a47960b8e4ee92b07fb4 | -| percona/percona-xtradb-cluster-operator:1.16.0 (ARM64) | 9ef03da5c52dd6f6d0c3e369f7c51a1873e8ea1554caea21d3c830f4dbb43a54 | +| percona/percona-xtradb-cluster-operator:1.16.0 (x86_64) | ddab83ee4610df03636bbbfb159379b96ef36593681879997d74ebe0d08e0ef9 | +| percona/percona-xtradb-cluster-operator:1.16.0 (ARM64) | c0a75755218c19834e586643f75f61efd4964199147fa969d01fd3d881d03fbe | | percona/haproxy:2.8.11 | 422a210b4170a973f8582ef3d7ddcc879c32bc48f6c66fad8b3154bce4e79b84 | | percona/proxysql2:2.7.1 | b1c5cd48b218d19386724fa823d20a8454b2de87f4ab445903e8daeb3b6b015b | | percona/percona-xtradb-cluster-operator:1.16.0-pxc8.4-backup-pxb8.4.0 | 500f20baa21a7df71a517c9434d1907e4cb482fdd58784975f97976a0bce699d |