SuperAPI AI 工具集

rhdh-plugin-export

部署与运维

查看项目

更新于 10-16 02:28

技能介绍

用途:把正在开发的 Backstage 插件从源码转成 Red Hat Developer Hub(RHDH)可部署的动态插件产物,介于“能跑通的源码”与“可部署产物”之间。仅处理本机自身工作区中的插件导出,不负责修复 overlay 仓库的 CI 导出(那属于 /rhdh-overlay)。

前置检查:在插件目录执行 yarn build 与 yarn tsc 确认可构建;查看 package.json 中的插件角色、名称、版本;后端插件需确认 src/index.ts 有默认导出。运行前先决定目标格式:OCI 镜像、tgz 归档或 npm 包。

主要能力与用法:通用路径由附带脚本完成,例如 python scripts/export-plugin.py --plugin-dir plugins/my-plugin --tag quay.io/ns/my-plugin:v0.1.0 --push --clean,可用 --help 查看完整选项。脚本默认值不适用时,按 references/export.md 逐步执行;依赖策略(shared、embedded、bundled)见 references/export-options.md;各打包格式对比见 references/packaging-formats.md;完整性值生成与校验见 references/integrity-hashes.md;完整部署配置示例见 examples/dynamic-plugins.yaml。

边界与限制:本技能只产出产物,不写插件源码、不生成部署配置、不运行 RHDH。插件源码问题归 /rhdh-plugin-authoring;消费该产物的 dynamic-plugins.yaml 配置归 /rhdh-plugin-wiring;将产物装入本地运行的 RHDH 归 /rhdh-local;overlay 仓库与 Extensions Catalog 归 /rhdh-overlay。不要臆造仓库引用,包名、tag 与 digest 须来自导出输出和仓库响应;推送注册表属于外部写入,需按 mutation-gate 技能执行,目标为确切的注册表、仓库与 tag;部署需要稳定产物时优先使用 digest。完成后需报告所执行的导出命令、产物格式及确切引用或路径、shared 与 embedded 依赖决策、生成的完整性值、是否推送及目标位置,以及下一步应调用的技能。