From: Gabriel Goller <g.goller@proxmox.com>
To: pve-devel@lists.proxmox.com
Subject: [PATCH pve-manager v3 25/28] network: allow setting the VRF of host interfaces
Date: Thu, 19 Nov 2026 20:41:11 +0100 [thread overview]
Message-ID: <20261119194116.575520-26-g.goller@proxmox.com> (raw)
In-Reply-To: <20261119194116.575520-1-g.goller@proxmox.com>
Host interfaces can now be put into a VRF from the network panel. The
VRF field suggests the VRFs of applied SDN zones on this node, but also
accepts other VRF names, for example a VRF configured by hand.
Interfaces that are part of a fabric get their VRF from the fabric, so
setting one is rejected and the field is read-only for them. Their
other settings stay editable.
The duplicate gateway check now only compares interfaces in the same
VRF, because every VRF has its own default route.
Signed-off-by: Gabriel Goller <g.goller@proxmox.com>
---
PVE/API2/Network.pm | 55 ++++++++++++++++++++++------
www/manager6/form/SDNZoneSelector.js | 44 ++++++++++++++++++----
www/manager6/node/Config.js | 12 ++++++
3 files changed, 93 insertions(+), 18 deletions(-)
diff --git a/PVE/API2/Network.pm b/PVE/API2/Network.pm
index 6f8854822f00..74d63cfe9f0b 100644
--- a/PVE/API2/Network.pm
+++ b/PVE/API2/Network.pm
@@ -165,6 +165,14 @@ my $confdesc = {
minimum => 1,
maximum => 4094,
},
+ vrf => {
+ description => 'VRF master interface.',
+ type => 'string',
+ minLength => 1,
+ maxLength => 15,
+ pattern => '[a-zA-Z0-9_][a-zA-Z0-9_.-]*',
+ optional => 1,
+ },
gateway => {
description => 'Default gateway address.',
type => 'string',
@@ -520,7 +528,9 @@ __PACKAGE__->register_method({
my $check_duplicate = sub {
my ($config, $newiface, $key, $name) = @_;
+ my $vrf = $config->{$newiface}->{vrf} // '';
foreach my $iface (keys %$config) {
+ next if ($config->{$iface}->{vrf} // '') ne $vrf;
raise_param_exc({ $key => "$name already exists on interface '$iface'." })
if ($newiface ne $iface) && $config->{$iface}->{$key};
}
@@ -652,10 +662,12 @@ __PACKAGE__->register_method({
raise_param_exc({ iface => "interface already exists" })
if $ifaces->{$iface};
- &$check_duplicate_gateway($ifaces, $iface)
- if $param->{gateway};
- &$check_duplicate_gateway6($ifaces, $iface)
- if $param->{gateway6};
+ if ($have_sdn && $param->{vrf}) {
+ my $fabrics = PVE::Network::SDN::Fabrics::config();
+ raise_param_exc({
+ vrf => "cannot set VRF on an interface that is part of a fabric" })
+ if $fabrics->is_fabric_interface(PVE::INotify::nodename(), $iface);
+ }
$check_duplicate_ports->($ifaces, $iface, $param);
@@ -704,6 +716,8 @@ __PACKAGE__->register_method({
if $param->{bridge_vids};
$ifaces->{$iface} = $param;
+ $check_duplicate_gateway->($ifaces, $iface) if $param->{gateway};
+ $check_duplicate_gateway6->($ifaces, $iface) if $param->{gateway6};
PVE::INotify::write_file('interfaces', $config);
};
@@ -753,6 +767,15 @@ __PACKAGE__->register_method({
raise_param_exc({ iface => "interface does not exist" })
if !$ifaces->{$iface};
+ if (
+ $have_sdn && $param->{vrf} && $param->{vrf} ne ($ifaces->{$iface}->{vrf} // '')
+ ) {
+ my $fabrics = PVE::Network::SDN::Fabrics::config();
+ raise_param_exc({
+ vrf => "cannot set VRF on an interface that is part of a fabric" })
+ if $fabrics->is_fabric_interface(PVE::INotify::nodename(), $iface);
+ }
+
my $families = ($param->{families} ||= []);
foreach my $k (PVE::Tools::split_list($delete)) {
delete $ifaces->{$iface}->{$k};
@@ -769,11 +792,6 @@ __PACKAGE__->register_method({
$map_cidr_to_address_netmask->($param);
- &$check_duplicate_gateway($ifaces, $iface)
- if $param->{gateway};
- &$check_duplicate_gateway6($ifaces, $iface)
- if $param->{gateway6};
-
$check_duplicate_ports->($ifaces, $iface, $param);
if ($param->{address}) {
@@ -795,6 +813,8 @@ __PACKAGE__->register_method({
foreach my $k (keys %$param) {
$ifaces->{$iface}->{$k} = $param->{$k};
}
+ $check_duplicate_gateway->($ifaces, $iface) if $ifaces->{$iface}->{gateway};
+ $check_duplicate_gateway6->($ifaces, $iface) if $ifaces->{$iface}->{gateway6};
if (
$param->{bridge_vids}
@@ -842,6 +862,12 @@ __PACKAGE__->register_method({
method => {
type => 'string',
},
+ 'vrf-readonly' => {
+ type => 'boolean',
+ optional => 1,
+ description =>
+ 'The VRF field is managed by an SDN fabric and should be disabled in the host network editor.',
+ },
},
},
code => sub {
@@ -855,10 +881,17 @@ __PACKAGE__->register_method({
raise_param_exc({ iface => "interface does not exist" })
if !$ifaces->{$iface};
+ my $data = { $ifaces->{$iface}->%* };
my $altnames = extract_altnames($iface);
- $ifaces->{$iface}->{altnames} = $altnames if defined($altnames);
+ $data->{altnames} = $altnames if defined($altnames);
+
+ if ($have_sdn) {
+ my $fabrics = PVE::Network::SDN::Fabrics::config();
+ $data->{'vrf-readonly'} = 1
+ if $fabrics->is_fabric_interface(PVE::INotify::nodename(), $iface);
+ }
- return $ifaces->{$iface};
+ return $data;
},
});
diff --git a/www/manager6/form/SDNZoneSelector.js b/www/manager6/form/SDNZoneSelector.js
index dde25371f18d..dfd516add5ca 100644
--- a/www/manager6/form/SDNZoneSelector.js
+++ b/www/manager6/form/SDNZoneSelector.js
@@ -5,12 +5,19 @@ Ext.define(
alias: ['widget.pveSDNZoneSelector'],
allowBlank: false,
+ // Use 'vrf' to submit the native VRF interface name instead of the zone ID.
valueField: 'zone',
displayField: 'zone',
// Only show simple zones which create a dedicated VRF.
vrfOnly: false,
+ // Only show zones available on this node, if specified.
+ nodename: undefined,
+
+ // Only show zones from the applied SDN configuration, not pending changes.
+ running: false,
+
initComponent: function () {
var me = this;
@@ -20,15 +27,29 @@ Ext.define(
property: 'zone',
direction: 'ASC',
},
- filters: me.vrfOnly
- ? [
- function (record) {
- return record.get('type') === 'simple' && record.get('dedicated-vrf');
- },
- ]
- : [],
+ filters: [
+ function (record) {
+ return (
+ !me.vrfOnly ||
+ (record.get('type') === 'simple' && record.get('dedicated-vrf'))
+ );
+ },
+ function (record) {
+ let nodes = record.get('nodes');
+ return !me.nodename || !nodes || nodes.split(',').includes(me.nodename);
+ },
+ ],
});
+ if (me.running) {
+ // Don't touch the shared model proxy, other selectors need the pending config.
+ store.setProxy({
+ type: 'proxmox',
+ url: '/api2/json/cluster/sdn/zones',
+ extraParams: { running: 1 },
+ });
+ }
+
Ext.apply(me, {
store: store,
autoSelect: false,
@@ -55,6 +76,15 @@ Ext.define(
fields: [
'zone',
'type',
+ 'nodes',
+ {
+ name: 'vrf',
+ // Preserve custom values in the synthetic records created by ComboBox.
+ convert: (value, record) => {
+ let zone = record.get('zone');
+ return value ?? (zone ? `vrf_${zone}` : value);
+ },
+ },
{ name: 'dedicated-vrf', type: 'boolean', defaultValue: false },
],
proxy: {
diff --git a/www/manager6/node/Config.js b/www/manager6/node/Config.js
index 747119379e75..4cfb1dc69a8f 100644
--- a/www/manager6/node/Config.js
+++ b/www/manager6/node/Config.js
@@ -196,6 +196,18 @@ Ext.define('PVE.node.Config', {
nodename: nodename,
editOptions: {
enableBridgeVlanIds: true,
+ vrfSelector: {
+ xtype: 'pveSDNZoneSelector',
+ running: true,
+ vrfOnly: true,
+ valueField: 'vrf',
+ displayField: 'vrf',
+ editable: true,
+ forceSelection: false,
+ anyMatch: true,
+ maxLength: 15,
+ notFoundIsValid: true,
+ },
},
onlineHelp: 'sysadmin_network_configuration',
},
--
2.47.3
next prev parent reply other threads:[~2026-11-19 19:44 UTC|newest]
Thread overview: 29+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-11-19 19:40 [PATCH common/manager/network/proxmox{-ve-rs,-perl-rs,-widget-toolkit} v3 00/28] SDN VRF support Gabriel Goller
2026-11-19 19:40 ` [PATCH pve-common v3 01/28] interfaces: preserve VRF membership across address family changes Gabriel Goller
2026-11-19 19:40 ` [PATCH proxmox-ve-rs v3 02/28] frr: add VRF-aware OSPF rendering Gabriel Goller
2026-11-19 19:40 ` [PATCH proxmox-ve-rs v3 03/28] sdn: add zone references to OSPF and BGP fabrics Gabriel Goller
2026-11-19 19:40 ` [PATCH proxmox-ve-rs v3 04/28] sdn: generate fabric routing configuration in zone VRFs Gabriel Goller
2026-11-19 19:40 ` [PATCH proxmox-ve-rs v3 05/28] sdn: fix VRF route-map scoping and zone ID validation Gabriel Goller
2026-11-19 19:40 ` [PATCH proxmox-ve-rs v3 06/28] tests: fabrics: add tests for fabrics in VRFs Gabriel Goller
2026-11-19 19:40 ` [PATCH proxmox-ve-rs v3 07/28] sdn: allow static routes in simple zone VRFs Gabriel Goller
2026-11-19 19:40 ` [PATCH proxmox-perl-rs v3 08/28] pve-rs: fabrics: assign network interfaces to configured VRFs Gabriel Goller
2026-11-19 19:40 ` [PATCH proxmox-perl-rs v3 09/28] pve-rs: fabrics: make per-fabric status queries VRF-aware Gabriel Goller
2026-11-19 19:40 ` [PATCH proxmox-perl-rs v3 10/28] pve-rs: fabrics: include VRF routes in aggregate status Gabriel Goller
2026-11-19 19:40 ` [PATCH proxmox-perl-rs v3 11/28] pve-rs: fabrics: expose host interface membership Gabriel Goller
2026-11-19 19:40 ` [PATCH proxmox-perl-rs v3 12/28] sdn: expose static routes for simple zone uplinks Gabriel Goller
2026-11-19 19:40 ` [PATCH pve-network v3 13/28] sdn: evpn: add unreachable IPv6 default route to zone VRFs Gabriel Goller
2026-11-19 19:41 ` [PATCH pve-network v3 14/28] sdn: add optional VRFs for simple zones Gabriel Goller
2026-11-19 19:41 ` [PATCH pve-network v3 15/28] sdn: allow fabrics to use simple zone VRFs Gabriel Goller
2026-11-19 19:41 ` [PATCH pve-network v3 16/28] sdn: require underlay fabrics to use the default VRF Gabriel Goller
2026-11-19 19:41 ` [PATCH pve-network v3 17/28] sdn: move full range CIDR formats into a separate module Gabriel Goller
2026-11-19 19:41 ` [PATCH pve-network v3 18/28] sdn: simple: support static routes in zone routing tables Gabriel Goller
2026-11-19 19:41 ` [PATCH pve-network v3 19/28] sdn: dhcp: only configure DHCP for zones on the local node Gabriel Goller
2026-11-19 19:41 ` [PATCH pve-network v3 20/28] sdn: dhcp: run dnsmasq in the zone VRF Gabriel Goller
2026-11-19 19:41 ` [PATCH pve-network v3 21/28] sdn: dhcp: fix DNS server option for IPv4 subnets without gateway Gabriel Goller
2026-11-19 19:41 ` [PATCH pve-network v3 22/28] sdn: evpn: no exit node null routes for simple zone VRFs Gabriel Goller
2026-11-19 19:41 ` [PATCH proxmox-widget-toolkit v3 23/28] ui: network: allow selecting a VRF for host interfaces Gabriel Goller
2026-11-19 19:41 ` [PATCH pve-manager v3 24/28] ui: sdn: add VRF zone selection for fabrics Gabriel Goller
2026-11-19 19:41 ` Gabriel Goller [this message]
2026-11-19 19:41 ` [PATCH pve-manager v3 26/28] ui: sdn: allow static routes for Simple zone VRFs Gabriel Goller
2026-11-19 19:41 ` [PATCH pve-manager v3 27/28] network: generate SDN DHCP config after ifreload Gabriel Goller
2026-11-19 19:41 ` [PATCH pve-manager v3 28/28] ui: sdn: subnet: allow setting the DHCP DNS server Gabriel Goller
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20261119194116.575520-26-g.goller@proxmox.com \
--to=g.goller@proxmox.com \
--cc=pve-devel@lists.proxmox.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.