website/content/v1.13/reference/configuration/network/linkaliasconfig.md
{{< highlight yaml >}} apiVersion: v1alpha1 kind: LinkAliasConfig name: int0 # Alias for the link.
selector: match: glob("00:1a:2b:*", mac(link.permanent_addr)) # The Common Expression Language (CEL) expression to match the link. {{< /highlight >}}
{{< highlight yaml >}} apiVersion: v1alpha1 kind: LinkAliasConfig name: net%d # Alias for the link.
selector: match: link.driver == "e1000" # The Common Expression Language (CEL) expression to match the link. {{< /highlight >}}
| Field | Type | Description | Value(s) |
|---|---|---|---|
name | string | Alias 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. <details><summary>Show example(s)</summary>{{< highlight yaml >}}
name: net0
{{< /highlight >}}{{< highlight yaml >}}
name: private
{{< /highlight >}}{{< highlight yaml >}}
name: net%d
{{< /highlight >}}</details> | |
|selector |<a href="#LinkAliasConfig.selector">LinkSelector</a> |Selector 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. | |
LinkSelector selects a link to alias.
| Field | Type | Description | Value(s) |
|---|---|---|---|
match | Expression | The Common Expression Language (CEL) expression to match the link. <details><summary>Show example(s)</summary>match links with a specific MAC address:{{< highlight yaml >}} | |
| match: mac(link.permanent_addr) == "00:1a:2b:3c:4d:5e" | |||
| {{< /highlight >}}match links by MAC address prefix:{{< highlight yaml >}} | |||
| match: glob("00:1a:2b:*", mac(link.permanent_addr)) | |||
| {{< /highlight >}}match links by driver name:{{< highlight yaml >}} | |||
| match: link.driver == "e1000" | |||
| {{< /highlight >}}</details> |