Skip to content

Rancher integration

Rancher Integration

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.

Note

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.

virtualization-management

Deploying Rancher

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.

Quick Start Guide

  1. 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
  2. Log into your Linux host using your preferred shell, such as PuTTy or a remote terminal connection.
  3. 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

Note

For more information on how to deploy the Rancher server, please refer to the Rancher documentation.

Virtualization Management

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.

import-cluster

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.

Note

Harvester Node Driver with RKE2/k3s is in Tech Preview.