SuperAPI AI 工具集

pipeline-template-module

部署与运维

查看项目

更新于 10-16 09:35

技能介绍

用途:本技能面向 BK-CI 流水线模板的创建与维护、模板实例化与批量实例化、模板更新、版本与草稿发布、分支版本管理、PAC 模板能力、模板权限控制及商店模板集成。当遇到模板复用、模板版本、批量实例化、模板迁移、商店模板或 PAC 模板时优先使用。

不适用:仅修改单条流水线模型结构而不涉及模板抽象;仅 YAML 转换问题而不涉及模板生命周期;仅商店插件或普通流水线执行问题。

主要能力与使用方式:先判断主线,模板基础结构与版本体系参考 reference/1-template-foundation.md;实例化、批量操作、权限参考 reference/2-instance-version-permission.md;PAC 模板与商店集成参考 reference/3-pac-store-integration.md;排查、事件、锁与扩展参考 reference/4-operations-extension.md。需区分 V1 与 V2,新功能判断、复杂版本管理、草稿、PAC 场景通常优先看 V2。模板相比普通流水线多了版本语义、实例关联关系、权限与共享边界、可能的商店分发与 PAC 来源;改动模板结构或版本逻辑时需同时检查模板资源持久化、实例化结果、版本兼容及模板关联流水线的更新影响。PAC 模板、商店模板、项目内模板来源、权限与版本流转不同,不应混为同一心智模型。模板模块负责如何复用与分发流水线定义,pipeline-model-architecture 负责模型本身结构。

限制与陷阱:模板版本与实例版本需区分;批量实例化、批量更新、商店安装会放大模板设计问题,改动前评估实例影响面;PAC 模板同时受模板体系和 YAML 转换体系影响;不要不区分 V1/V2 就改模板逻辑,不要只看模板而忽略已实例化流水线,不要把 PAC 模板问题当普通模板问题或反之,不要混用商店、项目、公共模板的权限与版本心智,模板变更需验证批量实例、版本切换与历史兼容。涉及模型结构再看 pipeline-model-architecture,涉及 YAML/PAC 转换细节再看 yaml-pipeline-transfer。