Skip to content
Projects
Groups
Snippets
Help
This project
Loading...
Sign in / Register
Toggle navigation
K
k3s
Project
Project
Details
Activity
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
0
Issues
0
List
Board
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Charts
Registry
Registry
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
Jacklull
k3s
Commits
e618e335
Commit
e618e335
authored
May 03, 2016
by
Isaac Hollander McCreery
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Add clarifying language about supported version skews
parent
f29d597d
Show whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
17 additions
and
10 deletions
+17
-10
versioning.md
docs/design/versioning.md
+17
-10
No files found.
docs/design/versioning.md
View file @
e618e335
...
@@ -95,27 +95,34 @@ X.Y.Z-beta.W, with an additional +bbbb build suffix added. Furthermore, builds
...
@@ -95,27 +95,34 @@ X.Y.Z-beta.W, with an additional +bbbb build suffix added. Furthermore, builds
that are built off of a dirty build tree, (during development, with things in
that are built off of a dirty build tree, (during development, with things in
the tree that are not checked it,) it will be appended with -dirty.
the tree that are not checked it,) it will be appended with -dirty.
### Supported releases
### Supported releases
and component skew
We expect users to stay reasonably up-to-date with the versions of Kubernetes
We expect users to stay reasonably up-to-date with the versions of Kubernetes
they use in production, but understand that it may take time to upgrade.
they use in production, but understand that it may take time to upgrade,
especially for production-critical components.
We expect users to be running approximately the latest patch release of a given
We expect users to be running approximately the latest patch release of a given
minor release; we often include critical bug fixes in
minor release; we often include critical bug fixes in
[
patch releases
](
#patch-release
)
, and so encourage users to upgrade as soon as
[
patch releases
](
#patch-release
)
, and so encourage users to upgrade as soon as
possible. Furthermore, we expect to "support" three minor releases at a time.
possible.
"Support" means we expect users to be running that version in production, though
we may not port fixes back before the latest minor version. For example, when
Different components are expected to be compatible across different amounts of
v1.3 comes out, v1.0 will no longer be supported: basically, that means that the
skew, all relative to the master version. Nodes may lag masters components by
up to two minor versions but should be at a version no newer than the master; a
client should be skewed no more than one minor version from the master, but may
lead the master by up to one minor version. For example, a v1.3 master should
work with v1.1, v1.2, and v1.3 nodes, and should work with v1.2, v1.3, and v1.4
clients.
Furthermore, we expect to "support" three minor releases at a time. "Support"
means we expect users to be running that version in production, though we may
not port fixes back before the latest minor version. For example, when v1.3
comes out, v1.0 will no longer be supported: basically, that means that the
reasonable response to the question "my v1.0 cluster isn't working," is, "you
reasonable response to the question "my v1.0 cluster isn't working," is, "you
should probably upgrade it, (and probably should have some time ago)". With
should probably upgrade it, (and probably should have some time ago)". With
minor releases happening approximately every three months, that means a minor
minor releases happening approximately every three months, that means a minor
release is supported for approximately nine months.
release is supported for approximately nine months.
This does
*not*
mean that we expect to introduce breaking changes between v1.0
and v1.3, but it does mean that we probably won't have reasonable confidence in
clusters where some components are running at v1.0 and others running at v1.3.
This policy is in line with
This policy is in line with
[
GKE's supported upgrades policy
](
https://cloud.google.com/container-engine/docs/clusters/upgrade
)
.
[
GKE's supported upgrades policy
](
https://cloud.google.com/container-engine/docs/clusters/upgrade
)
.
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment