mirror of
https://github.com/rancher/os.git
synced 2025-09-03 15:54:24 +00:00
52 lines
1.9 KiB
Markdown
52 lines
1.9 KiB
Markdown
# 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:__
|
|
```bash
|
|
curl -sL https://raw.githubusercontent.com/rancher/kontainer-driver-metadata/release-v2.6/data/data.json | jq -r '.k3s.releases[].version'
|
|
```
|
|
__rke2:__
|
|
```bash
|
|
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](https://artifacthub.io/packages/helm/rancher-stable/rancher) and
|
|
[latest](https://artifacthub.io/packages/helm/rancher-latest/rancher) 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](https://artifacthub.io/packages/helm/rancher-stable/rancher) |
|
|
| latest | [latest helm repo](https://artifacthub.io/packages/helm/rancher-latest/rancher) |
|
|
|