Skip to content

Commit

Permalink
move pd-microservice.md to doc
Browse files Browse the repository at this point in the history
Signed-off-by: husharp <[email protected]>
  • Loading branch information
HuSharp committed Mar 21, 2024
1 parent c330026 commit d1c0c27
Show file tree
Hide file tree
Showing 10 changed files with 11 additions and 74 deletions.
1 change: 0 additions & 1 deletion zh/TOC.md
Original file line number Diff line number Diff line change
Expand Up @@ -113,7 +113,6 @@
- [TiDB Scheduler 扩展调度器](tidb-scheduler.md)
- [增强型 StatefulSet 控制器](advanced-statefulset.md)
- [准入控制器](enable-admission-webhook.md)
- [PD 微服务](pd-microservices.md)
- [Sysbench 性能测试](benchmark-sysbench.md)
- [API 参考文档](https://github.com/pingcap/tidb-operator/blob/master/docs/api-references/docs.md)
- [Cheat Sheet](cheat-sheet.md)
Expand Down
4 changes: 2 additions & 2 deletions zh/configure-a-tidb-cluster.md
Original file line number Diff line number Diff line change
Expand Up @@ -221,7 +221,7 @@ TiDB Operator 支持为 PD、TiDB、TiKV、TiCDC 挂载多块 PV,可以用于
> **注意:**
>
> PD 从 v8.0.0 版本开始支持[微服务模式](pd-microservices.md)。
> PD 从 v8.0.0 版本开始支持[微服务模式](https://docs.pingcap.com/zh/tidb/stable/pd-microservices.md)。
```yaml
pd:
Expand Down Expand Up @@ -279,7 +279,7 @@ spec:

> **注意:**
>
> PD 从 v8.0.0 版本开始支持[微服务模式](pd-microservices.md)。
> PD 从 v8.0.0 版本开始支持[微服务模式](https://docs.pingcap.com/zh/tidb/stable/pd-microservices.md)。

如果要在集群中开启 PD 微服务,需要在 `${cluster_name}/tidb-cluster.yaml` 文件中配置 `spec.pd.mode` 与 `spec.pdms`:

Expand Down
2 changes: 1 addition & 1 deletion zh/deploy-tidb-cluster-across-multiple-kubernetes.md
Original file line number Diff line number Diff line change
Expand Up @@ -509,7 +509,7 @@ EOF

2. 以步骤 1 为例,按顺序进行如下升级操作:

1. 如果集群中部署了 [PD 微服务](pd-microservices.md)(从 TiDB v8.0.0 版本开始支持),为所有部署了 PD 微服务的 Kubernetes 集群升级 PD 微服务版本。
1. 如果集群中部署了 [PD 微服务](https://docs.pingcap.com/zh/tidb/stable/pd-microservices.md)(从 TiDB v8.0.0 版本开始支持),为所有部署了 PD 微服务的 Kubernetes 集群升级 PD 微服务版本。
2. 如果集群中部署了 TiProxy,为所有部署了 TiProxy 的 Kubernetes 集群升级 TiProxy 版本。
3. 如果集群中部署了 TiFlash,为所有部署了 TiFlash 的 Kubernetes 集群升级 TiFlash 版本。
4. 升级所有 Kubernetes 集群的 TiKV 版本。
Expand Down
4 changes: 2 additions & 2 deletions zh/enable-tls-between-components.md
Original file line number Diff line number Diff line change
Expand Up @@ -159,7 +159,7 @@ aliases: ['/docs-cn/tidb-in-kubernetes/dev/enable-tls-between-components/']
> **注意:**
>
> PD 从 v8.0.0 版本开始支持[微服务模式](pd-microservices.md)。如需部署 PD 微服务,并不需要为 PD 微服务的各个组件生成证书,只需要在 `pd-server.json` 文件的 `hosts` 字段中添加微服务相关的 hosts 配置即可。以 Scheduling 微服务为例,你需要进行以下配置:
> PD 从 v8.0.0 版本开始支持[微服务模式](https://docs.pingcap.com/zh/tidb/stable/pd-microservices.md)。如需部署 PD 微服务,并不需要为 PD 微服务的各个组件生成证书,只需要在 `pd-server.json` 文件的 `hosts` 字段中添加微服务相关的 hosts 配置即可。以 Scheduling 微服务为例,你需要进行以下配置:
>
> ``` json
> ...
Expand Down Expand Up @@ -1457,7 +1457,7 @@ aliases: ['/docs-cn/tidb-in-kubernetes/dev/enable-tls-between-components/']
> **注意:**
>
> PD 从 v8.0.0 版本开始支持[微服务模式](pd-microservices.md),如需部署 PD 微服务,需要为各个微服务配置 `cert-allowed-cn`。以 Scheduling 服务为例,你需要进行以下配置:
> PD 从 v8.0.0 版本开始支持[微服务模式](https://docs.pingcap.com/zh/tidb/stable/pd-microservices.md),如需部署 PD 微服务,需要为各个微服务配置 `cert-allowed-cn`。以 Scheduling 服务为例,你需要进行以下配置:
>
> - 更新 `pd.mode``ms`
> - 为 `scheduling` 微服务配置 `security` 字段
Expand Down
2 changes: 1 addition & 1 deletion zh/get-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -350,7 +350,7 @@ tidbcluster.pingcap.com/basic created

> **注意:**
>
> PD 从 v8.0.0 版本开始支持[微服务模式](pd-microservices.md)。如需部署 PD 微服务,可以按照如下方式进行部署:
> PD 从 v8.0.0 版本开始支持[微服务模式](https://docs.pingcap.com/zh/tidb/stable/pd-microservices.md)。如需部署 PD 微服务,可以按照如下方式进行部署:
>
> ``` shell
> kubectl create namespace tidb-cluster && \
Expand Down
2 changes: 1 addition & 1 deletion zh/modify-tidb-configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ PD 中[支持在线修改的配置项](https://docs.pingcap.com/zh/tidb/stable/d

> **注意:**
>
> PD 从 v8.0.0 版本开始支持[微服务模式](pd-microservices.md)。
> PD 从 v8.0.0 版本开始支持[微服务模式](https://docs.pingcap.com/zh/tidb/stable/pd-microservices.md)。

在 PD 微服务各个组件首次启动成功后,PD 的部分配置项会持久化到 etcd 中,且后续将以 etcd 中的配置为准。因此,在 PD 微服务各个组件首次启动后,这些配置项将无法再通过 TidbCluster CR 来进行修改。

Expand Down
62 changes: 0 additions & 62 deletions zh/pd-microservices.md

This file was deleted.

4 changes: 2 additions & 2 deletions zh/scale-a-tidb-cluster.md
Original file line number Diff line number Diff line change
Expand Up @@ -183,9 +183,9 @@ watch kubectl -n ${namespace} get pod -o wide

> **注意:**
>
> PD 从 v8.0.0 版本开始支持[微服务模式](pd-microservices.md)。
> PD 从 v8.0.0 版本开始支持[微服务模式](https://docs.pingcap.com/zh/tidb/stable/pd-microservices.md)。

PD 微服务通常用于解决 PD 出现性能瓶颈的问题,提高 PD 服务质量。可通过 [PD 微服务常见问题](pd-microservices.md#常见问题) 判断是否需要进行 PD 微服务扩缩容操作。
PD 微服务通常用于解决 PD 出现性能瓶颈的问题,提高 PD 服务质量。可通过 [PD 微服务常见问题](https://docs.pingcap.com/zh/tidb/stable/pd-microservices.md#常见问题) 判断是否需要进行 PD 微服务扩缩容操作。

- 目前,PD 微服务模式可将 PD 的时间戳分配和集群调度功能拆分为 TSO 微服务和 Scheduling 微服务单独部署。
- TSO 微服务为主备架构,如遇到瓶颈建议采用垂直扩缩容。
Expand Down
2 changes: 1 addition & 1 deletion zh/suspend-tidb-cluster.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ summary: 了解如何通过配置挂起 Kubernetes 上的 TiDB 集群。

> **注意:**
>
> 如果集群中部署了 [PD 微服务](pd-microservices.md)(从 TiDB v8.0.0 版本开始支持),PD 微服务组件的 Pod 会在删除 PD 之后被删除。
> 如果集群中部署了 [PD 微服务](https://docs.pingcap.com/zh/tidb/stable/pd-microservices.md)(从 TiDB v8.0.0 版本开始支持),PD 微服务组件的 Pod 会在删除 PD 之后被删除。

## 恢复 TiDB 集群

Expand Down
2 changes: 1 addition & 1 deletion zh/upgrade-a-tidb-cluster.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Kubernetes 提供了[滚动更新功能](https://kubernetes.io/docs/tutorials/ku

> **注意:**
>
> 当集群中部署了 [PD 微服务](pd-microservices.md)(从 TiDB v8.0.0 版本开始支持)时,如果采用滚动更新来升级 TiDB 集群,TiDB Operator 会按照 PD 各个微服务组件、PD、TiKV、TiDB 的顺序,串行地删除旧版本的 Pod 并创建新版本的 Pod。当新版本的 Pod 正常运行后,再处理下一个 Pod。
> 当集群中部署了 [PD 微服务](https://docs.pingcap.com/zh/tidb/stable/pd-microservices.md)(从 TiDB v8.0.0 版本开始支持)时,如果采用滚动更新来升级 TiDB 集群,TiDB Operator 会按照 PD 各个微服务组件、PD、TiKV、TiDB 的顺序,串行地删除旧版本的 Pod 并创建新版本的 Pod。当新版本的 Pod 正常运行后,再处理下一个 Pod。
滚动更新中,TiDB Operator 会自动处理 PD 和 TiKV 的 Leader 迁移。因此,在多节点的部署拓扑下(最小环境:PD \* 3、TiKV \* 3、TiDB \* 2),滚动更新 TiKV、PD 不会影响业务正常运行。对于有连接重试功能的客户端,滚动更新 TiDB 同样不会影响业务。

Expand Down

0 comments on commit d1c0c27

Please sign in to comment.