Tasks for Kubernetes v1.25

[sbueringer]

This issue is tracking the list of tasks that should be implemented when Kubernetes v1.24 is released. Currently, we are waiting for the Kubernetes release

For prior art please see #5968

• CI:

  • CAPD:
    • PR: ⚠️ Use Kubernetes 1.25 in Quick Start docs and CAPD. #7156
    • release-1.2 PR: [release-1.2] ⚠️ Use Kubernetes 1.25 in Quick Start docs and CAPD. #7174
    • docker.yaml: KUBERNETES_ env vars in variables
    • Tiltfile
    • kind_provider.go, docker/*, ... (just grep for the previously used version in CAPD)
    • also bump kind to v0.15.0
  • Jobs: Bump cluster-api jobs for v1.25/v1.26 kubernetes/test-infra#27421
    • Add new periodic upgrade jobs, for all release where we want to support the new Kubernetes version
    • Adjust presubmit jobs so that we have the latest upgrade jobs available on PRs (for all releases)
    • Update INIT_WITH_KUBERNETES_VERSION

• Book:

  • Update and test quickstart
    • PR: ⚠️ Use Kubernetes 1.25 in Quick Start docs and CAPD. #7156
    • release-1.2 PR: [release-1.2] ⚠️ Use Kubernetes 1.25 in Quick Start docs and CAPD. #7174
  • Update supported versions in versions.md
    • PR: 🌱 Update versions doc adding Kubernetes 1.25 #7194
    • release-1.2 PR: [release-1.2] 🌱 Update versions doc adding Kubernetes 1.25 #7195
  • Update job documentation in CAPI (jobs.md)
    • PR: 📖 docs update jobs.md #7196
    • release-1.2 PR: [release-1.2] 📖 docs update jobs.md #7197

• Release specific issues:

  • Adjust KCP to migrate registry:
    • 🐛 kcp: patch ImageRepository in ClusterConfiguration if it is not set for v1.25 #6917
    • [release-1.2] 🐛 kcp: patch ImageRepository in ClusterConfiguration if it is not set for v1.25 #6957

• After a Kubernetes release is cut a controller-runtime version is created. When the CR version is available we have to:

  • Bump controller-runtime to use new Kubernetes Go libraries (controller-runtime, controller-tools, client-go, ...)
    • This can include upgrading the Go version (we're using the same as k/k)
    • PR: 🌱 Bump controller-runtime to use new Kubernetes Go libraries #7211
  • Update KUBEBUILDER_ENVTEST_KUBERNETES_VERSION in Makefile
    • PR: 🌱 Update kubebuilder envtest (1.24.2 -> 1.25.0) #7193
  • Bump conversion-gen in Makefile via CONVERSION_GEN_VER
    • PR: 🌱 Update conversion-gen version (v0.23.1 -> v0.25.0) #7118
  • If the new Kubernetes version uses a new Go version
    • Jobs: Update kubekins-e2e images used for jobs running against main
      • Potentially it makes sense to switch to the latest ("master") version of kubekins-e2e if there is no -{KUBERNETES-VERSION} tag of the image already.
      • PR: presubmit Upgrade cluster-api kubekins-e2e version (v20220829-d5650c79bf-1.24 -… kubernetes/test-infra#27311
      • PR: periodics: Upgrade cluster-api kubekins-e2e version for periodics-main (v2022082… kubernetes/test-infra#27326
      • PR: bump Go in CAPI: 🌱 Upgrade golang version (1.18.3 -> 1.19.0) #7135
    • Update go version:
      • .github/workflows
      • .golangci.yml (+ corresponding workflow file)
      • cloudbuild YAMLs (to use an image with the current go version)
      • hack/ensure-go.sh
      • netlify.toml
      • Makefiles
      • Tiltfile
    • [opt] go.mod files (only if we want to increase the minimum supported version of consumers) [will bump to go 1.19 after the CR/k8s.io bump]

[chrischdi]

Release specific issues: / Adjust KCP to migrate registry should be fixed now :-)

[fabriziopandini]

/triage accepted

[sbueringer]

Just fyi. Kubernetes 1.25 is using Go 1.19

[sbueringer]

I'll be collecting some notes in this comment for the upcoming controller-runtime upgrade:

• Consider enabling RecoverPanic on all our webhooks, xref: ✨ webhook: add an option to recover from panics in handler controller-runtime#1900
  • Just realized we intentionally didn't do it for the reconcilers. So we probably also don't want to enable it for the webhooks, but TBD.

[oscr]

/assign

[sbueringer]

Just fyi. Added a new sub task as I noticed that we forgot to bump conversion-gen the last time. (we're currently using conversion-gen v0.23.1)

[oscr]

I will bump Go version once an updated cloudbuild image with Go 1.19 is released.

https://console.cloud.google.com/gcr/images/k8s-staging-test-infra/GLOBAL/gcb-docker-gcloud