Skip to content

📖 docs: add delete-machine info to Scaling Nodes page #13195

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
k8s-ci-robot merged 3 commits into from
Jan 5, 2026
Merged

📖 docs: add delete-machine info to Scaling Nodes page #13195

Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
e15292e
docs: add delete-machine info to Scaling Nodes page
Kausheel Dec 28, 2025
6b19f38
Add caveat when using delete-machine label
Kausheel Jan 4, 2026
7466196
Add line spacing
Kausheel Jan 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions docs/book/src/tasks/automated-machine-management/scaling.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@ Machines can be owned by scalable resources i.e. MachineSet and MachineDeploymen

You can scale MachineSets and MachineDeployments in or out by expressing intent via `.spec.replicas` or updating the scale subresource e.g `kubectl scale machinedeployment foo --replicas=5`.

If you need to prioritize which Machines get deleted during scale down, add the `cluster.x-k8s.io/delete-machine` label to the Machine. KCP or a MachineSet will delete labeled control plane or worker Machines first, and this label has top priority over all delete policies.
Copy link
Member

@fabriziopandini fabriziopandini Dec 30, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would suggest to add a note that explains that the annotation is considered only when scaling down a machine set; the decision about which machine set to scale down in a machine deployment is driven by other factors (e.g. primarily the fact that the MachineSet spec is UpToDate or not).


When you delete a Machine directly or by scaling down, the same process takes place in the same order:
- The Node backed by that Machine will try to be drained indefinitely and will wait for any volume to be detached from the Node unless you specify a `.spec.nodeDrainTimeout`.
- CAPI uses default [kubectl draining implementation](https://kubernetes.io/docs/tasks/administer-cluster/safely-drain-node/) with `-–ignore-daemonsets=true`. If you needed to ensure DaemonSets eviction you'd need to do so manually by also adding proper taints to avoid rescheduling.
Expand Down
Loading