Skip to main content

Developer Mode Installation

Developer mode (dev mode) is intended to be used for testing and development purposes.

Note: This video shows the dev mode installation.

Requirements​

  • For dev mode, it is assumed that Multus is installed across your cluster and a corresponding NetworkAttachmentDefinition CRD was created.
  • For dev mode, if you are using an RKE cluster, please ensure the ipv4.ip_forward is enabled for the CNI plugin so that the pod network works as expected. #94.

Install as an App​

Harvester can be installed on a Kubernetes cluster in the following ways:

  • Install with the Helm CLI
  • Install as a Rancher catalog app, in which case the harvester/harvester repo is added to the Rancher Catalog as a Helm v3 app

Please refer to the Harvester Helm chart for more details on installing and configuring the Helm chart.

Requirements​

The Kubernetes node must have hardware virtualization support.

To validate the support, use this command:

cat /proc/cpuinfo | grep vmx

Option 1: Install using Helm​

  1. Clone the GitHub repository:

    $ git clone https://github.com/harvester/harvester.git --depth=1

  2. Go to the Helm chart:

    $ cd harvester/deploy/charts

  3. Install the Harvester chart with the following commands:

### To install the chart with the release name `harvester`:

## Create the target namespace
$ kubectl create ns harvester-system

## Install the chart to the target namespace
$ helm install harvester harvester \
  --namespace harvester-system \
  --set longhorn.enabled=true,minio.persistence.storageClass=longhorn

Option 2: Install using Rancher​

Tip: You can create a testing Kubernetes environment in Rancher using the Digital Ocean cloud provider. For details, see this section.

  1. Add the Harvester repo https://github.com/harvester/harvester to your Rancher catalogs by clicking Global > Tools > Catalogs.
  2. Specify the URL and name. Set the branch to stable if you need a stable release version. Set the Helm version to be Helm v3. harvester-catalog.png
  3. Click Create.
  4. Navigate to your project-level Apps.
  5. Click Launch and choose the Harvester app.
  6. (Optional) You can modify the configurations if needed. Otherwise, use the default options.
  7. Click Launch and wait for the app's components to be ready.
  8. Click the /index.html link to navigate to the Harvester UI: harvester-app.png

Digital Ocean Test Environment​

Digital Ocean is one of the cloud providers who support nested virtualization by default.

You can create a testing Kubernetes environment in Rancher using the Digital Ocean cloud provider.

We recommend using the 8 core, 16 GB RAM node, which will have nested virtualization enabled by default.

This screenshot shows how to create a Rancher node template that would allow Rancher to provision such a node in Digital Ocean:

do.png

For more information on how to launch Digital Ocean nodes with Rancher, refer to the Rancher documentation.