Skip to content

feat(mks): document new loadbalancer flavor annotation for standard plan #8481

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
wants to merge 1 commit into
base: develop
Choose a base branch
from
+31 −13
Open

feat(mks): document new loadbalancer flavor annotation for standard plan #8481

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
44 changes: 31 additions & 13 deletions ...anaged_kubernetes/expose_your_applications_using_a_load_balancer/guide.en-gb.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Expose your applications using OVHcloud Public Cloud Load Balancer
excerpt: "How to expose your applications hosted on Managed Kubernetes Service using the OVHcloud Public Cloud Load Balancer"
updated: 2025-02-17
updated: 2025-10-06
---

> [!warning]
Expand All @@ -27,9 +27,6 @@ To be able to deploy [Public Cloud Load Balancer](/links/public-cloud/load-balan

| Kubernetes versions |
| ------------------- |
| 1.26.4-3 >= |
| 1.27.12-1 >= |
| 1.28.8-1 >= |
| 1.29.3-3 >= |
| 1.30.2-1 >= |

Expand Down Expand Up @@ -109,7 +106,10 @@ metadata:
namespace: test-lb-ns
annotations:
loadbalancer.ovhcloud.com/class: octavia //not required for cluster running kubernetes versions >= 1.31
loadbalancer.ovhcloud.com/flavor: small

# Use `openstack loadbalancer flavor list` to get the full list of available flavors.
loadbalancer.ovhcloud.com/flavor: small # Name of a loadbalancer flavor, used in MKS Free ONLY.
loadbalancer.openstack.org/flavor-id: xxx # UUID of a loadbalancer flavor, used in MKS Standard ONLY.
spec:
ports:
- name: 80-80
Expand Down Expand Up @@ -155,7 +155,11 @@ metadata:
namespace: test-lb-ns
annotations:
loadbalancer.ovhcloud.com/class: "octavia" //not required for cluster running kubernetes versions >= 1.31
loadbalancer.ovhcloud.com/flavor: "medium" //optional, default = small

# Use `openstack loadbalancer flavor list` to get the full list of available flavors.
# When not specified, the "small" flavor is used by default.
loadbalancer.ovhcloud.com/flavor: medium # Name of a loadbalancer flavor, used in MKS Free ONLY.
loadbalancer.openstack.org/flavor-id: yyy # UUID of a loadbalancer flavor, used in MKS Standard ONLY.
labels:
app: test-octavia
spec:
Expand Down Expand Up @@ -213,7 +217,11 @@ metadata:
namespace: test-lb-ns
annotations:
loadbalancer.ovhcloud.com/class: "octavia" //not required for cluster running kubernetes versions >= 1.31
loadbalancer.ovhcloud.com/flavor: "medium" //optional, default = small

# Use `openstack loadbalancer flavor list` to get the full list of available flavors.
# When not specified, the "small" flavor is used by default.
loadbalancer.ovhcloud.com/flavor: medium # Name of a loadbalancer flavor, used in MKS Free ONLY.
loadbalancer.openstack.org/flavor-id: yyy # UUID of a loadbalancer flavor, used in MKS Standard ONLY.
labels:
app: test-octavia
spec:
Expand Down Expand Up @@ -241,10 +249,17 @@ spec:

Authorized values: 'octavia' = Public Cloud Load Balancer, 'iolb' = Loadbalancer for Managed Kubernetes Service (will be deprecated in future versions). If not specified, the default class of the MKS Kubernetes versions you are using will be applied, please refer to the [versions matrix section](#kube-versions).

- `loadbalancer.ovhcloud.com/flavor`
- `loadbalancer.ovhcloud.com/flavor` (MKS Free only)

Not a standard OpenStack Octavia annotation (specific to OVHcloud). The size used for creating the loadbalancer. Specifications can be found on the [Load Balancer specifications](/links/public-cloud/load-balancer) page. Authorized values => `small`,`medium`,`large`, `xl`. Default is 'small'.

- `loadbalancer.openstack.org/flavor-id` (MKS Standard only)

The UUID of the flavor used to create the loadbalancer. To get the flavors UUIDs, see the following guides:
- [Prepare the environment to use the OpenStack API](/pages/public_cloud/public_cloud_cross_functional/prepare_the_environment_for_using_the_openstack_api),
- [Load the OpenStack environment variables](/pages/public_cloud/public_cloud_cross_functional/loading_openstack_environment_variables).
- Run `openstack loadbalancer flavor list` to get the list of flavors and their UUIDs.

- `service.beta.kubernetes.io/openstack-internal-load-balancer`

If 'true', the loadbalancer will only have an IP on the private network (no Floating IP is associated with the Load Balancer). Default is 'false'.
Expand Down Expand Up @@ -320,7 +335,7 @@ Authorized values: 'octavia' = Public Cloud Load Balancer, 'iolb' = Loadbalancer

- `loadbalancer.openstack.org/flavor-id`

The id of the flavor that is used for creating the loadbalancer. Not useful as we provide `loadbalancer.ovhcloud.com/flavor`.
The id of the flavor that is used for creating the loadbalancer: only in use for MKS Standard. MKS Free uses `loadbalancer.ovhcloud.com/flavor`.

- `loadbalancer.openstack.org/load-balancer-id`

Expand Down Expand Up @@ -363,8 +378,8 @@ Authorized values: 'octavia' = Public Cloud Load Balancer, 'iolb' = Loadbalancer

#### Resize your LoadBalancer

There is no proper way to "hot-resize" your loadbalancer yet (work in progress). The best alternative to change the flavor of your load balancer is to recreate a new Kubernetes Service that will use the same public IP as an existing one.
You can find the complete HowTo and examples on our public Github repository: <https://github.com/ovh/public-cloud-examples>
There is no proper way to "hot-resize" your loadbalancer yet ([work in progress](https://github.com/ovh/public-cloud-roadmap/issues/418)). The best alternative to change the flavor of your load balancer is to recreate a new Kubernetes Service that will use the same public IP as an existing one.
You can find the complete HowTo and examples on our public Github repository: <https://github.com/ovh/public-cloud-examples/tree/main/containers-orchestration/managed-kubernetes/use-public-cloud-load-balancer>.

- First, make sure that the existing service is using the `loadbalancer.openstack.org/keep-floatingip` annotation. If it's not using it, the public Floating IP will be released (it can be added after the service creation).
- Get the public IP of your existing service:
Expand All @@ -383,8 +398,11 @@ test-lb-todel LoadBalancer 10.3.107.18 141.94.215.240 80:30172/TCP
metadata:
name: my-medium-lb
annotations:
loadbalancer.ovhcloud.com/class: "octavia" //not required for clusters running kubernetes versions >= 1.31
loadbalancer.ovhcloud.com/flavor: "medium"
loadbalancer.ovhcloud.com/class: "octavia" # not required for clusters running kubernetes versions >= 1.31

# Use `openstack loadbalancer flavor list` to get the full list of available flavors.
loadbalancer.ovhcloud.com/flavor: medium # Name of a loadbalancer flavor, used in MKS Free ONLY.
loadbalancer.openstack.org/flavor-id: yyy # UUID of a loadbalancer flavor, used in MKS Standard ONLY.
labels:
app: demo-upgrade
spec:
Expand Down