rancher: helm can't download rancher alpha, and stable installation fails on latest k8s

Information about the Cluster

  • Kubernetes version: 1.23.2
  • Cluster Type (Local/Downstream): local

I just installed a fresh k8s cluster (1.23) on Ubuntu 20.04.3 LTS and wanted to install rancher with helm (v3-8-0), but it failed:

root@master:~# helm repo add rancher-latest https://releases.rancher.com/server-charts/latest
"rancher-latest" has been added to your repositories
root@master:~# kubectl create namespace cattle-system
namespace/cattle-system created
root@master:~# helm install rancher rancher-latest/rancher \
>   --namespace cattle-system \
>   --set hostname=rancher.my.org \
>   --set replicas=3 \
>   --set ingress.tls.source=secret
Error: INSTALLATION FAILED: chart requires kubeVersion: < 1.23.0-0 which is incompatible with Kubernetes v1.23.2

The documentation mentions alpha builds, but the adverized download links fail:

root@master:~# helm repo add rancher-alpha https://releases.rancher.com/server-charts/alpha
"rancher-alpha" has been added to your repositories
root@master:~# helm install rancher rancher-alpha/rancher   --namespace cattle-system  --set replicas=3   --set ingress.tls.source=secret
Error: INSTALLATION FAILED: failed to download "rancher-alpha/rancher"

What are the supported k8s versions and where are they documented?

About this issue

  • Original URL
  • State: open
  • Created 2 years ago
  • Reactions: 6
  • Comments: 37 (8 by maintainers)

Most upvoted comments

if you want to use the alpha chart use the --devel flag with helm

:~> helm repo add rancher-alpha https://releases.rancher.com/server-charts/alpha
"rancher-alpha" has been added to your repositories
~> helm repo update
Hang tight while we grab the latest from your chart repositories...
...Successfully got an update from the "rancher-alpha" chart repository
...Successfully got an update from the "rancher-stable" chart repository
...Successfully got an update from the "jetstack" chart repository
Update Complete. ⎈Happy Helming!⎈
:~> helm search repo --versions rancher-alpha/rancher
No results found
:~> helm search repo --versions rancher-alpha/rancher --devel
NAME                    CHART VERSION   APP VERSION     DESCRIPTION                                       
rancher-alpha/rancher   2.6.4-alpha3    v2.6.4-alpha3   Install Rancher Server to manage Kubernetes clu...
rancher-alpha/rancher   2.5.0-alpha5    v2.5.0-alpha5   Install Rancher Server to manage Kubernetes clu...
rancher-alpha/rancher   2.5.0-alpha4    v2.5.0-alpha4   Install Rancher Server to manage Kubernetes clu...
rancher-alpha/rancher   2.5.0-alpha3    v2.5.0-alpha3   Install Rancher Server to manage Kubernetes clu...
rancher-alpha/rancher   2.5.0-alpha2    v2.5.0-alpha2   Install Rancher Server to manage Kubernetes clu...
rancher-alpha/rancher   2.5.0-alpha1    v2.5.0-alpha1   Install Rancher Server to manage Kubernetes clu...
rancher-alpha/rancher   2.4.0-alpha1    v2.4.0-alpha1   Install Rancher Server to manage Kubernetes clu...
rancher-alpha/rancher   2.3.0-alpha7    v2.3.0-alpha7   Install Rancher Server to manage Kubernetes clu...
rancher-alpha/rancher   2.3.0-alpha6    v2.3.0-alpha6   Install Rancher Server to manage Kubernetes clu...
rancher-alpha/rancher   2.3.0-alpha5    v2.3.0-alpha5   Install Rancher Server to manage Kubernetes clu...
rancher-alpha/rancher   2.3.0-alpha4    v2.3.0-alpha4   Install Rancher Server to manage Kubernetes clu...
rancher-alpha/rancher   2.3.0-alpha3    v2.3.0-alpha3   Install Rancher Server to manage Kubernetes clu...
rancher-alpha/rancher   2.3.0-alpha2    v2.3.0-alpha2   Install Rancher Server to manage Kubernetes clu...
rancher-alpha/rancher   2.3.0-alpha1    v2.3.0-alpha1   Install Rancher Server to manage Kubernetes clu...
rancher-alpha/rancher   2.2.9-alpha1    v2.2.9-alpha1   Install Rancher Server to manage Kubernetes clu...
rancher-alpha/rancher   2.2.0-alpha6    v2.2.0-alpha6   Install Rancher Server to manage Kubernetes clu...
rancher-alpha/rancher   2.2.0-alpha5    v2.2.0-alpha5   Install Rancher Server to manage Kubernetes clu...
rancher-alpha/rancher   2.2.0-alpha4    v2.2.0-alpha4   Install Rancher Server to manage Kubernetes clu...
rancher-alpha/rancher   2.2.0-alpha3    v2.2.0-alpha3   Install Rancher Server to manage Kubernetes clu...
rancher-alpha/rancher   2.2.0-alpha2    v2.2.0-alpha2   Install Rancher Server to manage Kubernetes clu...

hopefully this helps!

Try update before install?

helm repo add rancher-alpha https://releases.rancher.com/server-charts/alpha

helm repo update


root@kube-master:/home/laundry# helm repo update

Hang tight while we grab the latest from your chart repositories...

...Successfully got an update from the "metallb" chart repository

...Successfully got an update from the "external-dns" chart repository

...Successfully got an update from the "ingress-nginx" chart repository

...Successfully got an update from the "rancher-alpha" chart repository

...Successfully got an update from the "rancher-stable" chart repository

...Successfully got an update from the "jetstack" chart repository

...Successfully got an update from the "rancher-latest" chart repository

Update Complete. ⎈Happy Helming!⎈

root@kube-master:/home/laundry# helm repo list

NAME          	URL

metallb       	https://metallb.github.io/metallb

ingress-nginx 	https://kubernetes.github.io/ingress-nginx

jetstack      	https://charts.jetstack.io

external-dns  	https://kubernetes-sigs.github.io/external-dns/

rancher-alpha 	https://releases.rancher.com/server-charts/alpha

rancher-latest	https://releases.rancher.com/server-charts/latest

rancher-stable	https://releases.rancher.com/server-charts/stable

root@kube-master:/home/laundry# helm search repo -l rancher-alpha

No results found

Same for me, I did try with docker-desktop and rancher-desktop on macOS.

It would be nice to have an answer on this as rancher-alpha is mentioned in the official documentation but it’s not working as advertised.

$ helm search repo --versions rancher-alpha/rancher No results found

After looking around, i.e. google foo, I found the answer..

helm install rancher rancher-latest/rancher --namespace cattle-system --set hostname=$HOSTNAME --set bootstrapPassword=$BOOTSTRAP --version 2.6.4-rc12

That’s worth mentioning it in the rancher documentation, isn’t it?