From 955f24da083f367c6ac072f0803daff184fbb3c5 Mon Sep 17 00:00:00 2001 From: Jinpei Su Date: Thu, 30 Apr 2026 03:21:30 +0000 Subject: [PATCH 1/4] Bump mysql-pxc and mysql-mgr docs versions to 4.3 The mysql-pxc and mysql-mgr sub-site entries were still pointing at version "4.0" on release-4.3, so the embedded content rendered on the ACP v4.3 docs site missed the PXC-removal announcement (mgr-docs v4.3.0+ and pxc-docs deprecation banners) and the v4.3.2 MGR release notes. Updates land alongside: - alauda/mgr-docs release-4.3 (v4.3.2 release notes, lifecycle policy, CRDs, migration-guide fixes) - alauda/pxc-docs release-4.3 (just cut from master with PXC deprecation banners linking to mgr-docs migration guide) Co-Authored-By: Claude Opus 4.7 --- sites.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/sites.yaml b/sites.yaml index a18a7e042..3b0d7e881 100644 --- a/sites.yaml +++ b/sites.yaml @@ -59,14 +59,14 @@ en: Alauda Database Service for MySQL-PXC zh: Alauda Database Service for MySQL-PXC base: /mysql-pxc - version: "4.0" + version: "4.3" repo: https://github.com/alauda/pxc-docs - name: mysql-mgr displayName: en: Alauda Database Service for MySQL-MGR zh: Alauda Database Service for MySQL-MGR base: /mysql-mgr - version: "4.0" + version: "4.3" repo: https://github.com/alauda/mgr-docs - name: redis displayName: From 0ef56af6d211a205090c5d6dbb4f9f30f447f4ec Mon Sep 17 00:00:00 2001 From: Jinpei Su Date: Thu, 30 Apr 2026 03:33:22 +0000 Subject: [PATCH 2/4] Bump postgresql docs version to 4.3 The postgresql sub-site entry was still pinned to version "4.0" on release-4.3, so the embedded content rendered on the ACP v4.3 docs site missed the v4.3.0 PostgreSQL release notes and lifecycle policy. pg-docs release-4.3 has been available since dd0197d. Co-Authored-By: Claude Opus 4.7 --- sites.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sites.yaml b/sites.yaml index 3b0d7e881..9e125228e 100644 --- a/sites.yaml +++ b/sites.yaml @@ -101,7 +101,7 @@ en: Alauda support for PostgreSQL zh: Alauda support for PostgreSQL base: /postgresql - version: "4.0" + version: "4.3" repo: https://github.com/alauda/pg-docs - name: costmanagement displayName: From 7adf78c0ba6e674f8ee684be04f7416941f69dad Mon Sep 17 00:00:00 2001 From: Jinpei Su Date: Tue, 24 Mar 2026 23:22:57 -0700 Subject: [PATCH 3/4] docs: fix ExternalSiteLink usage and PXC deprecation notices - Replace ExternalSiteLink name references with correct site names - Fix :::warning container format (title on separate line) - Add deprecation banner to pxc.mdx with migration link to mgr-docs - Update upgrade docs to link to MySQL-MGR migration guide Co-Authored-By: Claude Opus 4.6 --- docs/en/appservice/mysql/pxc.mdx | 4 ++++ docs/en/appservice/upgrade.mdx | 12 ++++++++++-- docs/en/upgrade/pre-upgrade.mdx | 4 ++++ docs/en/upgrade/upgrade_global_cluster.mdx | 4 ++++ docs/en/upgrade/upgrade_workload_cluster.mdx | 4 ++++ 5 files changed, 26 insertions(+), 2 deletions(-) diff --git a/docs/en/appservice/mysql/pxc.mdx b/docs/en/appservice/mysql/pxc.mdx index d95241eb1..1189434a7 100644 --- a/docs/en/appservice/mysql/pxc.mdx +++ b/docs/en/appservice/mysql/pxc.mdx @@ -6,6 +6,10 @@ i18n: title: About Alauda Database Service for MySQL-PXC --- +:::warning Deprecation Notice +MySQL-PXC is deprecated and no longer managed by the MySQL operator. Existing PXC clusters will continue to run but will not receive operator updates. Please migrate to [MySQL-MGR](./mgr.mdx) for continued support and new deployments. See for detailed migration instructions. +::: + Alauda Database Service for MySQL-PXC is a high availability database solution using synchronous replication based on Percona XtraDB Cluster, running on Kubernetes. It provides the capability for automated deployment and management of objects within the Percona XtraDB Cluster, and can also be used to start new Percona XtraDB Cluster instances or scale existing instance. diff --git a/docs/en/appservice/upgrade.mdx b/docs/en/appservice/upgrade.mdx index 04398de81..05a12b674 100644 --- a/docs/en/appservice/upgrade.mdx +++ b/docs/en/appservice/upgrade.mdx @@ -5,6 +5,15 @@ en: Upgrade # Upgrade +:::warning +PXC Removal in Alauda Database Service for MySQL v4.3.0 + +**MySQL-PXC is deprecated** and **removed** starting from Alauda Database Service for MySQL v4.3.0. Existing PXC instances will continue running but are no longer managed by the MySQL operator. If you have PXC instances, you **must migrate them to MySQL-MGR before upgrading** to MySQL Operator v4.3.0 or later. + +- **Migration Guide**: See for comprehensive step-by-step instructions covering schema compatibility, character sets, users, and privileges. +- **MySQL Operator Upgrade Guide**: See for pre-upgrade checklists, upgrade scenarios, and emergency response procedures. +::: + Alauda Container Platform Data Services Essentials requires a manual upgrade. After upgrading the platform, follow the steps below to upgrade the plugin: 1. Log in to the platform and navigate to **Marketplace** > **Cluster Plugins**. @@ -17,7 +26,6 @@ Alauda Container Platform Data Services RDS Framework will execute upgrades base * **Manual**: Requires manual approval before initiating the upgrade process. :::warning -When upgrading ACP from v3 to v4, it is recommended to promptly upgrade both the global cluster and workload clusters to the new version to ensure proper display of Data Services view. +When upgrading ACP from v3 to v4, it is recommended to promptly upgrade both the global cluster and workload clusters to the new version to ensure proper display of Data Services view. If only the global cluster is upgraded to v4 while workload clusters remain on v3, please contact the technical team during this period to obtain mitigation steps for view display issues in unupgraded workload clusters. ::: - diff --git a/docs/en/upgrade/pre-upgrade.mdx b/docs/en/upgrade/pre-upgrade.mdx index d89780a7e..239051504 100644 --- a/docs/en/upgrade/pre-upgrade.mdx +++ b/docs/en/upgrade/pre-upgrade.mdx @@ -11,6 +11,10 @@ weight: 20 Before starting, ensure your current platform version is within the supported upgrade range. +:::warning MySQL-PXC Removed in Alauda Database Service for MySQL v4.3.0 +If you have **MySQL-PXC** instances, they will become **unmanaged** after upgrading to ACP v4.3.0 or later (when the MySQL operator is also upgraded). See for migration instructions. +::: + ## Important Notes - Ensure the directory `/cpaas/minio` on the control plane nodes of global cluster has at least **120 GB** of free disk space. diff --git a/docs/en/upgrade/upgrade_global_cluster.mdx b/docs/en/upgrade/upgrade_global_cluster.mdx index 95e19ab03..ef0d406b8 100644 --- a/docs/en/upgrade/upgrade_global_cluster.mdx +++ b/docs/en/upgrade/upgrade_global_cluster.mdx @@ -4,6 +4,10 @@ weight: 30 # Upgrade the global cluster +:::warning MySQL-PXC Removed in Alauda Database Service for MySQL v4.3.0 +Upgrading the global cluster will also upgrade the MySQL operator. If you have PXC instances, they will become unmanaged after the operator upgrade. See for migration instructions before upgrading. +::: + consists of a **global** cluster and one or more workload clusters. To move the platform to a new ACP Distribution Version, upgrade the global tier to the target Distribution Version first, and then diff --git a/docs/en/upgrade/upgrade_workload_cluster.mdx b/docs/en/upgrade/upgrade_workload_cluster.mdx index b8c9a71d5..49effae6a 100644 --- a/docs/en/upgrade/upgrade_workload_cluster.mdx +++ b/docs/en/upgrade/upgrade_workload_cluster.mdx @@ -4,6 +4,10 @@ weight: 30 # Upgrade Workload Clusters +:::warning MySQL-PXC Removed in Alauda Database Service for MySQL v4.3.0 +**MySQL-PXC is removed** starting from Alauda Database Service for MySQL v4.3.0. Existing PXC instances will no longer be managed by the MySQL operator after upgrading to ACP v4.3.0 or later. See for migration instructions before upgrading. +::: + Workload clusters can be upgraded after the global tier has already reached the target ACP Distribution Version. The global tier does not need to be upgraded again if it is already at that Distribution Version. ACP 4.3 uses the same CVO-based workflow for workload clusters as for the `global` cluster: confirm prerequisites, run preflight checks, request the upgrade, and observe execution. This workflow has two additional rules: From 0e4e2c33e29d2e4c9032f09ee223c87f16013480 Mon Sep 17 00:00:00 2001 From: Jinpei Su Date: Wed, 25 Mar 2026 00:23:44 -0700 Subject: [PATCH 4/4] refine docs --- docs/en/appservice/overview/architecture.mdx | 1 - .../functions/param-templates.mdx | 4 +- .../backup/application/backup-app.mdx | 2 +- .../functionresources/functionresources.yaml | 47 ++----------------- 4 files changed, 7 insertions(+), 47 deletions(-) diff --git a/docs/en/appservice/overview/architecture.mdx b/docs/en/appservice/overview/architecture.mdx index 40726ddc4..f9d52b291 100644 --- a/docs/en/appservice/overview/architecture.mdx +++ b/docs/en/appservice/overview/architecture.mdx @@ -23,7 +23,6 @@ The Alauda Application Services platform supports various types of services, inc | Alauda Application Services | Version | Data Persistence Compatible Storage Class | Backup Compatible Storage Class | Default Scheduling Rule (Single Instance) | | ------------------- | ------------------------- | --------------------------------------- | ------------------------------ | ----------------------------------------------------------------------------------------------- | - | MySQL-PXC | 5.7 | TopoLVM (recommended) | S3 (recommended), TopoLVM | At most (required) only one MySQL node can be scheduled on each node. | | MySQL-MGR | 8.0 | TopoLVM (recommended) | S3 (recommended) | At most (required) only one MySQL node can be scheduled on each node. | | Redis | 5.0, 6.0, 7.2 (recommended) | TopoLVM (recommended) | S3 (recommended), CephFS, NFS | Cluster mode: At most (required) only one Redis node can be scheduled on each node. Sentinel mode: At most (required) only one Redis data node or one Redis sentinel node can be scheduled on each node. | | Kafka | 3.8 (recommended) | TopoLVM (recommended) | - | At most (required) only one Broker node can be scheduled on each node. | diff --git a/docs/en/appservice/unified-om/para-template-mgt/functions/param-templates.mdx b/docs/en/appservice/unified-om/para-template-mgt/functions/param-templates.mdx index 654fe22ec..28b9f40c7 100644 --- a/docs/en/appservice/unified-om/para-template-mgt/functions/param-templates.mdx +++ b/docs/en/appservice/unified-om/para-template-mgt/functions/param-templates.mdx @@ -5,7 +5,7 @@ sourceSHA: f629c4a27b114868ccf8dea89c926cdc1d8507d07e379c719c9c543b1d47c86d # Parameter Template Management -The parameter template feature is designed for the unified management and maintenance of parameter sets for various components. This includes viewing which parameters are included in the parameter templates, along with their default values and descriptions. Currently, the components that support parameter templates are MySQL (including PXC and MGR), Redis, and Kafka. The platform comes with pre-configured parameter templates for different scenarios and component specifications, representing industry best practices for use in those scenarios, thus allowing users to utilize them directly. Additionally, users can create custom parameter templates based on their specific business needs, facilitating internal standards implementation. All parameter templates can be selected for use when creating instances. +The parameter template feature is designed for the unified management and maintenance of parameter sets for various components. This includes viewing which parameters are included in the parameter templates, along with their default values and descriptions. Currently, the components that support parameter templates are MySQL (MGR), Redis, and Kafka. The platform comes with pre-configured parameter templates for different scenarios and component specifications, representing industry best practices for use in those scenarios, thus allowing users to utilize them directly. Additionally, users can create custom parameter templates based on their specific business needs, facilitating internal standards implementation. All parameter templates can be selected for use when creating instances. ## Main Features @@ -18,7 +18,7 @@ Users can click on the parameter template to access the list page, as shown in t On this page, users can view the parameter templates for specific projects according to component type and template type. The supported component types currently include MySQL, Redis, and Kafka. The template types available are the platform's pre-configured templates and user-defined templates. The platform's pre-configured templates are universally applicable across the entire cluster, while users can create custom templates specifically for the current project. ::: info -The parameter templates for MySQL can be applicable to both PXC architecture and MGR architecture. +The parameter templates for MySQL are applicable to MGR architecture. ::: ### View Details of a Specified Parameter Template diff --git a/docs/en/configure/backup/application/backup-app.mdx b/docs/en/configure/backup/application/backup-app.mdx index 7f1fa3eb9..2adfd4920 100644 --- a/docs/en/configure/backup/application/backup-app.mdx +++ b/docs/en/configure/backup/application/backup-app.mdx @@ -16,7 +16,7 @@ Create an application backup schedule to define the scope of data to back up (by :::warning * To back up application data, include PersistentVolumeClaims (PVCs). PVCs bound to `hostPath` PersistentVolumes are not supported. -* To ensure reliability and data integrity, do not back up database data (for example, MySQL-PXC, Redis). Use Data Services for database backups. +* To ensure reliability and data integrity, do not back up database data (for example, MySQL, Redis). Use Data Services for database backups. * Avoid reads, writes, updates, and deletes in the namespaces being backed up to prevent drift and inconsistencies after migration. ::: diff --git a/docs/shared/functionresources/functionresources.yaml b/docs/shared/functionresources/functionresources.yaml index a748cee99..4c04200fc 100644 --- a/docs/shared/functionresources/functionresources.yaml +++ b/docs/shared/functionresources/functionresources.yaml @@ -1421,8 +1421,8 @@ items: annotations: auth.cpaas.io/functionresource.function.id: "1" auth.cpaas.io/functionresource.module.id: "8" - cpaas.io/functionresource.function.display-name: MySQL (PXC) 实例管理 - cpaas.io/functionresource.function.display-name.en: MySQL (PXC) Instance + cpaas.io/functionresource.function.display-name: MySQL 实例管理 + cpaas.io/functionresource.function.display-name.en: MySQL Instance cpaas.io/functionresource.module.display-name: Data Service cpaas.io/functionresource.module.display-name.en: Data Service helm.sh/chart-version: v3.19.0-beta.88.gb325a12b @@ -1441,12 +1441,6 @@ items: uid: 6c37f95e-863a-4600-8f50-5b8bcd64e131 spec: rules: - - apiGroup: pxc.percona.com - bindCluster: unlimit - bindNamespacePart: common - bindScope: namespace - resources: - - perconaxtradbclusters - apiGroup: middleware.alauda.io bindCluster: unlimit bindNamespacePart: common @@ -1560,47 +1554,14 @@ items: bindScope: namespace resources: - mysqlrestores -- apiVersion: auth.alauda.io/v1beta1 - kind: FunctionResource - metadata: - annotations: - auth.cpaas.io/functionresource.function.id: "3" - auth.cpaas.io/functionresource.module.id: "8" - cpaas.io/functionresource.function.display-name: MySQL (PXC) 备份恢复 - cpaas.io/functionresource.function.display-name.en: MySQL (PXC) Backup/Restore - cpaas.io/functionresource.module.display-name: Data Service - cpaas.io/functionresource.module.display-name.en: Data Service - helm.sh/chart-version: v3.19.0-beta.88.gb325a12b - helm.sh/original-name: acp-middleware-mysqlrestore - creationTimestamp: "2025-02-13T01:53:15Z" - generation: 1 - labels: - auth.cpaas.io/functionresource.function: mysqlrestore - auth.cpaas.io/functionresource.module: middleware - auth.cpaas.io/product: console-acp - helm.sh/chart-name: auth-manager - helm.sh/release-name: auth-manager - helm.sh/release-namespace: cpaas-system - name: acp-middleware-mysqlrestore - resourceVersion: "6753" - uid: ba29feb9-7a5c-4ef6-988a-3bc1171f0c8f - spec: - rules: - - apiGroup: pxc.percona.com - bindCluster: unlimit - bindNamespacePart: common - bindScope: namespace - resources: - - perconaxtradbclusterbackups - - perconaxtradbclusterrestores - apiVersion: auth.alauda.io/v1beta1 kind: FunctionResource metadata: annotations: auth.cpaas.io/functionresource.function.id: "2" auth.cpaas.io/functionresource.module.id: "8" - cpaas.io/functionresource.function.display-name: MySQL (PXC) 用户管理 - cpaas.io/functionresource.function.display-name.en: MySQL (PXC) User + cpaas.io/functionresource.function.display-name: MySQL 用户管理 + cpaas.io/functionresource.function.display-name.en: MySQL User cpaas.io/functionresource.module.display-name: Data Service cpaas.io/functionresource.module.display-name.en: Data Service helm.sh/chart-version: v3.19.0-beta.88.gb325a12b