The Kubespray Project is released on an as-needed basis. The process is as follows:
- An issue is proposing a new release with a changelog since the last release
- At least one of the approvers must approve this release
- An approver creates new release in GitHub using a version and tag name like
vX.Y.Z
and attaching the release notes - An approver creates a release branch in the form
release-X.Y
- The corresponding version of quay.io/kubespray/kubespray:vX.Y.Z docker image is built and tagged
- The
KUBESPRAY_VERSION
variable is updated in.gitlab-ci.yml
- The release issue is closed
- An announcement email is sent to
kubernetes-dev@googlegroups.com
with the subject[ANNOUNCE] Kubespray $VERSION is released
- The topic of the #kubespray channel is updated with
vX.Y.Z is released! | ...
-
Kubespray maintains one branch for major releases (vX.Y). Minor releases are available only as tags.
-
Security patches and bugs might be backported.
-
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.
-
Kubespray major and minor releases are bound to the given
kube_version
major/minor version numbers and other components' arbitrary versions, like etcd or network plugins. Older or newer versions are not supported and not tested for the given release. -
There is no unstable releases and no APIs, thus Kubespray doesn't follow semver. 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 Kubespray 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
. Greaterkube_version
requires a new major or minor release. For example, if Kubespray v2.0.0 is bound tokube_version: 1.4.x
,calico_version: 0.22.0
,etcd_version: v3.0.6
, then Kubespray v2.1.0 may be bound to only minor changes tokube_version
, like v1.5.1 and any changes to other components, like etcd v4, or calico 1.2.3. And Kubespray v3.x.x shall be bound tokube_version: 2.x.x
respectively.