From 70eb60bd2ccac47d7c92f5a60402168426c151d4 Mon Sep 17 00:00:00 2001 From: Jonathon Anderson Date: Fri, 1 Aug 2025 16:42:47 -0600 Subject: [PATCH] v4.6.3 release Signed-off-by: Jonathon Anderson --- .github/releases/v4.6.3.md | 13 ++++ CHANGELOG.md | 6 +- RELEASE.md | 4 +- .../getting-started/debian-quickstart.rst | 2 +- userdocs/getting-started/el-quickstart.rst | 4 +- userdocs/index.rst | 1 + userdocs/release/v4.6.0.rst | 2 +- userdocs/release/v4.6.3.rst | 63 +++++++++++++++++++ userdocs/server/bootloaders.rst | 4 +- userdocs/server/installation.rst | 12 ++-- 10 files changed, 92 insertions(+), 19 deletions(-) create mode 100644 .github/releases/v4.6.3.md create mode 100644 userdocs/release/v4.6.3.rst diff --git a/.github/releases/v4.6.3.md b/.github/releases/v4.6.3.md new file mode 100644 index 00000000..c86d7cc1 --- /dev/null +++ b/.github/releases/v4.6.3.md @@ -0,0 +1,13 @@ +Warewulf v4.6.3 is a regularly-scheduled minor release in the v4.6.x series. + +- additions to the REST API +- improved IPv6 support +- overlay auto(re)build during node discovery +- automated Warewulf server daemon management +- improved netplan support +- other misc. documentation and bug fixes + +Significant changes are detailed in the [release +notes](https://warewulf.org/docs/v4.6.x/release/v4.6.3.html). Additional changes +may be listed in the +[CHANGELOG](https://github.com/warewulf/warewulf/blob/main/CHANGELOG.md). diff --git a/CHANGELOG.md b/CHANGELOG.md index 66af5359..edc125cf 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,14 +4,13 @@ All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). -## Unreleased +## v4.6.3, 2025-08-01 ### Added - Added system and runtime overlay built time to REST API. - Support If-None-Match header in `PUT /api/nodes/{id}` - Added `PUT|DELETE /api/overlays/{name}/file?path={path}` -- Added `DELETE /api/overlays/{name}/file?path={path}` - Added `wwctl configure warewulfd` - Added troubleshooting documentation regarding NUMA and tmpfs - Added support for IPv6 when booting with iPXE. #1852 @@ -21,9 +20,6 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). - Restore default idempotency of `PUT /api/nodes/{id}` - `DELETE /api/overlays/{name}?force=true` can delete overlays that are in use - `warewulfd` overlay autobuild rebuilds overlays after node discovery. #1468 - -### Fixed - - Improved netplan support. #1873 ### Fixed diff --git a/RELEASE.md b/RELEASE.md index 7d111b17..84da58d8 100644 --- a/RELEASE.md +++ b/RELEASE.md @@ -1,7 +1,7 @@ # Release procedure Major versions (e.g., v4.6.0) are tagged directly on the main branch. Minor -versions (e.g., v4.6.1) are tagged on a separate release branch. +versions (e.g., v4.6.3) are tagged on a separate release branch. 1. Update `CHANGELOG.md`. @@ -29,7 +29,7 @@ versions (e.g., v4.6.1) are tagged on a separate release branch. 6. Create a signed tag for the release of the format v4.MINOR.PATCH, following the format specified in . - git tag --sign v4.6.2; git push origin v4.6.2 + git tag --sign v4.6.3; git push origin v4.6.3 7. Monitor the release action associated with the pushed tag at https://github.com/warewulf/warewulf/actions, and verify the generated draft diff --git a/userdocs/getting-started/debian-quickstart.rst b/userdocs/getting-started/debian-quickstart.rst index d24c9f90..839ee928 100644 --- a/userdocs/getting-started/debian-quickstart.rst +++ b/userdocs/getting-started/debian-quickstart.rst @@ -31,7 +31,7 @@ Install Warewulf and dependencies cd ~/git git clone https://github.com/warewulf/warewulf.git cd warewulf - git checkout main # or switch to a tag like 'v4.6.2' + git checkout main # or switch to a tag like 'v4.6.3' make all && sudo make install Configure firewalld diff --git a/userdocs/getting-started/el-quickstart.rst b/userdocs/getting-started/el-quickstart.rst index 4cf67e9f..477098a5 100644 --- a/userdocs/getting-started/el-quickstart.rst +++ b/userdocs/getting-started/el-quickstart.rst @@ -10,11 +10,11 @@ Install Warewulf The preferred way to install Warewulf on Enterprise Linux is using the the RPMs published in `GitHub releases`_. For example, to install the -v4.6.2 release on Enterprise Linux 9: +v4.6.3 release on Enterprise Linux 9: .. code-block:: bash - dnf install https://github.com/warewulf/warewulf/releases/download/v4.6.2/warewulf-4.6.2-1.el9.x86_64.rpm + dnf install https://github.com/warewulf/warewulf/releases/download/v4.6.3/warewulf-4.6.3-1.el9.x86_64.rpm Packages are available for el8 and el9. diff --git a/userdocs/index.rst b/userdocs/index.rst index 10658113..d1124e69 100644 --- a/userdocs/index.rst +++ b/userdocs/index.rst @@ -92,3 +92,4 @@ Welcome to the Warewulf User Guide! v4.6.0 v4.6.1 v4.6.2 + v4.6.3 diff --git a/userdocs/release/v4.6.0.rst b/userdocs/release/v4.6.0.rst index ab73bbd8..377862b4 100644 --- a/userdocs/release/v4.6.0.rst +++ b/userdocs/release/v4.6.0.rst @@ -327,7 +327,7 @@ script. Utilizing the new iPXE menu, specifying an ``IPXEMenuEntry`` tag on a cluster node now selects the boot method to use, similar to the previously-existing -``GRUBMenuEntry``. The ``dracut.ipxe`` script has now been merged into the +``GrubMenuEntry``. The ``dracut.ipxe`` script has now been merged into the default iPXE script, and specifying ``IPXEMenuEntry=dracut`` now replaces specifying a discrete ``dracut`` iPXE template. diff --git a/userdocs/release/v4.6.3.rst b/userdocs/release/v4.6.3.rst new file mode 100644 index 00000000..07c4937c --- /dev/null +++ b/userdocs/release/v4.6.3.rst @@ -0,0 +1,63 @@ +==================== +v4.6.3 Release Notes +==================== + +v4.6.3 is a regularly-scheduled minor release in the v4.6.x series. + +Significant changes are described below. Additional changes are listed in the +`CHANGELOG`_. + +.. _CHANGELOG: https://github.com/warewulf/warewulf/blob/main/CHANGELOG.md + +REST API +======== + +v4.6.3 continues development of the REST API, adding support for the +``If-None-Match: *`` header to prevent overwriting an existing entity. + +Other new functionality in the REST API includes: + +- ``GET /api/nodes/{id}/overlays`` returns built time metadata for a node's + system and runtime overlay images. +- ``PUT /api/overlays/{name}/file?path={path}`` creates files in overlays. +- ``DELETE /api/overlays/{name}/file?path={path}`` delete files in overlays. +- ``DELETE /api/overlays/{name}?force=true`` deletes overlays that are in use. + +IPv6 Support +============ + +IPv6 is now supported during the iPXE network boot process, one step towards +improving overall IPv6 support. + +Overlay Autobuild +================= + +The Warewulf server (when "autobuild overlays" is enabled) now automatically +rebuilds overlays after node discovery, which resolves an issue where overlays +were out-of-sync with the newly-discovered configuration. This is one step in a +more general effort to imrpove overlay autobuild so that manual overlay builds +are less often required. + +Warewulf server configuration +============================= + +The ``wwctl configure`` command can now enable and (re)start the warewulf server +daemon itself to apply updated configuration, either as part of ``wwctl +configure -a`` or ``wwctl configure warewulfd``. + +Ubuntu and Debian Support +========================= + +The ``netplan`` overlay is now much more feature-complete, with relative parity +to the other network configuration overlays. This is one step in a more general +effort to support Wareewulf in Ubuntu and Debian environments. + +Other fixes +=========== + +- Fixed ``wwctl upgrade nodes`` to properly handle kernel argument lists. +- Fixed a panic during ``wwctl overlay edit`` due to missing ``reexec.Init()``. +- Fixed handling of comma-separated mount options in ``fstab`` and ``ignition`` + overlays. +- Fixed a race condition in ``wwctl overlay edit`` that led to changes not being + properly detected and applied. diff --git a/userdocs/server/bootloaders.rst b/userdocs/server/bootloaders.rst index 200109b3..40ff8f33 100644 --- a/userdocs/server/bootloaders.rst +++ b/userdocs/server/bootloaders.rst @@ -340,11 +340,11 @@ an initramfs inside the image. .. code-block:: shell # Enterprise Linux - wwctl image exec rockylinux-9 --build=false -- /usr/bin/dnf -y install https://github.com/warewulf/warewulf/releases/download/v4.6.2/warewulf-dracut-4.6.2-1.el9.noarch.rpm + wwctl image exec rockylinux-9 --build=false -- /usr/bin/dnf -y install https://github.com/warewulf/warewulf/releases/download/v4.6.3/warewulf-dracut-4.6.3-1.el9.noarch.rpm wwctl image exec rockylinux-9 -- /usr/bin/dracut --force --no-hostonly --add wwinit --regenerate-all # SUSE - wwctl image exec leap-15 --build=false -- /usr/bin/zypper -y install https://github.com/warewulf/warewulf/releases/download/v4.6.2/warewulf-dracut-4.6.2-1.suse.lp155.noarch.rpm + wwctl image exec leap-15 --build=false -- /usr/bin/zypper -y install https://github.com/warewulf/warewulf/releases/download/v4.6.3/warewulf-dracut-4.6.3-1.suse.lp155.noarch.rpm wwctl image exec leap-15 -- /usr/bin/dracut --force --no-hostonly --add wwinit --regenerate-all .. note:: diff --git a/userdocs/server/installation.rst b/userdocs/server/installation.rst index 1d1fe1b7..9a0c63e2 100644 --- a/userdocs/server/installation.rst +++ b/userdocs/server/installation.rst @@ -18,14 +18,14 @@ Rocky Linux 9 .. code-block:: console - # dnf install https://github.com/warewulf/warewulf/releases/download/v4.6.2/warewulf-4.6.2-1.el9.x86_64.rpm + # dnf install https://github.com/warewulf/warewulf/releases/download/v4.6.3/warewulf-4.6.3-1.el9.x86_64.rpm openSuse Leap ------------- .. code-block:: console - # zypper install https://github.com/warewulf/warewulf/releases/download/v4.6.2/warewulf-4.6.2-1.suse.lp155.x86_64.rpm + # zypper install https://github.com/warewulf/warewulf/releases/download/v4.6.3/warewulf-4.6.3-1.suse.lp155.x86_64.rpm Container images ================ @@ -97,9 +97,9 @@ appropriate substitutions: .. code-block:: bash - curl -LO https://github.com/warewulf/warewulf/releases/download/v4.6.2/warewulf-4.6.2.tar.gz - tar -xf warewulf-4.6.2.tar.gz - cd warewulf-4.6.2 + curl -LO https://github.com/warewulf/warewulf/releases/download/v4.6.3/warewulf-4.6.3.tar.gz + tar -xf warewulf-4.6.3.tar.gz + cd warewulf-4.6.3 make all && sudo make install Git @@ -118,7 +118,7 @@ from the main site, the GitHub releases page, or from a Git tag. git clone https://github.com/warewulf/warewulf.git cd warewulf - git checkout main # or switch to a tag like 'v4.6.2' + git checkout main # or switch to a tag like 'v4.6.3' make all && sudo make install Runtime Dependencies