如果你使用 TiDB Operator 部署管理 Kubernetes 上的 TiDB 集群,可以通过滚动更新来升级 TiDB 集群的版本,减少对业务的影响。本文介绍如何使用滚动更新来升级 Kubernetes 上的 TiDB 集群。
滚动更新功能介绍 Kubernetes 提供了滚动更新功能,在不影响应用可用性的前提下执行更新。
使用滚动更新时,TiDB Operator 会按 PD、TiKV、TiDB 的顺序,串行地删除旧版本的 Pod,并创建新版本的 Pod。当新版本的 Pod 正常运行后,再处理下一个 Pod。
滚动更新中,TiDB Operator 会自动处理 PD 和 TiKV 的 Leader 迁移。因此,在多节点的部署拓扑下(最小环境:PD * 3、TiKV * 3、TiDB * 2),滚动更新 TiKV、PD 不会影响业务正常运行。对于有连接重试功能的客户端,滚动更新 TiDB 同样不会影响业务。
警告
- 对于无法进行连接重试的客户端,滚动更新 TiDB 会导致连接到被关闭节点的数据库的连接失效,造成部分业务请求失败。对于这类业务,推荐在客户端添加重试功能,或者在低峰期进行 TiDB 的滚动更新操作。
- 升级前,请参考文档确认没有正在进行的 DDL 操作。
TiDB(v4.0.2 起)默认会定期收集使用情况信息,并将这些信息分享给 PingCAP 用于改善产品。若要了解所收集的信息详情及如何禁用该行为,请参见遥测。
- 在 TidbCluster CR 中,修改待升级集群的各组件的镜像配置:
kubectl edit tc ${cluster_name} -n ${namespace}
正常情况下,集群内的各组件应该使用相同版本,所以一般修改spec.version
即可。如果要为集群内不同组件设置不同的版本,可以修改spec..version
。
version
字段格式如下:
spec.version
,格式为imageTag
,例如v5.3
。spec..version
,格式为imageTag
,例如v3.1.0
。
- 查看升级进度:
watch kubectl -n ${namespace} get pod -o wide
当所有 Pod 都重建完毕进入Running
状态后,升级完成。
force-upgrade
强制升级集群以恢复集群功能。强制升级的步骤如下:
- 为集群设置 annotation:
kubectl annotate --overwrite tc ${cluster_name} -n ${namespace} tidb.pingcap.com/force-upgrade=true
- 修改 PD 相关配置,确保 PD 进入正常状态。
- 【kubernetes|升级 Kubernetes 上的 TiDB 集群】修复 PD 配置后,必须执行以下命令,禁用强制升级功能,否则下次升级过程可能会出现异常:
kubectl annotate tc ${cluster_name} -n ${namespace} tidb.pingcap.com/force-upgrade-
推荐阅读
- docker|Docker 进阶指南(上)- 使用Dockerfile自定义镜像
- mysql|mysql查看锁和事务
- 遇见Golang|【SQL注入】关于GORM的SQL注入问题
- asp.net|netcore基于asp.net的校园二手闲置商品交易系统
- JavaWeb从入门到实战|【JavaWeb】JDBC实战
- JavaWeb从入门到实战|【JavaWeb】数据库连接池
- Mybatis|SpringBoot整合Mybatisplus
- ui|Spring Boot 揭秘与实战
- ui|Spring Boot揭秘与实战 - 收藏集 - 掘金