Skip to content

Conversation

@wheatdog
Copy link
Member

@wheatdog wheatdog commented Nov 12, 2025

Problem:

Introduce the new Hotplug NIC feature and its limitation.

Solution:

Provide a dedicate documentation page and related images.

Related Issue(s):

harvester/harvester#7042

Test plan:

N/A

Additional documentation or context

Signed-off-by: Tim Liou <[email protected]>
@github-actions
Copy link

github-actions bot commented Nov 12, 2025

Name Link
🔨 Latest commit d5ef342
😎 Deploy Preview https://69364223c7d983100fae8999--harvester-preview.netlify.app

@wheatdog wheatdog changed the title draft for hotplug nic feat: document for hotplug nic Nov 21, 2025
@wheatdog wheatdog marked this pull request as ready for review November 21, 2025 03:44
Copy link
Contributor

@jillian-maroket jillian-maroket left a comment

Choose a reason for hiding this comment

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

Review done

wheatdog and others added 3 commits November 25, 2025 09:55
Co-authored-by: Jillian Maroket <[email protected]>
Signed-off-by: Tim Liou <[email protected]>
Co-authored-by: Jillian Maroket <[email protected]>
Signed-off-by: Tim Liou <[email protected]>
Co-authored-by: Jillian Maroket <[email protected]>
Signed-off-by: Tim Liou <[email protected]>
Copy link
Member Author

@wheatdog wheatdog left a comment

Choose a reason for hiding this comment

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

@jillian-maroket Thanks for your previous review! I have checked the revised version. For hotunplug, I think VMs should have at least two interfaces.

Co-authored-by: Tim Liou <[email protected]>
Signed-off-by: Jillian Maroket <[email protected]>
Copy link
Contributor

@innobead innobead left a comment

Choose a reason for hiding this comment

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

LGTM, just one question.

P.S. It seems we rely only on migration-based hotplug: https://kubevirt.io/user-guide/network/hotplug_interfaces/#migration-based-hotplug.


You cannot perform NIC hotplugging on virtual machines created in clusters running Harvester versions earlier than v1.7.0 _if the network interface's MAC address was not explicitly configured_. To enable this feature, you must restart those virtual machines. Restarting allows the system to automatically save the observed MAC addresses to the virtual machine's configuration.

In addition, virtual machines created by the [Harvester Node Driver](../rancher/node/node-driver.md) do not support NIC hotplugging and hotunplugging.
Copy link
Contributor

Choose a reason for hiding this comment

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

Does the Harvester Terraform provider support this? If not, we may also mention it.

Copy link
Member Author

Choose a reason for hiding this comment

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

Good question. I think it's not supported.

@wheatdog
Copy link
Member Author

LGTM, just one question.

P.S. It seems we rely only on migration-based hotplug: https://kubevirt.io/user-guide/network/hotplug_interfaces/#migration-based-hotplug.

Yes, currently only for migration-based hotplug. The reason for not supporting non-migration-based hotplug is documented in harvester/harvester#9498.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants