Skip to content

New Kubernetes Release

Jump to bottom
John Kasperski edited this page Oct 17, 2025 · 28 revisions

The following steps are required to create a new branch for a new Kubernetes release:

  1. Determine the version of latest Kubernetes Releases such as "v1.35.0-alpha.1".

  2. Click on that release to get to the Github source code. Locate the go.mod to determine the GO version for this new release

  3. Create new Label for the new release: "release-1.xx"

  4. Create new branch for this new Kubernetes release

    • Bring up the top level, default page of this repo
    • In the Branch drop-down menu, enter the name for the new branch: release-<major>.<minor> where <major>.<minor> is the Kubernetes major and minor version (e.g. release-1.35)

  5. Locally check out the new branch and make the following updates:

    • Update dependabot.yml configuration
    • Update kube-update.yml Github Action workflow
    • Update golangci-update.yml Github Action workflow
    • Update go.mod:
      • Update the GO version
      • Update each of the direct k8s.io modules to new release/patch level (such as v0.35.0-alpha.1)
        • NOTE: The k8s.io libraries are v0. where as the actual Kubernetes release is v1.
      • Remove all indirect references to the k8s.io modules

  6. Update the GO version installed on laptop to match this Kubernetes release GO version (it is OK for laptop to be at a newer version of GO)

  7. Run: go mod tidy to download the GO dependencies and refresh the go.sum file with the new libraries

  8. Run: make all to perform a local build of the repo. Fix all errors until the the new branch compiles cleanly.

  9. Check in / merge the changes to the new branch

  10. Make sure the Github actions build the branch cleanly

  11. Set the new branch to be the "default" branch. This is done in the repo Settings under the General tab

  12. Delete files no longer needed in the previous "default" branch:

    • .github/workflows/dispatch-pr-create.yml
    • .github/workflows/golangci-update.yml
    • .github/workflows/kube-update.yml
    • .github/dependabot.yml

  13. Update the Kubernetes-to-OpenShift-releases Wiki page with the new release

  14. Update all references/links on this Wiki page to the new release.

  15. Within 24 hours, the kube-update.yml Github Action workflow will run and create a PR to update the remaining files in the new branch to the new Kubernetes release

Clone this wiki locally