Skip to content

Commit df86061

Browse files
authored
Doc the loadbalancer auto cleanup feature (#980)
Signed-off-by: Jian Wang <[email protected]>
1 parent e354af0 commit df86061

File tree

2 files changed

+20
-1
lines changed

2 files changed

+20
-1
lines changed

docs/networking/loadbalancer.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -67,8 +67,15 @@ The Harvester load balancer supports TCP health checks. You can specify the para
6767
| Health Check Timeout | int | false | 3 | Specifies the timeout of every health check in seconds. Disabled by default.
6868

6969
## Guest Kubernetes cluster load balancer
70+
7071
In conjunction with Harvester Cloud Provider, the Harvester load balancer provides load balancing for LB services in the guest cluster.
7172
![](/img/v1.2/networking/guest-kubernetes-cluster-lb.png)
7273
When you create, update, or delete an LB service on a guest cluster with Harvester Cloud Provider, the Harvester Cloud Provider will create a Harvester LB automatically.
7374

7475
For more details, refer to [Harvester Cloud Provider](/rancher/cloud-provider.md).
76+
77+
### Automatic Cleanup
78+
79+
_Available as of Harvester v1.8.0_
80+
81+
When a guest cluster with the `harvester-cloud-provider` enabled is deleted, Harvester automatically performs a cleanup of all associated `LoadBalancer` resources.

docs/rancher/cloud-provider.md

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -399,6 +399,18 @@ Harvester's built-in load balancer offers both **DHCP** and **Pool** modes, and
399399
400400
:::
401401
402-
## Health checks
402+
### Health checks
403403
404404
Beginning with Harvester cloud provider v0.2.0, additional health checks of the `LoadBalancer` service within the guest Kubernetes cluster are no longer necessary. Instead, you can configure [liveness](https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/#define-a-tcp-liveness-probe) and [readiness](https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/#define-readiness-probes) probes for your workloads. Consequently, any unavailable pods will be automatically removed from the load balancer endpoints to achieve the same desired outcome.
405+
406+
### Automatic Cleanup
407+
408+
_Available as of Harvester v1.8.0_
409+
410+
When a guest cluster with the `harvester-cloud-provider` enabled is deleted, Harvester automatically performs a cleanup of all associated `LoadBalancer` resources on the host cluster.
411+
412+
Key benefits:
413+
414+
- Resource Management: Prevents "orphaned" LoadBalancers from consuming IP addresses after a guest cluster is gone.
415+
416+
- Zero Manual Intervention: The lifecycle of the LoadBalancer is tied directly to the lifecycle of the guest Kubernetes cluster.

0 commit comments

Comments
 (0)