SuperAPI AI 工具集

export-and-package

设计与创作

查看项目

更新于 10-16 07:27

技能介绍

用途:把已实现并构建成功的 Backstage 插件导出、打包为可部署的 RHDH 动态插件产物,支持 OCI 镜像、tgz 归档和 npm 包三种形式。不适用于创建新插件,新插件需先用后端或前端插件创建技能。

主要能力:用 RHDH CLI 导出动态插件,生成 dist-dynamic/(前端另生成 dist-scalprum/);控制共享依赖(--shared-package)与嵌入包(--embed-package);打包为 OCI 镜像、tgz 或 npm 包;推送到容器或 npm 仓库;将多个插件打包进同一镜像;生成完整性哈希;排查导出与打包问题。

使用方式:先进入插件目录执行 yarn build 与 yarn tsc 确认无错误。常用自动化脚本:python scripts/export-plugin.py --plugin-dir plugins/my-plugin --tag quay.io/ns/my-plugin:v0.1.0 --push --clean,可用 --help 查看 --format tgz、--shared-package、--embed-package、--json 等选项。手动流程为:npx @red-hat-developer-hub/cli@latest plugin export 导出;npx @red-hat-developer-hub/cli@latest plugin package --tag quay.io/<namespace>/<plugin-name>:v0.1.0 打包,可用 --container-tool 指定 podman(默认)、docker 或 buildah;tgz 用 cd dist-dynamic && npm pack,哈希用 npm pack --json | jq -r '.[0].integrity';npm 用 npm publish --registry <地址>;推送用 podman push 或 docker push,私有仓库可设 REGISTRY_AUTH_FILE。

适用场景:生产部署推荐 OCI 镜像;HTTP 分发用 tgz;私有 npm 仓库发布用 npm 包;前后端插件可打包为同一镜像。

限制与前提:需已安装容器运行时,发布 OCI 需可访问容器仓库;后端插件需使用新后端系统并具备默认导出,前端插件需有效 Scalprum 配置;需注意包路径与插件 ID 匹配、版本兼容性及完整性哈希一致。其余细节暂未提供。