rhdh-prow-jobs

RHDH Prow test entries and cluster pools

Read and change which platform versions RHDH is tested on in openshift/release. Listing and coverage analysis work against the remote repository through gh; generation and removal need a local checkout because they end in make update.

Run the bundled scripts instead of reconstructing their YAML logic. Every script accepts --repo-dir to point at a local openshift/release checkout and falls back to the GitHub API when it is absent.

Route

Intent	Load
List OCP test entries, or add/remove one	workflows/ocp-jobs.md
List, generate, or delete a Hive ClusterPool	workflows/ocp-pools.md
Find OCP coverage gaps and stale configuration	workflows/ocp-coverage.md
List AKS, EKS, or GKE entries, or bump their K8s version	workflows/k8s-jobs.md

Load only the selected workflow.

Scope

This skill owns individual test entries and cluster pools on branches that already exist. Creating or retiring the whole set of jobs for a release branch — the branch config file, its generated jobs, and its branch-protection block — is /rhdh-prow-release-branch. Running a configured job on demand is /rhdh-prow-trigger.

Composition

For whether a platform version is still supported, invoke /rhdh-platform-lifecycle by name and use what it returns. Do not import its Python package or read its files. scripts/analyze_coverage.py queries the lifecycle APIs directly so the scripts stay standalone.

Reading rules

• Report only versions that came from the read, never from recall. Say which config source was read and when.
• Extract OCP versions from cluster_claim.version, not from test names — some OCP-targeted tests do not encode the version in their name.
• A version that is configured is not the same as a version that is supported. Without lifecycle facts, name the platforms that remain unclassified rather than presenting configured versions as supported.

Writing rules

Generating a file, editing a config, running make update, committing, pushing, or opening a pull request is a write. Follow /mutation-gate, naming the config file or job file as the target of each operation.

• Use --dry-run on generate_cluster_pool.py to preview before writing.
• generate_test_entry.py prints a block for review; inserting it is a separate approved edit.
• Run make update after any config change, and commit the config and the generated job files together.
• Removing an OCP version means both its test entries on every product branch and its cluster pool. Check for the other half before declaring the removal finished.

Completion

A read is complete when the answer names the config source it was read from, every entry, pool, or gap in it came from that read, and anything the scan could not reach is named as unread instead of reported as absent.

A write is complete when every approved file edit has been applied and reported, make update has run, the regenerated job files under ci-operator/jobs/redhat-developer/rhdh/ are named alongside the config change, and the push and pull-request state is stated explicitly — including "not pushed" when nothing was pushed. A removal is complete only once both the test entries and the cluster pool for that version are accounted for.