Supported Versions and Channels¶
The kubernetesVersion and rancherVersion fields accept explicit versions
numbers or channel names.
Valid Versions¶
The list of valid versions for the kubernetesVersion field can be determined
from the Rancher metadata using the following commands.
k3s:
curl -sL https://raw.githubusercontent.com/rancher/kontainer-driver-metadata/release-v2.6/data/data.json | jq -r '.k3s.releases[].version'
curl -sL https://raw.githubusercontent.com/rancher/kontainer-driver-metadata/release-v2.6/data/data.json | jq -r '.rke2.releases[].version'
The list of valid rancherVersion values can be obtained from the
stable and
latest helm
repos. The version string is expected to be the "application version" which
is the version starting with a v. For example, v2.6.2 is the current
format not 2.6.2.
Version Channels¶
Valid kubernetesVersion channels are as follows:
| Channel Name | Description |
|---|---|
| stable | k3s stable (default value of kubernetesVersion) |
| latest | k3s latest |
| testing | k3s test |
| stable:k3s | Same as stable channel |
| latest:k3s | Same as latest channel |
| testing:k3s | Same as testing channel |
| stable:rke2 | rke2 stable |
| latest:rke2 | rke2 latest |
| testing:rke2 | rke2 testing |
| v1.21 | Latest k3s v1.21 release. The applies to any Kubernetes minor version |
| v1.21:rke2 | Latest rke2 v1.21 release. The applies to any Kubernetes minor version |
Valid rancherVersions channels are as follows:
| Channel Name | Description |
|---|---|
| stable | stable helm repo |
| latest | latest helm repo |