Skip to main content
apiVersion: v1alpha1
kind: LinkAliasConfig
name: int0 # Alias for the link.
# Selector to match the link to alias.
selector:
    match: glob("00:1a:2b:*", mac(link.permanent_addr)) # The Common Expression Language (CEL) expression to match the link.
apiVersion: v1alpha1
kind: LinkAliasConfig
name: net%d # Alias for the link.
# Selector to match the link to alias.
selector:
    match: link.driver == "e1000" # The Common Expression Language (CEL) expression to match the link.
FieldTypeDescriptionValue(s)
namestringAlias for the link.

Don’t use system interface names like “eth0”, “ens3”, “enp0s2”, etc. as those may conflict
with existing physical interfaces.

The name can contain a single integer format verb (%d) to create multiple aliases
from a single config document. When a format verb is detected, each matched link receives a sequential
alias (e.g. net0, net1, …) based on hardware address order of the links.
Links already aliased by a previous config are automatically skipped.
selectorLinkSelectorSelector to match the link to alias.

When the alias name is a fixed string, the selector must match exactly one link.
When the alias name contains a format verb (e.g. net%d), the selector may match multiple links
and each match receives a sequential alias.
If multiple selectors match the same link, the first one is used.

selector

LinkSelector selects a link to alias.
FieldTypeDescriptionValue(s)
matchExpressionThe Common Expression Language (CEL) expression to match the link.