Skip to content

Conversation

@Brianalmeida
Copy link

Removing "please install Rancher on a separate server" as it is confusing for users

Problem:

Currently, the Intergrating with Rancher section in the documentation is contradicting itself and leaving readers confused.

Solution:

Remove the first sentence and combine with the following one to ensure readers are not confused when trying to intergrate Rancher with Harvester.

Related Issue(s):

Related issue: harvester/harvester#9969

Test plan:

Additional documentation or context

Removing "please install Rancher on a separate server" as it is confusing for customers

Signed-off-by: Brian Almeida <[email protected]>
@github-actions
Copy link

github-actions bot commented Jan 28, 2026

Name Link
🔨 Latest commit d360aa4
😎 Deploy Preview https://697a39117b82d608f9952f55--harvester-preview.netlify.app

Made changes to promote using three nodes instead of a single node.

Signed-off-by: Brian Almeida <[email protected]>
@jillian-maroket jillian-maroket requested review from Vicente-Cheng and removed request for akashraj4261 and dariavladykina February 2, 2026 05:57
Copy link
Contributor

@Vicente-Cheng Vicente-Cheng left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hmm, maybe we need to rephrase this section?
Indeed, we suggest installing the Rancher on the external (the vcluster is a special case).
If we remove this section, users might think, yes, we can install the external Rancher within the Harvester cluster.
But this is not the best practice we recommend.

cc @harvester/tpm, @ibrokethecloud, @ihcsim

@ihcsim
Copy link
Contributor

ihcsim commented Feb 2, 2026

@Vicente-Cheng I'm under the same impression that external Rancher is the recommended best practice. Either we leave the doc unchanged, and/or mention that vcluster is available as an experimental option, or simply combine line 34 and line 36 and let user decide what works best for them:

"To use Rancher with Harvester, please follow the Deploying Rancher Server document to deploy and provision Rancher and a Kubernetes cluster with the provider of your choice."

@Brianalmeida
Copy link
Author

I would shy away from mentioning vcluster as the background leading up to this PR stems from a customer trying to leverage this feature and it not working as efficient as they were expecting. (In my testing, this is more on upstream vcluster then it is on Harvester)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants