Skip to content

Update cloud provider #1078

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
w13915984028 wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Update cloud provider #1078

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 23 additions & 1 deletion docs/rancher/cloud-provider.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,13 +15,31 @@ description: The Harvester cloud provider used by the guest cluster in Harvester
<link rel="canonical" href="https://docs.harvesterhci.io/v1.8/rancher/cloud-provider"/>
</head>

[RKE2](./node/rke2-cluster.md) clusters can be provisioned in Rancher using the built-in Harvester Node Driver. Harvester provides [load balancer](#load-balancer-support) and Harvester cluster [storage passthrough](./csi-driver.md) support to the guest Kubernetes cluster.
## Introduction

[RKE2](./node/rke2-cluster.md) clusters can be provisioned in Rancher using the built-in **Harvester Node Driver**. Harvester provides [load balancer](#load-balancer-support) and Harvester cluster [storage passthrough](./csi-driver.md) support to the guest Kubernetes cluster.

@jillian-maroket jillian-maroket Jul 14, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
[RKE2](./node/rke2-cluster.md) clusters can be provisioned in Rancher using the built-in **Harvester Node Driver**. Harvester provides [load balancer](#load-balancer-support) and Harvester cluster [storage passthrough](./csi-driver.md) support to the guest Kubernetes cluster.
You can provision [RKE2](./node/rke2-cluster.md) clusters in Rancher using the built-in **Harvester Node Driver**. This component provides [load balancer](#load-balancer-support) and [storage passthrough](./csi-driver.md) capabilities to guest Kubernetes clusters.


In this page we will learn:

- How to deploy the Harvester cloud provider in an RKE2 cluster.
- How to use the [Harvester load balancer](#load-balancer-support).

### Main Functionalities

The Harvester cloud provider implements a subset of the `cloudprovider` interface defined by `k8s.io/cloud-provider`.

It supports the following core components:

1. **[Node/Instance Lifecycle Management](#instance-lifecycle-management):**

* Acts as the instance manager to dynamically discover and report node metadata, including node names, regions, zones, and internal/external IP addresses.

* *Note: This serves as a critical bootstrap component for the RKE2 cluster.*

2. **[Load Balancer Management](#load-balancer-support):**

* Provisions and configures load balancers automatically for Kubernetes `Service` objects of type `LoadBalancer`, routing external traffic efficiently to target nodes.
Comment on lines +29 to +41

@jillian-maroket jillian-maroket Jul 14, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
The Harvester cloud provider implements a subset of the `cloudprovider` interface defined by `k8s.io/cloud-provider`.
It supports the following core components:
1. **[Node/Instance Lifecycle Management](#instance-lifecycle-management):**
* Acts as the instance manager to dynamically discover and report node metadata, including node names, regions, zones, and internal/external IP addresses.
* *Note: This serves as a critical bootstrap component for the RKE2 cluster.*
2. **[Load Balancer Management](#load-balancer-support):**
* Provisions and configures load balancers automatically for Kubernetes `Service` objects of type `LoadBalancer`, routing external traffic efficiently to target nodes.
The Harvester Cloud Provider implements a subset of the `cloudprovider` interface defined by `k8s.io/cloud-provider`. It supports the following core functions:
- **[Node/Instance Lifecycle Management](#instance-lifecycle-management)**: Dynamically discovers and reports node metadata (such as node names, regions, zones, and IP addresses), acting as a critical bootstrap component for the guest cluster.
- **[Load Balancer Management](#load-balancer-support)**: Automatically provisions and configures load balancers for Kubernetes `Service` objects (type: `LoadBalancer`), routing external traffic to the correct guest nodes.


### Backward Compatibility Notice

:::note
Expand Down Expand Up @@ -410,6 +428,10 @@ For more information, see [this GitHub issue comment](https://github.com/harvest

:::

## Instance Lifecycle Management



## Load Balancer Support
Comment on lines +431 to 435

@jillian-maroket jillian-maroket Jul 14, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Why is the Instance Lifecycle Management section empty? If that heading is supposed to be the parent of Load Balancer Support and subsequent sections, the markup should be changed accordingly.

Once you've deployed the Harvester cloud provider, you can leverage the Kubernetes `LoadBalancer` service to expose a microservice within the guest cluster to the external world. Creating a Kubernetes `LoadBalancer` service assigns a dedicated Harvester load balancer to the service, and you can make adjustments through the `Add-on Config` within the Rancher UI.

Expand Down
Loading