Skip to content

[Virt] Support MIG vgpu - #71

Merged
rnetser merged 2 commits into
RedHatQE:mainfrom
akri3i:mig-vgpu
Jul 31, 2026
Merged

[Virt] Support MIG vgpu#71
rnetser merged 2 commits into
RedHatQE:mainfrom
akri3i:mig-vgpu

Conversation

@akri3i

@akri3i akri3i commented Apr 6, 2026

Copy link
Copy Markdown
Contributor

STP Metadata

VEP issue:

What this PR does

Adds the Software Test Plan (STP) for the MIG vGPU feature, planning tests for VMs Running with MIG backed VGPU

Special notes for your reviewer

Summary by CodeRabbit

  • Documentation
    • Added a comprehensive Quality Engineering test plan for the MIG vGPU feature in OpenShift Virtualization, including testing strategy, acceptance criteria, known limitations, required environment setup, traceability requirements, and a required review/checklist process.

@akri3i

akri3i commented Apr 6, 2026

Copy link
Copy Markdown
Contributor Author

/wip

@coderabbitai

coderabbitai Bot commented Apr 6, 2026

Copy link
Copy Markdown

Review Change Stack

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review
📝 Walkthrough

Walkthrough

A new MIG vGPU Software Test Plan defines feature scope, QE review criteria, test strategy, environment requirements, limitations, risks, requirement traceability, and approval stakeholders for OpenShift Virtualization.

Changes

MIG vGPU Test Plan

Layer / File(s) Summary
Feature scope and QE review
stps/sig-virt/mig-vgpu-stp.md
Defines MIG vGPU terminology, feature context, requirements review criteria, known limitations, and technology/design considerations.
Test execution planning
stps/sig-virt/mig-vgpu-stp.md
Specifies testing goals, exclusions, functional and non-functional strategy, environment configuration, provisioning requirements, and entry criteria.
Risk, traceability, and approval
stps/sig-virt/mig-vgpu-stp.md
Documents test risks, maps tracked requirements to prioritized scenarios, and lists sign-off stakeholders.

Estimated code review effort: 2 (Simple) | ~12 minutes

Suggested reviewers: dshchedr, jean-edouard, samalber, kbidarkar, vsibirsk

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly matches the main change: adding MIG vGPU support documentation for OpenShift Virtualization.
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

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.

@openshift-virtualization-qe-bot-2

Copy link
Copy Markdown

Report bugs in Issues

Welcome! 🎉

This pull request will be automatically processed with the following features:

🔄 Automatic Actions

  • Reviewer Assignment: Reviewers are automatically assigned based on the OWNERS file in the repository root
  • Size Labeling: PR size labels (XS, S, M, L, XL, XXL) are automatically applied based on changes
  • Issue Creation: A tracking issue is created for this PR and will be closed when the PR is merged or closed
  • Branch Labeling: Branch-specific labels are applied to track the target branch
  • Auto-verification: Auto-verified users have their PRs automatically marked as verified
  • Labels: Enabled categories: branch, can-be-merged, cherry-pick, has-conflicts, hold, needs-rebase, size, verified, wip

📋 Available Commands

PR Status Management

  • /wip - Mark PR as work in progress (adds WIP: prefix to title)
  • /wip cancel - Remove work in progress status
  • /hold - Block PR merging (approvers only)
  • /hold cancel - Unblock PR merging
  • /verified - Mark PR as verified
  • /verified cancel - Remove verification status
  • /reprocess - Trigger complete PR workflow reprocessing (useful if webhook failed or configuration changed)
  • /regenerate-welcome - Regenerate this welcome message

Review & Approval

  • /lgtm - Approve changes (looks good to me)
  • /approve - Approve PR (approvers only)
  • /assign-reviewers - Assign reviewers based on OWNERS file
  • /assign-reviewer @username - Assign specific reviewer
  • /check-can-merge - Check if PR meets merge requirements

Testing & Validation

  • /retest tox - Run Python test suite with tox
  • /retest all - Run all available tests

Cherry-pick Operations

  • /cherry-pick <branch> - Schedule cherry-pick to target branch when PR is merged
    • Multiple branches: /cherry-pick branch1 branch2 branch3

Label Management

  • /<label-name> - Add a label to the PR
  • /<label-name> cancel - Remove a label from the PR

✅ Merge Requirements

This PR will be automatically approved when the following conditions are met:

  1. Approval: /approve from at least one approver
  2. LGTM Count: Minimum 2 /lgtm from reviewers
  3. Status Checks: All required status checks must pass
  4. No Blockers: No wip, hold, has-conflicts labels and PR must be mergeable (no conflicts)

📊 Review Process

Approvers and Reviewers

Approvers:

  • dshchedr
  • vsibirsk

Reviewers:

  • SamAlber
  • SiboWang1997
  • akri3i
  • dshchedr
  • jerry7z
  • kbidarkar
  • vsibirsk
Available Labels
  • hold
  • verified
  • wip
  • lgtm
  • approve
AI Features
  • Cherry-Pick Conflict Resolution: Enabled (claude/claude-opus-4-6[1m])

💡 Tips

  • WIP Status: Use /wip when your PR is not ready for review
  • Verification: The verified label is removed on new commits unless the push is detected as a clean rebase
  • Cherry-picking: Cherry-pick labels are processed when the PR is merged
  • Permission Levels: Some commands require approver permissions
  • Auto-verified Users: Certain users have automatic verification and merge privileges

For more information, please refer to the project documentation or contact the maintainers.

@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: 12

🧹 Nitpick comments (1)
stps/sig-virt/mig-vgpu-stp.md (1)

219-219: Consider simplifying wording.

"prior to" can be simplified to "before" for more concise documentation.

♻️ Proposed simplification
-- **Special Configurations:** GPU node must have MIG mode enabled and appropriate MIG profiles configured prior to test execution
+- **Special Configurations:** GPU node must have MIG mode enabled and appropriate MIG profiles configured before test execution
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@stps/sig-virt/mig-vgpu-stp.md` at line 219, Replace the phrase "prior to"
with "before" in the sentence "**Special Configurations:** GPU node must have
MIG mode enabled and appropriate MIG profiles configured prior to test
execution" so it reads "...configured before test execution" to simplify wording
and improve conciseness.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@stps/sig-virt/mig-vgpu-stp.md`:
- Line 13: Update the "**Participating SIGs:**" field in the mig-vgpu-stp.md
document: either list the other SIGs participating (e.g., "sig-foo, sig-bar") if
there are collaborators, or remove the line entirely or replace it with "None"
when sig-virt is the only SIG; ensure the final text uses the exact
"**Participating SIGs:**" label so reviewers can find it easily.
- Around line 142-148: The "Test Limitations" section contains two unresolved
sign-off placeholders for the NVIDIA A30-specific limitation and the MIG-capable
GPU hardware requirement; complete both sign-off fields by replacing
"[Name/Date]" with the approver's full name and approval date for each bullet
(the bullet mentioning "NVIDIA A30 GPU" and the bullet mentioning "MIG-capable
GPU hardware (e.g., NVIDIA A100)"), ensuring the completed entries are accurate
and authoritative before final STP approval.
- Line 11: Populate the QE Owner(s) field in the STP header by replacing the
placeholder "[Name(s)]" with the actual responsible QE engineer name(s); update
the "QE Owner(s):" entry so it lists one or more real names (e.g., "QE Owner(s):
Jane Doe, John Smith") before approving the document.
- Around line 116-141: Populate the PM/Lead Agreement placeholders for each
out-of-scope bullet so the document records explicit sign-offs: add a named
approver and date in place of each "[Name/Date]" for the items "Legacy GPUs
without MIG support", "Advanced multi-tenancy beyond GPU-level isolation",
"Custom MIG topologies beyond standard configurations", "Windows guest OS", "GPU
benchmark / performance testing inside VMs", and "MIG profile configuration and
GPU Operator installation" to indicate formal acceptance of these exclusions.
- Around line 266-268: The Test Environment risk block currently lacks an
approver signature; update the risk acknowledgement paragraph (the "**Risk:**
Only one NVIDIA A30 GPU node..." / "**Mitigation:** None" block) to include a
completed sign-off by replacing "[Name/Date]" with the approver's full name and
the approval date in YYYY-MM-DD (or the project's standard date format),
ensuring the "*Sign-off:*" line reads e.g. "*Sign-off:* Alice Smith /
2026-04-06" so the document has a clear, traceable approval for the Test
Environment risk.
- Around line 70-79: The Known Limitations section contains placeholder
sign-offs "[Name/Date]" for each bullet (e.g., the lines "Only RHEL guest OS is
validated", "MIG vGPU for Windows guests is only supported on vGPUs created on
RTX Pro 6000 hardware...", and "MIG vGPU configuration requires
pre-configuration of the GPU node..."); replace each placeholder with the actual
reviewer/approver name and date to complete the sign-off fields so the STP can
be approved.
- Around line 5-13: The Metadata & Tracking section currently omits the VEP
field referenced in the PR objectives; either add a "VEP:" (or "VEP issue:")
entry under the "Metadata & Tracking" block with an appropriate value or
placeholder (e.g., "VEP: TBD" or the VEP number) so the text "STP Metadata: VEP
issue field is present but not filled" matches the document, or update the PR
description to explicitly state that a VEP is not applicable; locate and modify
the "Metadata & Tracking" section (the header and the list containing
Enhancement(s), Feature Tracking, Epic Tracking, QE Owner(s), Owning SIG,
Participating SIG) to include the new VEP field or change the PR description
accordingly.
- Line 7: Replace the placeholder line labeled "Enhancement(s):" with either the
link(s) to the relevant enhancement PR(s) (e.g., OpenShift/KubeVirt enhancement
URLs) or, if no enhancement exists, a link and brief citation to the High-Level
Design (HLD) document; update the "Enhancement(s):" field in the document so it
no longer contains placeholder text and includes the actual enhancement or HLD
reference.
- Line 243: Update the entry criterion checklist in mig-vgpu-stp.md by marking
the "Requirements and design documents are **approved and merged**" item as
satisfied: change the unchecked box "[ ] Requirements and design documents are
**approved and merged**" to a checked box "[x] Requirements and design documents
are **approved and merged**" and, if possible, add a brief reference (PR/MR
number or link) to the merged approval artifact so reviewers can verify the
prerequisite is met.
- Around line 81-102: The Technology and Design Review section has unchecked
items and placeholder text; update the checklist by marking the boxes as
completed where content is provided (check "Technology Challenges", "API
Extensions", and "Topology Considerations") and replace the placeholder in
"Developer Handoff/QE Kickoff" with a concise summary of handoff actions and QE
kickoff steps (who, what, and follow-ups), and either populate "Test Environment
Needs" with the referenced environment/tool details from Section II.3/II.3.1 or
add a short note that the item requires stakeholder confirmation; reference the
section headings "Developer Handoff/QE Kickoff", "Technology Challenges", "API
Extensions", "Test Environment Needs", and "Topology Considerations" when making
these edits.
- Line 197: Summary: The phrase "MIG supported NVIDIA GPU hardware" must be
hyphenated as a compound adjective. In the document string "MIG supported NVIDIA
GPU hardware" (found in mig-vgpu-stp.md near the details line), replace it with
"MIG-supported NVIDIA GPU hardware" so the compound adjective correctly modifies
"NVIDIA GPU hardware"; ensure any other occurrences of the exact phrase "MIG
supported" used as a modifier are updated the same way.
- Line 72: Fix the malformed bold markup on the line containing "Only RHEL guest
OS is validated" by removing the trailing `**` so the bold formatting is
balanced; update the line in mig-vgpu-stp.md from "**Only RHEL guest OS is
validated **" to either "**Only RHEL guest OS is validated**" (to keep bold) or
"Only RHEL guest OS is validated" (to remove bold) as appropriate.

---

Nitpick comments:
In `@stps/sig-virt/mig-vgpu-stp.md`:
- Line 219: Replace the phrase "prior to" with "before" in the sentence
"**Special Configurations:** GPU node must have MIG mode enabled and appropriate
MIG profiles configured prior to test execution" so it reads "...configured
before test execution" to simplify wording and improve conciseness.
🪄 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: Pro

Run ID: 2b4c6e69-de0d-4785-9981-c46731afe75b

📥 Commits

Reviewing files that changed from the base of the PR and between dc8aed7 and 8b4dfee.

📒 Files selected for processing (1)
  • stps/sig-virt/mig-vgpu-stp.md

Comment thread stps/sig-virt/mig-vgpu-stp.md Outdated
Comment thread stps/sig-virt/mig-vgpu-stp.md Outdated
Comment thread stps/sig-virt/mig-vgpu-stp.md Outdated
Comment thread stps/sig-virt/mig-vgpu-stp.md Outdated
Comment thread stps/sig-virt/mig-vgpu-stp.md Outdated
Comment thread stps/sig-virt/mig-vgpu-stp.md
Comment thread stps/sig-virt/mig-vgpu-stp.md Outdated
Comment thread stps/sig-virt/mig-vgpu-stp.md Outdated
Comment thread stps/sig-virt/mig-vgpu-stp.md Outdated
Comment thread stps/sig-virt/mig-vgpu-stp.md Outdated
Comment thread stps/sig-virt/mig-vgpu-stp.md Outdated
@openshift-virtualization-qe-bot-2

Copy link
Copy Markdown

mtessun can not be added as reviewer. Reviews may only be requested from collaborators. One or more of the users or teams you specified is not a collaborator of the RedHatQE/openshift-virtualization-tests-design-docs repository.: 422 {"message": "Reviews may only be requested from collaborators. One or more of the users or teams you specified is not a collaborator of the RedHatQE/openshift-virtualization-tests-design-docs repository.", "documentation_url": "https://docs.github.com/rest/pulls/review-requests#request-reviewers-for-a-pull-request", "status": "422"}

@akri3i

akri3i commented Jul 10, 2026

Copy link
Copy Markdown
Contributor Author

/wip cancel

Comment thread stps/sig-virt/mig-vgpu-stp.md

@mtessun mtessun 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.

Just close out the few comments about negative testscenarios and clarification what is NVIDIA and what is us.

Comment thread stps/sig-virt/mig-vgpu-stp.md Outdated
Comment thread stps/sig-virt/mig-vgpu-stp.md
@openshift-virtualization-qe-bot-2

Copy link
Copy Markdown

Clean rebase detected — no code changes compared to previous head (0939c76).
The following labels were preserved: commented-akri3i.

@openshift-virtualization-qe-bot-2

Copy link
Copy Markdown

mtessun can not be added as reviewer. Reviews may only be requested from collaborators. One or more of the users or teams you specified is not a collaborator of the RedHatQE/openshift-virtualization-tests-design-docs repository.: 422 {"message": "Reviews may only be requested from collaborators. One or more of the users or teams you specified is not a collaborator of the RedHatQE/openshift-virtualization-tests-design-docs repository.", "documentation_url": "https://docs.github.com/rest/pulls/review-requests#request-reviewers-for-a-pull-request", "status": "422"}

coderabbitai[bot]
coderabbitai Bot previously approved these changes Jul 29, 2026
@openshift-virtualization-qe-bot-6

Copy link
Copy Markdown

Clean rebase detected — no code changes compared to previous head (e4df543).
The following labels were preserved: commented-akri3i.

@openshift-virtualization-qe-bot-6

Copy link
Copy Markdown

mtessun can not be added as reviewer. Reviews may only be requested from collaborators. One or more of the users or teams you specified is not a collaborator of the RedHatQE/openshift-virtualization-tests-design-docs repository.: 422 {"message": "Reviews may only be requested from collaborators. One or more of the users or teams you specified is not a collaborator of the RedHatQE/openshift-virtualization-tests-design-docs repository.", "documentation_url": "https://docs.github.com/rest/pulls/review-requests#request-reviewers-for-a-pull-request", "status": "422"}

1 similar comment
@openshift-virtualization-qe-bot-6

Copy link
Copy Markdown

mtessun can not be added as reviewer. Reviews may only be requested from collaborators. One or more of the users or teams you specified is not a collaborator of the RedHatQE/openshift-virtualization-tests-design-docs repository.: 422 {"message": "Reviews may only be requested from collaborators. One or more of the users or teams you specified is not a collaborator of the RedHatQE/openshift-virtualization-tests-design-docs repository.", "documentation_url": "https://docs.github.com/rest/pulls/review-requests#request-reviewers-for-a-pull-request", "status": "422"}

@rnetser

rnetser commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

/approve

@akri3i

akri3i commented Jul 29, 2026

Copy link
Copy Markdown
Contributor Author

/check-can-merge

@dshchedr

Copy link
Copy Markdown

/lgtm

@akri3i

akri3i commented Jul 30, 2026

Copy link
Copy Markdown
Contributor Author

/check-can-merge

Comment thread stps/sig-virt/mig-vgpu-stp.md
Comment thread stps/sig-virt/mig-vgpu-stp.md Outdated
Comment thread stps/sig-virt/mig-vgpu-stp.md Outdated

@lyarwood lyarwood 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.

STP Review — AGENTS.md Checklist

Overall the STP is in solid shape after multiple rounds of review. The major prior issues (constraint categorization, missing PM approver, missing negative scenario, NVIDIA responsibility clarification) have all been addressed.

2 HIGH items remain (template compliance), 2 MEDIUM refinements. See inline comments for details.

Verdict: COMMENT — no blockers, but the Self-Validation Testing type and reviewer role labels should be addressed before merge.

Comment thread stps/sig-virt/mig-vgpu-stp.md
Comment thread stps/sig-virt/mig-vgpu-stp.md
Comment thread stps/sig-virt/mig-vgpu-stp.md Outdated
Comment thread stps/sig-virt/mig-vgpu-stp.md Outdated
@openshift-virtualization-qe-bot-5

Copy link
Copy Markdown

mtessun can not be added as reviewer. Reviews may only be requested from collaborators. One or more of the users or teams you specified is not a collaborator of the RedHatQE/openshift-virtualization-tests-design-docs repository.: 422 {"message": "Reviews may only be requested from collaborators. One or more of the users or teams you specified is not a collaborator of the RedHatQE/openshift-virtualization-tests-design-docs repository.", "documentation_url": "https://docs.github.com/rest/pulls/review-requests#request-reviewers-for-a-pull-request", "status": "422"}

@openshift-virtualization-qe-bot-4

Copy link
Copy Markdown

Clean rebase detected — no code changes compared to previous head (7b8cefa).

@openshift-virtualization-qe-bot-4

Copy link
Copy Markdown

mtessun can not be added as reviewer. Reviews may only be requested from collaborators. One or more of the users or teams you specified is not a collaborator of the RedHatQE/openshift-virtualization-tests-design-docs repository.: 422 {"message": "Reviews may only be requested from collaborators. One or more of the users or teams you specified is not a collaborator of the RedHatQE/openshift-virtualization-tests-design-docs repository.", "documentation_url": "https://docs.github.com/rest/pulls/review-requests#request-reviewers-for-a-pull-request", "status": "422"}

coderabbitai[bot]
coderabbitai Bot previously approved these changes Jul 30, 2026
Signed-off-by: akri3i <guptaakriti70@gmail.com>
@openshift-virtualization-qe-bot-3

Copy link
Copy Markdown

mtessun can not be added as reviewer. Reviews may only be requested from collaborators. One or more of the users or teams you specified is not a collaborator of the RedHatQE/openshift-virtualization-tests-design-docs repository.: 422 {"message": "Reviews may only be requested from collaborators. One or more of the users or teams you specified is not a collaborator of the RedHatQE/openshift-virtualization-tests-design-docs repository.", "documentation_url": "https://docs.github.com/rest/pulls/review-requests#request-reviewers-for-a-pull-request", "status": "422"}

@openshift-virtualization-qe-bot-4

Copy link
Copy Markdown

Clean rebase detected — no code changes compared to previous head (1192a62).

@openshift-virtualization-qe-bot-4

Copy link
Copy Markdown

mtessun can not be added as reviewer. Reviews may only be requested from collaborators. One or more of the users or teams you specified is not a collaborator of the RedHatQE/openshift-virtualization-tests-design-docs repository.: 422 {"message": "Reviews may only be requested from collaborators. One or more of the users or teams you specified is not a collaborator of the RedHatQE/openshift-virtualization-tests-design-docs repository.", "documentation_url": "https://docs.github.com/rest/pulls/review-requests#request-reviewers-for-a-pull-request", "status": "422"}

@akri3i

akri3i commented Jul 30, 2026

Copy link
Copy Markdown
Contributor Author

/check-can-merge

@dshchedr

Copy link
Copy Markdown

/lgtm

@rnetser

rnetser commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

/approve

@mtessun

mtessun commented Jul 31, 2026

Copy link
Copy Markdown

/lgtm

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.