dbm 是一个软件套件，包含有 dbm-center 和 dbm-agent 两大组成部分；其中 dbm-center 可以看成一个 web 站点，DBA 通过它可以查看监控、告警、部署各种 MySQL|Redis 环境。 dbm-agent 是 dbm-center 的助手，负责环境的部署、监控的采集与上报、数据库的备份与监控。总的来讲接活的 dbm-center 真正干活的是 dbm-agent。另外 dbm-agent 也集成了若干命令行工具，这使得它也可以单独使用。
愿景
我们希望 DBA 可以从日常的工作中解放出来，做到只要在 web 界面上点一下“同意”系统就能自动、高效、优质的完成所有的操作；同样对于那些我们认为不合理的需求只要点一个“驳回”系统除了向需求方回一个被驳回的响应之外什么都不会干，安静的像一个美男子；更有意思的事，对于所有能用自动化解决的问题，dbm 绝对不会大半夜打 dba 的电话，出现故障自动解决，完成之后记录一下日志就行。
工作原理
dbm-agent 是安装在你机器上的一个 python 程序，它可以工作在两个模式
一：守护进程模式 这个模下我们可以先 dbm-agent 发送 http 请求来要求它完成相应的动作，另外后台线程也会定时上报一些监控信息到管理中心。
二：命令行模式 dbm-agent 除了以 http 方式来暴露功能外，还提供了相应的命令工具，真正做来最小化依赖拿来就用。
1. 安装 dbm-agent
pip3 install dbm-agent如果你是在国内，推荐使用腾讯云的源对 pip 安装进行加速，配置也非常简单一行命令搞定
pip3 config set global.index-url https://mirrors.cloud.tencent.com/pypi/simple2. 初始化
sudo su
dbma-cli-init --net-card=eth0 --dbm-center-url-prefix=https://127.0.0.1
# 检查有没有 init 成功
tree /usr/local/dbm-agent/
/usr/local/dbm-agent/
├── etc
│ ├── dbm-agent.json
│ └── templates
│ ├── mysql-8.0.30.cnf.jinja
│ ├── mysql-8.0.31.cnf.jinja
│ ├── mysql-8.0-init-only.jinja
│ ├── mysqld.service.jinja
├── logs
└── pkgs
└── mysql-8.0.31-linux-glibc2.12-x86_64.tar.xz3. 启动 不执行启动的话就用不了 http 接口，只能使用命令行工具。
dbm-agent start4. 检查 dbm-agent 进程在不在
ps -ef | grep dbm-agent
dbma 3520 1 0 16:02 ? 00:00:00 /usr/local/python/bin/python3.11 /usr/local/python/bin/dbm-agent start
root 3556 3273 0 16:02 pts/4 00:00:00 grep --color=auto dbm-agent5. 检查 http 服务是否正常
curl http://127.0.0.1:8086/apis/dbm-agent 2>/dev/null | jq
{
"name": "dbm-agent",
"version": "8.31.9"
}MySQL 目前支持的功能列表如下
| 功能名 | 详细文档 |
|---|---|
| MySQL单机&主从安装配置 | 安装配置-MySQL |
| MySQL备份 | 备份-MySQL |
| MySQL卸载 | 卸载-MySQL |
| MySQL清理 | 清理-MySQL |
| MySQLMGR | 开发中 |
| 高可用 | 开发中 |
Redis 目前支持的功能列表如下
| 功能名 | 详细文档 |
|---|---|
| Redis-master-安装 | Redis-master-安装 |
| Redis-replica-安装 | Redis-replica-安装 |
关闭 dbm-agent 守护进程
dbm-agent stop
Successful exitdbm-agent 在实现上遵守的规范
| 规范ID | 规范内容 |
|---|---|
| dbm-agent 工作目录位置 | /usr/local/dbm-agent |
| mysql 配置文件保存的位置 | /etc/my-{port}.cnf |
| systemd 配置文件保存的位置 | /usr/lib/systemd/system/mysqld-{port}.service |
| 数据目录 | /database/mysql/data/{port} |
| 备份目录 | /backup/mysql/{port} |
| binlog目录 | /binlog/mysql/binlog/{port} |
| 默认密码 | dbma@0352 |
| MySQL 安装目录 | /usr/local/ |
| MySQL-shell 安装目录 | /usr/local/ |
为了尽可能的减少 BUG ，我们尽全力把单元测试的覆盖率推向 100%，目前来看只达到了 87%
# 单元测试用到的依赖
# pip3 install pytest pytest-mock pytest-cov
# 运行单元测试
pytest --cov
... ... ... ... ...
---------- coverage: platform linux, python 3.11.3-final-0 -----------
Name Stmts Miss Cover
--------------------------------------------------------------------
dbma/__init__.py 0 0 100%
dbma/bil/__init__.py 1 0 100%
dbma/bil/cmdexecutor.py 6 0 100%
dbma/bil/daemon.py 66 36 45%
dbma/bil/fs.py 56 25 55%
dbma/bil/fun.py 4 0 100%
dbma/bil/net.py 12 1 92%
dbma/bil/osuser.py 139 0 100%
dbma/bil/sudos.py 12 0 100%
dbma/components/__init__.py 0 0 100%
dbma/components/mysql/__init__.py 0 0 100%
dbma/components/mysql/asserts.py 24 1 96%
dbma/components/mysql/backends/__init__.py 0 0 100%
dbma/components/mysql/backends/clears.py 119 31 74%
dbma/components/mysql/commons.py 137 73 47%
dbma/components/mysql/config.py 387 116 70%
dbma/components/mysql/exceptions.py 16 0 100%
dbma/components/mysql/install.py 194 19 90%
dbma/components/orchestrator/__init__.py 0 0 100%
dbma/components/orchestrator/exceptions.py 6 0 100%
dbma/components/orchestrator/install.py 40 22 45%
dbma/core/__init__.py 0 0 100%
dbma/core/configs.py 78 14 82%
dbma/core/exception.py 13 0 100%
dbma/core/messages.py 13 0 100%
dbma/core/threads/__init__.py 0 0 100%
dbma/core/threads/backends.py 31 16 48%
dbma/version.py 7 0 100%
--------------------------------------------------------------------
TOTAL 2180 361 83%# 生成 tar.gz 格式的安装包
cd dbm-agent
python3 setup.py sdist
# 执行安装
cd dist
pip3 install ./dbm-agent-8.33.10.tar.gz
目前 MySQL 支持如下这些版本，子版本的话推荐使用最新版本；因为每一个新版本出来的时候都会用它来测试下，老版本就不会再测试了。
- 8.0.x
- 8.3.x