Skip to content

OPCT-389: doc: update version matrix and conformance suite notes for OCP 4.20+#227

Merged
openshift-merge-bot[bot] merged 2 commits into
mainfrom
docs/OPCT-389-version-skew-420
Jul 23, 2026
Merged

OPCT-389: doc: update version matrix and conformance suite notes for OCP 4.20+#227
openshift-merge-bot[bot] merged 2 commits into
mainfrom
docs/OPCT-389-version-skew-420

Conversation

@bshaw7

@bshaw7 bshaw7 commented Jul 20, 2026

Copy link
Copy Markdown
Collaborator

Summary

Update the OPCT documentation to unblock VCSP validations on OCP 4.20+ and
address the acceptance criteria from OPCT-389.

Changes

  • Added v0.6.5+ row supporting OCP 4.19-4.22 (CI workflows hardcode quay.io/opct/opct:v0.6.5)
  • Narrowed previous v0.6.1+ to v0.6.1-v0.6.4 covering 4.16-4.19
  • Removed the OCPBUGS-77783 blocking notice
  • Added info block documenting:
    • Affected versions: OPCT v0.6.0 and earlier do not support 4.20+
    • Fix is in openshift-tests (openshift/origin), not in OPCT or plugins
    • OCP 4.20 was not affected by the conformance suite bug
    • OCP 4.21+ needs nightly or z-stream with origin PR #31353 (4.21) / #31270 (4.22)

Why v0.6.5+ and not v0.6.1+ or v0.6.6+?

  • All CI nightly workflows hardcode OPCT_CLI_IMAGE: "quay.io/opct/opct:v0.6.5"
  • The conformance fix is in openshift/origin, not OPCT — no OPCT code change was needed
  • v0.6.6 does not exist yet, and no changes after v0.6.5 are required for 4.20+ support

CI note

The e2e / e2e-cmd_adm-parse-metrics test fails on this PR due to a missing
test artifact on CloudFront (HTTP 403). This is a pre-existing infrastructure
issue unrelated to this docs-only change.

Fixes: https://redhat.atlassian.net/browse/OPCT-389
Epic: https://redhat.atlassian.net/browse/OPCT-421

Test plan

  • Verify version matrix renders correctly on the published docs site
  • Verify info block renders correctly
  • Confirm no other docs reference the removed blocking notice

🤖 Generated with Claude Code

@openshift-ci
openshift-ci Bot requested review from rvanderp3 and vr4manta July 20, 2026 09:48
@coderabbitai

coderabbitai Bot commented Jul 20, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Enterprise

Run ID: 0151b9bc-17fd-45d0-904e-352bf3db5866

📥 Commits

Reviewing files that changed from the base of the PR and between fa9b1b7 and c7e0868.

📒 Files selected for processing (1)
  • docs/guides/cluster-validation/index.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/guides/cluster-validation/index.md

📝 Walkthrough

Summary by CodeRabbit

  • Documentation
    • Updated the OpenShift and OPCT support matrix to add OPCT v0.6.5+ coverage for OCP 4.19–4.22.
    • Adjusted OPCT version banding, replacing the prior broader v0.6.1+ coverage with a narrower v0.6.1–v0.6.4 range.
    • Updated guidance to reflect that OpenShift 4.20+ cluster validations are now supported, including affected versions and fix details.

Walkthrough

The cluster validation guide updates the OPCT/OpenShift support matrix and documents restored conformance validation support for OCP 4.20+.

Changes

Cluster validation documentation

Layer / File(s) Summary
Version support and conformance documentation
docs/guides/cluster-validation/index.md
Adds OPCT v0.6.5+ mappings, narrows the v0.6.1-v0.6.4 band, and replaces the prior OCP 4.20+ validation block with support status and fix details.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Suggested reviewers: vr4manta, rvanderp3

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly summarizes the docs update to the version matrix and conformance suite notes for OCP 4.20+.
Description check ✅ Passed The description is directly related to the documentation changes and matches the stated goal of unblocking OCP 4.20+ validations.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/OPCT-389-version-skew-420

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@bshaw7 bshaw7 added the kind/documentation Categorizes issue or PR as related to documentation. label Jul 20, 2026

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/guides/cluster-validation/index.md`:
- Around line 185-190: Update the “Conformance suite changes on OCP 4.20+” note
to document that OCP 4.20+ switches the Kubernetes conformance suite source from
kubernetes/conformance to kubernetes/conformance/parallel via k8s-tests-ext,
while OCP 4.19 continues using kubernetes/conformance. Retain the existing
explanation that the resulting count change is expected and not a regression.
- Around line 192-199: Update the “Validated test counts by OCP version” table
to include provenance for every OCP row, either by linking each count to its
source periodic job/run or by adding the corresponding run date. Preserve the
existing count columns while making each baseline auditable and refreshable.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Enterprise

Run ID: 48d542ba-b7d5-40c3-955a-90a59b690775

📥 Commits

Reviewing files that changed from the base of the PR and between 8b02465 and b4883e5.

📒 Files selected for processing (1)
  • docs/guides/cluster-validation/index.md

Comment thread docs/guides/cluster-validation/index.md Outdated
Comment thread docs/guides/cluster-validation/index.md Outdated
@vr4manta

Copy link
Copy Markdown
Collaborator

/lgtm

@openshift-ci openshift-ci Bot added the lgtm Indicates that a PR is ready to be merged. label Jul 20, 2026
Update the cluster validation guide to unblock VCSP validations on
OCP 4.20+ and document the conformance suite fix details.

Changes:
- Added v0.6.5+ row supporting OCP 4.19-4.22
- Narrowed v0.6.1+ to v0.6.1-v0.6.4 (4.16-4.19)
- Removed OCPBUGS-77783 blocking notice
- Added info block documenting affected versions, fix availability,
  and references to resolved bugs

Fixes: https://redhat.atlassian.net/browse/OPCT-389

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@bshaw7
bshaw7 force-pushed the docs/OPCT-389-version-skew-420 branch from 185acb4 to fa9b1b7 Compare July 21, 2026 12:15
@openshift-ci openshift-ci Bot removed the lgtm Indicates that a PR is ready to be merged. label Jul 21, 2026

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/guides/cluster-validation/index.md`:
- Around line 191-194: Update the “Affected versions” section to explicitly
state that OPCT v0.6.1–v0.6.4 do not support OCP 4.20+, while preserving the
existing support statements for v0.6.0 and earlier and v0.6.5+.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Enterprise

Run ID: ec36f6a3-d337-4c46-9e64-0394c9cec0bf

📥 Commits

Reviewing files that changed from the base of the PR and between 3d09c4f and fa9b1b7.

📒 Files selected for processing (1)
  • docs/guides/cluster-validation/index.md

Comment thread docs/guides/cluster-validation/index.md
Address CodeRabbit review: v0.6.1-v0.6.4 also do not support
OCP 4.20+, not just v0.6.0 and earlier.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@vr4manta

Copy link
Copy Markdown
Collaborator

/lgtm

@openshift-ci openshift-ci Bot added the lgtm Indicates that a PR is ready to be merged. label Jul 22, 2026
@vr4manta

Copy link
Copy Markdown
Collaborator

/approve

@openshift-ci

openshift-ci Bot commented Jul 22, 2026

Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: vr4manta

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@openshift-ci openshift-ci Bot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Jul 22, 2026
@bshaw7

bshaw7 commented Jul 23, 2026

Copy link
Copy Markdown
Collaborator Author

/override e2e/e2e-cmd_adm-parse-metrics

@openshift-ci

openshift-ci Bot commented Jul 23, 2026

Copy link
Copy Markdown

@bshaw7: /override requires failed status contexts, check run or a prowjob name to operate on.
The following unknown contexts/checkruns were given:

  • e2e/e2e-cmd_adm-parse-metrics

Only the following failed contexts/checkruns were expected:

  • CodeRabbit
  • e2e / e2e-cmd_adm-parse-metrics
  • release
  • tide

If you are trying to override a checkrun that has a space in it, you must put a double quote on the context.

Details

In response to this:

/override e2e/e2e-cmd_adm-parse-metrics

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

@bshaw7

bshaw7 commented Jul 23, 2026

Copy link
Copy Markdown
Collaborator Author

/override "e2e / e2e-cmd_adm-parse-metrics"

@openshift-ci

openshift-ci Bot commented Jul 23, 2026

Copy link
Copy Markdown

@bshaw7: Overrode contexts on behalf of bshaw7: e2e / e2e-cmd_adm-parse-metrics

Details

In response to this:

/override "e2e / e2e-cmd_adm-parse-metrics"

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

@openshift-merge-bot
openshift-merge-bot Bot merged commit ee916c1 into main Jul 23, 2026
22 of 23 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved Indicates a PR has been approved by an approver from all required OWNERS files. kind/documentation Categorizes issue or PR as related to documentation. lgtm Indicates that a PR is ready to be merged.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants