在标准 Kubernetes 上部署 TiDB 集群

本文主要描述了如何在标准的 Kubernetes 集群上通过 TiDB Operator 部署 TiDB 集群。

前置条件

  • TiDB Operator 部署完成。

部署 TiDB 集群

在部署 TiDB 集群之前，需要先配置 TiDB 集群。请参阅在 Kubernetes 中配置 TiDB 集群。

配置 TiDB 集群后，请按照以下步骤部署 TiDB 集群：

  1. 创建 Namespace：

    1. kubectl create namespace ${namespace}

    部署 TiDB 集群 - 图1注意

    namespace 是命名空间，可以起一个方便记忆的名字，比如和 cluster_name 相同的名称。

  2. 部署 TiDB 集群：

    1. kubectl apply -f ${cluster_name} -n ${namespace}

    部署 TiDB 集群 - 图2注意

    建议在 cluster_name 目录下组织 TiDB 集群的配置，并将其另存为 ${cluster_name}/tidb-cluster.yaml。默认条件下，修改配置不会自动应用到 TiDB 集群中，只有在 Pod 重启时，才会重新加载新的配置文件。

    如果服务器没有外网，需要在有外网的机器上将 TiDB 集群用到的 Docker 镜像下载下来并上传到服务器上，然后使用 docker load 将 Docker 镜像安装到服务器上。

    部署一套 TiDB 集群会用到下面这些 Docker 镜像（假设 TiDB 集群的版本是 v5.4.0）：

    1. pingcap/pd:v5.4.0
    2. pingcap/tikv:v5.4.0
    3. pingcap/tidb:v5.4.0
    4. pingcap/tidb-binlog:v5.4.0
    5. pingcap/ticdc:v5.4.0
    6. pingcap/tiflash:v5.4.0
    7. pingcap/tidb-monitor-reloader:v1.0.1
    8. pingcap/tidb-monitor-initializer:v5.4.0
    9. grafana/grafana:6.0.1
    10. prom/prometheus:v2.18.1
    11. busybox:1.26.2

    接下来通过下面的命令将所有这些镜像下载下来：

    1. docker pull pingcap/pd:v5.4.0
    2. docker pull pingcap/tikv:v5.4.0
    3. docker pull pingcap/tidb:v5.4.0
    4. docker pull pingcap/tidb-binlog:v5.4.0
    5. docker pull pingcap/ticdc:v5.4.0
    6. docker pull pingcap/tiflash:v5.4.0
    7. docker pull pingcap/tidb-monitor-reloader:v1.0.1
    8. docker pull pingcap/tidb-monitor-initializer:v5.4.0
    9. docker pull grafana/grafana:6.0.1
    10. docker pull prom/prometheus:v2.18.1
    11. docker pull busybox:1.26.2
    13. docker save -o pd-v5.4.0.tar pingcap/pd:v5.4.0
    14. docker save -o tikv-v5.4.0.tar pingcap/tikv:v5.4.0
    15. docker save -o tidb-v5.4.0.tar pingcap/tidb:v5.4.0
    16. docker save -o tidb-binlog-v5.4.0.tar pingcap/tidb-binlog:v5.4.0
    17. docker save -o ticdc-v5.4.0.tar pingcap/ticdc:v5.4.0
    18. docker save -o tiflash-v5.4.0.tar pingcap/tiflash:v5.4.0
    19. docker save -o tidb-monitor-reloader-v1.0.1.tar pingcap/tidb-monitor-reloader:v1.0.1
    20. docker save -o tidb-monitor-initializer-v5.4.0.tar pingcap/tidb-monitor-initializer:v5.4.0
    21. docker save -o grafana-6.0.1.tar grafana/grafana:6.0.1
    22. docker save -o prometheus-v2.18.1.tar prom/prometheus:v2.18.1
    23. docker save -o busybox-1.26.2.tar busybox:1.26.2

    接下来将这些 Docker 镜像上传到服务器上，并执行 docker load 将这些 Docker 镜像安装到服务器上：

    1. docker load -i pd-v5.4.0.tar
    2. docker load -i tikv-v5.4.0.tar
    3. docker load -i tidb-v5.4.0.tar
    4. docker load -i tidb-binlog-v5.4.0.tar
    5. docker load -i ticdc-v5.4.0.tar
    6. docker load -i tiflash-v5.4.0.tar
    7. docker load -i tidb-monitor-reloader-v1.0.1.tar
    8. docker load -i tidb-monitor-initializer-v5.4.0.tar
    9. docker load -i grafana-6.0.1.tar
    10. docker load -i prometheus-v2.18.1.tar
    11. docker load -i busybox-1.26.2.tar

  3. 通过下面命令查看 Pod 状态：

    1. kubectl get po -n ${namespace} -l app.kubernetes.io/instance=${cluster_name}

单个 Kubernetes 集群中可以利用 TiDB Operator 部署管理多套 TiDB 集群，重复以上步骤并将 cluster_name 替换成不同名字即可。不同集群既可以在相同 namespace 中，也可以在不同 namespace 中，可根据实际需求进行选择。

部署 TiDB 集群 - 图3注意

如果要将 TiDB 集群部署到 ARM64 机器上，可以参考在 ARM64 机器上部署 TiDB 集群。

初始化 TiDB 集群

如果要在部署完 TiDB 集群后做一些初始化工作，参考 Kubernetes 上的集群初始化配置进行配置。

部署 TiDB 集群 - 图4注意

TiDB（v4.0.2 起）默认会定期收集使用情况信息，并将这些信息分享给 PingCAP 用于改善产品。若要了解所收集的信息详情及如何禁用该行为，请参见遥测。