Opens in a new tab
News

NVIDIA introduces NodeWright for Kubernetes host updates

In brief

NodeWright can coordinate host updates across a Kubernetes fleet. One labeled worker shows why the package, machine selection and observed result need to stay together.

3 min read

Is this the right starting point?
Before you read
Experience operating Kubernetes nodes, controllers and safe host-maintenance rollouts.
What you will take away
Bound a NodeWright host update and reconcile uncertain execution before expanding the rollout.
Sources
A coral stencil exposes one porcelain block in a row, placing a graphite change layer only on that block.
On this page2 sections

A team wants to change a kernel setting on one GPU worker. The same package could also change every worker if its machine selection is left empty. That is an illustrative NodeWright rollout, and the small difference captures what matters about a fleet maintenance tool: both what it runs and where it runs belong to the change.

NVIDIA introduced the open-source NodeWright operator in its September 23 announcement. Previously used internally as Skyhook, it coordinates package, configuration and tuning updates across Kubernetes hosts while accounting for the workloads on them. A host is the machine beneath those workloads; changing it can affect the pods already using it.

The team describes the desired change in a Kubernetes custom resource, a record the operator watches. NodeWright runs containerized packages containing the scripts and files that alter the host. NVIDIA describes progressive updates, interruption controls and package verification that can halt a rollout. These give the team a way to work through selected machines and observe the result.

One label keeps the first change on one machine

The official quickstart begins by labeling one node. Its empty selector matches all nodes. A copied resource with that selection left empty therefore describes a much larger job, even if the package itself is exactly right. The bounded-action guidance applies as much to a deterministic controller as to an AI agent: a reliable executor can faithfully carry out an overly broad instruction.

For a real deployment, the guide also recommends pinning the chart version. That keeps the installed controller identifiable alongside the package being rolled out. Teams moving from Skyhook need a separate compatibility check: the CLI reference says the current command-line tool requires nodewright.nvidia.com. It cannot work with an operator serving only the legacy group. Renaming the command does not upgrade the operator answering it.

A named package and explicitly selected nodes lead to bounded execution, host-state verification and a decision to proceed, stop or reconcile an unknown result.
Review a host change before extending its rollout. A controller's rollout controls support the decision; they do not define the acceptable consequences.

The worker may have changed before the check went quiet

Return to our hypothetical one-node trial. The package runs, but the verification job loses contact before reporting the setting. The update and its check have different jobs: one changes the machine; the other reads what remains. Losing the second result does not undo the first action.

Read the current host setting and the package execution record before deciding to retry. The setting may already be in place. Keeping the trial on one labeled node makes that uncertainty easier to resolve while the rest of the fleet stays out of it.

A successful script is only part of the result. The workload also needs to remain within its allowed interruption, with enough capacity to serve requests during maintenance. The disruption-budget pilot examines that capacity question. If the host change cannot be reversed, even a one-node rollout needs an approved recovery or replacement plan; making the selection smaller does not create an undo.

The first machine should leave a trail the team can read: the requested setting, what the package did and how the workload behaved afterward. Resolve a missing check there before extending the selection. That is the practical benefit of the first label: one uncertain result stays one uncertain result while the team learns what happened.

Sources & context

Sources linked in this article. Read alongside the author’s analysis; a citation does not independently verify a publisher’s claims.

Report an error or outdated detail

More on NVIDIA

All NVIDIA coverage

Keep reading

Where to go next