Skip to content

Sync CNV runbook VirtualMachineInstanceHasEphemeralHotplugVolume.md (Updated at 2025-12-16 16:56:04 +0000 UTC) #367

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
hco-bot wants to merge 1 commit into
base: master
Choose a base branch
from
+52 −0
Open

Sync CNV runbook VirtualMachineInstanceHasEphemeralHotplugVolume.md (Updated at 2025-12-16 16:56:04 +0000 UTC) #367

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
52 changes: 52 additions & 0 deletions ...hift-virtualization-operator/VirtualMachineInstanceHasEphemeralHotplugVolume.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
# VirtualMachineInstanceHasEphemeralHotplugVolume

## Meaning

The `VirtualMachineInstanceHasEphemeralHotplugVolume` alert is triggered when a
Virtual Machine Instance (VMI) contains an Ephemeral Hotplug Volume, which is
defined
as a hotplug volume that only exists in the VMI and will not persist during VM
restart

## Impact

The `HotplugVolumes` Feature Gate will be deprecated in a future release and
will
be replaced by the `DeclarativeHotplugVolumes` Feature Gate. The two are
mutually
exclusive, and when `DeclarativeHotplugVolumes` is enabled, any remaining
ephemeral hotplug volumes will automatically be unplugged from any VMIs.

If this alert is triggered, it is to inform of this future deprecation and to
suggest steps to convert ephermeral volumes to persist ones.

## Diagnosis

To diagnose the cause of this alert, the following steps can be taken:

1. Find each VM that contains an ephemeral hotplug volume.
This command will print out list entries in format [vm-name, namespace]
``` bash
$ oc get vmis -A -o json | jq -r '.items[].metadata | select(.annotations |
has("kubevirt.io/ephemeral-hotplug-volumes")) | [.name , .namespace] | @tsv'
```
2. For each VM listed, find the volumes that need to be patched.

``` bash
$ oc get vmis <vm-name> -n <namespace> -o json | jq -r
'.metadata.annotations."kubevirt.io/ephemeral-hotplug-volumes"'
```

## Mitigation

To mitigate the impact of this alert, consider converting these ephemeral
hotplug volumes to instead persist within the VM.

To do so:
``` bash
$ virtctl addvolume <vm-name> --volume-name=<volume-name> --persist
```

If you cannot resolve the issue, log in to the
[Customer Portal](https://access.redhat.com) and open a support case,
attaching the artifacts gathered during the diagnosis procedure.