From f5233f751df80fd47c44d75b3958fc6f638eabcd Mon Sep 17 00:00:00 2001 From: lidezhu Date: Thu, 6 Nov 2025 21:30:22 +0800 Subject: [PATCH 01/15] add description about deployment --- ticdc/ticdc-architecture.md | 46 +++++++++++++++++++++++++++++++++++-- 1 file changed, 44 insertions(+), 2 deletions(-) diff --git a/ticdc/ticdc-architecture.md b/ticdc/ticdc-architecture.md index a2a0d1e818ec..a933e0fc90be 100644 --- a/ticdc/ticdc-architecture.md +++ b/ticdc/ticdc-architecture.md @@ -109,7 +109,28 @@ TiCDC 新架构仅支持 v7.5.0 或者以上版本的 TiDB 集群，使用之前
-以下为通过 TiUP 部署 TiCDC 新架构的步骤： +使用 TiUP 部署时，你可以选择以下部署方式之一： + +- [使用 TiUP 部署启用新架构 TiCDC 的全新 TiDB 集群](#使用-tiup-部署启用新架构-ticdc-的全新-tidb-集群) + +- [使用 TiUP 在原有 TiDB 集群中部署启用新架构的 TiCDC 组件](#使用-tiup-在原有-tidb-集群中部署启用新架构的-ticdc-组件) +### 使用 TiUP 部署启用新架构 TiCDC 的全新 TiDB 集群 + +在使用 TiUP 部署 v8.5.4 或者以上版本的全新 TiDB 集群时，支持同时部署启用新架构的 TiCDC 组件。你需要在 TiUP 启动 TiDB 集群时的配置文件中加入 TiCDC 组件相关的部分并启用新架构，以下是一个示例： + +```yaml +cdc_servers: + - host: 10.0.1.20 + config: + newarch: true + - host: 10.0.1.21 + config: + newarch: true +``` + +更多详细操作，请参考[使用 TiUP 部署包含 TiCDC 组件的全新 TiDB 集群](/ticdc/deploy-ticdc.md#使用-tiup-部署包含-ticdc-组件的全新-tidb-集群)。 + +### 使用 TiUP 在原有 TiDB 集群中部署启用新架构的 TiCDC 组件 1. 如果你的 TiDB 集群中尚无 TiCDC 节点，参考[扩容 TiCDC 节点](/scale-tidb-using-tiup.md#扩容-ticdc-节点)在集群中扩容新的 TiCDC 节点，否则跳过该步骤。 @@ -158,7 +179,28 @@ TiCDC 新架构仅支持 v7.5.0 或者以上版本的 TiDB 集群，使用之前
-以下为通过 TiDB Operator 部署 TiCDC 新架构的步骤： +使用 TiDB Operator 部署时，你可以选择以下部署方式之一： + +- [使用 TiDB Operator 部署启用新架构 TiCDC 的全新 TiDB 集群](#使用-tidb-operator-部署启用新架构-ticdc-的全新-tidb-集群) +- [使用 TiDB Operator 在原有 TiDB 集群中部署启用新架构的 TiCDC 组件](#使用-tidb-operator-在原有-tidb-集群中部署启用新架构的-ticdc-组件) + +### 使用 TiDB Operator 部署启用新架构 TiCDC 的全新 TiDB 集群 + +在使用 TiDB Operator 部署 v8.5.4 或者以上版本的全新 TiDB 集群时，支持同时部署启用新架构的 TiCDC 组件。你需要在集群配置文件中加入 TiCDC 组件相关的部分并启用新架构，以下是一个示例： + +```yaml +spec: + ticdc: + baseImage: pingcap/ticdc + version: v8.5.4 + replicas: 3 + config: + newarch = true +``` + +更多详细操作，请参考[全新部署 TiDB 集群同时部署 TiCDC](https://docs.pingcap.com/zh/tidb-in-kubernetes/stable/deploy-ticdc/#在现有-tidb-集群上新增-ticdc-组件)。 + +### 使用 TiDB Operator 在原有 TiDB 集群中部署启用新架构的 TiCDC 组件 - 如果现有 TiDB 集群中没有 TiCDC 组件，参考[在现有 TiDB 集群上新增 TiCDC 组件](https://docs.pingcap.com/zh/tidb-in-kubernetes/stable/deploy-ticdc/#在现有-tidb-集群上新增-ticdc-组件)在集群中扩容新的 TiCDC 节点。操作时，只需在集群配置文件中将 TiCDC 的镜像版本指定为新架构版本即可。 From 9f3267bce88666db7bec824c7421fcbd8c9ab237 Mon Sep 17 00:00:00 2001 From: lidezhu Date: Thu, 6 Nov 2025 22:31:01 +0800 Subject: [PATCH 02/15] add description about metrics --- ticdc/monitor-ticdc.md | 2 +- ticdc/ticdc-architecture.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/ticdc/monitor-ticdc.md b/ticdc/monitor-ticdc.md index 7b7ec7a9afad..3c8f9e18dee3 100644 --- a/ticdc/monitor-ticdc.md +++ b/ticdc/monitor-ticdc.md @@ -15,7 +15,7 @@ cdc cli changefeed create --server=http://10.0.10.25:8300 --sink-uri="mysql://ro ## TiCDC 新架构监控指标 -[TiCDC 新架构](/ticdc/ticdc-architecture.md)的监控面板 **TiCDC-New-Arch** 暂时未集成到 TiUP 中。要在 Grafana 中查看相关监控信息，你需要手动导入 TiCDC 监控指标文件： +TiCDC 新架构的监控面板为 **TiCDC-New-Arch**。对于 v8.5.4 及以上版本的新建或现有集群，TiUP 或 TiDB Operator 将自动完成面板集成，无需手动操作。而对于现有低于 v8.5.4 版本的集群，需要手动导入 TiCDC 监控指标文件： 1. 下载 TiCDC 新架构监控指标文件 diff --git a/ticdc/ticdc-architecture.md b/ticdc/ticdc-architecture.md index a933e0fc90be..39f67c6bf5b5 100644 --- a/ticdc/ticdc-architecture.md +++ b/ticdc/ticdc-architecture.md @@ -281,6 +281,6 @@ cdc cli changefeed query -s --server=http://127.0.0.1:8300 --changefeed-id=simpl ## 监控 -目前，TiUP 尚未集成 TiCDC 新架构的监控面板 **TiCDC-New-Arch**。要在 Grafana 中查看该面板，你需要手动导入 [TiCDC 监控指标文件](https://github.com/pingcap/ticdc/blob/master/metrics/grafana/ticdc_new_arch.json)。 +TiCDC 新架构的监控面板为 **TiCDC-New-Arch**。对于 v8.5.4 及以上版本的新建或现有集群，TiUP 或 TiDB Operator 将自动完成面板集成，无需手动操作。而对于现有低于 v8.5.4 版本的集群，需手动导入[TiCDC 监控指标文件](https://github.com/pingcap/ticdc/blob/master/metrics/grafana/ticdc_new_arch.json) 以启用监控。 各监控指标的详细说明，请参考 [TiCDC 新架构监控指标](/ticdc/monitor-ticdc.md#ticdc-新架构监控指标)。 \ No newline at end of file From d1036c756ae166444a6ab02998a29830e2e14a8f Mon Sep 17 00:00:00 2001 From: lidezhu Date: Thu, 6 Nov 2025 22:34:57 +0800 Subject: [PATCH 03/15] small fix --- ticdc/ticdc-architecture.md | 1 + 1 file changed, 1 insertion(+) diff --git a/ticdc/ticdc-architecture.md b/ticdc/ticdc-architecture.md index 39f67c6bf5b5..4e1e4310a91c 100644 --- a/ticdc/ticdc-architecture.md +++ b/ticdc/ticdc-architecture.md @@ -114,6 +114,7 @@ TiCDC 新架构仅支持 v7.5.0 或者以上版本的 TiDB 集群，使用之前 - [使用 TiUP 部署启用新架构 TiCDC 的全新 TiDB 集群](#使用-tiup-部署启用新架构-ticdc-的全新-tidb-集群) - [使用 TiUP 在原有 TiDB 集群中部署启用新架构的 TiCDC 组件](#使用-tiup-在原有-tidb-集群中部署启用新架构的-ticdc-组件) + ### 使用 TiUP 部署启用新架构 TiCDC 的全新 TiDB 集群 在使用 TiUP 部署 v8.5.4 或者以上版本的全新 TiDB 集群时，支持同时部署启用新架构的 TiCDC 组件。你需要在 TiUP 启动 TiDB 集群时的配置文件中加入 TiCDC 组件相关的部分并启用新架构，以下是一个示例： From acd9f28c0babb1680cc05c4434240a063568fa18 Mon Sep 17 00:00:00 2001 From: lidezhu <47731263+lidezhu@users.noreply.github.com> Date: Fri, 7 Nov 2025 15:26:19 +0800 Subject: [PATCH 04/15] Update ticdc/monitor-ticdc.md Co-authored-by: Grace Cai --- ticdc/monitor-ticdc.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/ticdc/monitor-ticdc.md b/ticdc/monitor-ticdc.md index 3c8f9e18dee3..f0503a570c31 100644 --- a/ticdc/monitor-ticdc.md +++ b/ticdc/monitor-ticdc.md @@ -15,7 +15,9 @@ cdc cli changefeed create --server=http://10.0.10.25:8300 --sink-uri="mysql://ro ## TiCDC 新架构监控指标 -TiCDC 新架构的监控面板为 **TiCDC-New-Arch**。对于 v8.5.4 及以上版本的新建或现有集群，TiUP 或 TiDB Operator 将自动完成面板集成，无需手动操作。而对于现有低于 v8.5.4 版本的集群，需要手动导入 TiCDC 监控指标文件： +TiCDC 新架构的监控面板为 **TiCDC-New-Arch**。对于 v8.5.4 及以上版本的 TiDB 集群，该监控面板已在集群部署或升级时集成到 Grafana，无需手动操作。 + +如果你的集群版本低于 v8.5.4，需要手动导入 TiCDC 监控指标文件： 1. 下载 TiCDC 新架构监控指标文件 From f78c5451c713b7bb1293210499fd5a4e1067e639 Mon Sep 17 00:00:00 2001 From: lidezhu Date: Fri, 7 Nov 2025 15:41:38 +0800 Subject: [PATCH 05/15] address comment --- ticdc/ticdc-architecture.md | 60 ++++++++++++++++++------------------- 1 file changed, 29 insertions(+), 31 deletions(-) diff --git a/ticdc/ticdc-architecture.md b/ticdc/ticdc-architecture.md index 4e1e4310a91c..5af825817f84 100644 --- a/ticdc/ticdc-architecture.md +++ b/ticdc/ticdc-architecture.md @@ -106,17 +106,11 @@ TiCDC 新架构仅支持 v7.5.0 或者以上版本的 TiDB 集群，使用之前 你可以通过 TiUP 或 TiDB Operator 部署 TiCDC 新架构。 +### 部署启用新架构 TiCDC 的全新 TiDB 集群 +
-使用 TiUP 部署时，你可以选择以下部署方式之一： - -- [使用 TiUP 部署启用新架构 TiCDC 的全新 TiDB 集群](#使用-tiup-部署启用新架构-ticdc-的全新-tidb-集群) - -- [使用 TiUP 在原有 TiDB 集群中部署启用新架构的 TiCDC 组件](#使用-tiup-在原有-tidb-集群中部署启用新架构的-ticdc-组件) - -### 使用 TiUP 部署启用新架构 TiCDC 的全新 TiDB 集群 - 在使用 TiUP 部署 v8.5.4 或者以上版本的全新 TiDB 集群时，支持同时部署启用新架构的 TiCDC 组件。你需要在 TiUP 启动 TiDB 集群时的配置文件中加入 TiCDC 组件相关的部分并启用新架构，以下是一个示例： ```yaml @@ -131,7 +125,32 @@ cdc_servers: 更多详细操作，请参考[使用 TiUP 部署包含 TiCDC 组件的全新 TiDB 集群](/ticdc/deploy-ticdc.md#使用-tiup-部署包含-ticdc-组件的全新-tidb-集群)。 -### 使用 TiUP 在原有 TiDB 集群中部署启用新架构的 TiCDC 组件 +
+
+ +在使用 TiDB Operator 部署 v8.5.4 或者以上版本的全新 TiDB 集群时，支持同时部署启用新架构的 TiCDC 组件。你需要在集群配置文件中加入 TiCDC 组件相关的部分并启用新架构，以下是一个示例： + +```yaml +spec: + ticdc: + baseImage: pingcap/ticdc + version: v8.5.4 + replicas: 3 + config: + newarch = true +``` + +更多详细操作，请参考[全新部署 TiDB 集群同时部署 TiCDC](https://docs.pingcap.com/zh/tidb-in-kubernetes/stable/deploy-ticdc/#在现有-tidb-集群上新增-ticdc-组件)。 + +
+ + +### 在原有 TiDB 集群中部署启用新架构的 TiCDC 组件 + + +
+ +使用 TiUP 在原有 TiDB 集群中部署启用新架构的 TiCDC 组件可以参考以下步骤： 1. 如果你的 TiDB 集群中尚无 TiCDC 节点，参考[扩容 TiCDC 节点](/scale-tidb-using-tiup.md#扩容-ticdc-节点)在集群中扩容新的 TiCDC 节点，否则跳过该步骤。 @@ -180,28 +199,7 @@ cdc_servers:
-使用 TiDB Operator 部署时，你可以选择以下部署方式之一： - -- [使用 TiDB Operator 部署启用新架构 TiCDC 的全新 TiDB 集群](#使用-tidb-operator-部署启用新架构-ticdc-的全新-tidb-集群) -- [使用 TiDB Operator 在原有 TiDB 集群中部署启用新架构的 TiCDC 组件](#使用-tidb-operator-在原有-tidb-集群中部署启用新架构的-ticdc-组件) - -### 使用 TiDB Operator 部署启用新架构 TiCDC 的全新 TiDB 集群 - -在使用 TiDB Operator 部署 v8.5.4 或者以上版本的全新 TiDB 集群时，支持同时部署启用新架构的 TiCDC 组件。你需要在集群配置文件中加入 TiCDC 组件相关的部分并启用新架构，以下是一个示例： - -```yaml -spec: - ticdc: - baseImage: pingcap/ticdc - version: v8.5.4 - replicas: 3 - config: - newarch = true -``` - -更多详细操作，请参考[全新部署 TiDB 集群同时部署 TiCDC](https://docs.pingcap.com/zh/tidb-in-kubernetes/stable/deploy-ticdc/#在现有-tidb-集群上新增-ticdc-组件)。 - -### 使用 TiDB Operator 在原有 TiDB 集群中部署启用新架构的 TiCDC 组件 +使用 TiDB Operator 在原有 TiDB 集群中部署启用新架构的 TiCDC 组件可以参考以下步骤： - 如果现有 TiDB 集群中没有 TiCDC 组件，参考[在现有 TiDB 集群上新增 TiCDC 组件](https://docs.pingcap.com/zh/tidb-in-kubernetes/stable/deploy-ticdc/#在现有-tidb-集群上新增-ticdc-组件)在集群中扩容新的 TiCDC 节点。操作时，只需在集群配置文件中将 TiCDC 的镜像版本指定为新架构版本即可。 From 04b554ab64c8431784818d2ebd7d34cab1795d1f Mon Sep 17 00:00:00 2001 From: lidezhu Date: Fri, 7 Nov 2025 15:43:59 +0800 Subject: [PATCH 06/15] address comment --- ticdc/ticdc-architecture.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ticdc/ticdc-architecture.md b/ticdc/ticdc-architecture.md index 5af825817f84..14a4ac664f1b 100644 --- a/ticdc/ticdc-architecture.md +++ b/ticdc/ticdc-architecture.md @@ -150,7 +150,7 @@ spec:
-使用 TiUP 在原有 TiDB 集群中部署启用新架构的 TiCDC 组件可以参考以下步骤： +以下为通过 TiUP 在原有 TiDB 集群中部署启用新架构的 TiCDC 组件的步骤： 1. 如果你的 TiDB 集群中尚无 TiCDC 节点，参考[扩容 TiCDC 节点](/scale-tidb-using-tiup.md#扩容-ticdc-节点)在集群中扩容新的 TiCDC 节点，否则跳过该步骤。 @@ -199,7 +199,7 @@ spec:
-使用 TiDB Operator 在原有 TiDB 集群中部署启用新架构的 TiCDC 组件可以参考以下步骤： +以下为通过 TiDB Operator 在原有 TiDB 集群中部署启用新架构的 TiCDC 组件的步骤： - 如果现有 TiDB 集群中没有 TiCDC 组件，参考[在现有 TiDB 集群上新增 TiCDC 组件](https://docs.pingcap.com/zh/tidb-in-kubernetes/stable/deploy-ticdc/#在现有-tidb-集群上新增-ticdc-组件)在集群中扩容新的 TiCDC 节点。操作时，只需在集群配置文件中将 TiCDC 的镜像版本指定为新架构版本即可。 From b39da20365d280032e9ba59c74e905094ab97909 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Fri, 7 Nov 2025 16:45:37 +0800 Subject: [PATCH 07/15] Update ticdc-architecture.md --- ticdc/ticdc-architecture.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/ticdc/ticdc-architecture.md b/ticdc/ticdc-architecture.md index 14a4ac664f1b..18b3e4d814a4 100644 --- a/ticdc/ticdc-architecture.md +++ b/ticdc/ticdc-architecture.md @@ -154,9 +154,9 @@ spec: 1. 如果你的 TiDB 集群中尚无 TiCDC 节点，参考[扩容 TiCDC 节点](/scale-tidb-using-tiup.md#扩容-ticdc-节点)在集群中扩容新的 TiCDC 节点，否则跳过该步骤。 -2. 下载 TiCDC 新架构离线包。 +2. 如果你的 TiDB 集群为 v8.5.4 之前版本，需要按照以下方式手动下载 TiCDC 新架构离线包，并将下载的 TiCDC 二进制文件动态替换到你的 TiDB 集群，否则跳过该步骤。 - 离线包下载链接格式为 `https://tiup-mirrors.pingcap.com/cdc-${version}-${os}-${arch}.tar.gz`。其中，`${version}` 为 TiCDC 版本号，`${os}` 为你的操作系统，`${arch}` 为组件运行的平台（`amd64` 或 `arm64`）。 + 离线包下载链接格式为 `https://tiup-mirrors.pingcap.com/cdc-${version}-${os}-${arch}.tar.gz`。其中，`${version}` 为 TiCDC 新架构版本号，`${os}` 为你的操作系统，`${arch}` 为组件运行的平台（`amd64` 或 `arm64`）。 例如，可以使用以下命令下载 Linux 系统 x86-64 架构的 TiCDC v8.5.4-release.1 的离线包： @@ -282,4 +282,4 @@ cdc cli changefeed query -s --server=http://127.0.0.1:8300 --changefeed-id=simpl TiCDC 新架构的监控面板为 **TiCDC-New-Arch**。对于 v8.5.4 及以上版本的新建或现有集群，TiUP 或 TiDB Operator 将自动完成面板集成，无需手动操作。而对于现有低于 v8.5.4 版本的集群，需手动导入[TiCDC 监控指标文件](https://github.com/pingcap/ticdc/blob/master/metrics/grafana/ticdc_new_arch.json) 以启用监控。 -各监控指标的详细说明，请参考 [TiCDC 新架构监控指标](/ticdc/monitor-ticdc.md#ticdc-新架构监控指标)。 \ No newline at end of file +各监控指标的详细说明，请参考 [TiCDC 新架构监控指标](/ticdc/monitor-ticdc.md#ticdc-新架构监控指标)。 From 0d16298c474bf39c57a99026772556bcd28bc394 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Fri, 7 Nov 2025 16:49:19 +0800 Subject: [PATCH 08/15] revise descriptions --- ticdc/ticdc-architecture.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/ticdc/ticdc-architecture.md b/ticdc/ticdc-architecture.md index 18b3e4d814a4..209c297d7936 100644 --- a/ticdc/ticdc-architecture.md +++ b/ticdc/ticdc-architecture.md @@ -111,7 +111,7 @@ TiCDC 新架构仅支持 v7.5.0 或者以上版本的 TiDB 集群，使用之前
-在使用 TiUP 部署 v8.5.4 或者以上版本的全新 TiDB 集群时，支持同时部署启用新架构的 TiCDC 组件。你需要在 TiUP 启动 TiDB 集群时的配置文件中加入 TiCDC 组件相关的部分并启用新架构，以下是一个示例： +在使用 TiUP 部署 v8.5.4 或者以上版本的全新 TiDB 集群时，支持同时部署启用新架构的 TiCDC 组件。你需要在 TiUP 启动 TiDB 集群时的配置文件中加入 TiCDC 组件相关的部分并设置 `newarch: true` 以启用新架构，以下是一个示例： ```yaml cdc_servers: @@ -123,12 +123,12 @@ cdc_servers: newarch: true ``` -更多详细操作，请参考[使用 TiUP 部署包含 TiCDC 组件的全新 TiDB 集群](/ticdc/deploy-ticdc.md#使用-tiup-部署包含-ticdc-组件的全新-tidb-集群)。 +更多 TiCDC 部署信息，请参考[使用 TiUP 部署包含 TiCDC 组件的全新 TiDB 集群](/ticdc/deploy-ticdc.md#使用-tiup-部署包含-ticdc-组件的全新-tidb-集群)。
-在使用 TiDB Operator 部署 v8.5.4 或者以上版本的全新 TiDB 集群时，支持同时部署启用新架构的 TiCDC 组件。你需要在集群配置文件中加入 TiCDC 组件相关的部分并启用新架构，以下是一个示例： +在使用 TiDB Operator 部署 v8.5.4 或者以上版本的全新 TiDB 集群时，支持同时部署启用新架构的 TiCDC 组件。你需要在集群配置文件中加入 TiCDC 组件相关的部分并设置 `newarch: true` 以启用新架构，以下是一个示例： ```yaml spec: @@ -140,7 +140,7 @@ spec: newarch = true ``` -更多详细操作，请参考[全新部署 TiDB 集群同时部署 TiCDC](https://docs.pingcap.com/zh/tidb-in-kubernetes/stable/deploy-ticdc/#在现有-tidb-集群上新增-ticdc-组件)。 +更多 TiCDC 部署信息，请参考[全新部署 TiDB 集群同时部署 TiCDC](https://docs.pingcap.com/zh/tidb-in-kubernetes/stable/deploy-ticdc/#在现有-tidb-集群上新增-ticdc-组件)。
@@ -280,6 +280,6 @@ cdc cli changefeed query -s --server=http://127.0.0.1:8300 --changefeed-id=simpl ## 监控 -TiCDC 新架构的监控面板为 **TiCDC-New-Arch**。对于 v8.5.4 及以上版本的新建或现有集群，TiUP 或 TiDB Operator 将自动完成面板集成，无需手动操作。而对于现有低于 v8.5.4 版本的集群，需手动导入[TiCDC 监控指标文件](https://github.com/pingcap/ticdc/blob/master/metrics/grafana/ticdc_new_arch.json) 以启用监控。 +TiCDC 新架构的监控面板为 **TiCDC-New-Arch**。对于 v8.5.4 及以上版本的 TiDB 集群，该监控面板已在集群部署或升级时集成到 Grafana，无需手动操作。如果你的集群版本低于 v8.5.4，需手动导入[TiCDC 监控指标文件](https://github.com/pingcap/ticdc/blob/master/metrics/grafana/ticdc_new_arch.json) 以启用监控。 -各监控指标的详细说明，请参考 [TiCDC 新架构监控指标](/ticdc/monitor-ticdc.md#ticdc-新架构监控指标)。 +导入的详细步骤以及各监控指标的详细说明，请参考 [TiCDC 新架构监控指标](/ticdc/monitor-ticdc.md#ticdc-新架构监控指标)。 From 4fec24d42c8626552b7b304313868252c5464f3b Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Fri, 7 Nov 2025 17:07:07 +0800 Subject: [PATCH 09/15] Update TiCDC architecture doc with version info links --- ticdc/ticdc-architecture.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/ticdc/ticdc-architecture.md b/ticdc/ticdc-architecture.md index 209c297d7936..675eeaed127d 100644 --- a/ticdc/ticdc-architecture.md +++ b/ticdc/ticdc-architecture.md @@ -156,7 +156,7 @@ spec: 2. 如果你的 TiDB 集群为 v8.5.4 之前版本，需要按照以下方式手动下载 TiCDC 新架构离线包，并将下载的 TiCDC 二进制文件动态替换到你的 TiDB 集群，否则跳过该步骤。 - 离线包下载链接格式为 `https://tiup-mirrors.pingcap.com/cdc-${version}-${os}-${arch}.tar.gz`。其中，`${version}` 为 TiCDC 新架构版本号，`${os}` 为你的操作系统，`${arch}` 为组件运行的平台（`amd64` 或 `arm64`）。 + 离线包下载链接格式为 `https://tiup-mirrors.pingcap.com/cdc-${version}-${os}-${arch}.tar.gz`。其中，`${version}` 为 TiCDC 版本号（版本号信息可参考 [TiCDC 新架构版本发布列表](https://github.com/pingcap/ticdc/releases)），`${os}` 为你的操作系统，`${arch}` 为组件运行的平台（`amd64` 或 `arm64`）。 例如，可以使用以下命令下载 Linux 系统 x86-64 架构的 TiCDC v8.5.4-release.1 的离线包： @@ -201,7 +201,7 @@ spec: 以下为通过 TiDB Operator 在原有 TiDB 集群中部署启用新架构的 TiCDC 组件的步骤： -- 如果现有 TiDB 集群中没有 TiCDC 组件，参考[在现有 TiDB 集群上新增 TiCDC 组件](https://docs.pingcap.com/zh/tidb-in-kubernetes/stable/deploy-ticdc/#在现有-tidb-集群上新增-ticdc-组件)在集群中扩容新的 TiCDC 节点。操作时，只需在集群配置文件中将 TiCDC 的镜像版本指定为新架构版本即可。 +- 如果现有 TiDB 集群中没有 TiCDC 组件，参考[在现有 TiDB 集群上新增 TiCDC 组件](https://docs.pingcap.com/zh/tidb-in-kubernetes/stable/deploy-ticdc/#在现有-tidb-集群上新增-ticdc-组件)在集群中扩容新的 TiCDC 节点。操作时，只需在集群配置文件中将 TiCDC 的镜像版本指定为新架构版本即可。版本号信息可参考 [TiCDC 新架构版本发布列表](https://github.com/pingcap/ticdc/releases)。 示例如下： @@ -280,6 +280,6 @@ cdc cli changefeed query -s --server=http://127.0.0.1:8300 --changefeed-id=simpl ## 监控 -TiCDC 新架构的监控面板为 **TiCDC-New-Arch**。对于 v8.5.4 及以上版本的 TiDB 集群，该监控面板已在集群部署或升级时集成到 Grafana，无需手动操作。如果你的集群版本低于 v8.5.4，需手动导入[TiCDC 监控指标文件](https://github.com/pingcap/ticdc/blob/master/metrics/grafana/ticdc_new_arch.json) 以启用监控。 +TiCDC 新架构的监控面板为 **TiCDC-New-Arch**。对于 v8.5.4 及以上版本的 TiDB 集群，该监控面板已在集群部署或升级时集成到 Grafana，无需手动操作。如果你的集群版本低于 v8.5.4，需手动导入 [TiCDC 监控指标文件](https://github.com/pingcap/ticdc/blob/master/metrics/grafana/ticdc_new_arch.json) 以启用监控。 -导入的详细步骤以及各监控指标的详细说明，请参考 [TiCDC 新架构监控指标](/ticdc/monitor-ticdc.md#ticdc-新架构监控指标)。 +导入步骤以及各监控指标的详细说明，请参考 [TiCDC 新架构监控指标](/ticdc/monitor-ticdc.md#ticdc-新架构监控指标)。 From a0be8db5734af91fd29eb0b9c281f69f9faff71a Mon Sep 17 00:00:00 2001 From: lidezhu <47731263+lidezhu@users.noreply.github.com> Date: Mon, 10 Nov 2025 16:42:02 +0800 Subject: [PATCH 10/15] Update ticdc/ticdc-architecture.md Co-authored-by: Grace Cai --- ticdc/ticdc-architecture.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ticdc/ticdc-architecture.md b/ticdc/ticdc-architecture.md index 675eeaed127d..5553245adda6 100644 --- a/ticdc/ticdc-architecture.md +++ b/ticdc/ticdc-architecture.md @@ -128,7 +128,7 @@ cdc_servers:
-在使用 TiDB Operator 部署 v8.5.4 或者以上版本的全新 TiDB 集群时，支持同时部署启用新架构的 TiCDC 组件。你需要在集群配置文件中加入 TiCDC 组件相关的部分并设置 `newarch: true` 以启用新架构，以下是一个示例： +在使用 TiDB Operator 部署 v8.5.4 或者以上版本的全新 TiDB 集群时，支持同时部署启用新架构的 TiCDC 组件。你需要在集群配置文件中加入 TiCDC 组件相关的部分并设置 `newarch = true` 以启用新架构，以下是一个示例： ```yaml spec: From 85a39f5e7f7701468da7ad1af4070985ca27108b Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Tue, 11 Nov 2025 16:49:57 +0800 Subject: [PATCH 11/15] Apply suggestions from code review Co-authored-by: Aolin --- ticdc/monitor-ticdc.md | 2 +- ticdc/ticdc-architecture.md | 8 ++++---- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/ticdc/monitor-ticdc.md b/ticdc/monitor-ticdc.md index f0503a570c31..1ee3d25cddcf 100644 --- a/ticdc/monitor-ticdc.md +++ b/ticdc/monitor-ticdc.md @@ -15,7 +15,7 @@ cdc cli changefeed create --server=http://10.0.10.25:8300 --sink-uri="mysql://ro ## TiCDC 新架构监控指标 -TiCDC 新架构的监控面板为 **TiCDC-New-Arch**。对于 v8.5.4 及以上版本的 TiDB 集群，该监控面板已在集群部署或升级时集成到 Grafana，无需手动操作。 +[TiCDC 新架构](/ticdc/ticdc-architecture.md)的监控面板为 **TiCDC-New-Arch**。对于 v8.5.4 及以上版本的 TiDB 集群，该监控面板已在集群部署或升级时自动集成到 Grafana 中，无需手动操作。 如果你的集群版本低于 v8.5.4，需要手动导入 TiCDC 监控指标文件： diff --git a/ticdc/ticdc-architecture.md b/ticdc/ticdc-architecture.md index 5553245adda6..ebd7b517c6ea 100644 --- a/ticdc/ticdc-architecture.md +++ b/ticdc/ticdc-architecture.md @@ -111,7 +111,7 @@ TiCDC 新架构仅支持 v7.5.0 或者以上版本的 TiDB 集群，使用之前
-在使用 TiUP 部署 v8.5.4 或者以上版本的全新 TiDB 集群时，支持同时部署启用新架构的 TiCDC 组件。你需要在 TiUP 启动 TiDB 集群时的配置文件中加入 TiCDC 组件相关的部分并设置 `newarch: true` 以启用新架构，以下是一个示例： +使用 TiUP 部署 v8.5.4 或者以上版本的全新 TiDB 集群时，可以同时部署启用新架构的 TiCDC 组件。你需要在 TiUP 启动 TiDB 集群时的配置文件中添加 TiCDC 组件相关配置，并设置 `newarch: true` 以启用新架构，以下是一个示例： ```yaml cdc_servers: @@ -128,7 +128,7 @@ cdc_servers:
-在使用 TiDB Operator 部署 v8.5.4 或者以上版本的全新 TiDB 集群时，支持同时部署启用新架构的 TiCDC 组件。你需要在集群配置文件中加入 TiCDC 组件相关的部分并设置 `newarch = true` 以启用新架构，以下是一个示例： +使用 TiDB Operator 部署 v8.5.4 或者以上版本的全新 TiDB 集群时，可以同时部署启用新架构的 TiCDC 组件。你需要在集群配置文件中添加 TiCDC 组件配置，并设置 `newarch = true` 以启用新架构，以下是一个示例： ```yaml spec: @@ -201,7 +201,7 @@ spec: 以下为通过 TiDB Operator 在原有 TiDB 集群中部署启用新架构的 TiCDC 组件的步骤： -- 如果现有 TiDB 集群中没有 TiCDC 组件，参考[在现有 TiDB 集群上新增 TiCDC 组件](https://docs.pingcap.com/zh/tidb-in-kubernetes/stable/deploy-ticdc/#在现有-tidb-集群上新增-ticdc-组件)在集群中扩容新的 TiCDC 节点。操作时，只需在集群配置文件中将 TiCDC 的镜像版本指定为新架构版本即可。版本号信息可参考 [TiCDC 新架构版本发布列表](https://github.com/pingcap/ticdc/releases)。 +- 如果现有 TiDB 集群中没有 TiCDC 组件，参考[在现有 TiDB 集群上新增 TiCDC 组件](https://docs.pingcap.com/zh/tidb-in-kubernetes/stable/deploy-ticdc/#在现有-tidb-集群上新增-ticdc-组件)在集群中添加新的 TiCDC 节点。操作时，只需在集群配置文件中将 TiCDC 的镜像版本指定为新架构版本即可。版本号信息可参考 [TiCDC 新架构版本发布列表](https://github.com/pingcap/ticdc/releases)。 示例如下： @@ -280,6 +280,6 @@ cdc cli changefeed query -s --server=http://127.0.0.1:8300 --changefeed-id=simpl ## 监控 -TiCDC 新架构的监控面板为 **TiCDC-New-Arch**。对于 v8.5.4 及以上版本的 TiDB 集群，该监控面板已在集群部署或升级时集成到 Grafana，无需手动操作。如果你的集群版本低于 v8.5.4，需手动导入 [TiCDC 监控指标文件](https://github.com/pingcap/ticdc/blob/master/metrics/grafana/ticdc_new_arch.json) 以启用监控。 +TiCDC 新架构的监控面板为 **TiCDC-New-Arch**。对于 v8.5.4 及以上版本的 TiDB 集群，该监控面板已在集群部署或升级时自动集成到 Grafana 中，无需手动操作。如果你的集群版本低于 v8.5.4，需手动导入 [TiCDC 监控指标文件](https://github.com/pingcap/ticdc/blob/master/metrics/grafana/ticdc_new_arch.json) 以启用监控。 导入步骤以及各监控指标的详细说明，请参考 [TiCDC 新架构监控指标](/ticdc/monitor-ticdc.md#ticdc-新架构监控指标)。 From b4158c59976191e82c8f97a70b9824084a836eb3 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Tue, 11 Nov 2025 16:56:35 +0800 Subject: [PATCH 12/15] Update ticdc/ticdc-architecture.md Co-authored-by: Aolin --- ticdc/ticdc-architecture.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ticdc/ticdc-architecture.md b/ticdc/ticdc-architecture.md index ebd7b517c6ea..fc6f1a5d2f2c 100644 --- a/ticdc/ticdc-architecture.md +++ b/ticdc/ticdc-architecture.md @@ -132,12 +132,12 @@ cdc_servers: ```yaml spec: - ticdc: + ticdc: baseImage: pingcap/ticdc version: v8.5.4 replicas: 3 config: - newarch = true + newarch = true ``` 更多 TiCDC 部署信息，请参考[全新部署 TiDB 集群同时部署 TiCDC](https://docs.pingcap.com/zh/tidb-in-kubernetes/stable/deploy-ticdc/#在现有-tidb-集群上新增-ticdc-组件)。 From fc0b899b55cdedad001fa873a3382e16be6d3eb5 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Tue, 11 Nov 2025 17:41:46 +0800 Subject: [PATCH 13/15] update the intro section --- ticdc/ticdc-architecture.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ticdc/ticdc-architecture.md b/ticdc/ticdc-architecture.md index fc6f1a5d2f2c..f7124e5a5669 100644 --- a/ticdc/ticdc-architecture.md +++ b/ticdc/ticdc-architecture.md @@ -5,7 +5,7 @@ summary: 介绍 TiCDC 新架构的主要特性、架构设计、升级部署指 # TiCDC 新架构 -从 [TiCDC v8.5.4-release.1](https://github.com/pingcap/ticdc/releases/tag/v8.5.4-release.1) 版本起，TiCDC 引入新架构，显著提升了实时数据复制的性能、可扩展性与稳定性，同时降低了资源成本。新架构重新设计了 TiCDC 的核心组件并优化了数据处理流程，具有以下优势： +从 [TiCDC v8.5.4-release.1](https://github.com/pingcap/ticdc/releases/tag/v8.5.4-release.1) 版本起，TiCDC 引入新架构，显著提升了实时数据复制的性能、可扩展性与稳定性，同时降低了资源成本。新架构在完全兼容 [TiCDC 老架构](/ticdc/ticdc-classic-architecture)的配置项、使用方式和 API 的基础上，对 TiCDC 核心组件与数据处理流程进行了重构与优化，具有以下优势： - **更高的单节点性能**：单节点可支持最多 50 万张表的同步任务，宽表场景下单节点同步流量最高可达 190 MiB/s。 - **更强的扩展能力**：集群同步能力接近线性扩展，单集群可扩展至超过 100 个节点，支持超 1 万个 Changefeed；单个 Changefeed 可支持百万级表的同步任务。 From be39f8563001436fe0073189acbe0b8d4a6d8fe7 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Tue, 11 Nov 2025 17:42:28 +0800 Subject: [PATCH 14/15] Update ticdc/ticdc-architecture.md --- ticdc/ticdc-architecture.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/ticdc/ticdc-architecture.md b/ticdc/ticdc-architecture.md index f7124e5a5669..721d9c21c7bc 100644 --- a/ticdc/ticdc-architecture.md +++ b/ticdc/ticdc-architecture.md @@ -5,7 +5,9 @@ summary: 介绍 TiCDC 新架构的主要特性、架构设计、升级部署指 # TiCDC 新架构 -从 [TiCDC v8.5.4-release.1](https://github.com/pingcap/ticdc/releases/tag/v8.5.4-release.1) 版本起，TiCDC 引入新架构，显著提升了实时数据复制的性能、可扩展性与稳定性，同时降低了资源成本。新架构在完全兼容 [TiCDC 老架构](/ticdc/ticdc-classic-architecture)的配置项、使用方式和 API 的基础上，对 TiCDC 核心组件与数据处理流程进行了重构与优化，具有以下优势： +从 [TiCDC v8.5.4-release.1](https://github.com/pingcap/ticdc/releases/tag/v8.5.4-release.1) 版本起，TiCDC 引入新架构，显著提升了实时数据复制的性能、可扩展性与稳定性，同时降低了资源成本。 + +新架构在完全兼容 [TiCDC 老架构](/ticdc/ticdc-classic-architecture)的配置项、使用方式和 API 的基础上，对 TiCDC 核心组件与数据处理流程进行了重构与优化，具有以下优势： - **更高的单节点性能**：单节点可支持最多 50 万张表的同步任务，宽表场景下单节点同步流量最高可达 190 MiB/s。 - **更强的扩展能力**：集群同步能力接近线性扩展，单集群可扩展至超过 100 个节点，支持超 1 万个 Changefeed；单个 Changefeed 可支持百万级表的同步任务。 From c8e07b4dab58b5d83068d1354ee87dc608d9a0a0 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Tue, 18 Nov 2025 14:59:59 +0800 Subject: [PATCH 15/15] Update ticdc/ticdc-architecture.md --- ticdc/ticdc-architecture.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ticdc/ticdc-architecture.md b/ticdc/ticdc-architecture.md index 721d9c21c7bc..8dda1eb38804 100644 --- a/ticdc/ticdc-architecture.md +++ b/ticdc/ticdc-architecture.md @@ -7,7 +7,7 @@ summary: 介绍 TiCDC 新架构的主要特性、架构设计、升级部署指 从 [TiCDC v8.5.4-release.1](https://github.com/pingcap/ticdc/releases/tag/v8.5.4-release.1) 版本起，TiCDC 引入新架构，显著提升了实时数据复制的性能、可扩展性与稳定性，同时降低了资源成本。 -新架构在完全兼容 [TiCDC 老架构](/ticdc/ticdc-classic-architecture)的配置项、使用方式和 API 的基础上，对 TiCDC 核心组件与数据处理流程进行了重构与优化，具有以下优势： +新架构在完全兼容 [TiCDC 老架构](/ticdc/ticdc-classic-architecture.md)的配置项、使用方式和 API 的基础上，对 TiCDC 核心组件与数据处理流程进行了重构与优化，具有以下优势： - **更高的单节点性能**：单节点可支持最多 50 万张表的同步任务，宽表场景下单节点同步流量最高可达 190 MiB/s。 - **更强的扩展能力**：集群同步能力接近线性扩展，单集群可扩展至超过 100 个节点，支持超 1 万个 Changefeed；单个 Changefeed 可支持百万级表的同步任务。