Skip to content

📖 in-place updates: propose configurable fallback strategy - #14035

Open
LiangquanLi930 wants to merge 1 commit into
kubernetes-sigs:mainfrom
LiangquanLi930:proposal/in-place-configurable-fallback
Open

📖 in-place updates: propose configurable fallback strategy#14035
LiangquanLi930 wants to merge 1 commit into
kubernetes-sigs:mainfrom
LiangquanLi930:proposal/in-place-configurable-fallback

Conversation

@LiangquanLi930

@LiangquanLi930 LiangquanLi930 commented Aug 6, 2026

Copy link
Copy Markdown
Member

What this PR does:
This PR iterates on the CAPI In-Place Updates proposal (20240807-in-place-updates.md) by introducing a Configurable Fallback Strategy — a new inPlaceFallback field that lets cluster users control what happens when an in-place update cannot proceed, instead of always silently falling back to rolling replacement.

why we need it:
Today, when an in-place update cannot cover the full diff (e.g. the registered extension lacks support for a given change, or KCP preflight checks flag the candidate Machine), CAPI implicitly falls back to a rolling update that replaces Machines. For workloads where Machine replacement is expensive or destructive — bare metal nodes, nodes with local storage, license-bound nodes — this default behavior is unacceptable. Users would rather have the rollout stop and surface a condition so they can intervene, than lose irreplaceable Machines to an implicit fallback.

Change scope:

  1. Only modifies docs/proposals/20240807-in-place-updates.md
  2. Proposal documentation update only — no code or API changes in this PR
  3. Default value Replace preserves backward compatibility; existing behavior is unchanged

Which issue(s) this PR fixes :
NONE

@kubernetes-prow kubernetes-prow Bot added do-not-merge/needs-area PR is missing an area label cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Aug 6, 2026
@kubernetes-prow

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign fabriziopandini for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@LiangquanLi930
LiangquanLi930 marked this pull request as draft August 6, 2026 06:43
@kubernetes-prow kubernetes-prow Bot added the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Aug 6, 2026
@LiangquanLi930
LiangquanLi930 force-pushed the proposal/in-place-configurable-fallback branch 2 times, most recently from 2e21be3 to f70ba1c Compare August 7, 2026 03:58
@LiangquanLi930

Copy link
Copy Markdown
Member Author

/area provider/core

@kubernetes-prow kubernetes-prow Bot added area/provider/core Issues or PRs related to the core provider and removed do-not-merge/needs-area PR is missing an area label labels Aug 7, 2026
@LiangquanLi930
LiangquanLi930 force-pushed the proposal/in-place-configurable-fallback branch from f70ba1c to 64ec2a9 Compare August 7, 2026 05:39
@LiangquanLi930
LiangquanLi930 marked this pull request as ready for review August 7, 2026 05:40
@kubernetes-prow kubernetes-prow Bot removed the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Aug 7, 2026
@kubernetes-prow
kubernetes-prow Bot requested a review from sivchari August 7, 2026 05:40
@LiangquanLi930

Copy link
Copy Markdown
Member Author

/area documentation

@kubernetes-prow kubernetes-prow Bot added the area/documentation Issues or PRs related to documentation label Aug 7, 2026
@LiangquanLi930

Copy link
Copy Markdown
Member Author

@LiangquanLi930

Copy link
Copy Markdown
Member Author

@elmiko elmiko left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

i think this makes sense to me, should we have an example of the condition that will be added?

Introduce an opt-in `inPlaceFallback` field (Replace/Stop) so users can
require in-place-only updates. Default stays Replace; Stop halts the rollout
and surfaces a condition instead of replacing Machines.

Signed-off-by: Liangquan Li <liangquan.li@smartx.com>
@LiangquanLi930
LiangquanLi930 force-pushed the proposal/in-place-configurable-fallback branch from 035f877 to 3d4b49b Compare August 9, 2026 08:10
@LiangquanLi930

Copy link
Copy Markdown
Member Author

i think this makes sense to me, should we have an example of the condition that will be added?

@elmiko Thanks for the suggestion. I've added an example of the condition here: https://github.com/kubernetes-sigs/cluster-api/compare/035f8772a8b41b6060c48d4663fac1fae88cd4b6..3d4b49bff1b8c201f32220dd6577cb8c0f3e991a

@elmiko elmiko left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

looks great, thanks for the update!

/lgtm

@kubernetes-prow kubernetes-prow Bot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Aug 10, 2026
@kubernetes-prow

Copy link
Copy Markdown
Contributor

LGTM label has been added.

DetailsGit tree hash: 94de56228b23df0b6eb046f904643ff4c42e2671

@LiangquanLi930

Copy link
Copy Markdown
Member Author

/assign @enxebre @fabriziopandini @sbueringer

Got LGTM from @elmiko. This is a follow-up to the in-place updates proposal (#11029) — would appreciate an approve when you have a moment.

@LiangquanLi930

Copy link
Copy Markdown
Member Author

/assign @enxebre @fabriziopandini @sbueringer

@sbueringer

sbueringer commented Aug 11, 2026

Copy link
Copy Markdown
Member

This needs careful consideration, please don't ping us every few days (4 pings now in 4 days)

@LiangquanLi930

Copy link
Copy Markdown
Member Author

This needs careful consideration, please don't ping us every few days (4 pings now in 4 days)

Sorry for the frequent pings. I'll try to keep my fingers under control 😅. (I thought the assign hadn't gone through — it didn't seem to take effect — so I retried a couple of times.)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/documentation Issues or PRs related to documentation area/provider/core Issues or PRs related to the core provider cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. lgtm "Looks good to me", indicates that a PR is ready to be merged. size/M Denotes a PR that changes 30-99 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants