Yu-Jack/guest-cluster-in-harvester-example

Introduction

This repo demos how to create cluster on top of harvester. In other words, you could use virtual machine to start the RKE2 cluster in the virtual machine of harvester on Rancher.

More detail about this, please see Harvester Node Driver and Virtualization on Kubernetes with Harvester.

Bootstrap

1. Have a harvester cluster
2. Have a rancher cluster
3. Import harvester cluster
4. Create access and secret key in rancher GUI, and copy it to terraform.tfvars. (use cp terraform.tfvars.example terraform.tfvars first)
5. Upload the cloud image in image tab of harvester cluster (harvester-public namespace) For example, focal-server-cloudimg-amd64.img in https://cloud-images.ubuntu.com/focal/current/
6. Create vlan1 in VM Network tab of harvester cluster
7. terraform init and terraform apply

There are two different guest cluster you could try

1. default: terraform apply -target=module.guest_cluster
2. harvester-cloud-provider: terraform apply -target=module.guest_cluster_harvester_cloud_provider This one should set up the kvm.config from kvm.config.template first.

Terraform Documentation

• https://registry.terraform.io/providers/rancher/rancher2/latest

Import Example

# harvester cloud credential
terraform import rancher2_cloud_credential.harvesterkvm "cattle-global-data:cc-xxxxx.harvester"

# guest cluster
terraform import module.guest_cluster.rancher2_cluster_v2.rancher_guest_cluster fleet-default/local-test