You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

86 lines
5.4 KiB

  1. # Release Process
  2. The Kubespray Project is released on an as-needed basis. The process is as follows:
  3. 1. An issue is proposing a new release with a changelog since the last release. Please see [a good sample issue](https://github.com/kubernetes-sigs/kubespray/issues/8325)
  4. 1. At least one of the [approvers](OWNERS_ALIASES) must approve this release
  5. 1. (Only for major releases) The `kube_version_min_required` variable is set to `n-1`
  6. 1. (Only for major releases) Remove hashes for [EOL versions](https://github.com/kubernetes/website/blob/main/content/en/releases/patch-releases.md) of kubernetes from `*_checksums` variables.
  7. 1. Create the release note with [Kubernetes Release Notes Generator](https://github.com/kubernetes/release/blob/master/cmd/release-notes/README.md). See the following `Release note creation` section for the details.
  8. 1. An approver creates [new release in GitHub](https://github.com/kubernetes-sigs/kubespray/releases/new) using a version and tag name like `vX.Y.Z` and attaching the release notes
  9. 1. (Only for major releases) An approver creates a release branch in the form `release-X.Y`
  10. 1. (For major releases) On the `master` branch: bump the version in `galaxy.yml` to the next expected major release (X.y.0 with y = Y + 1), make a Pull Request.
  11. 1. (For minor releases) On the `release-X.Y` branch: bump the version in `galaxy.yml` to the next expected minor release (X.Y.z with z = Z + 1), make a Pull Request.
  12. 1. The corresponding version of [quay.io/kubespray/kubespray:vX.Y.Z](https://quay.io/repository/kubespray/kubespray) and [quay.io/kubespray/vagrant:vX.Y.Z](https://quay.io/repository/kubespray/vagrant) container images are built and tagged. See the following `Container image creation` section for the details.
  13. 1. (Only for major releases) The `KUBESPRAY_VERSION` in `.gitlab-ci.yml` is upgraded to the version we just released # TODO clarify this, this variable is for testing upgrades.
  14. 1. The release issue is closed
  15. 1. An announcement email is sent to `dev@kubernetes.io` with the subject `[ANNOUNCE] Kubespray $VERSION is released`
  16. 1. The topic of the #kubespray channel is updated with `vX.Y.Z is released! | ...`
  17. 1. Create/Update Issue for upgradeing kubernetes and [k8s-conformance](https://github.com/cncf/k8s-conformance)
  18. ## Major/minor releases and milestones
  19. * For major releases (vX.Y) Kubespray maintains one branch (`release-X.Y`). Minor releases (vX.Y.Z) are available only as tags.
  20. * Security patches and bugs might be backported.
  21. * Fixes for major releases (vX.Y) and minor releases (vX.Y.Z) are delivered
  22. via maintenance releases (vX.Y.Z) and assigned to the corresponding open
  23. [GitHub milestone](https://github.com/kubernetes-sigs/kubespray/milestones).
  24. That milestone remains open for the major/minor releases support lifetime,
  25. which ends once the milestone is closed. Then only a next major or minor release
  26. can be done.
  27. * Kubespray major and minor releases are bound to the given `kube_version` major/minor
  28. version numbers and other components' arbitrary versions, like etcd or network plugins.
  29. Older or newer component versions are not supported and not tested for the given
  30. release (even if included in the checksum variables, like `kubeadm_checksums`).
  31. * There is no unstable releases and no APIs, thus Kubespray doesn't follow
  32. [semver](https://semver.org/). Every version describes only a stable release.
  33. Breaking changes, if any introduced by changed defaults or non-contrib ansible roles'
  34. playbooks, shall be described in the release notes. Other breaking changes, if any in
  35. the contributed addons or bound versions of Kubernetes and other components, are
  36. considered out of Kubespray scope and are up to the components' teams to deal with and
  37. document.
  38. * Minor releases can change components' versions, but not the major `kube_version`.
  39. Greater `kube_version` requires a new major or minor release. For example, if Kubespray v2.0.0
  40. is bound to `kube_version: 1.4.x`, `calico_version: 0.22.0`, `etcd_version: v3.0.6`,
  41. then Kubespray v2.1.0 may be bound to only minor changes to `kube_version`, like v1.5.1
  42. and *any* changes to other components, like etcd v4, or calico 1.2.3.
  43. And Kubespray v3.x.x shall be bound to `kube_version: 2.x.x` respectively.
  44. ## Release note creation
  45. You can create a release note with:
  46. ```shell
  47. export GITHUB_TOKEN=<your-github-token>
  48. export ORG=kubernetes-sigs
  49. export REPO=kubespray
  50. release-notes --start-sha <The start commit-id> --end-sha <The end commit-id> --dependencies=false --output=/tmp/kubespray-release-note --required-author=""
  51. ```
  52. If the release note file(/tmp/kubespray-release-note) contains "### Uncategorized" pull requests, those pull requests don't have a valid kind label(`kind/feature`, etc.).
  53. It is necessary to put a valid label on each pull request and run the above release-notes command again to get a better release note
  54. ## Container image creation
  55. The container image `quay.io/kubespray/kubespray:vX.Y.Z` can be created from Dockerfile of the kubespray root directory:
  56. ```shell
  57. cd kubespray/
  58. nerdctl build -t quay.io/kubespray/kubespray:vX.Y.Z .
  59. nerdctl push quay.io/kubespray/kubespray:vX.Y.Z
  60. ```
  61. The container image `quay.io/kubespray/vagrant:vX.Y.Z` can be created from build.sh of test-infra/vagrant-docker/:
  62. ```shell
  63. cd kubespray/test-infra/vagrant-docker/
  64. ./build vX.Y.Z
  65. ```
  66. Please note that the above operation requires the permission to push container images into quay.io/kubespray/.
  67. If you don't have the permission, please ask it on the #kubespray-dev channel.