金色时刻 · 15:48
让好资源,触手可及
AGENT SKILL

47-managing-devops-pipeline

47-managing-devops-pipeline 是面向开发运维的 Agent Skill,来自 TencentBlueKing/bk-ci。查看技能说明、操作步骤与使用约定,并通过原项目了解详细用法。

管理蓝盾流水线的构建操作,包括查询构建历史、获取启动参数、查看构建状态、启动构建。当用户提及流水线、构建、部署、CI/CD、蓝盾或需要触发构建任务时使用。

SKILL.md

下载 MD ↓
name47-managing-devops-pipeline
description管理蓝盾流水线的构建操作,包括查询构建历史、获取启动参数、查看构建状态、启动构建。当用户提及流水线、构建、部署、CI/CD、蓝盾或需要触发构建任务时使用。

蓝盾流水线管理

通过 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://xxx/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 阶段成功

来源:TencentBlueKing/bk-ci · MIT 许可 · 许可原文 · MD 为来源页保存的历史版本