SuperAPI AI 工具集

bk-cli-devops

部署与运维

查看项目

更新于 10-16 08:45

技能介绍

用途:通过 bk-cli devops 调用蓝盾 DevOps 平台 API。该命令本身只负责分组,没有直接 action,需按需求选择子系统:bk-cli devops <subsystem> <action>。开始前必须先阅读共享 skill ../bk-cli-shared/SKILL.md,认证、context、tenant、stage、dry-run、verbose、header/body 与通用请求规则由其负责,本 skill 只补充 devops 的分组方式、参数语义和常见用法。

主要能力:pipeline 覆盖 get_build_list、get_build_status、get_build_start_info、get_artifactory_list、get_artifactory_user_download_url、get_artifactory_third_party_download_url、get_view_pipelines、start_build、stop_build,用于查询构建历史与状态、获取手动启动参数、查询制品与下载链接、查看 view 下的流水线、启动或停止构建。codecc 覆盖 get_task_detail、get_defect_detail_by_task_id、get_gf_defect_detail_by_task_id、get_pipeline_defect_detail、get_gf_defect_detail、get_pipeline_defect_statistic、get_gf_defect_statistic、get_gf_defect_statistic_by_task_id、get_defect_statistic_by_task_id,用于查看告警明细与统计。stream 覆盖 get_pipelines_list_info、get_name2pipeline_info、get_pipelines_manual_trigger_info、trigger,用于查询和触发 YAML 流水线。

使用方式与易错点:CLI flag 保持上游接口原样,直接传入接口参数名,如 projectId、pipelineId、buildNo、taskId、pageSize、yamlPath。pipeline 子命令的 projectId 是蓝盾项目英文名而非数字 ID;pipelineId 通常为 p- 前缀,buildId 为 b- 前缀。codecc 需先分清入口:有 taskId 按任务查,有 pipelineId 走流水线维度,有 gongfengId 走工蜂开源治理维度;多数明细接口支持 buildId,未传则默认取最新构建,分页参数是 pageNum/pageSize。stream 中 get_pipelines_list_info 使用路径参数 gitProjectId(工蜂项目数字 ID),其余接口的 projectId 为 git_${工蜂项目ID} 固定格式;trigger 必须显式传入完整 JSON --body。start_build 未传 --body 时发送空 JSON 对象 {}。

适用场景:结合“构建、制品、view、启动/停止构建”选 pipeline,结合“CodeCC、告警、缺陷、统计、taskId、gongfengId”选 codecc,结合“Stream、工蜂、YAML 流水线、手动触发、gitProjectId”选 stream。

限制:具体接口字段契约以共享 skill 与上游为准;用户只给零散字段时不应擅自补全缺失字段。