You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/proposals/20240807-in-place-updates.md
+4-12Lines changed: 4 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -130,7 +130,7 @@ Cluster API user experience MUST be the same when using default, immutable updat
130
130
131
131
If external update extensions can not cover the totality of the desired changes, CAPI will defer to Cluster API’s default, immutable rollouts. This is important for a couple of reasons:
132
132
133
-
* It allows to implement custom rollout strategies incrementally, without the need to cover all use cases up-front.
133
+
* It allows to implement in-place update capabilities incrementally, without the need to cover all use cases up-front.
134
134
* There are cases when replacing the machine will always be necessary:
135
135
* When it is not possible to recover the machine, e.g. hardware failure.
136
136
* When the user determines that recovering the machine is too complex/costly vs replacing it.
@@ -168,11 +168,11 @@ With the introduction of this experimental feature, users may want to apply the
168
168
169
169
#### Story 1
170
170
171
-
As a cluster operator, I want to perform in-place updates on my Kubernetes clusters without replacing the underlying machines. I expect the update process to be flexible, allowing me to customize the strategy based on my specific requirements, such as air-gapped environments or special node configurations.
171
+
As a cluster operator, I want to perform in-place updates on my Kubernetes clusters without replacing the underlying machines. I expect the update process to be flexible and customizable based on specific requirements, such as air-gapped environments or special node configurations.
172
172
173
173
#### Story 2
174
174
175
-
As a cluster operator, I want to seamlessly transition between rolling and in-place updates while maintaining a consistent user interface. I appreciate the option to choose or implement my own update strategy, ensuring that the update process aligns with my organization's unique needs.
175
+
As a cluster operator, I want to seamlessly transition between rolling and in-place updates while maintaining a consistent user interface. I appreciate the option to extend the rollout process with in-place upgrade capabilities, ensuring that the update process aligns with my organization's unique needs.
176
176
177
177
#### Story 3
178
178
As a cluster operator for resource constrained environments, I want to utilize CAPI pluggable external update mechanism to implement in-place updates without requiring additional compute capacity in a single node cluster.
@@ -265,7 +265,7 @@ Both `KCP` and `MachineDeployment` controllers follow a similar pattern around u
265
265
266
266
With `InPlaceUpdates` feature gate enabled, CAPI controllers will compute the set of desired changes and iterate over the registered external updaters, requesting through the Runtime Hook the set of changes each updater can handle. The changes supported by an updater can be the complete set of desired changes, a subset of them or an empty set, signaling it cannot handle any of the desired changes.
267
267
268
-
If any combination of the updaters can handle the desired changes then CAPI will determine that the update can be performed using the external strategy.
268
+
If any combination of the updaters can handle the desired changes then CAPI will determine that the update can be performed in-place.
269
269
270
270
If any of the desired changes cannot be covered by the updaters capabilities, CAPI will determine the desired state cannot be reached through external updaters. In this case, it will fallback to the rolling update strategy, replacing machines as needed.
0 commit comments