Rename debian.interfaces to ifupdown

When I first split the debian interfaces support from wwinit, I was unable to
figure out what it was called. I used the inelegant name "debian.interfaces" to
identify it; but I have since learned that it is called "ifupdown." I have
since learned that there is even a variant implementation, ifupdown-ng, that is
used by Alpine Linux.

This PR renames the overlay to ifupdown, but retains a copy of it at
debian.interfaces for backwards compatibility.

Signed-off-by: Jonathon Anderson <janderson@ciq.com>
This commit is contained in:
Jonathon Anderson
2025-09-07 08:24:47 -06:00
parent f36a373b8b
commit 91a69e8756
17 changed files with 44 additions and 21 deletions

View File

@@ -6,6 +6,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
## v4.6.5, unreleased
### Changed
- Renamed debian.interfaces overlay to ifupdown
## v4.6.4, 2025-09-05
### Added

View File

@@ -217,6 +217,9 @@ install: build docs ## Install Warewulf from source
chmod 0644 $(DESTDIR)$(DATADIR)/warewulf/overlays/ssh.host_keys/rootfs/etc/ssh/ssh*.pub.ww
chmod 0600 $(DESTDIR)$(DATADIR)/warewulf/overlays/NetworkManager/rootfs/etc/NetworkManager/system-connections/ww4-managed.ww
chmod 0750 $(DESTDIR)$(DATADIR)/warewulf/overlays/host/rootfs
rm -rf $(DESTDIR)$(DATADIR)/warewulf/overlays/debian.interfaces # replacing symlink with a copy
install -d -m 755 $(DESTDIR)$(DATADIR)/warewulf/overlays/debian.interfaces
cp -a $(DESTDIR)$(DATADIR)/warewulf/overlays/ifupdown/* $(DESTDIR)$(DATADIR)/warewulf/overlays/debian.interfaces/
install -m 0755 wwctl $(DESTDIR)$(BINDIR)
install -m 0755 wwclient $(DESTDIR)$(DATADIR)/warewulf/overlays/wwclient/rootfs/$(WWCLIENTDIR)/wwclient
install -m 0644 include/firewalld/warewulf.xml $(DESTDIR)$(FIREWALLDDIR)

View File

@@ -15,8 +15,8 @@ nodeprofiles:
- udev.netname
- systemd.netname
- ifcfg
- ifupdown
- NetworkManager
- debian.interfaces
- wicked
- ignition
kernel:

View File

@@ -34,8 +34,8 @@ func Benchmark_Overlay_Build(b *testing.B) {
- udev.netname
- systemd.netname
- ifcfg
- ifupdown
- NetworkManager
- debian.interfaces
- wicked
- ignition
kernel:
@@ -3044,7 +3044,7 @@ nodes:
- default`)
runtimeOverlays := []string{"hosts", "ssh.authorized_keys", "syncuser"}
systemOverlays := []string{"wwinit", "wwclient", "fstab", "hostname", "ssh.host_keys", "issue", "resolv", "udev.netname", "systemd.netname", "ifcfg", "NetworkManager", "debian.interfaces", "wicked", "ignition"}
systemOverlays := []string{"wwinit", "wwclient", "fstab", "hostname", "ssh.host_keys", "issue", "resolv", "udev.netname", "systemd.netname", "ifcfg", "ifupdown", "NetworkManager", "wicked", "ignition"}
for _, overlay := range append(runtimeOverlays, systemOverlays...) {
env.ImportDir(

View File

@@ -25,8 +25,8 @@ var wwinitSplitOverlays = []string{
"udev.netname",
"systemd.netname",
"ifcfg",
"ifupdown",
"NetworkManager",
"debian.interfaces",
"wicked",
"ignition",
}

View File

@@ -638,8 +638,8 @@ nodeprofiles:
- udev.netname
- systemd.netname
- ifcfg
- ifupdown
- NetworkManager
- debian.interfaces
- wicked
- ignition
kernel:
@@ -781,8 +781,8 @@ nodeprofiles:
- udev.netname
- systemd.netname
- ifcfg
- ifupdown
- NetworkManager
- debian.interfaces
- wicked
- ignition
nodes:
@@ -802,8 +802,8 @@ nodes:
- udev.netname
- systemd.netname
- ifcfg
- ifupdown
- NetworkManager
- debian.interfaces
- wicked
- ignition
`,
@@ -830,8 +830,8 @@ nodeprofiles:
- udev.netname
- systemd.netname
- ifcfg
- ifupdown
- NetworkManager
- debian.interfaces
- wicked
- ignition
nodes:
@@ -851,8 +851,8 @@ nodes:
- udev.netname
- systemd.netname
- ifcfg
- ifupdown
- NetworkManager
- debian.interfaces
- wicked
- ignition
`,
@@ -874,8 +874,8 @@ nodeprofiles:
- udev.netname
- systemd.netname
- ifcfg
- ifupdown
- NetworkManager
- debian.interfaces
- wicked
- ignition
nodes:
@@ -895,8 +895,8 @@ nodes:
- udev.netname
- systemd.netname
- ifcfg
- ifupdown
- NetworkManager
- debian.interfaces
- wicked
- ignition
`,
@@ -1076,8 +1076,8 @@ nodeprofiles:
- udev.netname
- systemd.netname
- ifcfg
- ifupdown
- NetworkManager
- debian.interfaces
- wicked
- ignition
kernel:

1
overlays/debian.interfaces Symbolic link
View File

@@ -0,0 +1 @@
ifupdown

View File

@@ -143,8 +143,8 @@ node methods in addition to its fields.
- udev.netname
- systemd.netname
- ifcfg
- ifupdown
- NetworkManager
- debian.interfaces
- wicked
- ignition
- Init: /sbin/init

View File

@@ -15,8 +15,8 @@ nodeprofiles:
- udev.netname
- systemd.netname
- ifcfg
- ifupdown
- NetworkManager
- debian.interfaces
- wicked
- ignition
kernel:

View File

@@ -13,7 +13,9 @@ import (
func Test_wickedOverlay(t *testing.T) {
env := testenv.New(t)
defer env.RemoveAll()
env.ImportFile("var/lib/warewulf/overlays/debian.interfaces/rootfs/etc/network/interfaces.d/default.ww", "../rootfs/etc/network/interfaces.d/default.ww")
env.ImportFile("var/lib/warewulf/overlays/ifupdown/rootfs/etc/network/interfaces.d/default.ww", "../rootfs/etc/network/interfaces.d/default.ww")
tests := []struct {
name string
@@ -25,7 +27,13 @@ func Test_wickedOverlay(t *testing.T) {
name: "debian.interfaces",
nodes_conf: "nodes.conf",
args: []string{"--render", "node1", "debian.interfaces", "etc/network/interfaces.d/default.ww"},
log: debian_interfaces,
log: expected_log,
},
{
name: "ifupdown",
nodes_conf: "nodes.conf",
args: []string{"--render", "node1", "ifupdown", "etc/network/interfaces.d/default.ww"},
log: expected_log,
},
}
@@ -49,7 +57,7 @@ func Test_wickedOverlay(t *testing.T) {
}
}
const debian_interfaces string = `backupFile: true
const expected_log string = `backupFile: true
writeFile: true
Filename: default

View File

@@ -80,7 +80,7 @@ You can also see the node's full attribute list by specifying ``--all``.
n1 Comment default This profile is automatically included for each node
n1 Ipxe default default
n1 RuntimeOverlay default hosts,ssh.authorized_keys
n1 SystemOverlay default wwinit,wwclient,fstab,hostname,ssh.host_keys,issue,resolv,udev.netname,systemd.netname,ifcfg,NetworkManager,debian.interfaces,wicked,ignition
n1 SystemOverlay default wwinit,wwclient,fstab,hostname,ssh.host_keys,issue,resolv,udev.netname,systemd.netname,ifcfg,ifupdown,NetworkManager,wicked,ignition
n1 Kernel.Args default quiet,crashkernel=no
n1 Init default /sbin/init
n1 Root default initramfs

View File

@@ -39,7 +39,7 @@ You can view the fields of a profile with ``wwctl profile --all``.
default ImageName --
default Ipxe default
default RuntimeOverlay hosts,ssh.authorized_keys
default SystemOverlay wwinit,wwclient,fstab,hostname,ssh.host_keys,issue,resolv,udev.netname,systemd.netname,ifcfg,NetworkManager,debian.interfaces,wicked,ignition
default SystemOverlay wwinit,wwclient,fstab,hostname,ssh.host_keys,issue,resolv,udev.netname,systemd.netname,ifcfg,ifupdown,NetworkManager,wicked,ignition
default Kernel.Version --
default Kernel.Args quiet,crashkernel=no
default Init /sbin/init
@@ -58,7 +58,7 @@ You can view the fields of a profile with ``wwctl profile --all``.
n1 Comment default This profile is automatically included for each node
n1 Ipxe default default
n1 RuntimeOverlay default hosts,ssh.authorized_keys
n1 SystemOverlay default wwinit,wwclient,fstab,hostname,ssh.host_keys,issue,resolv,udev.netname,systemd.netname,ifcfg,NetworkManager,debian.interfaces,wicked,ignition
n1 SystemOverlay default wwinit,wwclient,fstab,hostname,ssh.host_keys,issue,resolv,udev.netname,systemd.netname,ifcfg,ifupdown,NetworkManager,wicked,ignition
n1 Kernel.Args default quiet,crashkernel=no
n1 Init default /sbin/init
n1 Root default initramfs
@@ -108,7 +108,7 @@ to each node.
n1 ImageName image rockylinux-9
n1 Ipxe default default
n1 RuntimeOverlay default hosts,ssh.authorized_keys
n1 SystemOverlay default wwinit,wwclient,fstab,hostname,ssh.host_keys,issue,resolv,udev.netname,systemd.netname,ifcfg,NetworkManager,debian.interfaces,wicked,ignition
n1 SystemOverlay default wwinit,wwclient,fstab,hostname,ssh.host_keys,issue,resolv,udev.netname,systemd.netname,ifcfg,ifupdown,NetworkManager,wicked,ignition
n1 Kernel.Args default quiet,crashkernel=no
n1 Init default /sbin/init
n1 Root default initramfs

View File

@@ -221,10 +221,16 @@ systems. All of these are applied by default; but the list may be trimmed to
the desired system.
- ifcfg
- ifupdown
- NetworkManager
- debian.interfaces
- wicked
.. note::
The ``ifupdown`` overlay was previously named ``debian.interfaces``. The old
name is still supported for compatibility, but it is deprecated and will be
removed in a future release.
Warewulf also configures both systemd and udev with the intended names of
configured network interfaces, typically based on a known MAC address.

View File

@@ -194,6 +194,7 @@ getent group %{wwgroup} >/dev/null || groupadd -r %{wwgroup}
%{_overlaydir}/hostname/rootfs/*
%{_overlaydir}/hosts/rootfs/*
%{_overlaydir}/ifcfg/rootfs/*
%{_overlaydir}/ifupdown/rootfs/*
%{_overlaydir}/ignition/rootfs/*
%{_overlaydir}/issue/rootfs/*
%{_overlaydir}/netplan/rootfs/*