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 a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox