VOOZH about

URL: https://thenewstack.io/warewulf-4-4-cluster-management-system-now-offers-an-api/

⇱ Warewulf 4.4 Cluster Management System Now Offers an API - The New Stack


TNS
SUBSCRIBE
Join our community of software engineering leaders and aspirational developers. Always stay in-the-know by getting the most important news and exclusive content delivered fresh to your inbox to learn more about at-scale software development.
REQUIRED
It seems that you've previously unsubscribed from our newsletter in the past. Click the button below to open the re-subscribe form in a new tab. When you're done, simply close that tab and continue with this form to complete your subscription.
The New Stack does not sell your information or share it with unaffiliated third parties. By continuing, you agree to our Terms of Use and Privacy Policy.
Welcome and thank you for joining The New Stack community!
Please answer a few simple questions to help us deliver the news and resources you are interested in.
REQUIRED
REQUIRED
REQUIRED
REQUIRED
REQUIRED
Great to meet you!
Tell us a bit about your job so we can cover the topics you find most relevant.
REQUIRED
REQUIRED
REQUIRED
REQUIRED
REQUIRED
Welcome!

We’re so glad you’re here. You can expect all the best TNS content to arrive Monday through Friday to keep you on top of the news and at the top of your game.

What’s next?

Check your inbox for a confirmation email where you can adjust your preferences and even join additional groups.

Follow TNS on your favorite social media networks.

Become a TNS follower on LinkedIn.

Check out the latest featured and trending stories while you wait for your first TNS newsletter.

PREV
1 of 2
NEXT
VOXPOP
As a JavaScript developer, what non-React tools do you use most often?
Angular
0%
Astro
0%
Svelte
0%
Vue.js
0%
Other
0%
I only use React
0%
I don't use JavaScript
0%
Thanks for your opinion! Subscribe below to get the final results, published exclusively in our TNS Update newsletter:
NEW! Try Stackie AI
From clobbered drafts to real-time sync
Apr 14th 2026 10:00am, by David Moore
TypeScript 6.0 RC arrives as a bridge to a faster future
Mar 14th 2026 9:00am, by Darryl K. Taft
Mastra empowers web devs to build AI agents in TypeScript
Jan 28th 2026 11:00am, by Loraine Lawson
2023-05-12 10:00:44
Warewulf 4.4 Cluster Management System Now Offers an API
contributed,
Operations

Warewulf 4.4 Cluster Management System Now Offers an API

The Warewulf community has released Warewulf 4.4, which adds significant features and fixes some notable bugs to the cluster management system.
May 12th, 2023 10:00am by Jonathon Anderson
👁 Featued image for: Warewulf 4.4 Cluster Management System Now Offers an API

The Warewulf community has released Warewulf 4.4, which adds significant features and fixes some notable bugs to the cluster management system.

Documentation

First up is a change to the project as a whole: in the time since Warewulf 4.3, the online documentation for Warewulf has been merged into the source repository alongside the Warewulf code base. This enables better alignment of the documentation with the development of the Warewulf application.

You can find the current Warewulf documentation published on the Warewulf website. And if you’d like to try your hand at contributing to the docs, you can submit pull requests against the source.

New man pages have also been added for the warewulf.conf and nodes.conf configuration files, alongside existing man pages for the wwctl command.

Import and Export

If you’re coming from Warewulf 3, you might have a lot of nodes already defined. Migrating from Warewulf 3 to Warewulf 4 is likely to always be a manual process, but new import and export functionality in Warewulf 4.4 simplifies this process a bit, allowing you to import a CSV of node definitions. Or, if you’re moving nodes from one Warewulf 4 environment to another, simply export the node YAML and import it into the new environment.

Node Editing

Warewulf typically uses the wwctl command to configure node attributes, but sometimes it’s easier to edit the underlying YAML document that defines the nodes. You could always edit nodes.conf directly, but at the risk of a malformed YAML document causing an error in Warewulf, or of other parts of Warewulf not being updated to reflect the change.

Warewulf 4 adds a “node edit” feature that allows you to edit node definitions in an intermediate text editor, for the best of both worlds.

Networking

A number of improvements have been made to Warewulf’s support for configuring node network parameters. In particular:

  • Network interfaces now accept an mtu (maximum transmission unit)
  • The wwinit overlay now supplies a NetworkManager configuration alongside ifcfg-style configuration for Ethernet and InfiniBand interfaces.

Container Shell Detection

The wwctl container shell provides a standard shell interface inside of a traditional chroot view of a node image; but it can sometimes be difficult to keep track of what environment you’re in. A new environment variable, WW_CONTAINER_SHELL, identifies the current node image and, in so doing, also indicates that you’re in a container shell environment.

defaults.conf

Default node attribute values (e.g., for kernel arguments) are now read in from a defaults.conf configuration file. If this file is not present, built-in default values are used.

/etc/warewulf/excludes

This is technically a bugfix; but since the feature was broken before, and relatively unknown, it’s more like a new feature:

The wwctl container build reads /etc/warewulf/excludes from the node image. This file contains filepath.Match patterns to exclude files from being included in the final node image. This can be used for simple things, like excluding temporary files, or more complex use cases.

Warewulf API

Warewulf 4.4 includes an initial release of an API to further automate Warewulf alongside the wwctl command-line interface. This work is mostly being included in this release as a preview of things to come, and represents a bunch of foundational work supporting future development. An API-driven Warewulf supports a number of potential use cases, from graphical user interfaces to IaaS-style orchestration.

Unification of Nodes and Profiles

Warewulf’s nodes and profiles are intrinsically linked; but, until now, they have been implemented separately and kept in sync only through manual developer effort. No more! In Warewulf 4.4 nodes and profiles are built reflectively from the same metadata, as are the commands that manipulate them. To accomplish this, however, several command-line arguments had to be updated to bring the divergent interfaces into alignment with each other. You can find a full list of such changes in the release notes.

Miscellaneous Changes

A few other quick but notable changes:

  • Overlay templates can now be rendered locally for inspection during development, without having to deploy them to a node first, using wwctl overlay show –render.
  • The wwctl container list now shows the container creation date, modification date, and size.
  • The wwctl ssh now includes configuration for Bash tab-completion.

Miscellaneous Bug Fixes

Of course, there are other bug fixes, too. Of particular note:

  • System users are no longer prevented from logging into cluster nodes. Previously, this was broken due to a profile script exiting erroneously.)
  • The wwctl overlay now correctly handles uid and gid arguments, and no longer sets gid to 0 when unspecified.

See also

There’s a lot more in this release than what we’ve gone over here. If you’d like to know more about what went into the Warewulf 4.4, the official changelog is available, and the release nodes are included alongside the official release on GitHub. You can also look at all the conversations around its issues and pull requests in its GitHub milestone.

TRENDING STORIES
Jonathon Anderson has 16+ years of experience in Information Technology, including high performance computing, high throughput computing, parallel, distributed, and local file systems, local area networks, and IaaS and SaaS cloud services. Jonathon previously has served at R1 research institutions...
Read more from Jonathon Anderson
SHARE THIS STORY
TRENDING STORIES
SHARE THIS STORY
TRENDING STORIES
TNS DAILY NEWSLETTER Receive a free roundup of the most recent TNS articles in your inbox each day.
The New Stack does not sell your information or share it with unaffiliated third parties. By continuing, you agree to our Terms of Use and Privacy Policy.