managing-devops-pipeline
蓝盾流水线管理
通过 MCP 工具 devops-prod-pipeline 管理蓝盾流水线构建。
核心概念
- projectId:项目英文名(如
myproject) - pipelineId:流水线 ID,以
p-开头(如p-abc123) - buildId:构建 ID,以
b-开头(如b-xyz789)
重要规则
启动构建前必须获得用户确认:在调用 v4_user_build_start 之前,必须向用户展示完整的构建入参并获得明确确认。未经用户确认,禁止执行构建操作。
常用工作流
1. 启动构建
步骤 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}
是否确认启动?
2. 查询构建历史
使用 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 | 阶段成功 |
More from tencentblueking/bk-ci
frontend-vue-development
前端 Vue 开发规范,涵盖 Vue 2/3 组件开发、Vuex 状态管理、路由配置、组件通信、样式规范、国际化。当用户进行前端开发、编写 Vue 组件、处理状态管理或实现页面交互时使用。
146git-commit-specification
Git 提交规范,涵盖 commit message 格式(feat/fix/refactor)、Issue 关联、分支命名、PR 提交准备、rebase 使用。当用户提交代码、编写 commit message、创建分支或准备 PR 时使用。
63design-patterns
BK-CI 项目设计模式实践指南,涵盖工厂模式、策略模式、观察者模式、装饰器模式、模板方法等在项目中的实际应用。当用户学习设计模式、重构代码、设计可扩展架构或理解项目设计时使用。
62backend-microservice-development
后端微服务开发规范,涵盖目录结构、分层架构(API/Service/DAO)、依赖注入、配置管理、Spring Boot 最佳实践。当用户进行后端开发、创建新微服务、编写 Kotlin/Java 代码或设计服务架构时使用。
60database-design
BK-CI 数据库设计规范与表结构指南,涵盖命名规范、字段类型选择、索引设计、分表策略、数据归档。当用户设计数据库表、优化索引、规划分表策略或进行数据库架构设计时使用。
53unit-testing
单元测试编写指南,涵盖 JUnit5/MockK 使用、测试命名规范、Mock 技巧、测试覆盖率要求、TDD 实践。当用户编写单元测试、Mock 依赖、提高测试覆盖率或进行测试驱动开发时使用。
53