File tree Expand file tree Collapse file tree 1 file changed +9
-3
lines changed
keps/sig-architecture/4330-compatibility-versions Expand file tree Collapse file tree 1 file changed +9
-3
lines changed Original file line number Diff line number Diff line change @@ -203,9 +203,15 @@ still performing a stepwise upgrade of Kubernetes control-plane. For example:
203
203
204
204
Benefits to upgrading binary version independent of compatibility version:
205
205
206
- - During an upgrade, it is possible verify the binary version before
207
- accumulating any client usage of features/API at the new version, making
208
- a binary rollback at this stage of an upgrade fundamentally safer
206
+ - A skip-version binary upgrade that transitions through compat versions has
207
+ higher probability of bugs in those intermediate binary versions already being
208
+ fixed.
209
+ - During an upgrade, it is possible upgrade the new binary version while the
210
+ compatibility version is fixed (e.g. ` binaryVersion: 1.28 ` -> ` {binaryVersion: 1.29, compatVersion: 1.28} ` ).
211
+ This allow differences in the binary (bugs fixed or introduced, performance
212
+ changes, ...) to be introduced into a cluster and verified safe before
213
+ allowing access to the new APIs and features new version. Once the binary
214
+ version has been deamed safe, the compatibility version can then be upgraded.
209
215
- Any upgrade system that successfully detects failures between upgrade steps
210
216
can report which upgrade step failed. This makes it easier to diagnose the
211
217
failures, because there are fewer possible causes of the failure. (There's a
You can’t perform that action at this time.
0 commit comments