Skip to main content
apiVersion: v1alpha1
kind: BondConfig
name: bond.int # Name of the bond link (interface) to be created.
# Names of the links (interfaces) on which the bond will be created.
links:
    - enp1s2
    - enp1s2
bondMode: 802.3ad # Bond mode.
miimon: 100 # Link monitoring frequency in milliseconds.
updelay: 200 # The time, in milliseconds, to wait before enabling a slave after a link recovery has been detected.
downdelay: 200 # The time, in milliseconds, to wait before disabling a slave after a link failure has been detected.
xmitHashPolicy: layer3+4 # Selects the transmit hash policy to use for slave selection.
lacpRate: slow # LACPDU frames periodic transmission rate.
adActorSysPrio: 65535 # Actor system priority for 802.3ad.
resendIGMP: 1 # The number of times IGMP packets should be resent.
packetsPerSlave: 1 # The number of packets to transmit through a slave before moving to the next one.
# Configure addresses to be statically assigned to the link.
addresses:
    - address: 10.15.0.3/16 # IP address to be assigned to the link.
# Configure routes to be statically created via the link.
routes:
    - destination: 10.0.0.0/8 # The route's destination as an address prefix.
      gateway: 10.15.0.1 # The route's gateway (if empty, creates link scope route).

# # Override the hardware (MAC) address of the link.
# hardwareAddr: 2e:3c:4d:5e:6f:70

# # ARP link monitoring frequency in milliseconds.
# arpInterval: 1000

# # The list of IPv4 addresses to use for ARP link monitoring when arpInterval is set.
# arpIpTargets:
#     - 10.15.0.1

# # The list of IPv6 addresses to use for NS link monitoring when arpInterval is set.
# nsIp6Targets:
#     - fd00::1

# # Specifies whether or not ARP probes and replies should be validated.
# arpValidate: active

# # Specifies whether ARP probes should be sent to any or all targets.
# arpAllTargets: all

# # Specifies whether active-backup mode should set all slaves to the same MAC address
# failOverMac: active

# # Aggregate selection policy for 802.3ad.
# adSelect: stable

# # Whether to send LACPDU frames periodically.
# adLACPActive: on

# # Policy under which the primary slave should be reselected.
# primaryReselect: always

# # Whether dynamic shuffling of flows is enabled in tlb or alb mode.
# tlbLogicalLb: 1
FieldTypeDescriptionValue(s)
namestringName of the bond link (interface) to be created.
hardwareAddrHardwareAddrOverride the hardware (MAC) address of the link.
links[]stringNames of the links (interfaces) on which the bond will be created.
Link aliases can be used here as well.
bondModeBondModeBond mode.balance-rr
active-backup
balance-xor
broadcast
802.3ad
balance-tlb
balance-alb
miimonuint32Link monitoring frequency in milliseconds.
updelayuint32The time, in milliseconds, to wait before enabling a slave after a link recovery has been detected.
downdelayuint32The time, in milliseconds, to wait before disabling a slave after a link failure has been detected.
useCarrierboolSpecifies whether or not miimon should use MII or ETHTOOL.
xmitHashPolicyBondXmitHashPolicySelects the transmit hash policy to use for slave selection.layer2
layer3+4
layer2+3
encap2+3
encap3+4
arpIntervaluint32ARP link monitoring frequency in milliseconds.
arpIpTargets[]AddrThe list of IPv4 addresses to use for ARP link monitoring when arpInterval is set.
Maximum of 16 targets are supported.
nsIp6Targets[]AddrThe list of IPv6 addresses to use for NS link monitoring when arpInterval is set.
Maximum of 16 targets are supported.
arpValidateARPValidateSpecifies whether or not ARP probes and replies should be validated.none
active
backup
all
filter
filter-active
filter-backup
arpAllTargetsARPAllTargetsSpecifies whether ARP probes should be sent to any or all targets.any
all
lacpRateLACPRateLACPDU frames periodic transmission rate.slow
fast
failOverMacFailOverMACSpecifies whether active-backup mode should set all slaves to the same MAC address
at enslavement, when enabled, or perform special handling.
none
active
follow
adSelectADSelectAggregate selection policy for 802.3ad.stable
bandwidth
count
adActorSysPriouint16Actor system priority for 802.3ad.
adUserPortKeyuint16User port key (upper 10 bits) for 802.3ad.
adLACPActiveADLACPActiveWhether to send LACPDU frames periodically.on
off
primaryReselectPrimaryReselectPolicy under which the primary slave should be reselected.always
better
failure
resendIGMPuint32The number of times IGMP packets should be resent.
minLinksuint32The minimum number of active links required for the bond to be considered active.
lpIntervaluint32The number of seconds between instances where the bonding driver sends learning packets to each slave’s peer switch.
packetsPerSlaveuint32The number of packets to transmit through a slave before moving to the next one.
numPeerNotifuint8The number of peer notifications (gratuitous ARPs and unsolicited IPv6 Neighbor Advertisements)
to be issued after a failover event.
tlbLogicalLbuint8Whether dynamic shuffling of flows is enabled in tlb or alb mode.
allSlavesActiveuint8Whether duplicate frames (received on inactive ports) should be dropped (0) or delivered (1).
peerNotifDelayuint32The delay, in milliseconds, between each peer notification.
missedMaxuint8The number of arpInterval monitor checks that must fail in order for an interface to be marked down by the ARP monitor.
upboolBring the link up or down.

If not specified, the link will be brought up.
mtuuint32Configure LinkMTU (Maximum Transmission Unit) for the link.

If not specified, the system default LinkMTU will be used (usually 1500).
addressesAddressConfigConfigure addresses to be statically assigned to the link.
routesRouteConfigConfigure routes to be statically created via the link.
multicastboolSet the multicast capability of the link.

addresses[]

AddressConfig represents a network address configuration.
FieldTypeDescriptionValue(s)
addressPrefixIP address to be assigned to the link.

This field must include the network prefix length (e.g. /24 for IPv4, /64 for IPv6).
routePriorityuint32Configure the route priority (metric) for routes created for this address.

If not specified, the system default route priority will be used.

routes[]

RouteConfig represents a network route configuration.
FieldTypeDescriptionValue(s)
destinationPrefixThe route’s destination as an address prefix.

If not specified, a default route will be created for the address family of the gateway.
gatewayAddrThe route’s gateway (if empty, creates link scope route).
sourceAddrThe route’s source address (optional).
metricuint32The optional metric for the route.
mtuuint32The optional MTU for the route.
tableRoutingTableThe routing table to use for the route.

If not specified, the main routing table will be used.