Bridge Interface#
Virtual Networks → BIBridge Interfaces
A BridgeInterface combines a single Interface with a VLAN tag to create a sub-interface, which is then connected to a BridgeDomain. This way, the host(s) that are connected to this sub-interface can communicate with other hosts in the BridgeDomain.
BridgeInterface vs VLAN
The BridgeInterface connects a single Interface to the BridgeDomain, while a VLAN uses labels to select which Interfaces are connected to the BridgeDomain. The latter should be preferred wherever possible.
Traffic is switched via the BridgeDomain that matches the VLAN tag that the packets are tagged with, which allows a physical device to communicate with multiple services over the same physical interface.
A common use case is a server that hosts virtual machines: the physical device (hypervisor) hosts multiple VMs, all of which are assigned a unique VLAN ID to be able to connect to the network over the same physical interface.
Uplinks#
An uplink in the context of the BridgeInterface is a connection between a breakout switch and a service-aware switch. The breakout switch usually has fewer capabilities, both in terms of port speeds and control plane functionality.
These switches are typically not VxLAN or MPLS capable, and the distributed BridgeDomain can therefore not be extended onto the access switch. Instead, a separate non-distributed bridge domain service is created on the breakout switch which is attached to the distributed BridgeDomain through the uplink.
The uplinkSelectors label selector property is used to identify which links are connected to breakout switches. The VLAN that is used on this breakout uplink is determined by the uplinkVLANID or uplinkVLANPool property.
Note
On the breakout switch, only the interface selected by the BridgeInterface will be attached to the bridge domain service.
Dependencies#
BridgeDomain#
The BridgeInterface connects an Interface to a BridgeDomain, allowing the hosts that are behind the Interface to communicate with other hosts in the BridgeDomain.
The BridgeDomain must exist before the BridgeInterface can be configured.
Interface#
A BridgeInterface is mapped to a single Interface, although the same Interface can be referenced by many BridgeInterfaces. A VLAN tag is used to determine which service the traffic will be forwarded to.
The Interface must exist before the BridgeInterface can be configured.
Referenced resources#
TopoLink#
If an uplink is configured which connects an Interface on a breakout switch to the distributed BridgeDomain service, the uplink label selector selects TopoLink resources that are used to connect the breakout switch to the rest of the network.
Examples#
Custom Resource Definition#
To browse the Custom Resource Definition go to crd.eda.dev.
BridgeInterface
SPEC
The BridgeInterface enables the attachment of network interfaces to a Bridge Domain. It includes settings for VLAN ID allocation, interface attachment, and actions on ingress and egress traffic. The specification supports integration with other network resources, such as Bridge Domains and Interfaces, and provides advanced features like MAC Duplication Detection with configurable actions.
-
Reference to a BridgeDomain in which to attach the BridgeInterface.
-
The description of the BridgeInterface.
-
Reference to an Interface resource to attach this BridgeInterface.
-
L2 MTU specifies the maximum sized Ethernet frame that can be transmitted on the subinterface. If a frame exceeds this size it is discarded. If the l2-mtu of the subinterface exceeds the port-mtu of the associated interface, the subinterface will remain operationally down.
format: int32range: 1450 to 9500 -
Override for Mac Duplication Detection action if enabled in the associated BridgeDomain.
enum: "Blackhole", "OperDown", "StopLearning", "BridgeDomainAction" -
Split Horizon Group to be used for this BridgeInterface. The subinterface within this BridgeInterface will be a member of this Split Horizon Group.
-
The Uplink between your access breakout switch and your leaf switch.
-
Selects TopoLinks which connect a leaf switch to a breakout switch. This is the uplink between your access breakout switch and your leaf switch. There can only be a single TopoLink between the access breakout switch and the leaf switch, if more than one TopoLink is present between two devices the transaction will fail.
-
The VLAN ID to be utilized to isolate traffic from the VLAN on the access breakout switch to the leaf switch on the selected uplink TopoLink.
default: "pool" -
A VLAN from this pool will be utilized to isolate traffic from the VLAN on the access breakout switch to the leaf switch on the selected uplink TopoLink.
-
Single value between 1-4094 support, ranges supported in the format x-y,x-y, or the special keyword null, any, untagged or pool for auto allocation.
STATUS
-
Indicates the health score of the BridgeInterface.
format: int32range: <= 100 -
Indicates the reason for the health score.
-
The time when the state of the resource last changed.
-
Operational state of the BridgeInterface.
enum: "Up", "Down", "Degraded", "Unknown" -
Sub-interfaces status within the BridgeInterface.
-
-
The administrative status of the SubInterface.
-
Normalized interface name.
-
Eda interface resource.
-
Indicates when this SubInterface last changed state.
-
Reference to Node object.
-
Node specific interface name.
-
Operating System of the Node.
-
Indicates the current operational state of the SubInterface.
enum: "Up", "Down", "Degraded", "Unknown" -
Index allocated to the subinterface on the associated interface for the given VLAN.
format: int64 -
vlan assigned to this subinterface.
-
-
-
Uplinks status within the BridgeInterface.
-
-
The administrative status of the SubInterface.
-
Normalized interface name.
-
Eda interface resource.
-
Indicates when this SubInterface last changed state.
-
Reference to Node object.
-
Node specific interface name.
-
Operating System of the Node.
-
Indicates the current operational state of the SubInterface.
enum: "Up", "Down", "Degraded", "Unknown" -
Index allocated to the subinterface on the associated interface for the given VLAN.
format: int64 -
vlan assigned to this subinterface.
-
-
