rancher / elemental-docs

Documentation for everything around Rancher Elemental
http://elemental.docs.rancher.com
Apache License 2.0
5 stars 20 forks source link

Quickstart docs result in version confusion, Elemental cannot be installed #348

Open strophy opened 2 months ago

strophy commented 2 months ago

Hi, I am trying to evaluate Rancher + Elemental by following the Elemental Quickstart Visual Guide. I first deployed Rancher on AWS following the Rancher Quickstart guide. (This initially failed with an easily resolvable 9 month old unresolved bug, for which I opened a PR here.)

The Rancher docs deploy Rancher 2.7.9 by default, which conflicts with the Elemental docs which state that at least 2.8.x is required. I decided to proceed anyway, since Elemental 1.2.0 was visible and installable from the Extensions page under Rancher 2.7.9. But it was impossible to proceed beyond the Install the elemental operator step because the button was not visible.

I destroyed my deployment and tried updating the terraform.tfvars file to use the following variables based on the version support page:

cert_manager_version = "1.15.0"
rancher_version = "2.8.4"
rancher_kubernetes_version = "v1.28.10+k3s1"
workload_kubernetes_version = "v1.28.10+rke2r1"

This installation worked, but now when I enable Extensions in Rancher, only the Virtualization Manager and Kamaji extensions are available. Elemental does not appear at all. I have no idea how to proceed.

image

This is a lot of hoops to jump through and unnecessary versioning confusion for a beginner, and in the end I was not able to successfully run Elemental. Could you please update the documentation as necessary and carry out actual testing to verify the steps work?

juadk commented 2 months ago

Hello @strophy, you're right the doc does not cover this latest change: Since Rancher 2.8.2, you must be a prime user to see Elemental in the extensions tab, documentation was made with Rancher 2.8.0, thanks for the report because it is an essential thing to clarify. We will update the documentation tomorrow.