diff --git a/docs/upgrading_kubernetes.nd b/docs/upgrading_kubernetes.nd new file mode 100644 index 0000000000..d49080af55 --- /dev/null +++ b/docs/upgrading_kubernetes.nd @@ -0,0 +1,16 @@ +# Upgrade Kubernetes Process + +From time to time we need to update the version of Kubernetes used by RKE2. This document serves as a how-to for that process. The following steps are laid out in order. + +## Kube-proxy Helm Chart + +Create a new release asset for in the [rke2-charts](github.com/rancher/rke2-charts) repository. Instructions for doing so can be found in the repo. This is necessary as the RKE2 build process will check for that chart and source it into one of its build artifacts. + +## Update RKE2 + +The following files have references that will need to be updated in the respective locations. Replace the found version with the desired version. + +* Dockerfile: `RUN CHART_VERSION="v1.18.4" CHART_FILE=/charts/rke2-kube-proxy-chart.yml` +* Dockerfile: `FROM rancher/k3s:v1.18.4-k3s1 AS k3s` +* images.go: `KubernetesVersion = "v1.18.4"` +* version.sh: `KUBERNETES_VERSION=${KUBERNETES_VERSION:-v1.18.4}`