Skip to content

Rh virt/vm rebalance - #11

Merged
dmartinol merged 3 commits into
RHEcosystemAppEng:mainfrom
r2dedios:rh-virt/vm-rebalance
Feb 25, 2026
Merged

Rh virt/vm rebalance#11
dmartinol merged 3 commits into
RHEcosystemAppEng:mainfrom
r2dedios:rh-virt/vm-rebalance

Conversation

@r2dedios

Copy link
Copy Markdown
Contributor

vm-rebalance Skill

Orchestrates VM migrations across OpenShift cluster nodes for load balancing, maintenance, and resource optimization.

Features

Rebalancing Modes:

  • Manual Mode: User specifies VMs and target nodes for precise control
  • Automatic Mode: AI analyzes cluster state and generates optimal rebalance plans

Migration Strategies:

  • Live Migration: Zero downtime (requires RWX storage or ContainerDisk)
  • Cold Migration: Brief downtime (~30-60s, works with any storage)

Key Capabilities:

  • Automatic node selection using official KubeVirt labels (kubevirt.io/schedulable, devices.kubevirt.io/kvm)
  • Storage compatibility detection (RWX vs RWO)
  • Parallel or sequential execution modes
  • Resource version conflict prevention during cold migrations
  • Standardized two-table plan visualization (VM Rebalance Plan + Node State Before→After)

Implementation Highlights

Documentation Structure:

  • SKILL.md: Core workflow, common validation, error handling, plan visualization format
  • REBALANCE_MANUAL.md: User-driven migration workflow (stop → re-read → update → start)
  • REBALANCE_AUTOMATIC.md: AI-driven cluster optimization
  • references/: 4 comprehensive guides (live migration best practices, performance tuning, anti-patterns, production considerations)

…efactored rh-virt skills based on repo's design principles, and Claude's skill guidelines

Signed-off-by: r2dedios <alex.ansi.c@gmail.com>
Signed-off-by: r2dedios <alex.ansi.c@gmail.com>
…rence files

Signed-off-by: r2dedios <alex.ansi.c@gmail.com>
@r2dedios
r2dedios requested a review from dmartinol February 24, 2026 16:43
@r2dedios r2dedios self-assigned this Feb 24, 2026
@r2dedios r2dedios added the enhancement New feature or request label Feb 24, 2026
@dmartinol
dmartinol requested a review from Copilot February 25, 2026 21:15

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

This PR introduces the vm-rebalance skill for orchestrating VM migrations across OpenShift cluster nodes, supporting both manual (user-driven) and automatic (AI-driven) rebalancing modes with live and cold migration strategies.

Changes:

  • Added comprehensive vm-rebalance skill with manual and automatic rebalancing workflows
  • Created four reference guides covering live migration best practices, performance tuning, anti-patterns, and production considerations
  • Added three VM snapshot skills (create, list, delete, restore) for backup and recovery operations
  • Renamed vm-creator skill to vm-create for consistency across the collection
  • Updated documentation URLs from docs.openshift.com to docs.redhat.com domain

Reviewed changes

Copilot reviewed 25 out of 25 changed files in this pull request and generated no comments.

Show a summary per file
File Description
rh-virt/skills/vm-snapshot-restore/SKILL.md New skill for restoring VMs from snapshots with strict safety confirmations
rh-virt/skills/vm-snapshot-list/SKILL.md New skill for listing VM snapshots with status and recovery information
rh-virt/skills/vm-snapshot-delete/SKILL.md New skill for permanently deleting VM snapshots with user confirmation
rh-virt/skills/vm-snapshot-create/SKILL.md New skill for creating VM snapshots with storage backend analysis
rh-virt/skills/vm-rebalance/references/production-considerations.md Production deployment guidance including workload planning and HA strategies
rh-virt/skills/vm-rebalance/references/performance-tuning.md Advanced performance tuning parameters and optimization strategies
rh-virt/skills/vm-rebalance/references/live-migration-best-practices.md Configuration parameters and requirements for VM live migration
rh-virt/skills/vm-rebalance/references/anti-patterns.md Common mistakes and pitfalls to avoid when rebalancing VMs
rh-virt/skills/vm-rebalance/SKILL.md Core skill orchestrating VM migrations with common validation logic
rh-virt/skills/vm-rebalance/REBALANCE_MANUAL.md User-driven migration workflow with live and cold migration support
rh-virt/skills/vm-rebalance/REBALANCE_AUTOMATIC.md AI-driven cluster optimization with multi-objective rebalancing
rh-virt/skills/vm-lifecycle-manager/SKILL.md Updated skill references from vm-creator to vm-create
rh-virt/skills/vm-inventory/SKILL.md Updated skill references from vm-creator to vm-create
rh-virt/skills/vm-delete/SKILL.md Updated skill references from vm-creator to vm-create
rh-virt/skills/vm-creator/SKILL.md Renamed skill from vm-creator to vm-create throughout
rh-virt/skills/vm-clone/SKILL.md Updated skill references from vm-creator to vm-create
rh-virt/docs/troubleshooting/*.md Updated skill references and documentation URLs
rh-virt/README.md Updated skill references from vm-creator to vm-create
CLAUDE.md Added rh-virt as quality-controlled pattern example

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +14 to +15
- [Best Practices to Deploy VMs in Red Hat OpenShift Virtualization](https://docs.netapp.com/us-en/netapp-solutions-virtualization/openshift/os-osv-bpg.html) - NetApp Solutions
- [OpenShift Virtualization Best Practices](https://www.tigera.io/learn/guides/kubernetes-networking/openshift-virtualization/) - Tigera

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

these they don't see to be "official Red Hat documentation"

Comment on lines +16 to +17
- [Best Practices for Virtual Machine Deployments on OpenShift Virtualization](https://learn.microsoft.com/en-us/azure/openshift/best-practices-openshift-virtualization) - Microsoft Azure Red Hat OpenShift (2026-02-16)
- [Best Practices to Deploy VMs in Red Hat OpenShift Virtualization](https://docs.netapp.com/us-en/netapp-solutions-virtualization/openshift/os-osv-bpg.html) - NetApp Solutions

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

same

@dmartinol dmartinol left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

/lgtm

@dmartinol
dmartinol merged commit 94bf5e4 into RHEcosystemAppEng:main Feb 25, 2026
4 of 5 checks passed
@ikrispin ikrispin mentioned this pull request Mar 23, 2026
22 tasks
@github-actions github-actions Bot mentioned this pull request Mar 30, 2026
22 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants