将 TiDB 迁移至 Kubernetes

本文介绍一种不借助备份恢复工具将部署在物理机或虚拟机中的 TiDB 迁移至 Kubernetes 中的方法。

先置条件

Kubernetes 集群外物理机或虚拟机节点必须与集群内 Pod 网络互通
Kubernetes 集群外物理机或虚拟机节点必须能够解析 Kubernetes 集群内部 Pod 域名（具体配置方法见第一步）
待迁移集群没有开启组件间 TLS 加密通信

第一步：在待迁移集群的所有节点中配置 DNS 服务

获取 Kubernetes 集群 CoreDNS 或 kube-dns 服务的 endpoints 的 Pod ip 地址列表：
```
kubectl describe svc/kube-dns -n kube-system
```

修改待迁移集群节点 /etc/resolv.conf 配置，向该配置文件中添加如下内容：

search default.svc.cluster.local svc.cluster.local cluster.local
nameserver <CoreDNS Pod_IP_1>
nameserver <CoreDNS Pod_IP_2>
nameserver <CoreDNS Pod_IP_n>

测试解析 Kubernetes 集群内部域名是否成功：

$ ping basic-pd-2.basic-pd-peer.blade.svc
PING basic-pd-2.basic-pd-peer.blade.svc (10.24.66.178) 56(84) bytes of data.
64 bytes from basic-pd-2.basic-pd-peer.blade.svc (10.24.66.178): icmp_seq=1 ttl=61 time=0.213 ms
64 bytes from basic-pd-2.basic-pd-peer.blade.svc (10.24.66.178): icmp_seq=2 ttl=61 time=0.175 ms
64 bytes from basic-pd-2.basic-pd-peer.blade.svc (10.24.66.178): icmp_seq=3 ttl=61 time=0.188 ms
64 bytes from basic-pd-2.basic-pd-peer.blade.svc (10.24.66.178): icmp_seq=4 ttl=61 time=0.157 ms

第二步：在 Kubernetes 中创建 TiDB 集群

通过 PD Control 获取待迁移集群 PD 节点地址及端口号：

pd-ctl -u http://<address>:<port> member | jq '.members | .[] | .client_urls'

在 Kubernetes 中创建目标 TiDB 集群（TiKV 节点个数不少于 3 个），并在 spec.pdAddresses 字段中指定待迁移 TiDB 集群的 PD 节点地址（以 http:// 开头）：
```
spec
  ...
  pdAddresses:
  - http://pd1_addr:port
  - http://pd2_addr:port
  - http://pd3_addr:port
```
确认部署在 Kubernetes 内的 TiDB 集群与待迁移 TiDB 集群组成的新集群正常运行。
- 获取新集群 store 个数、状态：
```
# store 个数
pd-ctl -u http://<address>:<port> store | jq '.count'
# store 状态
pd-ctl -u http://<address>:<port> store | jq '.stores | .[] | .store.state_name'
```
- 通过 MySQL 客户端访问 Kubernetes 上的 TiDB 集群。

第三步：缩容待迁移集群 TiDB 节点

将待迁移集群的 TiDB 节点缩容至 0 个：

如果待迁移集群使用 TiUP 部署，参考缩容 TiDB/PD/TiKV 节点一节。
如果待迁移集群使用 TiDB Ansible 部署，参考缩容 TiDB 节点一节。

注意

若通过负载均衡或数据库访问层中间件的方式接入待迁移 TiDB 集群，则先修改配置，将业务流量迁移至目标 TiDB 集群，避免影响业务。

第四步：缩容待迁移集群 TiKV 节点

将待迁移集群的 TiKV 节点缩容至 0 个：

如果待迁移集群使用 TiUP 部署，参考缩容 TiDB/PD/TiKV 节点一节。
如果待迁移集群使用 TiDB Ansible 部署，参考缩容 TiKV 节点一节。

注意

依次缩容待迁移集群的 TiKV 节点，等待上一个 TiKV 节点对应的 store 状态变为 "tombstone" 后，再执行下一个 TiKV 节点的缩容操作。
可通过 PD Control 工具查看 store 状态。

第五步：缩容待迁移集群 PD 节点

将待迁移集群的 PD 节点缩容至 0 个：

如果待迁移集群使用 TiUP 部署，参考缩容 TiDB/PD/TiKV 节点一节。
如果待迁移集群使用 TiDB Ansible 部署，参考缩容 PD 节点一节。

第六步：删除 `spec.pdAddresses` 字段

为避免后续对集群进行操作时产生困惑，迁移成功后，建议将新集群的 manifest 中的 spec.pdAddresses 字段删除。