升级为什么会停服
数据库升级不是替换一个二进制文件那么简单,而停服的本质,是一次进程重启。新版本要接管旧版本留下的数据目录,中间涉及系统表变更、元数据迁移、存储格式的兼容处理,这些动作大多只能在进程启动阶段完成。于是无论升级包多大、步骤多简单,停掉旧进程、换上新的可执行文件、重新打开数据目录并完成迁移这个序列都绕不开。服务中断的长度,取决于这段序列要跑多久,以及在这段时间里有没有别的节点能顶上。
这也解释了一个常见的思维惯性:把升级默认等同于停机窗口。单机只有一份数据、一个进程,进程一停,服务就归零;分布式集群不是这样——只要还有足够多的副本在线,停掉一个节点,数据照样可读可写。所以能不能不停服,本质上不是命令写法的问题,而是架构和冗余的问题。
三种升级范式
工程上常见的升级方式只有三类,区别在于数据有几份、服务由谁兜底。

三种升级范式的取舍
KaiwuDB 的升级方式
这里给大家整理下 KaiwuDB 3.3.0 官方文档列出来的几种升级方式,升级前先对上号,不要凭经验直接动手。

总结下,目前 KaiwuDB V3.x 内部可以原地升级,但KaiwuDB V1.x / V2.x 需要走走导入导出。换句话说,目前不停服升级只对 3.x 的集群成立;老版本跨大版本,必须接受一次数据搬迁。
KaiwuDB 升级准备
按部署形态分成单机部署和集群部署,执行按部署方式分成安装程序升级和容器镜像升级。不管选择哪条路,升级前都需要做好准备工作。
2、单机部署的准备
单机部署的准备只有三步,主要包括:确认新版本高于已安装版本;停止 KaiwuDB 服务;备份用户数据目录。
systemctl stop kaiwudb
停服这一步在单机上没有替代方案。单机只有一份数据、一个进程,服务停止就是业务中断,所以要规划的是停多久,而不是纠结能不能不停。备份用户数据目录是最有安全的兜底方案——单机升级失败时,能回去的只有这份目录
3、集群部署的准备
集群部署的准备流程:版本 → 参数 → 健康检查 → 备份,前两步决定能不能升,后面几步决定现在该不该升。
第一步,确认新版本高于已安装版本。
第二步,如果是多副本集群,先处理参数:3.2.0 起时序 raft log 的落盘周期默认改为实时,从 3.0.x 或 3.1.x 升到 3.2.0 之前,需要在旧版本上把参数切过去,并等待集群完成切换。
SET CLUSTER SETTING ts.raft_log.sync_period = '0s';
等待 5 分钟以上,再查询分片状态确认集群正常,异常时可多次重试.
SELECT * FROM kwdb_internal.ranges;
第三步,检查集群状态。可以从监控平台的总览页看:节点状态下有没有异常或不可用节点(存在时不允许升级)、副本状态下有没有不可用分区或副本数不足分区、Nodes 下各节点版本是否一致且 CPU 与内存还有余量。也可以用命令查:
// 查看集群状态
kw-status
// 查看副本状态
SELECT sum((metrics->>'ranges.unavailable')::DECIMAL)::INT AS ranges_unavailable,
sum((metrics->>'ranges.underreplicated')::DECIMAL)::INT AS ranges_underreplicated
FROM kwdb_internal.kv_store_status;
第四步,检查是否存在正在执行的模式更改或批量导入操作。监控平台的事件页可以看到,命令行用 SHOW JOBS 更直接。升级会中断这类任务,等它跑完再动手更稳妥。
第五步,检查集群内表的 Leaseholder 和副本分布是否均匀,命令还是 SELECT * FROM kwdb_internal.ranges。分布明显倾斜时,升级期间的热点节点风险会被放大。
第六步,备份集群。官方原话是:如果升级失败,可以使用备份将集群还原到之前的状态。到这一步,准备工作才算闭合——前面五步回答“能不能升”,这一步回答“升坏了怎么办”。
KaiwuDB 升级方式一:安装程序升级
准备做完,进入执行。KaiwuDB 按部署方式分成两类:安装程序升级与容器镜像升级。安装程序又提供命令行、终端图形交互、可视化 GUI 三种模式,三者动作基本完全一致,区别主要是在“在哪里点、怎么填”
下述仅把不同类型的要点做出提炼总结,详细内容可前往官方文档>>https://www.kaiwudb.com/docs/#/db-operation/db-upgrade.html
1、 前提条件
-
已获取新版本的安装程序(.run 文件);
-
待升级节点已安装 KaiwuDB;已备份待升级节点的用户数据目录;
-
执行节点(集群内任一节点)能通过 SSH 登录待升级节点,并且对待升级节点的安装目录有写权限;
-
执行用户满足权限要求——命令行与终端图形模式为 root 或已配置 sudo 免密的普通用户,可视化 GUI 模式为 root 或拥有 sudo 权限的普通用户,容器部署下非 root 用户还需先加入 docker 组。
第四条最容易被忽略:升级不是在本机执行的,而是由集群里某个节点通过 SSH 推到目标节点,所以执行节点必须能登录过去、并对安装目录有写权限。如果这一条不满足,安装程序会在第一步就中止,并提示部署方式或权限有误。
2、命令行模式:一个节点一个节点地滚
命令行模式的动作可以压缩成一个单节点闭环:停服、升级、改配置、启动、校验,然后换下一个节点。
// 1. 把新版本安装程序复制到执行节点,赋予执行权限
chmod +x KaiwuDB-*.run
// 2. 在待升级节点停止服务
sudo systemctl stop kaiwudb
// 3. 在执行节点以命令行模式启动安装程序
./KaiwuDB-*.run -c
// 4. 主功能菜单输入 4(升级节点),节点数量填 1
// 5. 安装程序生成升级配置文件,把 host 改为待升级节点 IP
// 6. 在待升级节点按部署方式修正配置文件中的 IP(裸机为三处)
sudo vim /etc/systemd/system/kaiwudb.service
sudo vim /usr/local/kaiwudb/bin/kw-status.sh
sudo vim /usr/local/kaiwudb/bin/kw-sql.sh
// 7. 重载系统服务配置并启动
sudo systemctl daemon-reload
sudo systemctl start kaiwudb
// 8. 校验通过后,才对下一个节点重复步骤 2-8
kw-status
这段流程里有三个细节重点关注。
第一,节点数量填 1。KaiwuDB 对集群的要求是逐个节点升级,这个节点重新加入集群、确认版本与状态无误,再动下一个;不要图省事一次填成节点总数,那等于把滚动升级做成了批量停机。
第二,升级后必须改配置文件里的 IP:裸机部署要改 systemd 的 kaiwudb.service、kw-status.sh、kw-sql.sh 三处;容器部署则要改 docker-compose.yml——删除 ports 与 deploy.resources 配置块,网络改为 host 模式,并把 command 里的 IP 换成实际节点 IP,同时修正 kw-status.sh、kw-sql.sh。
第三,改过 unit 文件一定要先 daemon-reload 再 start,否则启动的还是旧配置。
容器部署的集群同样适用这套节奏。
3、终端图形交互模式
把命令行换成菜单,就是终端图形交互模式:用 ./KaiwuDB-*.run -i(或 --interact)启动,方向键选中升级节点回车,在参数设置里依次填待升级节点的 IP、端口、用户名、密码,保存后开始升级。升级完成后动作与命令行模式一致:改配置文件、daemon-reload、启动、kw-status,再重复到下一个节点。
4、可视化 GUI 模式
GUI 模式用 sudo ./KaiwuDB-*.run -g(或 --gui)启动,在向导页选“版本升级”点下一步;节点管理页点“增加节点”,填 IP、端口、用户名、密码并保存;再点下一步等待升级完成,点结束退出。后续依旧是改配置、daemon-reload、启动、校验、换下一个节点。
5、全部节点完成后的收尾
三种模式走到最后都是同样的三步:重新申请并配置许可证(企业版升级后需要重新申请);验证数据是否完整;多副本集群再查一次分片状态,确认没有不可用分片和副本不足,Leaseholder 与副本已经重新均衡。
SELECT * FROM kwdb_internal.ranges;
KaiwuDB 升级方式二:容器镜像升级
容器部署的实例,升级对象是镜像本身。KaiwuDB 提供 Docker Compose 和 Docker Run 两条路径,前提都是一致的:已完成数据和配置备份,已获取新版本容器镜像。
1、Docker Compose
用 Compose 编排的实例,顺序如下:加载新镜像、下线旧容器、删旧镜像、改镜像版本、拉起、检查:
docker load < KaiwuDB.tar # 加载新版本容器镜像
docker-compose down # 停止并移除现有容器
docker rmi ${image_name} # 删除旧版本镜像
# 修改 docker-compose.yml,更新镜像版本
docker-compose up -d # 启动新版本
docker-compose ps # 检查容器是否正常运行
2、Docker Run
用 docker run 直接起的实例,保留原容器参数、只替换镜像:
docker stop <kaiwudb_container> # 停止容器
docker rm <kaiwudb_container> # 删除容器
docker load < KaiwuDB.tar # 加载新版本镜像
docker run -d --name <kaiwudb_container> \
[原容器参数] <new_image_name> # 除镜像名外,其余参数与原容器保持一致
docker ps # 检查容器状态
这里需要明确一件事:容器方式解决的是怎么把新镜像换上去,不解决能不能滚。多副本集群仍然要一个节点一个节点地换,一次把所有容器都 down 掉,等于自己制造了一次全量停机。
一张可落地的升级 SOP
我们把上述提到的重点收成一张表,供大家参考,

把升级要不要停服拆开看,答案由三件事决定:有没有副本冗余、客户端能不能绕开单点、版本之间是否支持原地升级。三条都成立,滚动升级就是一条安全且可预期的路径;缺任何一条,不停服就只是口号。
KaiwuDB 在 3.x 内部给出的正是标准滚动路径:确认升级路径、健康检查、备份、逐节点停服升级、校验、再下一个节点。真正决定成败的,往往而是升级前那几项检查有没有老实做完,以及备份到底能不能还原。
更多关于KaiwuDB 的详细内容可前往官方文档>> https://www.kaiwudb.com/docs/#/db-operation/db-upgrade.html
企业版和开源版均支持数据库升级能力,欢迎获取安装包体验:https://www.kaiwudb.com/download?tab=1

评论(0)