Physical network¶
The physical network type connects to an existing physical network, which can be a network interface or a bridge, and serves as an uplink network for OVN.
This network type allows to specify presets to use when connecting OVN networks to a parent interface or to allow an instance to use a physical interface as a NIC.
In this case, the instance NICs can simply set the networkoption to the network they connect to without knowing any of the underlying configuration details.
Configuration options¶
The following configuration key namespaces are currently supported for the physical network type:
bgp(BGP peer configuration)dns(DNS server and resolution configuration)ipv4(L3 IPv4 configuration)ipv6(L3 IPv6 configuration)maas(MAAS network identification)ovn(OVN configuration)user(free-form key/value for user metadata)
Note
LXD uses the CIDR notation where network subnet information is required, for example, 192.0.2.0/24 or 2001:db8::/32. This does not apply to cases where a single address is required, for example, local/remote addresses of tunnels, NAT addresses or specific addresses to apply to an instance.
The following configuration options are available for the physical network type:
| Key: | bgp.peers.NAME.address |
| Type: | string |
| Condition: | BGP server |
| Scope: | global |
The address can be IPv4 or IPv6.
| Key: | bgp.peers.NAME.asn |
| Type: | integer |
| Condition: | BGP server |
| Scope: | global |
| Key: | bgp.peers.NAME.holdtime |
| Type: | integer |
| Default: |
|
| Condition: | BGP server |
| Required: | no |
| Scope: | global |
Specify the peer session hold time in seconds.
| Key: | bgp.peers.NAME.password |
| Type: | string |
| Default: | (no password) |
| Condition: | BGP server |
| Required: | no |
| Scope: | global |
| Key: | dns.nameservers |
| Type: | string |
| Condition: | standard mode |
| Scope: | global |
Specify a list of DNS server IPs.
| Key: | gvrp |
| Type: | bool |
| Default: |
|
| Scope: | global |
This option specifies whether to register the VLAN using the GARP VLAN Registration Protocol.
| Key: | ipv4.gateway |
| Type: | string |
| Condition: | standard mode |
| Scope: | global |
Use CIDR notation.
| Key: | ipv4.ovn.ranges |
| Type: | string |
| Scope: | global |
Specify a comma-separated list of IPv4 ranges in FIRST-LAST format.
| Key: | ipv4.routes |
| Type: | string |
| Condition: | IPv4 address |
| Scope: | global |
Specify a comma-separated list of IPv4 CIDR subnets that can be used with child OVN network forwarders, load-balancers and ipv4.routes.external setting.
| Key: | ipv4.routes.anycast |
| Type: | bool |
| Default: |
|
| Condition: | IPv4 address |
| Scope: | global |
If set to true, this option allows the overlapping routes to be used on multiple networks/NICs at the same time.
| Key: | ipv6.gateway |
| Type: | string |
| Condition: | standard mode |
| Scope: | global |
Use CIDR notation.
| Key: | ipv6.ovn.ranges |
| Type: | string |
| Scope: | global |
Specify a comma-separated list of IPv6 ranges in FIRST-LAST format.
| Key: | ipv6.routes |
| Type: | string |
| Condition: | IPv6 address |
| Scope: | global |
Specify a comma-separated list of IPv6 CIDR subnets that can be used with child OVN network forwarders, load-balancers and ipv6.routes.external setting.
| Key: | ipv6.routes.anycast |
| Type: | bool |
| Default: |
|
| Condition: | IPv6 address |
| Scope: | global |
If set to true, this option allows the overlapping routes to be used on multiple networks/NICs at the same time.
| Key: | maas.subnet.ipv4 |
| Type: | string |
| Condition: | IPv4 address; using the |
| Scope: | global |
| Key: | maas.subnet.ipv6 |
| Type: | string |
| Condition: | IPv6 address; using the |
| Scope: | global |
| Key: | ovn.ingress_mode |
| Type: | string |
| Default: |
|
| Condition: | standard mode |
| Scope: | global |
Possible values are l2proxy (proxy ARP/NDP) and routed.
Supported features¶
The following features are supported for the physical network type: