TiDB Operator v1.1 重要注意事项

    从 TiDB Operator v1.1.0 开始，PingCAP 不再继续更新 tidb-cluster chart，原来由 tidb-cluster chart 负责管理的组件或者功能在 v1.1 中的变更如下：

    • tidb-cluster chart 会继续发布，但是 PingCAP 不再添加新功能，社区贡献者仍然可以为 tidb-cluster chart 添加新功能。
    • 通过 v1.0.x TiDB Operator 部署的 TiDB 集群，在 TiDB Operator 升级到 v1.1 之后，仍然可以通过 v1.1 版本的 tidb-cluster chart 升级和管理 TiDB 集群。

    虽然 TiDB Operator v1.1 版本仍然支持用户使用 Helm 和 tidb-cluster chart 管理集群，但是由于 tidb-cluster chart 不再新增功能，用户可以自己为 tidb-cluster chart 贡献新功能或者切换到 TiDB Operator v1.1 完整支持的方式。

    下面介绍如何将 tidb-cluster chart 管理的组件或者功能切换到 v1.1 完整支持的方式。

    Discovery 服务直接由 TiDB Operator 内部生成，不再需要用户做任何配置。

    PD、TiDB、TiKV

    在 tidb-cluster chart 中，PD、TiDB、TiKV 配置由 Helm 渲染成 ConfigMap，从 TiDB Operator v1.1 开始，PD、TiDB、TiKV 配置也可以直接在 TiDBCluster CR 中配置，具体配置方法可以参考 。

    Monitor

    可以参考 创建 TidbMonitor CR，管理 Monitor 组件。

    注意：

    • TidbMonitor CR 中的 需要和集群中 TidbCluster CR 的名字保持一致。
    • 由于 TiDB Operator 渲染资源的方式和 Helm 渲染资源的方式不同，从 tidb-cluster chart values.yaml 中的配置迁移到 TidbMonitor CR，会引起 Monitor 组件滚动升级。
    • 如果在升级到 TiDB Operator v1.1 之前，初始化 Job 已经执行，初始化 Job 不需要从 tidb-cluster chart 中迁移到 TidbInitializer CR。
    • 如果在升级到 TiDB Operator v1.1 之前，没有执行过初始化 Job，也没有修改过 TiDB 服务 root 用户的密码，升级到 TiDB Operator v1.1 之后，需要执行初始化，可以参考 Kubernetes 上的集群初始化配置进行配置。

    Pump

    升级到 TiDB Operator v1.1 之后，可以修改 TidbCluster CR，添加 Pump 相关配置，通过 TidbCluster CR 管理 Pump 组件：

    按照集群实际情况修改 version、、storageClassName、 等配置。

    Scheduled Backup

    • 如果 TiDB 集群版本 < v3.1，可以参考
    • 如果 TiDB 集群版本 >= v3.1，可以参考 BR 定时全量备份

    注意：

    • 如果切换到 CR 方式管理，请删除原有定时全量备份的 Cronjob，以防止重复备份。
    • 如果在升级到 TiDB Operator v1.1 之前，没有部署 Drainer，现在需要新部署，可以参考 。
    • 如果在升级到 TiDB Operator v1.1 之前，已经通过 tidb-drainer chart 部署 Drainer，继续用 chart 管理。
    • 如果在升级到 TiDB Operator v1.1 之前，已经通过 tidb-cluster chart 部署 Drainer，建议直接用 kubectl 管理。

    TiKV Importer

    • 如果在升级到 TiDB Operator v1.1 之前，没有部署 TiKV Importer，现在需要新部署，可以参考 。
    • 如果在升级到 TiDB Operator v1.1 之前，已经部署 TiKV Importer，建议直接用 kubectl 管理。

    Ad-hoc 备份

    升级到 TiDB Operator v1.1 之后，可以通过 Backup CR 进行备份。Dumpling 方式只支持全量备份，BR 方式支持全量备份与增量备份：

    • 如果 TiDB 集群版本 < v3.1，可以参考
    • 如果 TiDB 集群版本 >= v3.1，可以参考 BR Ad-hoc 备份

    升级到 TiDB Operator v1.1 之后，可以通过 Restore CR 进行备份恢复：

    注意：