Routed Interface#
Virtual Networks → RIRouted Interfaces
A RoutedInterface associates an Interface with a Router, usually with an IP address that is used as the source IP of originated traffic.
It is very similar to the IRBInterface, which connects a Router to a BridgeDomain. The RoutedInterface does not have to be associated with a physical interface: it can also be used with loopback1 interfaces.
The most common use cases of routed interfaces are:
- Setting up a BGP connection to a locally connected device (a firewall, a datacenter gateway)
- Establishing an OSPF neighborship between a host and the virtualized
Router - Providing a next-hop for static routes toward an internet gateway router
Dependencies#
Interface#
A RoutedInterface is always associated with a particular Interface. This interface can be virtual (a loopback1), or linked to a (set of) physical port(s).
The same physical interface can be connected to multiple virtualized Router services. A VLAN tag is used to determine which service will be used to process the packet.
Router#
The RoutedInterface enables reachability towards a particular subnet. This route may be a host route (/32) for a loopback1 interface, a point-to-point route (/31 or /30), or a bigger subnet route.
This route is installed in the routing table of the Router that the RoutedInterface is connected to. If the Interface should be connected to the default VRF, check out the DefaultInterface instead.
Referenced resources#
IndexAllocationPool#
If the RoutedInterface is connected to a physical interface, a VLAN tag should be specified to determine which packets will be processed by the Router associated with this RoutedInterface.
The VLAN tag can be manually specified (including special values null and any), or can automatically be drawn from an index allocation pool.
Filter#
Traffic that is received by or sent from the RoutedInterface can optionally be filtered by specifying one or more Filter resources in the ingress (respectively egress) container.
IngressPolicy#
Traffic that is received by the RoutedInterface can optionally be processed by one or more QoS IngressPolicies by specifying them in the ingress container.
EgressPolicy#
Traffic that is sent by the RoutedInterface can optionally be processed by one or more QoS EgressPolicies by specifying them in the egress container.
Examples#
Custom Resource Definition#
To browse the Custom Resource Definition go to crd.eda.dev.
RoutedInterface
SPEC
The RoutedInterface enables the configuration and management of Layer 3 interfaces for routing traffic between different networks. This resource allows for specifying an underlying Interface and Router, configuring VLAN IDs, and setting the IP MTU. It also supports the learning of unsolicited ARPs, defining both IPv4 and IPv6 addresses, and enabling unnumbered interfaces. Advanced features such as BFD configuration, Proxy ARP/ND, and ARP timeout settings are included to ensure robust and efficient routing.
-
Enables BFD on the RoutedInterface.
-
The minimum interval in milliseconds between transmission of BFD control packets.
default: 1000format: int32range: 10 to 100000 -
The number of packets that must be missed to declare this session as down.
default: 3format: int32range: 3 to 20 -
Enables Biforward Detection.
default: false -
The minimum interval between echo packets the local node can receive.
default: 0format: int32range: 0 to 100000 -
The minimum interval in milliseconds between received BFD control packets that this system should support.
default: 1000format: int32range: 10 to 100000 -
Sets custom IP TTL or Hop Limit for multi-hop BFD sessions packets. Not applicable to single-hop BFD sessions.
format: int32range: 2 to 255
-
-
The description of the RoutedInterface.
-
Configures host route population based on ARP/ND entries.
-
Reference to an Interface to use for attachment.
-
IP MTU for the RoutedInterface.
default: 1500format: int32range: 1280 to 9486 -
IPv4 parameters that are not applicable to IPv6.
-
Duration of time that dynamic ARP entries remain in the ARP cache before they expire.
default: 14400format: int64range: >= 0 -
Allow receiving and forwarding of directed broadcast packets. Enabled when set to true.
-
Enable or disable learning of unsolicited ARPs.
default: "Disabled"enum: "Enabled", "Disabled"
-
-
IPv6 parameters that are not applicable to IPv4.
-
Enable or disable learning of unsolicited Neighbor Advertisements.
default: "Disabled"enum: "All", "Global", "LinkLocal", "Disabled" -
Manages IPv6 Router Advertisement parameters.
-
The current hop limit to advertise in the router advertisement messages.
default: 64format: int32range: 0 to 255 -
Enable or disable IPv6 router advertisements.
default: false -
The IP MTU to advertise in the router advertisement messages.
format: int32range: 1280 to 9486 -
Enable DHCPv6 for address configuration (M-bit).
default: false -
Maximum time between router advertisements (in seconds).
default: 600format: int32range: 4 to 1800 -
Minimum time between router advertisements (in seconds).
default: 200format: int32range: 3 to 1350 -
Enable DHCPv6 for other configuration (O-bit).
default: false -
IPv6 prefixes to advertise in router advertisements.
-
IPv6Prefix defines the configuration for an IPv6 prefix advertisement.
-
When this is set in the prefix information option hosts can use the prefix for stateless address autoconfiguration (SLAAC).
default: true -
When this is set in the prefix information option hosts can use the prefix for on-link determination.
default: true -
The length of time in seconds (relative to the time the packet is sent) that addresses generated from the prefix via stateless address autoconfiguration remain preferred.
default: 604800format: int64range: >= 0 -
An IPv6 global unicast address prefix.
-
The length of time in seconds (relative to the time the packet is sent) that the prefix is valid for the purpose of on-link determination.
default: 2592000format: int64range: >= 0
-
-
-
Time in milliseconds for Neighbor Unreachability Detection.
default: 0format: int32range: 0 to 3600000 -
Time in milliseconds between retransmitted NS messages.
default: 0format: int32range: 0 to 1800000 -
Router lifetime in seconds for default gateway.
default: 1800format: int32range: 0 to 9000
-
-
-
Reference to a Router.
-
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.
default: "pool" -
Reference to a VLAN pool to use for allocations.
default: "vlan-pool"
STATUS
RoutedInterfaceStatus defines the observed state of RoutedInterface
-
Indicates the health score of the RoutedInterface.
format: int32range: <= 100 -
Indicates the reason for the health score.
-
The time when the state of the resource last changed.
-
Operational state of the RoutedInterface.
enum: "Up", "Down", "Degraded", "Unknown" -
Sub-interface status within the RoutedInterface.
-
-
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.
-
-