Skip to content

📖 document ClusterClass rotation behavior for MachinePool objects#13280

Open
bnallapeta wants to merge 1 commit intokubernetes-sigs:mainfrom
bnallapeta:mp/contract
Open

📖 document ClusterClass rotation behavior for MachinePool objects#13280
bnallapeta wants to merge 1 commit intokubernetes-sigs:mainfrom
bnallapeta:mp/contract

Conversation

@bnallapeta
Copy link
Contributor

@bnallapeta bnallapeta commented Jan 29, 2026

What this PR does / why we need it:
Addresses the concern raised in #13110

Which issue(s) this PR fixes (optional, in fixes #<issue number>(, fixes #<issue_number>, ...) format, will close the issue(s) when PR gets merged):
Part of #10496

Additional info:
Post discussions with the MachinePool Working Group, proposals mentioned in this doc is created to unblock #13110

Area example:
/area machinepool
/area clusterclass

@k8s-ci-robot k8s-ci-robot added do-not-merge/needs-area PR is missing an area label size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Jan 29, 2026
@k8s-ci-robot
Copy link
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 neolit123 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

@k8s-ci-robot k8s-ci-robot added the cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. label Jan 29, 2026
@bnallapeta
Copy link
Contributor Author

/cc @AndiDog @richardcase

Signed-off-by: Bharath Nallapeta <nr.bharath97@gmail.com>
@bnallapeta
Copy link
Contributor Author

@AndiDog PTAL. Thanks.

@sbueringer sbueringer added the area/documentation Issues or PRs related to documentation label Feb 11, 2026
@k8s-ci-robot k8s-ci-robot removed the do-not-merge/needs-area PR is missing an area label label Feb 11, 2026
As of today the Node initialization consists of syncing labels from Machines to Nodes. Once the labels have been
initially synced the taint is removed from the Node.

### Infrastructure provider watching for bootstrap changes
Copy link
Member

Choose a reason for hiding this comment

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

This page here is a description of the contract for bootstrap providers. I think we should not specify the infrastructure provider contract on this page

When the topology controller detects that the InfraMachinePoolTemplate has changed (e.g., from template updates in ClusterClass), it performs
a **rotation**:

1. Creates a new InfraMachinePool object with a new name
Copy link
Member

Choose a reason for hiding this comment

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

@AndiDog @mboersma @richardcase Do we have consensus across InfraMachinePool providers that rotation is the right thing to do here?

I would have expected that just in-place updating the InfraMachinePool is much easier to implement for infra providers

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 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.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants