[x] Depending on your OS, make sure Docker is running
[x] Export a GITHUB_TOKEN that has access to the repository. Only classic tokens are
supported at the moment, the needed scopes are write:org, public_repo and project.
[x] Make sure a setup (GPG, SSH, S/MIME) is in place for signing tags
with Git and install gh.
[ ] Run git clone https://github.com/cilium/charts.git "$GOPATH/src/github.com/cilium/charts"
[ ] Run git clone https://github.com/cilium/release.git "$GOPATH/src/github.com/cilium/release"
[ ] If you already have the repo checked out, make sure the release binary is up to date:
git checkout main && git pull && make
[x] Read the documentation of release start --help tool to understand what
each automated step does.
Pre-check (run ~1 week before release date)
[x] When you create a GitHub issue using this issue template, GitHub Slack app posts a
message in #launchpad Slack channel. Create a thread for that message and ping the
current backporter to merge the outstanding backport PRs and stop merging any new
backport PRs until the GitHub issue is closed (to avoid generating incomplete
release notes).
[x] Run ./release start --steps 1-pre-check --target-version v1.14.17
[x] Check that there are no release blockers for the targeted release
version.
[x] Ensure that outstanding backport PRs are merged (these may be
skipped on case by case basis in coordination with the backporter).
[x] Check with @cilium/security team in case there are any CVEs found in the
docker image.
[x] Check with @cilium/security team if there are any security fixes to
include in the release.
Preparation PR (run ~1 day before release date. It can be re-run multiple times.)
[x] Go to release workflow and Run the workflow from "Branch: main", for
step "2-prepare-release" and version for v1.14.17
[x] Check if the workflow was successful and check the PR opened by the
Release bot.
[x] Merge PR
Tagging
[x] Ask a maintainer if there are any known issues that should hold up the release
[x] FYI, do not wait too much time between a tag is created and the helm charts are published.
Once the tags are published the documentation will be pointing to them. Until we release
the helm chart, users will face issues while trying out our documentation.
[x] Run ./release start --steps 3-tag --target-version v1.14.17
[x] Ask a maintainer to approve the build in the following link (keep the URL
of the GitHub run to be used later):
Cilium Image Release builds
Post Tagging (run after docker images are published)
[x] Go to release workflow and Run the workflow from "Branch: main", for
step "4-post-release" and version for v1.14.17
[x] Check if the workflow was successful and check the PR opened by the
Release bot.
[x] Merge PR
[ ] This step opened a GitHub project
to track the PRs in the release. Close the corresponding project.
Publish helm (run after docker images are published)
[x] Update the text at the top with 2-3 highlights of the release
[x] Check with @cilium/security if the release addresses any open security
advisory. If it does, include the list of security advisories at the
top of the release notes.
[x] Check whether the new release should be set as the latest release
(via the checkbox at the bottom of the page). It should be the new
latest if the version number is strictly superior to the current
latest release displayed on GitHub (e.g. 1.11.13 does not become the
new latest release over 1.12.5, but version 1.12.6 will).
[x] Publish the release
[x] Announce the release in #general on Slack (do not use [@]channel).
See below for templates.
[x] Prepare post-release changes to main branch using ../release/internal/bump-readme.sh.
Slack example text templates
Patch releases
:confetti_ball: :cilium-radiant: Release Announcement :cilium-radiant::confetti_ball:
Cilium v1.14.17, vA.B.C, and vD.E.F have been released. Thanks all for your contributions! Please see the release notes below for details :cilium-gopher:
v1.14.17: https://github.com/cilium/cilium/releases/tag/v1.14.17
vA.B.C: https://github.com/cilium/cilium/releases/tag/vA.B.C
vD.E.F: https://github.com/cilium/cilium/releases/tag/vD.E.F
First pre-release
:cilium-new: *Cilium v has been released:*
https://github.com/cilium/cilium/releases/tag/v
This is the first monthly snapshot for the v1.14 development cycle. There are [v OSS docs](https://docs.cilium.io/en/v) available if you want to pull this version & try it out.
Subsequent pre-/rc- releases
*Announcement* :tada: :tada:
:cilium-new: *Cilium v has been released:*
https://github.com/cilium/cilium/releases/tag/v
Thank you for the testing and contributing to the previous pre-releases. There are [v OSS docs](https://docs.cilium.io/en/v) available if you want to pull this version & try it out.
Setup preparation
GITHUB_TOKEN
that has access to the repository. Only classic tokens are supported at the moment, the needed scopes arewrite:org
,public_repo
andproject
.[x] Make sure the Cilium helm charts and release repositories are installed locally:
git clone https://github.com/cilium/charts.git "$GOPATH/src/github.com/cilium/charts"
git clone https://github.com/cilium/release.git "$GOPATH/src/github.com/cilium/release"
[ ] If you already have the repo checked out, make sure the
release
binary is up to date:git checkout main && git pull && make
release start --help
tool to understand what each automated step does.Pre-check (run ~1 week before release date)
./release start --steps 1-pre-check --target-version v1.14.17
Preparation PR (run ~1 day before release date. It can be re-run multiple times.)
Tagging
./release start --steps 3-tag --target-version v1.14.17
Post Tagging (run after docker images are published)
Publish helm (run after docker images are published)
./release start --steps 5-publish-helm --target-version v1.14.17
Publish docs (only for pre/rc releases)
docsearch.config.json
, commit them and push a trigger the workflow herePost-release
../release/internal/bump-readme.sh
.Slack example text templates
Patch releases
First pre-release
Subsequent pre-/rc- releases