用途:在本地运行并管理 Red Hat Developer Hub(RHDH)环境,配合 rhdh-local-setup 定制系统完成动态插件的启用、禁用、配置应用与端到端验证,并把执行证据返回给调用方工作流。所有命令使用该技能自带的独立 CLI,无需安装其他技能。
主要能力:通过 uv run scripts/rhdh-local --help 查看能力;用 --json status 查看状态、plugins list 查看已启用包、apply 应用定制、up/down 启停、health 检查健康、backup 备份、restore <archive> 恢复(默认 dry run,需 --force 才实际执行)。可用 python3 scripts/fetch-plugin-metadata.py <plugin-name> --branch <branch-or-tag> --json 读取指定分支或标签的插件版本或制品,默认 ref 为 main。
使用方式:通过 RHDH_LOCAL_SETUP_DIR 或从当前目录向上查找定位 rhdh-local-setup;若缺失,需说明所需环境变量或检出布局并停止运行时分支。按结果路由到对应工作流文档,如 enable-plugin.md、disable-plugin.md、switch-mode.md、test-plugin.md,以及 troubleshooting.md、env-reference.md。
限制与约束:不得把 .env 中的密钥读入对话上下文,只询问缺失的变量名。仅编辑 rhdh-customizations/ 下的源文件,每次编辑后运行 apply 以同步 rhdh-local/ 下的副本。启用 Lightspeed 或 Orchestrator 时须使用本 CLI 的 up/down 管理 compose 生命周期与共享网络。包引用须来自 spec.dynamicArtifact 或调用方提供的引用,不得按命名约定构造 OCI 引用。保留动态插件覆盖中的 includes: 块,后端包放在前端包之前。插件测试仅在记录安装、启动、健康与 UI 结果后才算成功,并需区分预期凭据错误与加载失败。调用方需提供要启用的包引用、所需环境变量名、目录测试实体、要运行的检查项及是否清理。报告需包含测试对象与模式、每项检查结果、实际启用的包引用、日志摘录及清理状态。