蓝盾流水线管理
通过 MCP 工具 devops-prod-pipeline 管理蓝盾流水线构建。
核心概念
-
projectId:项目英文名(如 myproject )
-
pipelineId:流水线 ID,以 p- 开头(如 p-abc123 )
-
buildId:构建 ID,以 b- 开头(如 b-xyz789 )
重要规则
启动构建前必须获得用户确认:在调用 v4_user_build_start 之前,必须向用户展示完整的构建入参并获得明确确认。未经用户确认,禁止执行构建操作。
常用工作流
- 启动构建
步骤 1:获取启动参数 → devops-prod-pipeline:v4_user_build_startInfo 步骤 2:向用户展示构建参数,等待用户确认 ⚠️ 必须执行 步骤 3:用户确认后启动构建 → devops-prod-pipeline:v4_user_build_start 步骤 4:查看状态 → devops-prod-pipeline:v4_user_build_status
步骤 2 确认模板:
即将启动构建,请确认以下参数:
- 项目:{projectId}
- 流水线:{pipelineId}
- 构建参数: {列出所有 body_param 的 key-value}
是否确认启动?
- 查询构建历史
使用 devops-prod-pipeline:v4_user_build_list 获取历史记录。
常用流水线
用户配置的常用流水线,参阅 config.json
URL 解析规则:从 https://xxxxxx/console/pipeline/{projectId}/{pipelineId} 提取:
-
projectId :/pipeline/ 后的第一段
-
pipelineId :以 p- 开头的最后一段
工具参考
获取构建历史:参阅 reference/build-list.md 获取启动参数:参阅 reference/build-startinfo.md 查看构建状态:参阅 reference/build-status.md 启动构建:参阅 reference/build-start.md
快速示例
查询最近构建
{ "path_param": { "projectId": "your-project" }, "query_param": { "pipelineId": "p-xxx", "page": 1, "pageSize": 10 } }
启动一次构建
{ "path_param": { "projectId": "your-project" }, "query_param": { "pipelineId": "p-xxx" }, "body_param": { "branch": "master" } }
构建状态枚举
状态 说明
SUCCEED 成功
FAILED 失败
CANCELED 已取消
RUNNING 运行中
QUEUE 排队中
STAGE_SUCCESS 阶段成功