Default Interface#
Underlay Routing → DIDefault Interfaces
The DefaultInterface resource links an Interface to the DefaultRouter, with the addition of an optional VLAN tag. It can be configured with an IP-Prefix or IPv6 unnumbered, which configures the IP that will be associated with the interface.
Best deployed as part of a Fabric
When possible, we recommend that you deploy this resource through a Fabric which automatically creates two DefaultInterfaces for every inter-switch link: one on each side of the Link.
BFD#
BFD parameters can be configured on a DefaultInterface. The configured BFD session will monitor the neighboring interface, improving the fault detection time significantly if there is layer-2-only equipment in between the two switches.
Not seeing BFD sessions being established?
BFD requires a protocol to subscribe before a BFD session is created. This could be either a static route, a BGP peer, or OSPF neighbor. For example, a BGPPeer with BFD enabled will only establish a session with its peer if the underlying DefaultInterface has BFD enabled as well, and vice versa.
Dependencies#
DefaultRouter#
The DefaultInterface is always connected to a DefaultRouter, which is the abstraction for the routing table that will install the IP subnet configured on the interface. The DefaultRouter must be created before the DefaultInterface can be attached to it.
Referenced resources#
The DefaultInterface has no references to any other EDA resources.
Examples#
apiVersion: routing.eda.nokia.com/v1
kind: DefaultInterface
metadata:
name: interface-leaf-1-ethernet-1-3
namespace: eda
spec:
bfd:
desiredMinTransmitIntMs: 1000
detectionMultiplier: 3
enabled: true
requiredMinEchoReceiveIntMs: 1000
requiredMinReceiveIntMs: 1000
defaultRouter: router-leaf-1
interface: leaf-1-ethernet-1-3
ipMTU: 8922
ipv4Addresses:
- ipPrefix: 12.0.0.8/31
cat << 'EOF' | kubectl apply -f -
apiVersion: routing.eda.nokia.com/v1
kind: DefaultInterface
metadata:
name: interface-leaf-1-ethernet-1-3
namespace: eda
spec:
bfd:
desiredMinTransmitIntMs: 1000
detectionMultiplier: 3
enabled: true
requiredMinEchoReceiveIntMs: 1000
requiredMinReceiveIntMs: 1000
defaultRouter: router-leaf-1
interface: leaf-1-ethernet-1-3
ipMTU: 8922
ipv4Addresses:
- ipPrefix: 12.0.0.8/31
EOF
Custom Resource Definition#
To browse the Custom Resource Definition go to crd.eda.dev.
DefaultInterface
SPEC
DefaultInterface enables the configuration of default interfaces, including Interface references, DefaultRouter, VLAN IDs, IP MTU settings, and options for IPv4 and IPv6 addresses. It also supports unnumbered interfaces and BFD (Bidirectional Forwarding Detection) configuration.
-
Enable or disable BFD on this DefaultInterface.
-
The minimum interval in milliseconds between transmission of BFD control packets.
default: 1000range: 10 to 100000 -
The number of packets that must be missed to declare this session as down.
default: 3range: 3 to 20 -
Enables Biforward Detection.
default: false -
The minimum interval between echo packets the local node can receive.
default: 1000range: 0 to 100000 -
The minimum interval in milliseconds between received BFD control packets that this system should support.
default: 1000range: 10 to 100000 -
Sets custom IP TTL or Hop Limit for multi-hop BFD sessions packets. Not applicable to single-hop BFD sessions.
range: 2 to 255
-
-
Reference to a DefaultRouter.
-
The description of the DefaultInterface.
-
Reference to an Interface to use for attachment.
-
Set the IP MTU for the DefaultInterface.
range: 1280 to 9486 -
Subinterface index to use with this DefaultInterface. Ignored for platforms that do not support subinterface index
-
Enables the use of unnumbered interfaces on the ISL. For IPv6, no IP address are configured on the sub-interface and only the link local address will be used. If any allocation pool is specified for IPv6 that will take precedence and IPs will be assigned to the interfaces. When using eBGP for an underlay protocol, the DefaultInterfaces which are a part of the ISL will be added to the BGP dynamic neighbor list.
enum: "IPv6" -
VLAN to use with this DefaultInterface.
range: 1 to 4094
STATUS
DefaultInterfaceStatus defines the observed state of DefaultInterface
-
Indicates the health score of the DefaultInterface.
-
Indicates the reason for the health score.
-
Indicates when this Interface last changed state.
-
Indicates the current operational state of the DefaultInterface.
enum: "Up", "Down", "Degraded", "Unknown"