Skip to content
GitLab
Explore
Sign in
Primary navigation
Search or go to…
Project
K
Kubespray
Manage
Activity
Members
Code
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Deploy
Model registry
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
Mirror
Kubespray
Commits
98c7f2eb
Commit
98c7f2eb
authored
8 years ago
by
Bogdan Dobrelya
Committed by
GitHub
8 years ago
Browse files
Options
Downloads
Plain Diff
Merge pull request #887 from bogdando/docs
Clarify major/minor/maintainance releases
parents
c63cda7c
d332502d
No related branches found
No related tags found
No related merge requests found
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
RELEASE.md
+22
-9
22 additions, 9 deletions
RELEASE.md
with
22 additions
and
9 deletions
RELEASE.md
+
22
−
9
View file @
98c7f2eb
...
...
@@ -14,14 +14,27 @@ The Kargo Project is released on an as-needed basis. The process is as follows:
branches, and there are no backports. Therefore, there is no need for merge
freezes as well.
*
Fixes for major releases (vX.Y.0) are delivered via minor releases (vX.Y.Z)
and assigned to the corresponding open milestone (vX.Y). That milestone
remains open for the release support lifetime, which ends once the milestone
closed. Then only a next major release can be done.
*
Fixes for major releases (vX.x.0) and minor releases (vX.Y.x) are delivered
via maintenance releases (vX.Y.Z) and assigned to the corresponding open
milestone (vX.Y). That milestone remains open for the major/minor releases
support lifetime, which ends once the milestone closed. Then only a next major
or minor release can be done.
*
Kargo major releases are bound to the given
``kube_version``
and other components'
versions, like etcd or network plugins.
Older or newer versions are not
supported and not tested for the given release.
*
Kargo major
and minor
releases are bound to the given
``kube_version``
major/minor
version
numbers and other components' arbitrary version
s, like etcd or network plugins.
Older or newer versions are not
supported and not tested for the given release.
*
Minor releases can change components' versions, but not the
``kube_version``
.
Greater
``kube_version``
requires a new major release.
*
There is no unstable releases and no APIs, thus Kargo doesn't follow
[
semver
](
http://semver.org/
)
. Every version describes only a stable release.
Breaking changes, if any introduced by changed defaults or non-contrib ansible roles'
playbooks, shall be described in the release notes. Other breaking changes, if any in
the contributed addons or bound versions of Kubernetes and other components, are
considered out of Kargo scope and are up to the components' teams to deal with and
document.
*
Minor releases can change components' versions, but not the major
``kube_version``
.
Greater
``kube_version``
requires a new major or minor release. For example, if Kargo v2.0.0
is bound to
``kube_version: 1.4.x``
,
``calico_version: 0.22.0``
,
``etcd_version: v3.0.6``
,
then Kargo v2.1.0 may be bound to only minor changes to
``kube_version``
, like v1.5.1
and
*any*
changes to other components, like etcd v4, or calico 1.2.3.
And Kargo v3.x.x shall be bound to
``kube_version: 2.x.x``
respectively.
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment