Veops/CMDB 项目本地开发环境搭建指南
环境准备
在开始搭建 Veops/CMDB 项目之前,我们需要确保本地开发环境满足以下要求:
系统依赖
-
数据库服务:
- MySQL:用于存储CMDB的核心数据
- Redis:用于缓存和异步任务队列
-
Python环境:
- 版本要求:3.8 ≤ Python ≤ 3.11
- 推荐使用虚拟环境管理工具(如pipenv)
-
前端环境:
- Node.js 14.x版本
- Yarn包管理工具
数据库服务部署
使用Docker快速部署
对于本地开发环境,推荐使用Docker容器化部署数据库服务,这样可以避免污染本地环境。
MySQL部署
# 创建数据持久化目录
mkdir ~/cmdb_db
# 启动MySQL容器
docker run -d -p 3306:3306 --name mysql-cmdb \
-e MYSQL_ROOT_PASSWORD=Root_321 \
-v ~/cmdb_db:/var/lib/mysql \
mysql
Redis部署
# 启动Redis容器
docker run -d --name redis -p 6379:6379 redis
MySQL配置调整
CMDB项目对MySQL的SQL模式有特定要求,需要执行以下配置:
- 进入MySQL容器:
docker exec -it mysql-cmdb bash
mysql -uroot -pRoot_321
- 设置SQL模式:
SET GLOBAL sql_mode='STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION';
SET SESSION sql_mode='STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION';
- 创建CMDB专用数据库:
CREATE DATABASE cmdb;
项目代码获取与配置
-
获取项目源代码后,进入项目目录
-
复制配置文件模板:
cp cmdb-api/settings.example.py cmdb-api/settings.py
- 编辑
cmdb-api/settings.py
文件,配置数据库连接信息,确保与之前部署的MySQL服务配置一致。
依赖安装
后端依赖安装
进入cmdb-api
目录,使用pipenv安装Python依赖:
cd cmdb-api && pipenv run pipenv install && cd ..
前端依赖安装
- 确保Node.js版本为14.x(推荐使用nvm管理Node版本)
- 进入
cmdb-ui
目录,使用yarn安装前端依赖:
cd cmdb-ui && yarn install && cd ..
数据库初始化
有三种方式初始化数据库:
-
导入预置SQL文件:
- 将
docs/cmdb.sql
导入数据库,会创建默认用户(demo/123456)
- 将
-
使用迁移工具初始化:
cd cmdb-api pipenv run flask db-setup pipenv run flask common-check-new-columns pipenv run flask cmdb-init-cache
服务启动
后端服务启动
cd cmdb-api
pipenv run flask run -h 0.0.0.0
前端服务启动
cd cmdb-ui
yarn run serve
异步任务Worker启动
CMDB使用Celery处理异步任务,需要启动两个worker:
- CMDB异步任务worker:
cd cmdb-api
pipenv run celery -A celery_worker.celery worker -E -Q one_cmdb_async --autoscale=5,2 --logfile=one_cmdb_async.log -D
- ACL异步任务worker:
pipenv run celery -A celery_worker.celery worker -E -Q acl_async --autoscale=2,1 --logfile=one_acl_async.log -D
访问系统
- 本地访问:浏览器打开
http://127.0.0.1:8000
- 远程访问:需要修改
cmdb-ui/.env
文件中的VUE_APP_API_BASE_URL
,将其指向后端服务的实际IP地址
常见问题解决
-
Python版本问题:
- 确保使用3.8-3.11之间的Python版本
- 推荐使用pyenv管理多Python版本
-
MySQL连接问题:
- 检查
settings.py
中的数据库配置 - 确认MySQL服务已启动且端口开放
- 检查
-
前端编译问题:
- 确保Node.js版本为14.x
- 清除node_modules后重新安装依赖
通过以上步骤,您应该能够成功在本地搭建Veops/CMDB项目的开发环境。如果在部署过程中遇到问题,可以检查各服务的日志输出以获取更多调试信息。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考