rhdh-prow-trigger

触发 RHDH nightly ProwJob

执行一个已在 openshift/release 中配置的作业。此技能绝不会修改 CI 配置：更改现有作业的方式是，测试条目和池使用 /rhdh-prow-jobs，发布分支的整套作业使用 /rhdh-prow-release-branch。

路由

加载 workflows/trigger-nightly.md。其中介绍了如何列出作业、将自然语言请求映射为完整作业名称、覆盖选项以及执行作业。

身份验证

scripts/trigger_nightly_job.py 使用专用 kubeconfig：~/.config/openshift-ci/kubeconfig，因此绝不会影响用户当前的集群上下文。它使用现有的 oc 会话，绝不会执行登录。

实时提交和 --status 需要该会话。如果缺少 oc、找不到专用 kubeconfig，或会话已过期，请停止并告知用户运行 /setup-rhdh-skills openshift-ci。登录由 Setup 负责，此技能不负责。离线预览和公开的作业／标签列表无需身份验证。

公开脚本只向 scripts/gangway_adapter.py 传递 kubeconfig 路径和请求负载。只有该适配器会获取临时凭据并对请求进行身份验证，然后返回不含凭据的响应数据。不要让令牌出现在参数、输出或任何反馈给用户的内容中。

执行规则

触发作业属于外部写入操作；--dry-run、--list、--list-tags 和 --status 则不属于。遵循 /mutation-gate，并将完整作业名称作为目标。

• 先使用 --dry-run 预览。它会离线验证受支持的 nightly 名称和标志，然后打印适配器请求；此过程不会访问凭据、创建配置或发起网络请求。它不会验证作业、镜像或 chart 是否存在。实时提交会检查所属仓库中配置的作业列表；如果无法验证其是否在列表中，则停止。仅在紧急情况下使用 --skip-job-check 绕过此检查。
• 预览内容包括完整命令、参数、资源影响、未知成本、中止指南、失败行为和验证步骤。在写入审批环节使用预览；在未使用 --dry-run 执行前，必须先获得明确批准。
• GKE 和 OSD-GCP 各自共用一个集群。同一平台上有作业正在运行时，绝不要再启动第二个作业；触发任一平台的作业前，先警告用户。
• 获准检查或执行 dry run，不代表获准执行。请再次征求批准。
• --image-repo 必须与 --tag 一起使用；--tag 可单独使用。--playwright-version 仅适用于 overlay。overlay 作业不接受镜像、chart 和告警覆盖选项。

完成条件

触发操作完成后，必须准确显示实际执行的命令，报告 Gangway API 响应，并醒目注明运行 URL 或 ID；如果 API 未返回标识符，必须明确说明这一点，不能含糊带过。dry run 完成后，必须显示打印出的请求，并明确说明未执行任何操作。失败处理完成后，必须报告错误及可能的原因；常见原因是身份验证已过期。如果问题出在会话上，应引导用户运行 /setup-rhdh-skills openshift-ci。以上内容中不得出现任何凭据。