v1.26.X

Upgrade Notice

Before upgrading from earlier releases, be sure to read the Kubernetes Urgent Upgrade Notes.

Version Release date Kubernetes Etcd Containerd Runc Metrics-server CoreDNS Ingress-Nginx Helm-controller Canal (Default) Calico Cilium Multus

v1.26.15+rke2r1

Mar 20 2024

v1.26.15

v3.5.9-k3s1

v1.7.11-k3s2

v1.1.

v0.6.3

v1.11.1

nginx-1.9.3-hardened1

v0.15.9

Flannel v0.24.3
Calico v3.27.2

v3.27.2

v1.15.1

v4.0.2

v1.26.14+rke2r1

Feb 29 2024

v1.26.14

v3.5.9-k3s1

v1.7.11-k3s2

v1.1.12

v0.6.3

v1.11.1

nginx-1.9.3-hardened1

https://github.com/k3s-io/helm-controller/releases/tag/

Flannel v0.24.2
Calico v3.27.0

v3.27.0

v1.15.1

v4.0.2

v1.26.13+rke2r1

Feb 06 2024

v1.26.13

v3.5.9-k3s1

v1.7.11-k3s2

v1.1.12

v0.6.3

v1.10.1

nginx-1.9.3-hardened1

v0.15.8

Flannel v0.23.0
Calico v3.26.3

v3.26.3

v1.14.4

v4.0.2

v1.26.12+rke2r1

Dec 26 2023

v1.26.12

v3.5.9-k3s1

v1.7.11-k3s2

v1.1.10

v0.6.3

v1.10.1

nginx-1.9.3-hardened1

v0.15.4

Flannel v0.23.0
Calico v3.26.3

v3.26.3

v1.14.4

v4.0.2

v1.26.11+rke2r1

Dec 05 2023

v1.26.11

v3.5.9-k3s1

v1.7.7-k3s1

v1.1.8

v0.6.3

v1.10.1

nginx-1.9.3-hardened1

v0.15.4

Flannel v0.23.0
Calico v3.26.3

v3.26.3

v1.14.4

v4.0.2

v1.26.10+rke2r2

Nov 08 2023

v1.26.10

v3.5.9-k3s1

v1.7.7-k3s1

v1.1.8

v0.6.3

v1.10.1

4.8.2

v0.15.4

Flannel v0.22.1
Calico v3.26.1

v3.26.1

v1.14.2

v4.0.2

v1.26.10+rke2r1

Oct 31 2023

v1.26.10

v3.5.9-k3s1

v1.7.7-k3s1

v1.1.8

v0.6.3

v1.10.1

4.8.2

v0.15.4

Flannel v0.22.1
Calico v3.26.1

v3.26.1

v1.14.2

v4.0.2

v1.26.9+rke2r1

Sep 18 2023

v1.26.9

v3.5.9-k3s1

v1.7.3-k3s1

v1.1.8

v0.6.3

v1.10.1

4.6.1

v0.15.4

Flannel v0.22.1
Calico v3.26.1

v3.26.1

v1.14.1

v4.0.2

v1.26.8+rke2r1

Sep 06 2023

v1.26.8

v3.5.9-k3s1

v1.7.3-k3s1

v1.1.8

v0.6.3

v1.10.1

4.6.1

v0.15.4

Flannel v0.22.1
Calico v3.26.1

v3.26.1

v1.14.0

v4.0.2

v1.26.7+rke2r1

Jul 28 2023

v1.26.7

v3.5.7-k3s1

v1.7.1-k3s1

v1.1.7

v0.6.3

v1.10.1

4.6.1

v0.15.2

Flannel v0.22.0
Calico v3.25.1

v3.26.1

v1.13.2

v4.0.2

v1.26.6+rke2r1

Jun 27 2023

v1.26.6

v3.5.7-k3s1

v1.7.1-k3s1

v1.1.7

v0.6.3

v1.10.1

4.5.2

v0.15.0

Flannel v0.22.0
Calico v3.25.1

v3.25.0

v1.13.2

v3.9.3

v1.26.5+rke2r1

May 30 2023

v1.26.5

v3.5.7-k3s1

v1.7.1-k3s1

v1.1.7

v0.6.3

v1.10.1

4.5.2

v0.14.0

Flannel v0.21.3
Calico v3.25.1

v3.25.0

v1.13.2

v3.9.3

v1.26.4+rke2r1

Apr 21 2023

v1.26.4

v3.5.7-k3s1

v1.6.19-k3s1

v1.1.5

v0.6.2

v1.10.1

4.5.2

v0.13.2

Flannel v0.21.3
Calico v3.25.0

v3.25.0

v1.13.0

v3.9.3

v1.26.3+rke2r1

Mar 27 2023

v1.26.3

v3.5.5-k3s1

v1.6.19-k3s1

v1.1.4

v0.6.2

v1.9.3

4.1.0

v0.13.2

Flannel v0.21.3
Calico v3.25.0

v3.25.0

v1.13.0

v3.9.3

v1.26.2+rke2r1

Mar 10 2023

v1.26.2

v3.5.5-k3s1

v1.6.15-k3s1

v1.1.4

v0.6.2

v1.9.3

4.1.0

v0.13.2

Flannel v0.21.1
Calico v3.25.0

v3.25.0

v1.12.5

v3.9.3

v1.26.1+rke2r1

Jan 26 2023

v1.26.1

v3.5.5-k3s1

v1.6.15-k3s1

v1.1.4

v0.6.2

v1.9.3

4.1.0

v0.13.1

Flannel v0.20.2
Calico v3.24.5

v3.24.5

v1.12.4

v3.9.3

v1.26.0+rke2r2

Jan 10 2023

v1.26.0

v3.5.5

v1.6.14-k3s1

v1.1.4

v0.6.2

v1.9.3

4.1.0

v0.13.1

Flannel v0.20.2
Calico v3.24.5

v3.24.5

v1.12.4

v3.9

v1.26.0+rke2r1

Dec 15 2022

v1.26.0

v3.5.5

v1.6.12-k3s1

v1.1.4

v0.6.2

v1.9.3

4.1.0

v0.13.1

Flannel v0.20.2
Calico v3.24.5

v3.24.5

v1.12.4

v3.9

Release v1.26.15+rke2r1

This v1.26.15+rke2r1 release updates Kubernetes to v1.26.15.

Important Notes

  • Canal uses flannel 0.24.3 which includes a bug: every 5 seconds it tries to add ipv6 iptables rules and fails if the node does not have an ipv6 address. The consequence is the log "Failed to ensure iptables rules: error setting up rules: failed to apply partial iptables-restore unable to run iptables-restore (, ): exit status 4" appears every 5 seconds in the flannel container of the canal pod.

  • Flannel daemonset is not tolerating node taints: "node-role.kubernetes.io/etcd:NoExecute", "node-role.kubernetes.io/control-plane:NoSchedule" and "node.cloudprovider.kubernetes.io/uninitialized:NoSchedule" which can create problems when deploying with Rancher in certain cloud-providers (e.g. vShpere or DigitalOcean).

  • If your server (control-plane) nodes were not started with the --token CLI flag or config file key, a randomized token was generated during initial cluster startup. This key is used both for joining new nodes to the cluster, and for encrypting cluster bootstrap data within the datastore. Ensure that you retain a copy of this token, as is required when restoring from backup.

    You may retrieve the token value from any server already joined to the cluster:

    cat /var/lib/rancher/rke2/server/token

Changes since v1.26.14+rke2r1

  • Add a multus e2e test (#5547)

  • Bump vsphere csi chart to 3.1.2-rancher101 and cpi to 1.7.001 (#5556)

  • Bump coredns chart (#5563)

  • Update Calico and Canal to v3.27.2 (#5585)

  • Bump multus chart version (#5596)

  • Bump K3s version for v1.26 (#5590)

    • Fix: use correct wasm shims names

    • Bump spegel to v0.0.18-k3s3

    • Adds wildcard registry support

    • Fixes issue with excessive CPU utilization while waiting for containerd to start

    • Add env var to allow spegel mirroring of latest tag

    • Bump helm-controller/klipper-helm versions

    • Fix snapshot prune

    • Fix issue with etcd node name missing hostname

    • Fix additional corner cases in registries handling

    • RKE2 will now warn and suppress duplicate entries in the mirror endpoint list for a registry. Containerd does not support listing the same endpoint multiple times as a mirror for a single upstream registry.

  • Bump K3s version for v1.26 (#5608)

  • Update to 1.26.15 (#5616)

Charts Versions

Component Version

rke2-cilium

1.15.100

rke2-canal

v3.27.2-build2024030800

rke2-calico

v3.27.200

rke2-calico-crd

v3.27.002

rke2-coredns

1.29.002

rke2-ingress-nginx

4.8.200

rke2-metrics-server

2.11.100-build2023051513

rancher-vsphere-csi

3.1.2-rancher101

rancher-vsphere-cpi

1.7.001

harvester-cloud-provider

0.2.200

harvester-csi-driver

0.1.1700

rke2-snapshot-controller

1.7.202

rke2-snapshot-controller-crd

1.7.202

rke2-snapshot-validation-webhook

1.7.302

Release v1.26.14+rke2r1

This v1.26.14+rke2r1 release updates Kubernetes to v1.26.14.

Important Notes

If your server (control-plane) nodes were not started with the --token CLI flag or config file key, a randomized token was generated during initial cluster startup. This key is used both for joining new nodes to the cluster, and for encrypting cluster bootstrap data within the datastore. Ensure that you retain a copy of this token, as is required when restoring from backup.

You may retrieve the token value from any server already joined to the cluster:

cat /var/lib/rancher/rke2/server/token

Changes since v1.26.13+rke2r1

  • Fix validate-charts script (#5375)

  • Windows (#5370)

  • Avoid race condition when deleting HNS networks (#5385)

  • Add CNI plugin flannel support for Windows (#5396)

  • Bump coredns and multus/whereabouts versions (#5402)

  • Fix: missing 'ip link delete cilium_wg0' in rke2-killall.sh (#5408)

  • Update canal version (#5418)

  • Improve calico in windows (#5429)

  • Update Calico to v3.27.0 (#5438)

  • Update Cilium to 1.15.0 (#5453)

  • Backport agent containerd behavior 1.26 (#5455)

  • Bump K3s version for v1.26 (#5461)

  • Bump harvester-csi-driver to 0.1.7 (#5445)

  • Update k8s and Go (#5468)

  • Update Cilium to 1.15.1 (#5479)

  • Bump rke2-coredns chart (#5499)

  • Bump k3s for etcd-only fix (#5508)

  • Add new network policy for ingress controller webhook (#5512)

  • Backport bugfixes for 2024-02 rc (#5533)

    • Bump wharfie to v0.6.6 to add support for bare hostname as endpoint, fix unnecessary namespace param inclusion

    • Refactor netpol creation and add two new netpols for metrics-server and snapshot-validation-webhook

Charts Versions

Component Version

rke2-cilium

1.15.100

rke2-canal

v3.27.0-build2024020601

rke2-calico

v3.27.002

rke2-calico-crd

v3.27.002

rke2-coredns

1.29.001

rke2-ingress-nginx

4.8.200

rke2-metrics-server

2.11.100-build2023051513

rancher-vsphere-csi

3.0.1-rancher101

rancher-vsphere-cpi

1.5.100

harvester-cloud-provider

0.2.200

harvester-csi-driver

0.1.1700

rke2-snapshot-controller

1.7.202

rke2-snapshot-controller-crd

1.7.202

rke2-snapshot-validation-webhook

1.7.302

Release v1.26.13+rke2r1

This v1.26.13+rke2r1 release updates Kubernetes to v1.26.13.

Important Notes

  • Addresses the runc CVE: CVE-2024-21626 by updating runc to v1.1.12.

  • If your server (control-plane) nodes were not started with the --token CLI flag or config file key, a randomized token was generated during initial cluster startup. This key is used both for joining new nodes to the cluster, and for encrypting cluster bootstrap data within the datastore. Ensure that you retain a copy of this token, as is required when restoring from backup.

    You may retrieve the token value from any server already joined to the cluster:

    cat /var/lib/rancher/rke2/server/token

Changes since v1.26.12+rke2r1

  • Use dl.k8s.io for getting kubectl (#5179)

  • Ensure charts directory exists in Windows runtime image (#5185)

  • Bump versions of different components (#5170)

  • Update coredns chart to fix bug (#5202)

  • Update multus chart to add optional dhcp daemonset (#5212)

  • Add e2e test about dnscache (#5228)

  • Update rke2-whereabouts to v0.6.3 and bump rke2-multus parent chart (#5246)

  • Bump sriov image build versions (#5257)

  • Enable arm64 based images for calico, multus and harvester (#5267)

  • Improve kube-proxy and calico logging in Windows (#5286)

  • Bump k3s for v1.26 (#5271)

  • Update to 1.26.13 (#5293)

  • Update base image (#5308)

  • Bump K3s and runc versions for v1.26 (#5352)

Charts Versions

Component Version

rke2-cilium

1.14.400

rke2-canal

v3.26.3-build2023110900

rke2-calico

v3.26.300

rke2-calico-crd

v3.26.300

rke2-coredns

1.24.008

rke2-ingress-nginx

4.8.200

rke2-metrics-server

2.11.100-build2023051511

rancher-vsphere-csi

3.0.1-rancher101

rancher-vsphere-cpi

1.5.100

harvester-cloud-provider

0.2.200

harvester-csi-driver

0.1.1600

rke2-snapshot-controller

1.7.202

rke2-snapshot-controller-crd

1.7.202

rke2-snapshot-validation-webhook

1.7.302

Release v1.26.12+rke2r1

This v1.26.12+rke2r1 release updates Kubernetes to v1.26.12.

Important Notes

If your server (control-plane) nodes were not started with the --token CLI flag or config file key, a randomized token was generated during initial cluster startup. This key is used both for joining new nodes to the cluster, and for encrypting cluster bootstrap data within the datastore. Ensure that you retain a copy of this token, as is required when restoring from backup.

You may retrieve the token value from any server already joined to the cluster:

cat /var/lib/rancher/rke2/server/token

Changes since v1.26.11+rke2r1

  • Bump containerd and runc (#5121)

    • Bumped containerd/runc to v1.7.10/v1.1.10

  • Bump containerd to v1.7.11 (#5131)

  • Update to 1.26.12 for december 2023 (#5149)

Charts Versions

Component Version

rke2-cilium

1.14.400

rke2-canal

v3.26.3-build2023110900

rke2-calico

v3.26.300

rke2-calico-crd

v3.26.300

rke2-coredns

1.24.006

rke2-ingress-nginx

4.8.200

rke2-metrics-server

2.11.100-build2023051510

rancher-vsphere-csi

3.0.1-rancher101

rancher-vsphere-cpi

1.5.100

harvester-cloud-provider

0.2.200

harvester-csi-driver

0.1.1600

rke2-snapshot-controller

1.7.202

rke2-snapshot-controller-crd

1.7.202

rke2-snapshot-validation-webhook

1.7.302

Release v1.26.11+rke2r1

This v1.26.11+rke2r1 release updates Kubernetes to v1.26.11.

Important Notes

  • This release includes a version of ingress-nginx affected by CVE-2023-5043 and CVE-2023-5044. Ingress administrators should set the --enable-annotation-validation flag to enforce restrictions on the contents of ingress-nginx annotation fields.

  • If your server (control-plane) nodes were not started with the --token CLI flag or config file key, a randomized token was generated during initial cluster startup. This key is used both for joining new nodes to the cluster, and for encrypting cluster bootstrap data within the datastore. Ensure that you retain a copy of this token, as is required when restoring from backup.

    You may retrieve the token value from any server already joined to the cluster:

    cat /var/lib/rancher/rke2/server/token

Changes since v1.26.10+rke2r2

  • Add chart validation tests (#5003)

  • Update canal to v3.26.3 (#5017)

  • Update calico to v3.26.3 (#5027)

  • Bump cilium chart to 1.14.400 (#5059)

  • Bump K3s version for v1.26 (#5031)

    • Containerd may now be configured to use rdt or blockio configuration by defining rdt_config.yaml or blockio_config.yaml files.

    • Disable helm CRD installation for disable-helm-controller

    • Omit snapshot list configmap entries for snapshots without extra metadata

    • Add jitter to client config retry to avoid hammering servers when they are starting up

  • Bump K3s version for v1.26 (#5074)

    • Don’t apply S3 retention if S3 client failed to initialize

    • Don’t request metadata when listing S3 snapshots

    • Print key instead of file path in snapshot metadata log message

  • Kubernetes patch release (#5064)

  • Remove s390x steps temporarily since runners are disabled (#5097)

Charts Versions

Component Version

rke2-cilium

1.14.400

rke2-canal

v3.26.3-build2023110900

rke2-calico

v3.26.300

rke2-calico-crd

v3.26.300

rke2-coredns

1.24.006

rke2-ingress-nginx

4.8.200

rke2-metrics-server

2.11.100-build2023051510

rancher-vsphere-csi

3.0.1-rancher101

rancher-vsphere-cpi

1.5.100

harvester-cloud-provider

0.2.200

harvester-csi-driver

0.1.1600

rke2-snapshot-controller

1.7.202

rke2-snapshot-controller-crd

1.7.202

rke2-snapshot-validation-webhook

1.7.302

Release v1.26.10+rke2r2

This v1.26.10+rke2r2 release fixes an issue with identifying additional container runtimes.

Important Notes

  • This release includes a version of ingress-nginx affected by CVE-2023-5043 and CVE-2023-5044. Ingress administrators should set the --enable-annotation-validation flag to enforce restrictions on the contents of ingress-nginx annotation fields.

  • If your server (control-plane) nodes were not started with the --token CLI flag or config file key, a randomized token was generated during initial cluster startup. This key is used both for joining new nodes to the cluster, and for encrypting cluster bootstrap data within the datastore. Ensure that you retain a copy of this token, as is required when restoring from backup.

    You may retrieve the token value from any server already joined to the cluster:

    cat /var/lib/rancher/rke2/server/token

Changes since v1.26.10+rke2r1

  • Bump k3s, include container runtime fix (#4981)

    • Fixed an issue with identifying additional container runtimes

  • Update hardened kubernetes image (#4986)

Release v1.26.10+rke2r1

This v1.26.10+rke2r1 release updates Kubernetes to v1.26.10.

Important Notes

  • This release includes a version of ingress-nginx affected by CVE-2023-5043 and CVE-2023-5044. Ingress administrators should set the --enable-annotation-validation flag to enforce restrictions on the contents of ingress-nginx annotation fields.

  • If your server (control-plane) nodes were not started with the --token CLI flag or config file key, a randomized token was generated during initial cluster startup. This key is used both for joining new nodes to the cluster, and for encrypting cluster bootstrap data within the datastore. Ensure that you retain a copy of this token, as is required when restoring from backup.

    You may retrieve the token value from any server already joined to the cluster:

    cat /var/lib/rancher/rke2/server/token

Changes since v1.26.9+rke2r1

  • Add a time.Sleep in calico-win to avoid polluting the logs (#4792)

  • Support generic "cis" profile (#4798)

  • Update calico chart to accept felix config values (#4815)

  • Remove unnecessary docker pull (#4822)

  • Mirrored pause backport (#4827)

  • Write pod-manifests as 0600 in cis mode (#4839)

  • Bumping k3s (#4863)

  • Filter release branches (#4858)

  • Update charts to have ipFamilyPolicy: PreferDualStack as default (#4846)

  • Bump K3s, Cilium, Token Rotation support (#4870)

  • Bump containerd to v1.7.7+k3s1 (#4881)

  • Bump K3s version for v1.26 (#4885)

    • RKE2 now tracks snapshots using custom resource definitions. This resolves an issue where the configmap previously used to track snapshot metadata could grow excessively large and fail to update when new snapshots were taken.

    • Fixed an issue where static pod startup checks may return false positives in the case of pod restarts.

  • K3s Bump (#4898)

  • Bump K3s version for v1.26 (#4918)

    • Re-enable etcd endpoint auto-sync

    • Manually requeue configmap reconcile when no nodes have reconciled snapshots

  • Update Kubernetes to v1.26.10 (#4921)

  • Remove pod-manifests dir in killall script (#4927)

  • Revert mirrored pause backport (#4936)

  • Bump ingress-nginx to v1.9.3 (#4957)

  • Bump ingress-nginx to v1.9.3 (#4959)

  • Bump ingress-nginx to v1.9.3 (#4960)

  • Bump K3s version for v1.26 (#4970)

Release v1.26.9+rke2r1

This v1.26.9+rke2r1 release updates Kubernetes to v1.26.9.

Important Notes

If your server (control-plane) nodes were not started with the --token CLI flag or config file key, a randomized token was generated during initial cluster startup. This key is used both for joining new nodes to the cluster, and for encrypting cluster bootstrap data within the datastore. Ensure that you retain a copy of this token, as is required when restoring from backup.

You may retrieve the token value from any server already joined to the cluster:

cat /var/lib/rancher/rke2/server/token

Changes since v1.26.8+rke2r1

  • Update cilium to 1.14.1 (#4757)

  • Update Kubernetes to v1.26.9 (#4762)

Release v1.26.8+rke2r1

This v1.26.8+rke2r1 release updates Kubernetes to v1.26.8, and fixes a number of issues.

Important Notes

  • ⚠️ This release includes support for remediating CVE-2023-32186, a potential Denial of Service attack vector on RKE2 servers. See https://github.com/rancher/rke2/security/advisories/GHSA-p45j-vfv5-wprq for more information, including mandatory steps necessary to harden clusters against this vulnerability.

  • If your server (control-plane) nodes were not started with the --token CLI flag or config file key, a randomized token was generated during initial cluster startup. This key is used both for joining new nodes to the cluster, and for encrypting cluster bootstrap data within the datastore. Ensure that you retain a copy of this token, as is required when restoring from backup.

    You may retrieve the token value from any server already joined to the cluster:

    cat /var/lib/rancher/rke2/server/token

Changes since v1.26.7+rke2r1

  • Sync Felix and calico-node datastore (#4576)

  • Update Calico and Flannel on Canal (#4564)

  • Update cilium to v1.14.0 (#4586)

  • Update to whereabouts v0.6.2 (#4591)

  • Version bumps and backports for 2023-08 release (#4598)

    • Updated the embedded containerd to v1.7.3+k3s1

    • Updated the embedded runc to v1.1.8

    • Updated the embedded etcd to v3.5.9+k3s1

    • Updated the rke2-snapshot-validation-webhook chart to enable VolumeSnapshotClass validation

    • Security bump to docker/distribution

    • Fix static pod UID generation and cleanup

    • Fix default server address for rotate-ca command

  • Fix wrongly formatted files (#4612)

  • Fix repeating "cannot find file" error (#4618)

  • Bump k3s version to recent 1.26 (#4636)

  • Bump K3s version for v1.26 (#4647)

    • The version of helm used by the bundled helm controller’s job image has been updated to v3.12.3

    • Bumped dynamiclistener to address an issue that could cause the supervisor listener on 9345 to stop serving requests on etcd-only nodes.

    • The RKE2 supervisor listener on 9345 now sends a complete certificate chain in the TLS handshake.

  • Install BGP windows packages in Windows image for tests (#4652)

  • Allow OS env variables to be consumed (#4657)

  • Upgrade multus chart to v4.0.2-build2023081100 (#4664)

  • Fix bug. Add VXLAN_VNI env var to Calico-node exec (#4671)

  • Update to v1.26.8 (#4684)

  • Bump K3s version for v1.26 (#4702)

    • Added a new --tls-san-security option. This flag defaults to false, but can be set to true to disable automatically adding SANs to the server’s TLS certificate to satisfy any hostname requested by a client.

  • Add additional static pod cleanup during cluster reset (#4725)

Release v1.26.7+rke2r1

This v1.26.7+rke2r1 release updates Kubernetes to v1.26.7, and fixes a number of issues.

Important Notes

If your server (control-plane) nodes were not started with the --token CLI flag or config file key, a randomized token was generated during initial cluster startup. This key is used both for joining new nodes to the cluster, and for encrypting cluster bootstrap data within the datastore. Ensure that you retain a copy of this token, as is required when restoring from backup.

You may retrieve the token value from any server already joined to the cluster:

cat /var/lib/rancher/rke2/server/token

Changes since v1.26.6+rke2r1

  • Update Calico to v3.26.1 (#4424)

  • Update multus version (#4432)

  • Add log files for felix and calico (#4438)

  • Update K3s for 2023-07 releases (#4448)

  • Bump ingress-nginx charts to v1.7.1 (#4454)

  • Add support for cni none on windows and initial windows-bgp backend (#4460)

  • Updated Calico crd on Canal (#4467)

  • Update to 1.26.7 (#4493)

Release v1.26.6+rke2r1

This v1.26.6+rke2r1 release updates Kubernetes to v1.26.6, and fixes a number of issues.

Important Notes

If your server (control-plane) nodes were not started with the --token CLI flag or config file key, a randomized token was generated during initial cluster startup. This key is used both for joining new nodes to the cluster, and for encrypting cluster bootstrap data within the datastore. Ensure that you retain a copy of this token, as is required when restoring from backup.

You may retrieve the token value from any server already joined to the cluster:

cat /var/lib/rancher/rke2/server/token

Changes since v1.26.5+rke2r1

  • Update canal chart (#4343)

  • Bump K3s version for v1.26 (#4358)

  • Update rke2 (#4368)

  • Bump harvester cloud provider 0.2.2 (#4376)

  • Preserve mode when extracting runtime data (#4378)

  • Use our own file copy logic instead of continuity (#4389)

Release v1.26.5+rke2r1

This v1.26.5+rke2r1 release updates Kubernetes to v1.26.5, and fixes a number of issues.

Important Notes

  • If your server (control-plane) nodes were not started with the --token CLI flag or config file key, a randomized token was generated during initial cluster startup. This key is used both for joining new nodes to the cluster, and for encrypting cluster bootstrap data within the datastore. Ensure that you retain a copy of this token, as is required when restoring from backup.

    You may retrieve the token value from any server already joined to the cluster:

    cat /var/lib/rancher/rke2/server/token
  • Many systems have updated their packages with newer version of container-selinux (> v2.191.0) which is incompatible with our rke2-selinux policy and require a change in policy. We have updated our policy; you will notice the rke2-selinux package being upgraded from version v0.11.1 to newer version v0.12.0.

Changes since v1.26.4+rke2r1

  • Fix drone dispatch step (#4148)

  • Update Cilium to v1.13.2 (#4175)

  • Bump golangci-lint for golang 1.20 compat and fix warnings (#4186)

  • Enable --with-node-id flag (#4190)

  • Backport fixes and bump K3s/containerd/runc versions (#4211)

    • The bundled containerd and runc versions have been bumped to v1.7.1-k3s1/v1.1.7

    • Replace github.com/ghodss/yaml with sigs.k8s.io/yaml

    • Fix hardcoded file mount handling for default audit log filename

  • Update Calico image on Canal (#4218)

  • Move Drone dispatch pipeline (#4205)

  • Upgrade docker/docker package (#4225) (#4234)

  • Bump metrics-server to v0.6.3 (#4245)

  • V1.26.5+rke2r1 (#4260)

  • Bump vsphere csi/cpi and csi snapshot charts (#4272)

  • Bump vsphere csi to remove duplicate CSI deployment. (#4296)

Release v1.26.4+rke2r1

This v1.26.4+rke2r1 release updates Kubernetes to v1.26.4, and fixes a number of issues.

Important Notes

If your server (control-plane) nodes were not started with the --token CLI flag or config file key, a randomized token was generated during initial cluster startup. This key is used both for joining new nodes to the cluster, and for encrypting cluster bootstrap data within the datastore. Ensure that you retain a copy of this token, as is required when restoring from backup.

You may retrieve the token value from any server already joined to the cluster:

cat /var/lib/rancher/rke2/server/token

Changes since v1.26.3+rke2r1

  • Adding decision against rc version removal (#3155)

  • Bump to 1.24.12 (#4064)

  • Add skipfiles step to skip drone runs based on files in PR (#3977)

  • Update whereabouts to v0.6.1 (#4080)

  • Automatically add volume mount for audit-log-path dir if set (#4027)

  • Updated Calico chart to add crd missing values (#4044)

  • Clean up static pods on etcd member removal (#4066)

  • Add ADR for security bumps automation (#3570)

  • Make commands for terraform automation and fix upgrade split role tests (#4056)

  • Bump ingress-nginx to 1.6.4 (#4090)

  • Fix wrong dependency name (#4093)

  • Bump k3s and component versions for 2023-04 release (#4096)

  • Update Kubernetes to v1.26.4 (#4115)

Release v1.26.3+rke2r1

This v1.26.3+rke2r1 release updates Kubernetes to v1.26.3, and fixes a number of issues.

Important Notes

If your server (control-plane) nodes were not started with the --token CLI flag or config file key, a randomized token was generated during initial cluster startup. This key is used both for joining new nodes to the cluster, and for encrypting cluster bootstrap data within the datastore. Ensure that you retain a copy of this token, as is required when restoring from backup.

You may retrieve the token value from any server already joined to the cluster:

cat /var/lib/rancher/rke2/server/token

Changes since v1.26.2+rke2r1

  • Remove root --debug flag (#3955)

  • Remove unmounts in killall script (#3954)

  • Update Flannel version to v0.21.3 on Canal (#3980)

  • Remove unnecessary bits from testing dockerfile (#3975)

  • Expand SUC upgrade check to check pods as well as nodes (#3938)

  • Don’t package empty Windows folder in Linux tar (#3970)

  • Bump K3s (#3990)

  • Improve uninstallation on RHEL based OS (#3919)

  • Update cilim to v1.13.0 (#4003)

  • Bump harvester csi driver to v0.1.16 (#3999)

  • Update stable channel to v1.24.11+rke2r1 (#4010)

  • Bump k3s and containerd (#4015)

  • Add automation for Restart command for Rke2 (#3962)

  • Update 1.26 and Go (#4033)

Release v1.26.2+rke2r1

This v1.26.2+rke2r1 release updates Kubernetes to v1.26.2, and fixes a number of issues.

Important Notes

If your server (control-plane) nodes were not started with the --token CLI flag or config file key, a randomized token was generated during initial cluster startup. This key is used both for joining new nodes to the cluster, and for encrypting cluster bootstrap data within the datastore. Ensure that you retain a copy of this token, as is required when restoring from backup.

You may retrieve the token value from any server already joined to the cluster:

cat /var/lib/rancher/rke2/server/token

Changes since v1.26.1+rke2r1

  • Remove pod logs as part of killall (#3821)

  • Update channel server (#3853)

  • Bump cilium images (#3802)

  • Update canal chart to v3.25.0-build2023020901 (#3877)

  • Bump wharfie and go-containerregistry (#3863)

  • Update Calico to v3.25.0 (#3887)

  • Updated RKE2 README’s header image to point to the new rke2-docs repo (#3727)

  • Bump K3s version (#3897)

    • Fixed an issue where leader-elected controllers for managed etcd did not run on etcd-only nodes

    • RKE2 now functions properly when the cluster CA certificates are signed by an existing root or intermediate CA. You can find a sample script for generating such certificates before RKE2 starts in the K3s repo at contrib/util/certs.sh.

    • RKE2 now supports kubeadm style join tokens. rke2 token create now creates join token secrets, optionally with a limited TTL.

    • RKE2 agents joined with an expired or deleted token stay in the cluster using existing client certificates via the NodeAuthorization admission plugin, unless their Node object is deleted from the cluster.

    • ServiceLB now honors the Service’s ExternalTrafficPolicy. When set to Local, the LoadBalancer will only advertise addresses of Nodes with a Pod for the Service, and will not forward traffic to other cluster members. (ServiceLB is still disabled by default)

  • Bump K3s commit (#3905)

  • Add bootstrap token auth handler (#3920)

  • Add support for legacy kubelet logging flags (#3932)

  • Bump helm-controller/klipper-helm (#3936)

    • The embedded helm-controller job image now correctly handles upgrading charts that contain resource types that no longer exist on the target Kubernetes version. This includes properly handling removal of PodSecurityPolicy resources when upgrading from ⇐ v1.24.

  • Add sig-storage snapshot controller and validation webhook (#3944)

  • Add a quick host-path CSI snapshot to the basic CI test (#3946)

  • Update kubernetes to v1.26.2 (#3953)

Release v1.26.1+rke2r1

This v1.26.1+rke2r1 release updates Kubernetes to v1.26.1 to backport registry changes and fix two critical issues.

Important Notes

If your server (control-plane) nodes were not started with the --token CLI flag or config file key, a randomized token was generated during initial cluster startup. This key is used both for joining new nodes to the cluster, and for encrypting cluster bootstrap data within the datastore. Ensure that you retain a copy of this token, as is required when restoring from backup.

You may retrieve the token value from any server already joined to the cluster:

cat /var/lib/rancher/rke2/server/token

Changes since v1.26.0+rke2r2

  • Don’t clean up kube-proxy every time agents start (#3737)

  • Add rke2 e2e test run script and adjustments (#3766)

  • Update channels (#3768)

  • Bump containerd to v1.6.15-k3s1 (#3767)

  • Fix typos (#3741)

  • Generate report and upload test results (#3771)

  • Update multus to v3.9.3 and whereabouts to v0.6 (#3789)

  • Bump harvester cloud provider and harvester csi driver (#3781)

  • Bump K3s version for tls-cipher-suites and etcd snapshot conflict fix (#3772)

Release v1.26.0+rke2r2

This v1.26.0+rke2r2 release updates containerd to v1.6.14 to resolve an issue where pods would lose their CNI information when containerd was restarted.

Changes since v1.26.0+rke2r1

  • Bump containerd to v1.6.14-k3s1 (#3746)

    • The embedded containerd version has been bumped to v1.6.14-k3s1. This includes a backported fix for containerd/7843 which caused pods to lose their CNI info when containerd was restarted, which in turn caused the kubelet to recreate the pod.

    • Windows agents now use the k3s fork of containerd, which includes support for registry rewrites.

Release v1.26.0+rke2r1

This v1.26.0+rke2r1 release is RKE2’s first in the v1.26 line. This release updates Kubernetes to v1.26.0.

Before upgrading from earlier releases, be sure to read the Kubernetes Urgent Upgrade Notes.

Important Notes

This release is affected by https://github.com/containerd/containerd/issues/7843, which causes the kubelet to restart all pods whenever RKE2 is restarted. For this reason, we have removed this RKE2 release from the channel server. Please use v1.26.0+rke2r2 instead.

Changes since v1.25.4+rke2r1

  • Bump ingress-nginx (#3703)

  • Fixed cilium chart when enabled hubble images (#3687)

  • Update kubernetes to v1.26.0 (#3599)

  • Bump ingress-nginx to 1.4.1 (#3653)

  • Bump k3s version for v1.25 (#3646)

  • Bump metrics-server tag (#3647)

  • Updated cilium version and added new cilium images (#3642)

  • Fix jenkinsfile typo and clarify support for oracle in tf automation (#3611)

  • Update rke2-calico chart to v3.24.501 (#3620)

  • Update canal version (#3625)

  • Update rke2-multus chart to v3.9-build2022102805 (#3622)

  • Support autodetection interface methods in windows (#3615)

  • Add rke2 standalone install script for windows (#3608)

  • Update tf variable for aws to be more clear (#3609)

  • Add more tests to the windows env (#3594)

  • Fix aws s3 artifact upload issues (#3601)

  • Create upgrade test in tf and refactor to allow running packages separately (#3583)

  • Dualstack e2e test fix and additional netpol test (#3574)

  • Remove old docs (#3584)

  • Switching from gcp gcs to aws s3 buckets (#3563)

  • Take nodeip into account to configure the calico networks (#3530)

  • Refactor windows calico code (#3543)

  • Bump k3s and component versions (#3577)

  • Terminate pods directly via cri instead of waiting for kubelet cleanup (#3567)

  • Utilize jenkins env vars for required cluster creation variables (#3576)

  • Update channels.yaml for november (#3575)

  • Don’t try to validate linux cis profile compliance on windows (#3568)