Skip to content

Add bridge mode warning: untagged external networks incompatible with…#462

Open
sethesterline wants to merge 2 commits into
mainfrom
461-physical-bridge-mode-untagged-warning
Open

Add bridge mode warning: untagged external networks incompatible with…#462
sethesterline wants to merge 2 commits into
mainfrom
461-physical-bridge-mode-untagged-warning

Conversation

@sethesterline

Copy link
Copy Markdown
Collaborator

… Physical Bridge Mode

When Physical Bridge Mode is enabled on a physical network, all traffic must be VLAN-tagged. External networks with VLAN type None (untagged/native) will not pass traffic on a bridged interface. Adds a warning callout to the trunk mode Virtual Switch Port setup section and a bridge mode info note to the Networking Concepts physical network definition.

Closes #461

… Physical Bridge Mode

When Physical Bridge Mode is enabled on a physical network, all traffic
must be VLAN-tagged. External networks with VLAN type None (untagged/native)
will not pass traffic on a bridged interface. Adds a warning callout to the
trunk mode Virtual Switch Port setup section and a bridge mode info note to
the Networking Concepts physical network definition.

Closes #461

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Indent the bridge-mode warning admonition under step 4 so it parses as part of the list item
- Add troubleshooting entry for untagged external network not passing traffic

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@jasnoyaeger

Copy link
Copy Markdown
Member

@sethesterline — flagging one open question before merging (also sent over Slack):

The callout added to network-concepts.md lists both Virtual Switch Ports and Tenant Layer 2 Networks as use cases for the Physical Bridged toggle, but product-guide/tenants/layer-2-networks.md never mentions Physical Bridge Mode as a prerequisite.

Two possibilities:

  1. Tenant Layer 2 Networks does require bridge mode under the hoodlayer-2-networks.md is missing that prerequisite and should get the same untagged-traffic warning.
  2. Tenant Layer 2 Networks doesn't use bridge mode → the network-concepts callout is slightly misleading, and we should reword the link as a "related feature" rather than a "use case for bridge mode."

Which is it? Happy to follow up with edits either way.

@bcampbellverg

Copy link
Copy Markdown
Collaborator

Currently working on reviewing this doc - discussing with development and setting up a test environment to walk through scenarios. I think it may be possible that bridge mode does not actually require all traffic on the interface to be VLAN-tagged --- but a reboot might be necessary after the network is changed to bridged mode. I will work to verify if this is the case or not.

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.

Docs: Physical Bridge Mode Warning — Incompatible with Untagged External Networks

3 participants