CMDB数据库升级原理与实战指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00447/article/details/148504958

CMDB数据库升级原理与实战指南

bk-cmdb 蓝鲸智云配置平台(BlueKing CMDB) 项目地址: https://gitcode.com/gh_mirrors/bk/bk-cmdb

前言

在企业IT资产管理领域，CMDB（配置管理数据库）作为核心系统，其版本升级和数据迁移是运维工作中至关重要的环节。本文将深入解析CMDB系统的数据库升级机制，帮助运维人员和安全工程师理解升级原理并掌握实际操作技巧。

一、CMDB升级概述

CMDB系统的升级主要包含两大核心部分：

数据库结构升级：涉及新增表结构初始化、已有表结构扩展以及数据完整性校验修复
权限中心数据升级（对接权限中心时）：包括资源模板初始化和默认权限策略配置

二、数据库升级详解

2.1 升级前的必要准备

重要安全提示：在执行任何升级操作前，必须对数据库进行完整备份。这是保障数据安全的基本要求。

2.2 升级执行方式

CMDB提供了两种升级方式：

API调用方式：

curl -X POST -H 'Content-Type:application/json' \
-H 'X-Bkcmdb-User:migrate' \
-H 'X-Bkcmdb-Supplier-Account:0' \
http://${cmdb_adminserver_host}:${cmdb_adminserver_port}/migrate/v3/migrate/community/0

脚本方式（开源版本）：使用项目构建输出目录下的init_db.sh脚本

2.3 升级机制原理

CMDB采用版本化升级机制，其核心设计如下：

版本记录：当前版本号存储在MongoDB的cc_System集合中，可通过命令查询：

db.cc_System.find({type: "version"}).pretty()

升级程序结构：升级程序以版本号命名的模块形式存在，例如：

scene_server/admin_server/upgrader/
├── y3.6.201911261109
├── y3.6.201912241627
...

升级执行逻辑：升级过程遵循严格的版本顺序执行，其伪代码逻辑如下：

all_versions = sorted(all_versions)
for version in all_versions:
    if version > current_version:
        execute_upgrade(version)
        update_version(version)

2.4 升级输出解析

典型升级成功输出示例：

{
  "result": true,
  "bk_error_code": 0,
  "bk_error_msg": "",
  "data": "migrate success",
  "pre_version": "x19_10_22_03",
  "current_version": "y3.6.201912241627",
  "finished_migrations": [
    "y3.6.201909062359",
    ...
  ]
}

关键字段说明：

pre_version：升级前版本
current_version：升级后版本
finished_migrations：本次执行的升级脚本列表

2.5 故障排查指南

当升级出现问题时，可采取以下排查步骤：

检查返回错误信息：
- result：操作是否成功
- bk_error_code：具体错误代码
- bk_error_msg：错误描述
查看详细日志：检查adminserver日志文件： cmdb_adminserver/logs/cmdb_adminserver.ERROR
网络连通性检查：使用curl的详细模式调试：

curl -vvv -X POST ...

端口确认：在adminserver主机上确认监听地址：

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

三、权限中心升级（对接权限中心时）

权限升级同样通过adminserver接口执行：

curl -X POST -H 'Content-Type:application/json' \
-H 'X-Bkcmdb-User:migrate' \
-H 'X-Bkcmdb-Supplier-Account:0' \
http://${cmdb_adminserver_host}:${cmdb_adminserver_port}/migrate/v3/authcenter/init

注意：未对接权限中心的用户可跳过此步骤。