Available as of v0.3.0
Rancher is an open-source multi-cluster management platform. Harvester has integrated Rancher by default starting with Rancher v2.6.1.
Harvester v1.0.0 is compatible with Rancher v2.6.3 or above only.
Users can now import and manage multiple Harvester clusters using the Rancher Virtualization Management page and leverage the Rancher authentication feature and RBAC control for multi-tenancy support.
Deploying Rancher Server¶
To use Rancher with Harvester, please install the Rancher and Harvester in two separated servers. If you want to try out the integration features, you can create a VM in Harvester and install Rancher v2.6.3 or above.
Use one of the following guides to deploy and provision Rancher and a Kubernetes cluster with the provider of your choice:
- AWS (uses Terraform)
- AWS Marketplace (uses Amazon EKS)
- Azure (uses Terraform)
- DigitalOcean (uses Terraform)
- GCP (uses Terraform)
- Hetzner Cloud (uses Terraform)
- Equinix Metal
Do not install Rancher with Docker in production. Otherwise, your environment may be damaged and your cluster may not be recovered. Installing Rancher in Docker should only be used for quick evaluation and testing purposes.
To install Rancher with Docker:
- Begin creation of a custom cluster by provisioning a Linux host. Your host can be any of the following:
- A cloud-hosted virtual machine (VM)
- An on-premises VM
- A bare-metal server
- Log into your Linux host using your preferred shell, such as PuTTy or a remote terminal connection.
- From your shell, enter the following command:
# for a quick evaluation, you can run the Rancher server with the following command $ sudo docker run -d --restart=unless-stopped -p 80:80 -p 443:443 --privileged rancher/rancher:v2.6.3
With Rancher's Virtualization Management feature, you can now import and manage Harvester clusters.
By clicking on one of the clusters, you are able to view and manage the imported Harvester cluster resources like Hosts, VMs, images, volumes, etc. Additionally, the
Virtualization Management leverages existing Rancher features such as authentication with various auth providers and multi-tenant support.
For more details, please check the virtualization management page.
Creating Kubernetes Clusters using the Harvester Node Driver¶
Harvester node driver is used to provision VMs in the Harvester cluster, which Rancher uses to launch and manage guest Kubernetes clusters.
Starting with Rancher
v2.6.1, the Harvester node driver has been added by default. Users can reference the node-driver page for more details.
Harvester Node Driver with RKE2/k3s is in Tech Preview.