Skip to content

Commit 31ce345

Browse files
authored
Shared LBs - improve docs (#2195)
I'm clarifying that 2.5 is and Octavia *API* version, adding a note about FIP being shared too and explaining changes from #2190.
1 parent 522de1c commit 31ce345

File tree

1 file changed

+6
-2
lines changed

1 file changed

+6
-2
lines changed

docs/openstack-cloud-controller-manager/expose-applications-using-loadbalancer-type-service.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -491,12 +491,16 @@ To enable PROXY protocol support, the either the openstack-cloud-controller-mana
491491

492492
### Sharing load balancer with multiple Services
493493

494-
By default, different Services of LoadBalancer type should have different corresponding cloud load balancers, however, openstack-cloud-controller-manager allows multiple Services to share a single load balancer if the Octavia service supports the tag feature (since version 2.5).
494+
By default, different Services of LoadBalancer type should have different corresponding cloud load balancers, however, openstack-cloud-controller-manager allows multiple Services to share a single load balancer if the Octavia service supports the tag feature (since API version 2.5).
495495

496-
The shared load balancer can be created either by other Services or outside the cluster, e.g. created manually by the user in the cloud or by Services from the other Kubernetes clusters. The load balancer is deleted only when the last attached Service is deleted, unless the load balancer was created outside the Kubernetes cluster.
496+
The shared load balancer can be created either by other Services or outside the cluster, e.g. created manually by the user in the cloud or by Services from the other Kubernetes clusters. The load balancer is deleted only when the last attached Service is deleted, unless the load balancer was created outside the Kubernetes cluster.
497+
498+
All Services attached to one shared load balancer will have the same external IP as the floating IP and LB VIP are shared too.
497499

498500
The maximum number of Services that share a load balancer can be configured in `[LoadBalancer] max-shared-lb`, default value is 2. The ports of those Services shouldn't have collisions.
499501

502+
In order to prevent accidental exposure internal Services cannot share a load balancer with any other Service. This means that cloud provider will prevent creation of a secondary internal Service sharing a load balancer with either external or internal Service. This is because floating IPs are attached to the load balancer and not to the listener.
503+
500504
For example, create a Service `service-1` as before:
501505

502506
```yaml

0 commit comments

Comments
 (0)