Rancher v2.6.2
For this supported product version, open source software and integrations covered by our terms and conditions0 are those validated and certified per support matrix00 below.
Installing Rancher v2.6.2 on RKE
RKE CLI & K8S for Local Cluster
| Rancher Version | Recommended CLI Version | Kubernetes Versions |
|---|---|---|
| v2.6.2 | v1.3.1 | v1.21.5
v1.20.11 v1.19.15 v1.18.20 |
OS & Docker
| Type | Version | Validated/certified on1 |
|---|---|---|
| CentOS | 7.7, 7.8, 7.9 | Docker 18.06.3, 18.09.x, 19.03.x, 20.10.x | 8.3, 8.4 | Docker 19.03.x, 20.10.x |
| Rocky Linux | 8.4 | Docker 19.03.x, 20.10.x |
| Oracle Linux | 7.7, 7.9 | Docker 19.03.x, 20.10.x |
| 8.2, 8.3, 8.4 | Docker 19.03.x, 20.10.x | |
| RHEL | 7.7, 7.8, 7.9 | RHEL Docker 1.13.x Docker 18.06.3, 18.09.x, 19.03.x, 20.10.x |
| 8.2, 8.3, 8.4 | Docker 19.03.x, 20.10.x | |
| SLES | 12 SP5, 15 SP1, 15 SP2, 15 SP3 | Docker 19.03.x, Docker 20.10.x |
| openSUSE Leap | 15.3 | 19.03.x, 20.10.x |
| Ubuntu | 18.04, 20.04 | Docker 18.06.3, 18.09.x, 19.03.x, 20.10.x |
Installing Rancher v2.6.2 on K3S
Local Cluster
| K3S Version | Validated/certified on2,3,4,5 |
|---|---|
| v1.21.5+k3s1 |
Aurora (MySQL 5.7) 2.09.0
MySQL 5.7 PostgreSQL 11.5, 12.5, 13.1 MariaDB 10.4.8 External Etcd 3.4.13 Embedded Etcd v3.4.13-k3s1 CRI: embedded Containerd v1.4.9-k3s1 CNI: embedded Flannel v0.14.0 |
| v1.20.11+k3s1 |
Aurora (MySQL 5.7) 2.09.0
MySQL 5.7 PostgreSQL 11.5, 12.5, 13.1 MariaDB 10.4.8 External Etcd 3.4.15 Embedded Etcd v3.4.13-k3s3 CRI: embedded Containerd v1.4.9-k3s1 CNI: embedded Flannel v0.12.0-k3s.2 |
| v1.19.15+k3s1 |
Aurora (MySQL 5.7) 2.09.0
MySQL 5.7 PostgreSQL 11.5, 12.5, 13.1 MariaDB 10.4.8 External Etcd 3.4.13 Embedded Etcd v3.4.13-k3s3 CRI: embedded Containerd v1.4.9-k3s1 CNI: embedded Flannel v0.12.0-k3s.1 |
| v1.18.20+k3s1
(supported on Ubuntu and CentOS/RHEL 7.x only) |
Aurora (MySQL 5.7) 2.09.0
MySQL 5.7 PostgreSQL 11.5 MariaDB 10.3.20 External Etcd 3.3.15 CRI: embedded Containerd v1.3.10-k3s1 CNI: embedded Flannel v0.11.0-k3s.2 |
OS
| Type | Version | Validated/certified on1 |
|---|---|---|
| Ubuntu | 18.04, 20.04 | x86_64 architecture |
| SLES | 15 SP1, 15 SP2, 15 SP3 | x86_64 architecture |
| OpenSUSE LEAP | 15.3 | x86_64 architecture |
| CentOS | 7.8, 7.9, 8.2, 8.3, 8.4 | x86_64 architecture |
| Rocky Linux | 8.4 | x86_64 architecture |
| RHEL | 7.8, 7.9, 8.2, 8.3, 8.4 | x86_64 architecture |
Installing Rancher v2.6.2 on RKE2
Local Cluster
| RKE2 Version | Validated/certified on2,3,4,5 |
|---|---|
| v1.21.5+rke2r1
(Cilium CNI does not support CentOS / RHEL 7.x environments) |
CRI: Containerd v1.4.9-k3s1
CNI: Canal (Flannel v0.13.0-rancher1, Calico: v3.19.2) CNI: Calico v3.19.2 CNI: Cilium v1.10.4 |
| v1.20.11+rke2r1
(Cilium CNI does not support CentOS / RHEL 7.x environments) |
CRI: Containerd v1.4.9-k3s1
CNI: Canal (Flannel v0.13.0-rancher1, Calico: v3.13.3) CNI: Calico v3.19.1 CNI: Cilium v1.9.8 |
| v1.19.15+rke2r1 | CRI: Containerd v1.4.9-k3s1
CNI: Canal (Flannel v0.13.0-rancher1, Calico: v3.13.3) |
OS
| Type | Version | Validated/certified on1 |
|---|---|---|
| Ubuntu | 18.04, 20.04 | x86_64 architecture |
| SLES | 15 SP1, 15 SP2, 15 SP3 | x86_64 architecture |
| CentOS | 7.8, 7.9, 8.2, 8.3, 8.4 | x86_64 architecture |
| Rocky Linux | 8.4 | x86_64 architecture |
| OpenSUSE LEAP | 15.3 | x86_64 architecture |
| RHEL | 7.8, 7.9, 8.2, 8.3, 8.4 | x86_64 architecture |
Installing Rancher v2.6.2 on Hosted Kubernetes
| Service | Provider | Highest Version Validated/certified on |
|---|---|---|
| AKS | Microsoft Azure | v1.20.7 |
| EKS | Amazon | v1.20.x |
| GKE | v1.20.8-gke.900 |
Downstream Clusters in Rancher v2.6.2
Rancher RKE Downstream Clusters - Linux Worker Nodes
Note: Rancher RKE Downstream clusters can be either provisioned by node drivers or custom/existing nodes, or registered into Rancher.
OS & Docker
| Type | Version | Validated/certified on1 |
|---|---|---|
| CentOS | 7.7, 7.8, 7.9 | Docker 18.06.3, 18.09.x, 19.03.x, 20.10.x | 8.2, 8.3 | Docker 19.03.x, 20.10.x |
| Rocky Linux | 8.4 | Docker 19.03.x, 20.10.x (does not work with node driver as the Rancher Docker install script doesn’t support Rocky Linux yet) |
| Oracle Linux | 7.7, 7.9 | Docker 19.03.x, 20.10.x |
| 8.2, 8.3, 8.4 | Docker 19.03.x, 20.10.x | |
| RHEL | 7.7, 7.8, 7.9 | RHEL Docker 1.13.x
Docker 18.06.3, 18.09.x, 19.03.x, 20.10.x |
| 8.2, 8.3 | Docker 19.03.x, 20.10.x | |
| SLES | 12 SP5, 15 SP1, 15 SP2, 15 SP3 | Docker 19.03.x, 20.10.x |
| Ubuntu | 18.04, 20.04 | Docker 18.06.3, 18.09.x, 19.03.x, 20.10.x |
| Rocky Linux | 8.4 | Using custom node provisioning only: Docker 19.03.x, 20.10.x (Rancher node driver provisioning of Docker is not supported) |
Supported K8S Versions
| Upstream K8S Version | Validated/certified on2,3,4,5 |
|---|---|
| v1.21.5 | etcd: v3.4.16
flannel: v0.14.0 canal: v3.19.2 nginx-ingress-controller: 0.48.1-rancher1 |
| v1.20.11 | etcd: v3.4.15
flannel: v0.13.0 canal: v3.17.2 nginx-ingress-controller: 0.48.1-rancher1 |
| v1.19.15 | etcd: v3.4.15
flannel: v0.13.0 canal: v3.16.5 nginx-ingress-controller: 0.48.1-rancher1 |
| v1.18.20 | etcd: v3.4.15
flannel: v0.12.0 canal: v3.13.4 nginx-ingress-controller: 0.35.0-rancher2 |
Node Drivers
| Type | Version | SLA limited to |
|---|---|---|
| AWS | N/A | Built-in, Active6 |
| Azure | N/A | Built-in, Active6 |
| Digital Ocean | N/A | Built-in, Active6 |
| Linode | N/A | Built-in, Active6 |
| VMware | vSphere 6.5, 6.7, 7.0update 2a | Built-in, Active6 |
Rancher RKE Downstream Clusters - Windows Worker Nodes
Note: Windows clusters use a mix of Linux and Windows hosts as cluster nodes. Windows nodes can only be used for deploying workloads, while Linux nodes are required for cluster management.
Supported Windows Server, Docker, K8S Versions
| Windows Server | Docker Version | Upstream K8S Version | Windows EOM |
|---|---|---|---|
| Windows Server 2019 LTSC | Docker 19.03.x EE | v1.21.x
v1.20.x v1.19.8 v1.18.16 |
1/19/2024 |
| 2004 SAC | Docker 19.03.x EE | v.1.21.x
v1.20.x v1.19.8 v1.18.16 |
12/14/2021 |
| 20H2 SAC | Docker 19.03.x EE | v.1.21.x | 5/10/2022 |
Refer these external links for more info related to Windows and Kubernetes:
Windows OS version support in Kubernetes
Windows Server release information
Windows Servicing Channels
Rancher K3S Downstream Clusters
Note: Rancher k3s clusters can only be registered into Rancher. The versions below are supported for importing and upgrading.
OS
| Type | Version | Validated/certified on1 |
|---|---|---|
| Ubuntu | 18.04, 20.04 | x86_64 architecture |
| SLES | 15 SP1, 15 SP2, 15 SP3 | x86_64 architecture |
| OpenSUSE LEAP | 15 SP3 | x86_64 architecture |
| CentOS | 7.8, 7.9, 8.2, 8.3, 8.4 | x86_64 architecture |
| Rocky Linux | 8.4 | x86_64 architecture |
| RHEL | 7.8, 7.9, 8.2, 8.3, 8.4 | x86_64 architecture |
Supported K3S Versions
| K3S Version | Validated/certified on2,3,4,5 |
|---|---|
| v1.21.5+k3s1 |
Aurora (MySQL 5.7) 2.09.0
MySQL 5.7 PostgreSQL 11.5, 12.5, 13.1 MariaDB 10.4.8 External Etcd 3.4.13 Embedded Etcd v3.4.13-k3s1 CRI: embedded Containerd v1.4.9-k3s1 CNI: embedded Flannel v0.14.0 |
| v1.20.11+k3s1 |
Aurora (MySQL 5.7) 2.09.0
MySQL 5.7 PostgreSQL 11.5, 12.5, 13.1 MariaDB 10.4.8 External Etcd 3.4.15 Embedded Etcd v3.4.13-k3s3 CRI: embedded Containerd v1.4.9-k3s1 CNI: embedded Flannel v0.12.0-k3s.2 |
| v1.19.15+k3s1 |
Aurora (MySQL 5.7) 2.09.0
MySQL 5.7 PostgreSQL 11.5, 12.5, 13.1 MariaDB 10.4.8 External Etcd 3.4.13 Embedded Etcd v3.4.13-k3s3 CRI: embedded Containerd v1.4.9-k3s1 CNI: embedded Flannel v0.12.0-k3s.1 |
| v1.18.20+k3s1
(supported on Ubuntu and CentOS/RHEL 7.x only) |
Aurora (MySQL 5.7) 2.09.0
MySQL 5.7 PostgreSQL 11.5 MariaDB 10.3.20 External Etcd 3.3.15 CRI: embedded Containerd v1.3.10-k3s1 CNI: embedded Flannel v0.11.0-k3s.2 |
Rancher RKE2 Downstream Clusters
Note: Rancher RKE2, also known as RKE Government, clusters can only be registered into Rancher as an imported cluster.
OS
| Type | Version | Validated/certified on1 |
|---|---|---|
| CentOS | 7.8, 7.9, 8.2, 8.3, 8.4 | x86_64 architecture |
| Rocky Linux | 8.4 | x86_64 architecture |
| RHEL | 7.8, 7.9, 8.2, 8.3, 8.4 | x86_64 architecture |
| OpenSUSE LEAP | 15 SP3 | x86_64 architecture |
| SLES | 15 SP1, 15 SP2, 15 SP3 | x86_64 architecture |
| Ubuntu | 18.04, 20.04 | x86_64 architecture |
Supported RKE2 Versions
| RKE2 Version | Validated/certified on2,3,4,5 |
|---|---|
| v1.21.5+rke2r1
(Cilium CNI does not support CentOS / RHEL 7.x environments) |
Etcd: v3.4.13-k3s1
Containerd: v1.4.9-k3s1 Runc: v1.0.2 Metrics-server: v0.3.6 CoreDNS: v1.8.3 Ingress-Nginx: v3.34.001 Helm-controller: v0.10.6 CNI Plugins: v0.8.7 CNI: Canal (Flannel: v0.13.0-rancher1, Calico: v3.13.3) CNI: Calico v3.19.2 CNI: Cilium v1.9.8 |
| v1.20.11+rke2r1 | Etcd: v3.4.13-k3s1
Containerd: v1.4.9-k3s1 Runc: v1.0.1 Metrics-server: v0.3.6 CoreDNS: v1.6.9 Ingress-Nginx: v1.36.3 Helm-controller: v0.10.6 CNI Plugins: v0.8.7 CNI: Canal (Flannel: v0.13.0-rancher1, Calico: v3.13.3) CNI: Calico v3.19.1 CNI: Cilium v1.9.8 |
| v1.19.15+rke2r1 | Etcd: v3.4.13-k3s1
Containerd: v1.4.9-k3s1 Runc: v1.0.1 Metrics-server: v0.3.6 CoreDNS: v1.6.9 Ingress-Nginx: v1.36.3 Helm-controller: v0.8.4 CNI Plugins: v0.8.7 CNI: Canal (Flannel: v0.13.0-rancher1, Calico: v3.13.3) |
Hosted Kubernetes Downstream Clusters
Note: Hosted Kubernetes clusters can be either provisioned by Rancher or registered into Rancher.
Supported K8S Versions
| Service | Provider | Highest Version Validated/certified on | Notes |
|---|---|---|---|
| AKS | Microsoft Azure | v1.21.2 | |
| EKS | Amazon | v1.21.2-eks-0389ca3 | Amazon Linux 2 is certified on Managed Node Groups. |
| GKE | v1.20.9-gke.2100 |
Other Registered Kubernetes Downstream Clusters
Note: Any Upstream Kubernetes conformant cluster can be registered.
Supported K8S Versions
| Type | Highest version validated/certified on2,3,4,5 | Notes |
|---|---|---|
| Any | By minor version of upstream K8S: v1.21.x v1.20.10 v1.19.14 v1.18.20 |
|
| EKS | v1.20.x |
Cluster Explorer
Rancher Apps
| Feature | App Name | App version2 3 4 5 |
|---|---|---|
| Alerting and Monitoring | rancher-monitoring | v16.6.0 |
| Istio | rancher-istio | v1.10.4 |
| Logging | rancher-logging | v3.12.0 |
| CIS | rancher-cis-benchmark | v2.0.1 |
| Rancher Backup | rancher-backup | v2.0.1 |
Rancher Longhorn
| Version | Validated/certified on2 3 4 5 |
|---|---|
| v1.2.0 | Default settings of individual components |
| v1.2.2 | Default settings of individual components |
Rancher Continuous Delivery
| Version | Validated/certified on2 3 4 5 |
|---|---|
| v0.3.7 | Default settings of individual components |
Cluster Manager Tools (Legacy)
Tools
| Type | Version | Highest Kubernetes Version | Validated/certified on2 3 4 5 |
|---|---|---|---|
| Monitoring/Alerts/Notifiers | 0.3.1 | v1.21.5 | 0.3.1 prometheus: v2.18.2 prometheus-operator: v0.40.0 prometheus-config-reloader: v0.40.0 prometheus-auth: v0.2.2 node-exporter: v1.0.1 kube-state-metrics: v2.0.0 configmap-reload: v0.3.0 grafana: v7.5.8 nginx: 1.21.1-alpine |
| Istio Service Mesh | v1.5.920 | v1.20.11 | istio-citadel: v1.5.9 istio-galley: v1.5.9 istio-proxyv2: v1.5.9 istio-pilot: v1.5.9 istio-mixer: v1.5.9 istio-sidecar_injector: v1.5.9 jaegertracing-all-in-one: v1.14 kiali-kiali: v1.17 istio-node-agent-k8s: v1.5.9 coredns-coredns: v1.6.2 prom-prometheus: v2.12.0 jetstack-cert-manager-controller: v0.8.1 |
| Logging/Project Logging | v0.3.0 | v1.20.11 | fluentd:v0.1.29 log-aggregator:v0.1.8 configmap-reload:v0.3.0-rancher4 |
| Pipelines | v0.1.4 | v1.20.11 | pipeline-jenkins-server:v0.1.4 pipeline-tools:v0.1.16 mirrored-jenkins-jnlp-slave:4.7-1 |
| CIS | CIS 1.5 | v1.20.11 | security-scan:v0.1.14 |