KDM (Kontainer Driver Metadata) updates are crucial for ensuring the compatibility and stability of Kubernetes (K8s) environments. These updates provide the necessary information for Rancher to manage and provision Kubernetes clusters. In this article, we will discuss the latest KDM update for K8s, specifically the v2.10 patch released in March 2025.
It is essential to update system images and add-ons in the template as needed. The following table provides a list of system images and add-ons that require updates:
The following table provides a list of system images and add-ons that require updates:
Expand for system images & add-on templates versioning table
Note: Truncated repository names with a * indicates there are multiple images with that prefix. All repository names that match a truncated prefix should be checked for the same version stated in the table.
For example: rancher/weave-* matches weaveworks/weave-kube and weaveworks/weave-npc, and they should both have the same version.
v1.30.5-rancher1-1
| Repository |
Tag |
| rancher/mirrored-coreos-etcd |
v3.5.10 |
| rancher/hyperkube |
v1.30.5-rancher1 |
| rancher/rke-tools |
v0.1.96 |
| rancher/mirrored-k8s-dns-* |
1.22.28 |
| rancher/mirrored-cluster-proportional-autoscaler |
1.8.6 |
| rancher/flannel-cni |
v0.3.0-rancher8 |
| rancher/mirrored-flannel-flannel |
v0.21.4 |
| rancher/mirrored-calico-* |
v3.26.3 |
| weaveworks/weave-* |
2.8.1 |
| noiro/* (All ACI images) |
6.0.3.2.81c2369 |
| rancher/mirrored-pause |
3.7 |
| rancher/nginx-ingress-controller |
nginx-1.9.4-rancher1 |
| rancher/mirrored-nginx-ingress-controller-defaultbackend |
1.5-rancher1 |
| rancher/mirrored-jettech-kube-webhook-certgen |
v20231011-8b53cabe0 |
| rancher/mirrored-metrics-server |
v0.6.3 |
| rancher/mirrored-coredns-coredns |
1.9.4 |
| rancher/mirrored-cluster-proportional-autoscaler |
1.8.6 |
| rancher/mirrored-k8s-dns-node-cache |
1.22.28 |
| Add-on Name |
Add-on Template Version Constraint |
| ------------- |
---------------------------------- |
| Calico |
calicov3261Rancher2 |
| Canal |
canalv3261Rancher2 |
| Flannel |
flannelv0214 |
| CoreDNS |
coreDnsv183Rancher2 |
| KubeDNS |
kubeDnsv116 |
| MetricsServer |
metricsServerv061 |
| Weave |
weavev122 |
| Aci |
aciv6032 |
| NginxIngress |
nginxIngressv194Rancher1 |
| Nodelocal |
nodelocalv121 |
v1.29.9-rancher1-1
| Repository |
Tag |
| rancher/mirrored-coreos-etcd |
v3.5.10 |
| rancher/hyperkube |
v1.29.9-rancher1 |
| rancher/rke-tools |
v0.1.96 |
| rancher/mirrored-k8s-dns-* |
1.22.28 |
| rancher/mirrored-cluster-proportional-autoscaler |
1.8.6 |
| rancher/flannel-cni |
v0.3.0-rancher8 |
| rancher/mirrored-flannel-flannel |
v0.21.4 |
| rancher/mirrored-calico-* |
v3.26.3 |
| weaveworks/weave-* |
2.8.1 |
| noiro/* (All ACI images) |
6.0.3.2.81c2369 |
| rancher/mirrored-pause |
3.7 |
| rancher/nginx-ingress-controller |
nginx-1.9.4-rancher1 |
| rancher/mirrored-nginx-ingress-controller-defaultbackend |
1.5-rancher1 |
| rancher/mirrored-jettech-kube-webhook-certgen |
v20231011-8b53cabe0 |
| rancher/mirrored-metrics-server |
v0.6.3 |
| rancher/mirrored-coredns-coredns |
1.9.4 |
| rancher/mirrored-cluster-proportional-autoscaler |
1.8.6 |
| rancher/mirrored-k8s-dns-node-cache |
1.22.28 |
| Add-on Name |
Add-on Template Version Constraint |
|
[v2.10] KDM Update for K8s March 2025 patch: Q&A
Q: What is the purpose of the KDM update for K8s?
A: The KDM update for K8s is designed to ensure the compatibility and stability of Kubernetes environments. It provides the necessary information for Rancher to manage and provision Kubernetes clusters.
Q: What new Kubernetes versions are supported by the v2.10 patch?
A: The v2.10 patch introduces support for the following new Kubernetes versions:
- 1.31.7-rancher1-1: This version is supported by Rancher 2.10.0-patch0 and RKE 1.7.0-rc0.
- 1.30.11-rancher1-1: This version is supported by Rancher 2.9.0-patch0 and RKE 1.6.0-rc0.
- 1.29.15-rancher1-1: This version is supported by Rancher 2.9.0-patch0 and RKE 1.6.0-rc0.
Q: What are the system images and add-ons that require updates?
A: The following system images and add-ons require updates:
| Repository |
Tag |
| rancher/mirrored-coreos-etcd |
v3.5.10 |
| rancher/hyperkube |
v1.30.5-rancher1 |
| rancher/rke-tools |
v0.1.96 |
| rancher/mirrored-k8s-dns-* |
1.22.28 |
| rancher/mirrored-cluster-proportional-autoscaler |
1.8.6 |
| rancher/flannel-cni |
v0.3.0-rancher8 |
| rancher/mirrored-flannel-flannel |
v0.21.4 |
| rancher/mirrored-calico-* |
v3.26.3 |
| weaveworks/weave-* |
2.8.1 |
| noiro/* (All ACI images) |
6.0.3.2.81c2369 |
| rancher/mirrored-pause |
3.7 |
| rancher/nginx-ingress-controller |
nginx-1.9.4-rancher1 |
| rancher/mirrored-nginx-ingress-controller-defaultbackend |
1.5-rancher1 |
| rancher/mirrored-jettech-kube-webhook-certgen |
v20231011-8b53cabe0 |
| rancher/mirrored-metrics-server |
v0.6.3 |
| rancher/mirrored-coredns-coredns |
1.9.4 |
| rancher/mirrored-cluster-proportional-autoscaler |
1.8.6 |
| rancher/mirrored-k8s-dns-node-cache |
1.22.28 |
Q: What are the add-on template version constraints that require updates?
A: The following add-on template version constraints require updates:
| Add-on Name |
Add-on Template Version Constraint |
| Calico |
calicov3261Rancher2 |
| Canal |
canalv3261Rancher2 |
| Flannel |
flannelv0214 |
| CoreDNS |
coreDnsv183Rancher2 |
| KubeDNS |
kubeDnsv116 |
| MetricsServer |
metricsServerv061 |
| Weave |
weavev122 |
| Aci |
aciv6032 |
| NginxIngress |
nginxIngressv194Rancher1 |
| Nodelocal |
nodelocalv121 |
Q: How do I update my system images and add-ons?
A: To update your system images and add-ons, follow these steps:
- Check the versioning reference table to ensure you have the latest versions.
- Update the system images and add-ons in the template as needed.
- Confirm the versions for system images, add-on templates are correct using the versioning reference table.
- Update the table if new versions are introduced.
- Confirm the add-on template version constraints are correct using the versioning reference table.
- Update the table if needed.
Q: What are the benefits of updating my KDM?
A: Updating your KDM ensures the compatibility and stability of your Kubernetes environment. It provides the necessary information for Rancher to manage and provision Kubernetes clusters, ensuring a smooth and efficient experience.
Q: How do I get started with the v2.10 patch?
A: To get started with the v2.10 patch, follow these steps:
- Review the KDM update documentation to understand the changes and requirements.
- Update your system images and add-ons as needed.
- Confirm the versions for system images, add-on templates are correct using the versioning reference table.
- Update the table if new versions are introduced.
- Confirm the add-on template version constraints are correct using the versioning reference table.
- Update the table if needed.
By following these steps and updating your KDM, you can ensure a smooth and efficient experience with your Kubernetes environment.