Rhdh Prow Trigger

---
name: rhdh-prow-trigger
description: >-
  Runs an RHDH nightly ProwJob on demand through the OpenShift CI Gangway REST
  API, for `periodic-ci-redhat-developer-rhdh-*-nightly` and
  `periodic-ci-redhat-developer-rhdh-plugin-export-overlays-*-nightly` jobs, with
  optional image registry/repo/tag, catalog-index, Helm chart, Playwright, fork,
  and Slack-alert overrides. Use for "trigger the nightly", "run the e2e job
  now", "kick off the AKS operator job on 1.9", RC or GA image verification runs,
  or listing the available nightly jobs and quay.io tags.
compatibility: "Python 3.9+ and uv; the oc CLI with an existing OpenShift CI session in ~/.config/openshift-ci/kubeconfig."
---

# Trigger an RHDH nightly ProwJob

Execute a job that is already configured in `openshift/release`. This skill never
edits CI configuration: changing which jobs exist is `/rhdh-prow-jobs` for test
entries and pools, and `/rhdh-prow-release-branch` for a release branch's whole
job set.

## Route

Load `workflows/trigger-nightly.md`. It covers listing jobs, mapping a
natural-language request to a full job name, the override options, and execution.

## Authentication

`scripts/trigger_nightly_job.py` uses a dedicated kubeconfig at
`~/.config/openshift-ci/kubeconfig` so it never disturbs the user's current
cluster context. It consumes an existing `oc` session and never performs a login.

When `oc` is missing, the dedicated kubeconfig is absent, or the session has
expired, stop and tell the user to run `/setup-rhdh-skills openshift-ci`. Setup
owns login; this skill does not.

The public script hands `scripts/gangway_adapter.py` only a kubeconfig path and
the request payload. That adapter alone retrieves the transient credential and
authenticates the request, and returns credential-free response data. Keep
tokens out of arguments, output, and anything reported back.

## Execution rules

Triggering a job is an external write; `--dry-run` and `--list` are not. Follow
`/mutation-gate`, with the full job name as the target.

- Preview with `--dry-run` first. It prints the adapter request without
  executing.
- The preview carries the full command, the parameters, what the run will cost
  and touch, and how to abort it. Get explicit approval before running without
  `--dry-run`.
- GKE and OSD-GCP each share one cluster. Never start a second job on the same
  platform while one is running; warn the user before triggering either.
- Approval to inspect or dry-run is not approval to execute. Ask again.
- `--image-repo` requires `--tag`; `--tag` works alone. `--playwright-version` is
  overlay-only. Image, chart, and alert overrides are rejected for overlay jobs.

## Completion

A trigger is complete when the executed command is shown exactly as run, the
Gangway API response is reported, and the run URL or ID is stated prominently —
or, when the API returned no identifier, that absence is stated rather than
implied. A dry run is complete when the printed request is shown and it is clear
that nothing was executed. A failure is complete when the error is reported with
its likely cause, expired authentication being the common one, and the user is
pointed at `/setup-rhdh-skills openshift-ci` when the session is the problem. No
credential appears in any of it.