Skip to content

Commit ddae554

Browse files
committed
Apply feedback
1 parent 185a3a2 commit ddae554

File tree

1 file changed

+9
-3
lines changed
  • keps/sig-architecture/4330-compatibility-versions

1 file changed

+9
-3
lines changed

keps/sig-architecture/4330-compatibility-versions/README.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -203,9 +203,15 @@ still performing a stepwise upgrade of Kubernetes control-plane. For example:
203203

204204
Benefits to upgrading binary version independent of compatibility version:
205205

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.
209215
- Any upgrade system that successfully detects failures between upgrade steps
210216
can report which upgrade step failed. This makes it easier to diagnose the
211217
failures, because there are fewer possible causes of the failure. (There's a

0 commit comments

Comments
 (0)