DHorse Deploy
ShanNanBean/dhorse-deploy
Automação de build e deploy para aplicações em nuvem com notificações em tempo real
Ver no GitHubFerramenta de automação para compilação e deploy de aplicações em nuvem com suporte a três modos: Hermes Agent, CLI e MCP Server. Oferece deploy em um clique, monitoramento automático, notificações via WeChat corporativo e controle de concorrência para evitar compilações duplicadas.
Instalação
npx convez-ai ShanNanBean/dhorse-deploy1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automatizar pipeline de deploy de múltiplos serviços
- Monitorar status de compilação e disparar deploys automáticos
- Coordenar notificações de deploy para diferentes times (frontend/backend)
- Implementar estratégias de blue-green deployment
Veredito

MCP server robusto para automação de deploy que integra bem com ecossistemas de CI/CD existentes. Funcionalidade sólida de monitoramento e notificações, ideal para equipes que usam DHorse ou plataformas similares em ambiente corporativo.
README
A tradução para o português deste README ainda está na fila.
DHorse Deploy
DHorse 云应用编译部署自动化工具,支持 Hermes Agent、命令行 CLI、MCP Server 三种使用方式。
✨ 功能特性
- 🚀 一键编译部署 - 支持普通部署和蓝绿部署两种模式
- 📦 批量部署 - 支持多个服务并行或顺序编译部署
- 📊 自动监控 - 后台轮询编译状态,编译成功后自动部署
- 📱 企业微信通知 - 编译开始、成功、失败全程通知
- 🔀 多 Webhook 路由 - 前端/后端项目通知发送到不同群聊
- 🔐 并发控制 - 检测正在编译的服务,避免重复触发
- 📝 审计追踪 - 操作人记录,企业微信消息历史可追溯
- 🔌 多平台兼容 - 支持 Hermes Agent、CLI、MCP Server
📋 目录
🚀 快速开始
1. 下载项目
git clone https://github.com/your-username/dhorse-deploy.git
cd dhorse-deploy
2. 配置
编辑 scripts/config.json:
{
"dhorse_url": "http://your-dhorse-host:8100",
"username": "your_username",
"password": "your_password"
}
3. 初始化服务列表
python scripts/init_services.py
自动从 DHorse 获取所有应用和环境信息。
4. 开始使用
# 命令行方式
python cli.py deploy user-service develop --operator Alice
# 或对 Hermes Agent 说
"部署服务的 main 分支,我是Alice"
📥 安装方式
一键安装(推荐)
告诉你的 Agent:
"安装这个 skill: https://github.com/YOUR_USERNAME/dhorse-deploy.git"
Agent 会自动克隆并安装到 skills 目录。
手动安装
Hermes Agent:
# Windows
git clone https://github.com/YOUR_USERNAME/dhorse-deploy.git "%LOCALAPPDATA%\hermes\skills\devops\dhorse-deploy"
# macOS/Linux
git clone https://github.com/YOUR_USERNAME/dhorse-deploy.git ~/.local/share/hermes/skills/devops/dhorse-deploy
其他 Agent:
# 克隆到你的 agent 的 skills 目录
git clone https://github.com/YOUR_USERNAME/dhorse-deploy.git <your-agent-skills-dir>/dhorse-deploy
安装后配置
- 编辑
scripts/config.json,填入你的 DHorse 信息 - 运行
python scripts/init_services.py自动获取服务列表
# 初始化
cd <skill-dir>
python scripts/init_services.py
方式 1: Hermes Agent(推荐)
将 dhorse-deploy 目录复制到 Hermes skills 目录:
Windows:
xcopy /E /I dhorse-deploy %LOCALAPPDATA%\hermes\skills\devops\dhorse-deploy
macOS/Linux:
cp -r dhorse-deploy ~/.local/share/hermes/skills/devops/
方式 2: 独立使用
直接在项目目录使用 CLI 或 MCP Server,无需安装到 Agent。
⚙️ 配置说明
配置文件:scripts/config.json
基础配置
{
"dhorse_url": "http://your-dhorse-host:8100",
"username": "your_username",
"password": "your_password"
}
| 字段 | 说明 | 示例 |
|---|---|---|
dhorse_url | DHorse 平台地址 | http://1.1.1.1:8100 |
username | 登录用户名 | admin |
password | 登录密码(明文,脚本自动转 MD5) | your_password |
Webhook 配置
{
"webhook_url": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YOUR_KEY",
"webhooks": {
"default": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=DEFAULT_KEY",
"web-web-app": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=FRONTEND_KEY"
},
"web-web-app_services": ["web-web-app", "web-mobile-web-app", "operations-web-web-app"]
}
| 字段 | 说明 |
|---|---|
webhook_url | 默认 Webhook 地址(兼容旧配置) |
webhooks.default | 后端项目通知地址 |
webhooks.web-web-app | 前端项目通知地址 |
web-web-app_services | 前端服务列表,匹配的服务通知发到 webhooks.web-web-app |
获取 Webhook 地址:
- 打开企业微信群聊
- 点击右上角
...→ 群机器人 → 添加 - 创建机器人,复制 Webhook 地址
服务配置
{
"services": {
"user-service": {
"normal": {"appId": "1234", "envId": "1234"},
"green": {"appId": "1234", "envId": "1234"}
},
"api-gateway": {
"normal": {"appId": "1234", "envId": "1234"},
"green": {"appId": "1234", "envId": "1234"}
}
},
"default_branch": "main"
}
| 字段 | 说明 |
|---|---|
services | 服务映射表,key 为服务简称 |
services.{name}.normal | 普通部署的 appId 和 envId |
services.{name}.green | 蓝绿部署的 appId 和 envId |
default_branch | 默认分支(用户未指定时使用) |
自动获取服务配置:
python scripts/init_services.py
完整配置示例
{
"dhorse_url": "http://dhorse.example.com:8100",
"username": "deploy_user",
"password": "secure_password",
"webhook_url": "webhook_url",
"webhooks": {
"default": "default_url",
"web-web-app": "web-web-app_url"
},
"web-web-app_services": [
"web-web-app",
"web-mobile-web-app",
"operations-web-web-app",
],
"services": {
"user-service": {
"normal": {"appId": "xxx", "envId": "yyy"},
"green": {"appId": "aaa", "envId": "bbb"}
}
},
"default_branch": "main",
"poll_interval_seconds": 120
}
🎯 使用方式
方式 1: Hermes Agent
安装到 Hermes skills 目录后,直接用自然语言对话:
"部署服务的 main 分支,我是Alice"
"蓝绿部署API网关服务到 main,我是Bob"
"编译 web-web-app 的 develop 分支"
Hermes 会自动:
- 解析服务名、分支、操作人
- 检查是否正在编译
- 触发编译 + 发送通知
- 后台监控编译状态
- 编译成功后自动部署
- 发送完成通知
方式 2: 命令行 CLI
部署单个服务
# 普通部署
python cli.py deploy api-gateway main --operator Alice
# 蓝绿部署
python cli.py deploy api-gateway main --mode green --operator Bob
# 指定 Webhook
python cli.py deploy auth-service develop --operator Charlie --webhook "https://..."
# 不等待编译完成
python cli.py deploy web-web-app main --operator David --no-wait
# 强制部署(即使正在编译)
python cli.py deploy web-web-app main --operator Alice --force
参数说明:
| 参数 | 说明 | 必填 | 默认值 |
|---|---|---|---|
service | 服务名称 | ✅ | - |
branch | 分支名称 | ✅ | - |
--operator | 操作人姓名 | ❌ | unknown |
--mode | 部署模式:normal 或 green | ❌ | normal |
--webhook | Webhook 地址 | ❌ | 使用配置 |
--no-wait | 不等待编译完成 | ❌ | false |
--force | 强制部署 | ❌ | false |
批量部署
- 创建批量配置文件
batch.json:
{
"operator": "Alice",
"branch": "main",
"mode": "normal",
"webhook": "webhook_url",
"tasks": [
{"service": "api-gateway"},
{"service": "auth-service"},
{"service": "api-gateway", "mode": "green"},
{"service": "auth-service"}
]
}
- 执行批量部署:
# 并行部署(同时触发所有)
python cli.py batch batch.json --parallel
# 顺序部署(前一个成功后再下一个)
python cli.py batch batch.json --sequential
批量配置说明:
| 字段 | 说明 | 必填 |
|---|---|---|
operator | 操作人 | ✅ |
branch | 分支(所有服务共用) | ✅ |
mode | 默认部署模式 | ❌ |
webhook | Webhook 地址 | ❌ |
tasks | 服务列表 | ✅ |
tasks[].service | 服务名称 | ✅ |
tasks[].mode | 单独指定部署模式 | ❌ |
查看状态
# 查看服务编译状态
python cli.py status auth-service
# 列出所有服务
python cli.py list
初始化服务列表
python cli.py init
# 或
python scripts/init_services.py
方式 3: MCP Server
适用于支持 MCP 协议的 Agent(Claude Desktop, Cursor, Continue, Cline 等)。
启动 MCP Server
python mcp_server.py
Claude Desktop 配置
编辑 ~/Library/Application Support/Claude/claude_desktop_config.json(macOS)或
%APPDATA%\Claude\claude_desktop_config.json(Windows):
{
"mcpServers": {
"dhorse-deploy": {
"command": "python",
"args": ["/path/to/dhorse-deploy/mcp_server.py"]
}
}
}
Cursor 配置
在 .cursor/mcp.json 中添加:
{
"mcpServers": {
"dhorse-deploy": {
"command": "python",
"args": ["/path/to/dhorse-deploy/mcp_server.py"]
}
}
}
可用工具
| 工具 | 说明 | 参数 |
|---|---|---|
dhorse_list_services | 列出所有服务 | 无 |
dhorse_deploy | 部署单个服务 | service, branch, operator, mode?, wait? |
dhorse_batch_deploy | 批量部署 | services[], branch, operator, parallel? |
dhorse_status | 查看状态 | service |
MCP 工具调用示例:
{
"name": "dhorse_deploy",
"arguments": {
"service": "auth-service",
"branch": "main",
"operator": "Alice",
"mode": "normal",
"wait": true
}
}
🔥 高级功能
1. 自动监控部署
编译触发后,系统自动设置 cronjob 监控编译状态:
# 手动运行监控脚本
python scripts/monitor.py <appId> <envId> <service> <branch> <operator> [webhook]
监控脚本会:
- 每 2 分钟检查编译状态
- 编译成功 → 自动部署 + 发送成功通知
- 编译失败 → 发送失败通知
- 编译中 → 静默等待
2. Webhook 通知模板
编译开始:
🚀 编译部署通知
> 操作人: Alice
> 服务名: auth-service
> 分 支: main
> 模 式: 普通部署
> 时 间: 2024-01-15 14:30:00
> 状 态: 编译中...
部署成功:
✅ 部署成功
> 操作人: Alice
> 服务名: auth-service
> 分 支: main
> 版 本: v20240115_143000
> 状 态: 已部署到测试环境
部署失败:
❌ 部署失败
> 操作人: Alice
> 服务名: auth-service
> 分 支: main
> 请登录 DHorse 平台查看详情
3. 操作人记录
首次使用时,Hermes 会询问操作人姓名并保存到 memory:
用户偏好: dhorse 部署操作人姓名 = Alice
后续自动使用,无需重复输入。
4. 审计追踪
所有部署记录可通过以下方式追溯:
- 企业微信群聊 - 消息历史完整记录
- Hermes session_search - 查询历史部署会话
- DHorse 平台 - 部署历史页面
📚 API 文档
认证机制
POST /sysUser/auth-service
Content-Type: application/json
{
"auth-serviceSource": 1,
"auth-serviceName": "admin",
"password": "MD5_UPPER_32_CHARS"
}
Response:
{
"code": "000000",
"data": {
"lastLoginToken": "xxx"
}
}
后续请求:Cookie auth-service_token=<token>
响应码
| Code | 说明 |
|---|---|
000000 | 成功 |
200000 | 业务错误 |
300000 | 未登录/Token 失效 |
核心接口
| 接口 | 方法 | 说明 |
|---|---|---|
/app/search | POST | 搜索应用列表 |
/app/env/search | POST | 搜索环境列表 |
/app/branch/search | POST | 搜索分支列表 |
/app/branch/buildVersion | POST | 普通编译 |
/app/branch/buildVersionWithClusterMode | POST | 蓝绿编译 |
/app/deployment/version/page | POST | 查询版本列表 |
/app/deployment/version/submitToDeploy | POST | 部署版本 |
详细 API 文档见 references/api.md
❓ 常见问题
Q: 如何获取 appId 和 envId?
运行初始化脚本自动获取:
python scripts/init_services.py
或手动查询:
python cli.py list
Q: 编译成功后为什么没有自动部署?
- 检查 cronjob 是否正常运行
- 确认
monitor.py脚本可以正常执行 - 检查 DHorse 登录是否过期
Q: 如何修改 Webhook 通知模板?
编辑 scripts/notify.py 中的模板内容。
Q: 支持哪些 DHorse 版本?
支持 DHorse v1.6.x 及以上版本。
Q: 如何同时部署多个服务?
使用批量部署功能:
python cli.py batch batch.json --parallel
Q: 企业微信通知收不到?
- 检查 Webhook 地址是否正确
- 确认机器人未被移除
- 检查网络连接
📁 文件结构
dhorse-deploy/
├── cli.py # 命令行工具(独立可用)
├── mcp_server.py # MCP Server(兼容所有 MCP Agent)
├── SKILL.md # Hermes Skill 文档
├── README.md # 本文件
├── scripts/
│ ├── config.json # 配置文件(需填写)
│ ├── dhorse_deploy.py # DHorse API 封装
│ ├── monitor.py # 监控+自动部署脚本
│ ├── notify.py # 企业微信通知
│ ├── batch_deploy.py # 批量部署
│ └── init_services.py # 服务列表初始化
└── references/
└── api.md # API 参考文档
📄 License
MIT License
🤝 贡献
欢迎提交 Issue 和 Pull Request!
📧 联系方式
如有问题,请提交 Issue 或联系维护者。