| name | rhdh-ocp-coverage |
| description | Analyze RHDH OCP version coverage by cross-referencing cluster pools and CI test configs against both RHDH and OCP lifecycle APIs to find gaps, stale configurations, and compatibility mismatches |
| allowed-tools | Read, Bash(bash *analyze-coverage.sh*) |
RHDH OCP Coverage Analysis
Cross-reference RHDH cluster pools, CI test configurations, RHDH lifecycle data, and OCP lifecycle data to identify coverage gaps and stale configurations.
When to Use
Use this skill when you need to:
- Check if RHDH CI coverage matches the current RHDH-supported OCP versions
- Find OCP versions that RHDH no longer supports but still have active pools or test entries
- Find RHDH-supported OCP versions missing cluster pools or test entries
- Plan OCP version additions or removals for a new RHDH release
Prerequisites
curl, jq, and yq (v4+) must be available- Internet connectivity to reach
https://access.redhat.com
- Working directory must be the root of the
openshift/release repository
CLAUDE_SKILL_DIR is set automatically by the Claude Code skill loader. For manual invocation, set it to this skill's directory (e.g., CLAUDE_SKILL_DIR=ci-operator/config/redhat-developer/rhdh/.claude/skills/rhdh-ocp-coverage)
Usage
Run the bundled analysis script from the repository root:
bash "${CLAUDE_SKILL_DIR}/scripts/analyze-coverage.sh"
Two Dimensions of Support
The analysis checks two independent dimensions for each OCP version:
| Dimension | Source | Meaning |
|---|
| OCP supported | OCP lifecycle API | The OCP version itself is still receiving updates (Full, Maintenance, or EUS) |
| RHDH supported | RHDH lifecycle API (openshift_compatibility field) | RHDH officially supports running on this OCP version |
An OCP version must satisfy both to warrant a cluster pool and test entry:
- An OCP-EOL version should always be removed (regardless of RHDH compatibility)
- An OCP-supported but non-RHDH-supported version should be reviewed (e.g., old EUS versions RHDH has dropped)
How main Branch Is Handled
The main branch targets the next unreleased RHDH version. Since it's unreleased, it doesn't appear in the RHDH lifecycle API. The script estimates its OCP support as:
Latest active RHDH release's OCP versions + any newer OCP versions that have reached GA
For example, if RHDH 1.9 supports OCP 4.16-4.21 and OCP 4.22 just went GA, then main is estimated to support 4.16-4.22.
Output Sections
1. Current State
- Cluster pool versions with sizing
- Test entry versions per product branch
- RHDH lifecycle with per-release OCP compatibility
- OCP lifecycle with supported/EOL versions
2. OCP Version Matrix
A combined view showing each relevant OCP version with:
| Column | Description |
|---|
| OCP | Version number |
| OCP_SUPP | Is OCP itself still supported? |
| RHDH_SUPP | Does any active RHDH release support this OCP? |
| OCP_PHASE | Current OCP lifecycle phase |
| RHDH_RELEASES | Which RHDH releases support this OCP |
3. Analysis Results
Actions are categorized by severity:
- REMOVE โ Definitive: OCP version is end-of-life, resources should be deleted
- REVIEW โ Needs judgment: OCP is supported but RHDH compatibility doesn't match, or vice versa
- ADD โ Missing: RHDH-supported OCP version lacks a pool or test entry
Specific checks:
- Pools for OCP-EOL versions (REMOVE)
- Pools for OCP versions not in any RHDH release's compatibility list (REVIEW)
- Test entries mismatched with the branch's RHDH compatibility (REMOVE/REVIEW)
- RHDH-supported OCP versions missing pools (ADD)
- RHDH-supported OCP versions missing test entries per branch (ADD)
4. Summary
Counts per action category plus the per-branch OCP support mapping.
Workflow
After running the analysis:
- Handle REMOVE items first โ delete pools/tests for OCP-EOL versions
- Review REVIEW items โ decide based on context whether they need action
- Handle ADD items โ use
rhdh-ocp-pool and rhdh-ocp-tests skills
- Run
make update after all changes
- Commit both config and generated files together
Data Sources
- RHDH lifecycle:
https://access.redhat.com/product-life-cycles/api/v1/products?name=Red+Hat+Developer+Hub
- OCP lifecycle:
https://access.redhat.com/product-life-cycles/api/v1/products?name=OpenShift+Container+Platform+4
- RHDH support policy:
https://access.redhat.com/support/policy/updates/developerhub
Related Skills
rhdh-ocp-lifecycle โ Check RHDH and OCP version support statusrhdh-ocp-pool โ List and generate OCP cluster pool configurationsrhdh-ocp-tests โ List, generate, add, and remove OCP test entries
