Skip to content

Latest commit

 

History

History
124 lines (86 loc) · 5.54 KB

db_upgrade.md

File metadata and controls

124 lines (86 loc) · 5.54 KB

CMDB版本升级说明

CMDB数据升级主要两个部分:一是DB数据升级,与其它项目类似,主要是新特性带来的新增的表结构初始化及部分已有表结构的扩展,有时会包含一些不完整数据的检测和修复;二是权限中心数据升级(如果对接了蓝鲸权限中心),主要是做资源模板的初始化,权限中心通过资源模板识别注册过来的资源,以及用户升级权限时显示相应的资源,另外还包含一些默认用户组(比如admin用户组)的默认权限策略。

DB数据升级

注意 db数据升级前请做好db备份。

db数据升级通过调用cmdb_adminserver的如下接口实现:

curl -X POST -H 'Content-Type:application/json' -H 'BK_USER:migrate' -H 'HTTP_BLUEKING_SUPPLIER_ID:0' http://${cmdb_adminserver_host}:${cmdb_adminserver_port}/migrate/v3/migrate/community/0

其中 ${cmdb_adminserver_host}${cmdb_adminserver_port}分别是 adminserver 的监听的地址和端口。

如果您使用的是开源版本,可以使用构建输出目录下的 init_db.sh 脚本实现DB升级。

DB 升级程序原理及执行过程

cmdb 数据版本升级由当前版本号和标记了版本号的升级程序组成,当前版本可在mongodb中执行 db.cc_System.find({type: "version"}).pretty() 输出当前版本信息,升级程序为定义在 scene_server/admin_server/upgrader 目录下的一个个模块,比如 y3.6.201911261109 为一个升级程序,版本号为 y3.6.201911261109,执行完改目录下的升级程序后,cmdb数据版本会变更到 y3.6.201911261109。

(bk-cmdb) ➜  src git:(v3.6.x) ✗ ll scene_server/admin_server/upgrader
total 40
-rw-r--r--   1 root  root   2.9K Jan 13 10:26 compare.go
-rw-r--r--   1 root  root   994B Aug 12 16:08 doc.go
-rw-r--r--   1 root  root   7.6K Jan 13 10:26 register.go
-rw-r--r--   1 root  root   3.2K Jan 13 10:26 util.go
drwxr-xr-x  10 root  root   320B Jan 13 10:26 v3.0.8
...
drwxr-xr-x   5 root  root   160B Dec 19 20:04 y3.6.201911261109
drwxr-xr-x   4 root  root   128B Jan  8 15:54 y3.6.201912241627
(bk-cmdb) ➜  src git:(v3.6.x) ✗

db 升级程序执行时,先将所有的升级程序按版本号升序排序,然后从小到大与当前版本号挨个比对,如果版本号大于当前版本号,则执行改版本的升级程序,然后开始下一轮循环,整个db升级可以用如下python脚本描述:

all_versions = sorted(all_versions)
for version in all_versions:
    if version > current_version:
        print("run %s" % version)
        run(version)
        current_version = version

DB 升级输出及故障排查

如下内容是从 v3.5.x 升级到 v3.6.x 的输出:

(bk-cmdb) ➜  v3.6.x git:(v3.6.x) ✗ ./init_db.sh
{
  "result": true,
  "bk_error_code": 0,
  "bk_error_msg": "",
  "permission": null,
  "data": "migrate success",
  "pre_version": "x19_10_22_03",
  "current_version": "y3.6.201912241627",
  "finished_migrations": [
   "y3.6.201909062359",
   "y3.6.201909272359",
   "y3.6.201910091234",
   "y3.6.201911121930",
   "y3.6.201911122106",
   "y3.6.201911141015",
   "y3.6.201911141516",
   "y3.6.201911261109",
   "y3.6.201912241627"
  ]
 }
(bk-cmdb) ➜  v3.6.x git:(v3.6.x) ✗

输出字段说明

通用字段

  • result 字段表示升级是否出错
  • bk_error_code 为出错时的具体原因
  • bk_error_msg 为错误描述
  • 正常执行完升级 data 字段内容为 "migrate success"
  • permission为cmdb接口统一返回字段,这里直接忽略

db 升级相关字段

  • pre_version 为db升级前数据库中cmdb数据处于的版本
  • current_version 为执行完升级脚本后cmdb数据处于的版本
  • finished_migrations 为本次升级脚本执行时完成的升级版本

db升级故障排查

如果在db升级过程中程序运行出错,上述输出字段 result,bk_error_code,bk_error_msg会提示错误原因,更具体的原因可通过查看 adminserver 的运行日志 cmdb_adminserver/logs/cmdb_adminserver.ERROR 获取

注意:如果输出信息中没有出现 result,bk_error_code,bk_error_msg 等字段,可能是没有成功访问到cmdb_adminserver导致的,如果怀疑是网络原因可以结合curl命令的 -vvv 参数重试,会有详细的debug信息输出。

curl -vvv -X POST -H 'Content-Type:application/json' -H 'BK_USER:migrate' -H 'HTTP_BLUEKING_SUPPLIER_ID:0' http://${cmdb_adminserver_host}:${cmdb_adminserver_port}/migrate/v3/migrate/community/0

升级接口请求失败,常见的一类原因是配置了错误的ip和端口,其中cmdb_adminserver ip需要是监听的ip,可能你的主机有多个网卡,adminserver只监听了其中一个,如果还不是很确定,可在adminserver所在服务器上通过如下命令获取:

ps aux | grep cmdb | grep adminserver | awk '{print $12}' | awk -F '=' '{print $2}'

权限数据升级

权限数据升级指对接了蓝鲸权限中心的权限升级,如果没有对接蓝鲸权限中心(开源版本用户),可跳过这部分说明信息

权限升级也是通过方案cmdb_adminserver的http接口进行,需要访问的接口如下:

curl -X POST -H 'Content-Type:application/json' -H 'BK_USER:migrate' -H 'HTTP_BLUEKING_SUPPLIER_ID:0' http://${cmdb_adminserver_host}:${cmdb_adminserver_port}/migrate/v3/authcenter/init

如果在升级过程中出现问题,上述输出字段 result,bk_error_code,bk_error_msg会提示错误原因,更具体的原因可通过查看 adminserver 的运行日志 cmdb_adminserver/logs/cmdb_adminserver.ERROR 获取