diff --git a/release-schedule.markdown b/release-schedule.markdown index 5b12d72..894aa47 100644 --- a/release-schedule.markdown +++ b/release-schedule.markdown @@ -42,3 +42,35 @@ permalink: /release-schedule/ + +
+
+
+

Backports, CVEs, and respins, oh my!

+ +

Kroxylicious is a community endeavour: we maintain one branch, main, and make releases from it. + We always recommend running the latest release.

+

We recognise this doesn't work for everyone. The community can get fixes into older releases — with a little help from a friend.

+ +

A note on respins: a CVE in a base image alone is not a reason to cut a maintenance release — rebuild your container image instead. + Maintenance releases are for vulnerabilities in Kroxylicious code or its runtime dependencies.

+ +

How to get a maintenance release

+
    +
  1. Start a conversation — anyone in the community, including committers and project managers, needs to drop a note to kroxylicious-dev@googlegroups.com describing the version you need and the fixes required. + This is a discussion, not a demand: you'll need to convince a committer that a maintenance release makes sense.
  2. +
  3. A committer creates the release branch — if a committer agrees, they will create a release/X.Y branch. + Community members cannot create release branches directly; this step requires a committer.
  4. +
  5. The community does the work — cherry-picks from main are ideal, but not always practical. + Were main ever to move to a new major version of a core dependency, an older release on the previous version would need changes adapted rather than simply cherry-picked. + The contributor proposing the backport is responsible for that adaptation.
  6. +
  7. Agree scope — before cutting the maintenance release, the committer should call for lazy consensus on the mailing list: share what will be included and allow a reasonable window for objections. + There's no value in running the release machinery for every individual change; batching is preferred. + For a highly exploitable CVE the committers may agree to shorten or waive the consensus window.
  8. +
  9. A committer cuts the release — once consensus is reached, lazy style, on the branch content, a committer will cut the release.
  10. +
+
+
+