Skip to content

win-overlay: document required apiVersion setting for containerd#154

Open
VaishnavSreekumar wants to merge 1 commit into
containernetworking:mainfrom
VaishnavSreekumar:win-overlay-apiversion-doc
Open

win-overlay: document required apiVersion setting for containerd#154
VaishnavSreekumar wants to merge 1 commit into
containernetworking:mainfrom
VaishnavSreekumar:win-overlay-apiversion-doc

Conversation

@VaishnavSreekumar
Copy link
Copy Markdown

@VaishnavSreekumar VaishnavSreekumar commented May 5, 2026

This PR documents the apiVersion field for the win-overlay plugin.

The current documentation does not mention apiVersion, but it is required for correct operation with container runtimes such as containerd. Without explicitly setting apiVersion: 2, the plugin may fail to create or locate the expected HNS endpoint.

Changes:

  • Add apiVersion: 2 to the example configuration
  • Introduce a new section describing the apiVersion field
  • Clarify its requirement for containerd-based setups

Fixes containernetworking/plugins#1229

Add documentation for the apiVersion field in the win-overlay plugin.
Clarify that apiVersion: 2 is required for containerd-based setups
to avoid HNS endpoint creation failures.

Fixes containernetworking/plugins#1229

Signed-off-by: Vaishnav Sreekumar <vaishnavsreekumar301@gmail.com>
@VaishnavSreekumar VaishnavSreekumar force-pushed the win-overlay-apiversion-doc branch from d6a371e to 7ecd048 Compare May 5, 2026 12:57
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.

Documentation for win-overlay is missing ApiVersion setting

1 participant