文档目录

Kubernetes 上的 TiDB 集群常见问题

本文介绍 Kubernetes 上的 TiDB 集群常见问题以及解决方案。

如何修改时区设置?

默认情况下,在 Kubernetes 集群上部署的 TiDB 集群各组件容器中的时区为 UTC,如果要修改时区配置,有下面两种情况:

第一次部署集群

配置 TidbCluster CR 的 .spec.timezone 属性,例如:

...
spec:
  timezone: Asia/Shanghai
...

然后部署 TiDB 集群。

集群已经在运行

如果 TiDB 集群已经在运行,需要先升级 TiDB 集群,然后再配置 TiDB 集群支持新的时区。

  1. 升级 TiDB 集群

    配置 TidbCluster CR 的 .spec.timezone 属性,例如:

    ...
    spec:
      timezone: Asia/Shanghai
    ...

    然后升级 TiDB 集群。

  2. 修改 TiDB 支持新的时区

    参考时区支持,修改 TiDB 服务时区配置。

TiDB 相关组件可以配置 HPA 或 VPA 么?

TiDB 集群目前还不支持 HPA(Horizontal Pod Autoscaling,自动水平扩缩容)和 VPA(Vertical Pod Autoscaling,自动垂直扩缩容),因为对于数据库这种有状态应用而言,实现自动扩缩容难度较大,无法仅通过 CPU 和 memory 监控数据来简单地实现。

使用 TiDB Operator 编排 TiDB 集群时,有什么场景需要人工介入操作吗?

如果不考虑 Kubernetes 集群本身的运维,TiDB Operator 存在以下可能需要人工介入的场景:

在公有云上使用 TiDB Operator 编排 TiDB 集群时,推荐的部署拓扑是怎样的?

首先,为了实现高可用和数据安全,我们在推荐生产环境下的 TiDB 集群中至少部署在三个可用区 (Available Zone)。

当考虑 TiDB 集群与业务服务的部署拓扑关系时,TiDB Operator 支持下面几种部署形态。它们有各自的优势与劣势,具体选型需要根据实际业务需求进行权衡:

  • 将 TiDB 集群与业务服务部署在同一个 VPC 中的同一个 Kubernetes 集群上;
  • 将 TiDB 集群与业务服务部署在同一个 VPC 中的不同 Kubernetes 集群上;
  • 将 TiDB 集群与业务服务部署在不同 VPC 中的不同 Kubernetes 集群上。

TiDB Operator 支持 TiSpark 吗?

TiDB Operator 尚不支持自动编排 TiSpark。

假如要为 TiDB in Kubernetes 添加 TiSpark 组件,你需要在同一个 Kubernetes 集群中自行维护 Spark,确保 Spark 能够访问到 PD 和 TiKV 实例的 IP 与端口,并为 Spark 安装 TiSpark 插件,TiSpark 插件的安装方式可以参考 TiSpark

在 Kubernetes 上维护 Spark 可以参考 Spark 的官方文档:Spark on Kubernetes

如何查看 TiDB 集群配置?

如果需要查看当前集群的 PD、TiKV、TiDB 组件的配置信息,可以执行下列命令:

  • 查看 PD 配置文件

    kubectl exec -it ${pod_name} -n ${namespace} -- cat /etc/pd/pd.toml
  • 查看 TiKV 配置文件

    kubectl exec -it ${pod_name} -n ${namespace} -- cat /etc/tikv/tikv.toml
  • 查看 TiDB 配置文件

    kubectl exec -it ${pod_name} -c tidb -n ${namespace} -- cat /etc/tidb/tidb.toml

部署 TiDB 集群时调度失败是什么原因?

TiDB Operator 调度 Pod 失败的原因可能有三种情况:

  • 资源不足,导致 Pod 一直阻塞在 Pending 状态。详细说明参见集群故障诊断

  • 部分 Node 被打了 taint,导致 Pod 无法调度到对应的 Node 上。详请参考 taint & toleration

  • 调度错误,导致 Pod 一直阻塞在 ContainerCreating 状态。这种情况发生时请检查 Kubernetes 集群中是否部署过多个 TiDB Operator。重复的 TiDB Operator 自定义调度器的存在,会导致同一个 Pod 的调度周期不同阶段会分别被不同的调度器处理,从而产生冲突。

    执行以下命令,如果有两条及以上记录,就说明 Kubernetes 集群中存在重复的 TiDB Operator,请根据实际情况删除多余的 TiDB Operator。

    kubectl get deployment --all-namespaces |grep tidb-scheduler