用途:为 RHDH(企业级 Backstage 应用)创建可动态安装、卸载而无需重建应用的后端动态插件,适用于新建后端 API 插件、已有插件的后端模块(如 catalog-backend-module-*)、Scaffolder 动作与模板、Catalog 处理器与提供者、认证模块等服务器端功能。不适用于前端插件、前端接线(挂载点、动态路由)、主题或前端定制。
主要能力与流程:先确定目标 RHDH 版本并查阅版本兼容矩阵;用脚手架脚本生成 Backstage 应用与插件,运行 python scripts/scaffold.py --rhdh-version 1.9 --plugin-id my-plugin(可用 --help 查看全部选项);插件必须基于新后端系统,入口用 createBackendPlugin() 或 createBackendModule() 并以 default 导出,随后 yarn build 验证;接着用 npx @red-hat-developer-hub/cli@latest plugin export 导出,再用 plugin package 打包并推送,例如 npx @red-hat-developer-hub/cli@latest plugin package --tag quay.io/<namespace>/<plugin-name>:v0.1.0 与 podman push。最后在 dynamic-plugins.yaml 中配置,本地测试可复制 dist-dynamic 到 RHDH 的 dynamic-plugins-root。
前置条件:Node.js 22+ 与 Yarn、容器运行时(podman 或 docker)、可访问容器镜像仓库(如 quay.io)。限制与常见问题:插件不加载时检查是否使用新后端系统、是否 default 导出、版本是否兼容;依赖冲突可用 --shared-package 排除、--embed-package 打包;构建失败先运行 yarn tsc。发布、价格等信息暂未提供。