convez.ai
MCP ServerDevOps & InfraestruturaIntermediário
ShanNanBean

DHorse Deploy

ShanNanBean/dhorse-deploy

Automação de build e deploy para aplicações em nuvem com notificações em tempo real

Ver no GitHub
InicialPluginScore · de 0 a 100

Ferramenta 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-deploy

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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 三种使用方式。

Python 3.6+ License: MIT No Dependencies

✨ 功能特性

  • 🚀 一键编译部署 - 支持普通部署和蓝绿部署两种模式
  • 📦 批量部署 - 支持多个服务并行或顺序编译部署
  • 📊 自动监控 - 后台轮询编译状态,编译成功后自动部署
  • 📱 企业微信通知 - 编译开始、成功、失败全程通知
  • 🔀 多 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

安装后配置

  1. 编辑 scripts/config.json,填入你的 DHorse 信息
  2. 运行 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_urlDHorse 平台地址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 地址:

  1. 打开企业微信群聊
  2. 点击右上角 ... → 群机器人 → 添加
  3. 创建机器人,复制 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 会自动:

  1. 解析服务名、分支、操作人
  2. 检查是否正在编译
  3. 触发编译 + 发送通知
  4. 后台监控编译状态
  5. 编译成功后自动部署
  6. 发送完成通知

方式 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
--webhookWebhook 地址❌使用配置
--no-wait不等待编译完成❌false
--force强制部署❌false

批量部署

  1. 创建批量配置文件 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"}
  ]
}
  1. 执行批量部署:
# 并行部署(同时触发所有)
python cli.py batch batch.json --parallel

# 顺序部署(前一个成功后再下一个)
python cli.py batch batch.json --sequential

批量配置说明:

字段说明必填
operator操作人✅
branch分支(所有服务共用)✅
mode默认部署模式❌
webhookWebhook 地址❌
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. 审计追踪

所有部署记录可通过以下方式追溯:

  1. 企业微信群聊 - 消息历史完整记录
  2. Hermes session_search - 查询历史部署会话
  3. 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/searchPOST搜索应用列表
/app/env/searchPOST搜索环境列表
/app/branch/searchPOST搜索分支列表
/app/branch/buildVersionPOST普通编译
/app/branch/buildVersionWithClusterModePOST蓝绿编译
/app/deployment/version/pagePOST查询版本列表
/app/deployment/version/submitToDeployPOST部署版本

详细 API 文档见 references/api.md

❓ 常见问题

Q: 如何获取 appId 和 envId?

运行初始化脚本自动获取:

python scripts/init_services.py

或手动查询:

python cli.py list

Q: 编译成功后为什么没有自动部署?

  1. 检查 cronjob 是否正常运行
  2. 确认 monitor.py 脚本可以正常执行
  3. 检查 DHorse 登录是否过期

Q: 如何修改 Webhook 通知模板?

编辑 scripts/notify.py 中的模板内容。

Q: 支持哪些 DHorse 版本?

支持 DHorse v1.6.x 及以上版本。

Q: 如何同时部署多个服务?

使用批量部署功能:

python cli.py batch batch.json --parallel

Q: 企业微信通知收不到?

  1. 检查 Webhook 地址是否正确
  2. 确认机器人未被移除
  3. 检查网络连接

📁 文件结构

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 或联系维护者。

Ver o original no GitHub

Bom para

Relacionados