prow-trigger-nightly

用途

该技能用于按需触发 RHDH（Red Hat Developer Hub）的 nightly ProwJob，调用 OpenShift CI Gangway REST API 完成触发。适用于希望手动运行夜间端到端（e2e）任务的场景，例如 RC 或 GA 版本验证。

支持两类仓库：

rhdh：主 RHDH 应用（periodic-ci-redhat-developer-rhdh-*-nightly）
rhdh-plugin-export-overlays：插件导出叠加仓库（periodic-ci-redhat-developer-rhdh-plugin-export-overlays-*-nightly）

前置条件

Python 3.9+
已安装 oc CLI（用于 OpenShift CI 身份认证）

脚本位置为技能目录下的相对路径：skills/prow-trigger-nightly/scripts/trigger_nightly_job.py

主要能力与使用方式

整体流程分为三步：

获取任务并选择：运行 uv run scripts/trigger_nightly_job.py --list 列出已配置的 nightly 任务，以表格呈现短名称与包含该任务的分支。用户可用自然语言描述所需任务与分支；未提及分支时默认 main。支持的自然语言映射包括 ocp helm、operator、helm upgrade、auth providers、版本号（如 4.17 / 4.19 / 4.20 / 4.21）、aks helm、aks operator、eks helm、eks operator、gke helm、gke operator、osd gcp 等，以及 overlay 相关任务。也可指定多个任务（如“all AKS jobs”“all Operator jobs on main”）按顺序触发。

特殊约束：GKE 与 OSD-GCP 各自共享单一集群，同一平台不可同时运行两个任务，触发前脚本会警告。

选项设置：

overlay 仓库任务支持 fork 覆盖（--org、--repo、--branch）、catalog 索引覆盖（--catalog-index-image）、Playwright 版本覆盖（--playwright-version）；不支持镜像覆盖（--image-registry、--image-repo、--tag）、--chart-version、--send-alerts，若传入这些参数脚本会报错。
RHDH 仓库任务以下选项统一呈现，用户按编号多选：镜像覆盖（默认镜像 / 仅自定义 tag / 自定义 repo+tag / 完全自定义镜像）、catalog 索引镜像、Helm chart 版本、fork 覆盖、发送 Slack 告警。约束：--image-repo 需要同时提供 --tag，而 --tag 可单独使用；--playwright-version 仅限 overlay 任务。

若选择 quay.io 仓库的 tag 选项，可获取可用 tag 并以编号呈现；release-* 分支会据 release- 前缀推导 --tag-filter，main 分支省略该参数以显示全部版本。可使用 --image-repo 指定其他镜像仓库（默认 rhdh/rhdh-hub-rhel9）。非 quay 仓库需手动填写 registry、repo 与 tag。

确认与执行：展示完整命令，提供执行、修改参数或 dry-run 选项。执行后展示 API 响应；若返回任务 URL 或 ID 会显著展示。出错时协助诊断（常见问题：token 过期、任务名无效）。

命令示例（RC 验证）： uv run scripts/trigger_nightly_job.py
--job periodic-ci-redhat-developer-rhdh-main-e2e-ocp-helm-nightly
--image-repo rhdh/rhdh-hub-rhel9 --tag 1.9-227
--catalog-index-image quay.io/rhdh/plugin-catalog-index:1.9
--chart-version 1.9-227-CI

命令示例（GA 验证）： uv run scripts/trigger_nightly_job.py
--job periodic-ci-redhat-developer-rhdh-main-e2e-ocp-helm-nightly
--image-registry registry.redhat.io --image-repo rhdh/rhdh-hub-rhel9 --tag 1.9.4
--catalog-index-image registry.access.redhat.com/rhdh/plugin-catalog-index:1.9.4

脚本参数

-j/--job、-l/--list、-T/--list-tags、--tag-filter、-I/--image-registry、-q/--image-repo、-t/--tag、--catalog-index-image、--chart-version、--playwright-version、-o/--org、-r/--repo、-b/--branch、-S/--send-alerts、-n/--dry-run、--json

其他说明

脚本使用独立 kubeconfig（~/.config/openshift-ci/kubeconfig），不会干扰当前集群上下文；如需认证会打开浏览器进行 SSO 登录。

限制

价格、收费与平台支持范围等未在资料中提供。

技能介绍

用途

前置条件

主要能力与使用方式

脚本参数

其他说明

限制