Backstage 软件模板创作台
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/backstage-software-template-composer。
技能介绍
解决的问题
在 Backstage 里新增一个软件模板,要同时写 Scaffolder 的步骤配置、处理模板文件拉取、发布目标仓库,以及目录注册。任何一个环节遗漏,模板就会“看起来能点,实际跑不通”或者目录里缺少对应实体。
工作机制
- 以
template.yaml作为单一入口,集中描述模板输入、输出和 Scaffolder 执行步骤 - 内置三类操作:
fetch:template拉取模板文件,publish:github发布到 GitHub 仓库,catalog:register把新组件注册进 Backstage 目录 - 通过 Backstage REST API 管理目录条目,避免手动维护
catalog-info.yaml
适用边界
- 适合标准 Backstage 实例;如果 Scaffolder 后端被深度定制,预置步骤可能需要调整
publish:github假设目标托管在 GitHub,换到其他平台要替换该步骤- 只定义模板的元数据与流程,不生成模板内部的具体业务代码
使用场景
- 在初始化 Backstage 项目时,需要快速生成符合规范的 template.yaml 配置,并通过 Scaffolder 步骤生成新服务模板
- 需要将新开发的工具项目发布到 GitHub 仓库,并自动将组件元数据注册到 Backstage 软件目录中
- 在配置 Scaffolder 时,需要处理模板文件拉取、目标仓库发布和目录注册的完整流水线,避免遗漏关键步骤
- 通过 Backstage REST API 管理软件目录条目,自动同步 catalog-info.yaml,减少手动维护的繁琐流程
适合人员
- 负责维护 Backstage 平台的 DevOps 工程师,需要快速创建标准化服务模板并确保目录数据准确
- 参与云原生项目脚手架设计的开发者,需要集成 Scaffolder 操作并实现自动化发布流程
- 管理团队 Backstage 目录的技术负责人,需要通过 API 高效管理组件元数据并保持目录一致性
- 正在搭建内部开发者平台的工程师,需要减少模板配置中的错误并加速从代码生成到注册的全链路