Skip to content

Commit 3ec686f

Browse files
authored
Merge pull request #8737 from ovh/sa-iplb-batch-5
IPLB refresh - Batch 5
2 parents 87c5fc1 + 910d80f commit 3ec686f

File tree

17 files changed

+1327
-1314
lines changed

17 files changed

+1327
-1314
lines changed
Lines changed: 50 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,26 @@
11
---
2-
title: 'Working with redirections'
3-
universe: cloud
4-
excerpt: 'Integrate your web services behind a Load Balancer with redirections'
5-
updated: 2021-02-05
2+
title: "Configuring an OVHcloud Load Balancer service with redirects"
3+
excerpt: Integrate your web services behind a Load Balancer with redirects
4+
updated: 2025-11-27
65
---
76

87
## Objective
98

10-
The OVH Load Balancer acts by default as a proxy. It can also be configured to redirect your customers to a third-party website, which is useful if you are changing your domain name, or want to redirect your customers to your website’s HTTPS version, for example. This is known as HTTP redirection.
9+
The **OVHcloud Load Balancer** operates by default as a proxy. It can also be configured to redirect client traffic to a third-party website. This functionality is essential for scenarios such as **domain name migration** or enforcing the **HTTPS version** of a website. This is known as **HTTP redirection**.
1110

12-
**This guide will show you how to integrate your web services behind an OVH Load Balancer with redirections.**
11+
**This guide outlines the process for integrating your web services behind an OVHcloud Load Balancer utilizing HTTP redirections.**
1312

1413
## Requirements
1514

16-
- an [OVH Load Balancer](/links/network/load-balancer)
17-
- access to the [OVH Control Panel](/links/manager), or the [OVH API](/links/api)
15+
- Have an [OVHcloud Load Balancer](/links/network/load-balancer) offer in your OVHcloud account.
16+
- Have access to your [OVHcloud Control Panel](/links/manager).
17+
- Have access to the [OVHcloud API](/links/api).
1818

1919
## Instructions
2020

21-
### Presentation
21+
### Overview
2222

23-
A HTTP redirection is presented as follows:
23+
An HTTP redirect looks like this:
2424

2525
```bash
2626
HTTP/1.1 301 Moved Permanently
@@ -29,85 +29,88 @@ Content-Type: text/html
2929
Content-Length: 174
3030
```
3131

32-
Custom redirections should have the following form: `<scheme>://<net_loc>/<path>;<params>?<query>#<fragment>`. You can only specify one redirection per front-end.
32+
Custom redirects must be formatted as `<scheme>://<net_loc>/<path>;<params>?<query>#<fragment>`. Only one redirect can be specified per frontend.
3333

34-
Custom redirections can be specified via the OVH Control Panel and via the API, both on new and existing `front-ends`{.action}.
34+
Custom redirects can be specified via the OVHcloud Control Panel or via the API, on a new or existing frontend.
3535

36-
### Add a custom redirection via the OVH Control Panel.
36+
### Adding a custom redirect from the OVHcloud Control Panel
3737

38-
You can define custom redirections from the [OVH Control Panel](/links/manager) by going to the `Cloud`{.action} section, then `Load Balancer`{.action}.
38+
You can define a custom redirect from the [OVHcloud Control Panel](/links/manager) in the `Bare Metal Cloud`{.action} section and then `Load Balancer`{.action}.
39+
This can be done either on a new frontend during its creation, or on an existing frontend.
3940

40-
You can either do this on a new front-end as you create it, or on an existing front-end.
41+
#### Adding a new frontend
4142

42-
* Add a new front-end.
43+
In the `Frontends`{.action} section, click on the `Add a frontend`{.action} button to create a new one.
4344

44-
In the `Front-ends`{.action} section of the OVH Control Panel, click on `Add a front-end`{.action} to create a new one.
45+
In the frontend editing page, select the `HTTP`{.action} or `HTTPS`{.action} protocol.<br>
46+
Configure the information as usual. However, it is unnecessary to specify the `Default backend`{.action}, as it will not be used.
4547

46-
In the editing page for a front-end, select `HTTP`{.action} or `HTTPS`{.action} protocol. Configure the information as requested. However, please note that there is no need to set a `Default farm`{.action}, as it will not be used.
48+
In the advanced settings, fill in the `HTTP redirect`{.action}.
4749

48-
In the advanced settings, enter the `HTTP redirection`{.action}.
50+
#### Editing an existing frontend
4951

50-
* Edit an existing front-end.
52+
In the `Frontends`{.action} section, click on the `...`{.action} button to the right of the relevant frontend and select `Edit`{.action}.<br>
53+
Make sure the selected frontend is of the `HTTP` or `HTTPS` protocol. Complete the configuration if necessary.
54+
However, it is unnecessary to specify the `Default backend`{.action}, as it will not be used.
5155

52-
In the `Front-ends`{.action} section of the OVH Control Panel, select the front-end you would like to edit. To do this, click the `...`{.action} button, then select `Edit`{.action} in the menu that appears. Please ensure that the front-end you have chosen uses either `HTTP` or `HTTPS` protocol.
56+
In the advanced settings, fill in the `HTTP redirect`{.action}.
5357

54-
In the editing page for the front-end, complete the configuration if needed. However, please note that there is no need to set a `Default farm`{.action}, as it will not be used.
58+
![Configuration of a Frontend Redirect](images/add_redirectlocation.png){.thumbnail}
5559

56-
In the advanced settings, enter the `HTTP redirection`{.action}.
60+
Once the frontend is configured, click on `Add`{.action} or `Edit`{.action} depending on whether you are configuring a new frontend or an existing one.
61+
Do not forget to deploy the configuration.
5762

58-
![Configure a front-end redirection](images/add_redirectlocation.png){.thumbnail}
63+
To do this, you can either:
5964

60-
Once the front-end has been configured, click `Add`{.action} or `Edit`{.action}, depending on whether you are configuring a new or existing front-end. Please remember to deploy the configuration. There are two ways of doing this:
65+
- In the `Status` section of the `Home`{.action} tab, click on the `...`{.action} button of your Load Balancer and then click on `Apply the configuration`{.action}.
6166

62-
- via the `Status`{.action} section of the OVH Control Panel, by clicking on your Load Balancer’s `...`{.action} button, then selecting `Apply configuration`{.action}
67+
- In the reminder banner informing you that the configuration is not applied, click on `Apply the configuration`{.action}.
6368

64-
- via the reminder box in the OVH Control Panel, notifying you that the configuration has not been applied, by clicking `Apply configuration`{.action}
69+
![Application of a Load Balancer Configuration](images/apply_configuration.png){.thumbnail}
6570

66-
![Apply a Load Balancer configuration](images/apply_configuration.png){.thumbnail}
71+
### Adding a custom redirect from the OVHcloud API
6772

68-
### Add a custom redirection via the API.
73+
In the [OVHcloud API](/links/api), redirects are specified in the redirectLocation string:
6974

70-
In the [OVH API](/links/api), redirections are specified in the redirectLocation character chain.
71-
72-
* If you are creating a new front-end:
75+
**Creating a new frontend**
7376

7477
> [!api]
7578
>
7679
> @api {v1} /ipLoadbalancing POST /ipLoadbalancing/{serviceName}/http/frontend
7780
>
7881
79-
|Setting|Meaning|
82+
|Parameter|Meaning|
8083
|---|---|
81-
|serviceName|Your Load Balancer service ID|
82-
|port|Front-end listening ports|
83-
|zone|Front-end deployment zones|
84-
|redirectLocation|HTTP redirection URL|
84+
|serviceName|Identifier of your Load Balancer service|
85+
|port|Port(s) of the frontend|
86+
|zone|Deployment zone of the frontend|
87+
|redirectLocation|HTTP redirect URL|
8588

86-
* If you are updating an existing front-end:
89+
**Updating an existing frontend**
8790

8891
> [!api]
8992
>
9093
> @api {v1} /ipLoadbalancing PUT /ipLoadbalancing/{serviceName}/http/frontend/{frontendId}
9194
>
9295
93-
|Setting|Meaning|
96+
|Parameter|Meaning|
9497
|---|---|
95-
|serviceName|Your Load Balancer service ID|
96-
|frontendId|ID of the front-end to be updated|
97-
|redirectLocation|HTTP redirection URL|
98+
|serviceName|Identifier of your Load Balancer service|
99+
|frontendId|Identifier of the frontend to update|
100+
|redirectLocation|HTTP redirect URL|
98101

99-
Then apply the modifications:
102+
**Applying the changes**
100103

101104
> [!api]
102105
>
103106
> @api {v1} /ipLoadbalancing POST /ipLoadbalancing/{serviceName}/refresh
104107
>
105108
106-
|Setting|Meaning|
109+
|Parameter|Meaning|
107110
|---|---|
108-
|serviceName|Your Load Balancer service ID|
109-
|zone|Front-end deployment zones|
111+
|serviceName|Identifier of your Load Balancer service|
112+
|zone|Deployment zone of the frontend|
110113

111114
## Go further
112115

113-
Join our community of users on <https://community.ovh.com/en/>.
116+
Join our [community of users](/links/community).

pages/network/load_balancer/create_redirectlocation/guide.fr-fr.md

Lines changed: 14 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,20 @@
11
---
22
title: "Configuration d'un service OVHcloud Load Balancer avec les redirections"
33
excerpt: Intégrez vos services web derrière un Load Balancer avec les redirections
4-
updated: 2022-03-28
4+
updated: 2025-11-27
55
---
66

77
## Objectif
88

9-
Le service OVHcloud Load Balancer agit par défaut comme un mandataire ou « Proxy ». Il peut aussi être configuré pour rediriger vos clients vers un site tiers, par exemple dans le cas d'un changement de nom de domaine ou pour rediriger vos clients en HTTPS. C'est que l'on appelle la redirection HTTP.
9+
Le **Load Balancer OVHcloud** fonctionne par défaut comme un proxy, un intermédiaire entre le trafic client et vos serveurs backend. Il peut également être configuré pour rediriger le trafic client vers un site web tiers. Cette fonctionnalité est essentielle pour des scénarios tels que la **migration de nom de domaine** ou l'application de la **version HTTPS** d'un site web. On parle alors de **redirection HTTP**.
10+
11+
**Ce guide décrit le processus d'intégration de vos services web derrière un Load Balancer OVHcloud utilisant des redirections HTTP.**
1012

1113
## Prérequis
1214

1315
- Posséder une offre [OVHcloud Load balancer](/links/network/load-balancer) dans votre compte OVHcloud.
14-
- Être connecté à votre [espace client OVHcloud](/links/manager).
15-
- Être connecté à l'[API OVHcloud](/links/api).
16+
- Avoir accès à votre [espace client OVHcloud](/links/manager).
17+
- Avoir accès à l'[API OVHcloud](/links/api).
1618

1719
## En pratique
1820

@@ -27,13 +29,13 @@ Content-Type: text/html
2729
Content-Length: 174
2830
```
2931

30-
Les Rrdirections personnalisées doivent être de la forme `<scheme>://<net_loc>/<path>;<params>?<query>#<fragment>`. Il n'est possible de spécifier qu'une seule redirection par frontend.
32+
Les redirections personnalisées doivent utiliser le format `<scheme>://<net_loc>/<path>;<params>?<query>#<fragment>`. Il n'est possible de spécifier qu'une seule redirection par frontend.
3133

3234
Les redirections personnalisées peuvent être spécifiées via l'espace client ou via l'API, tant sur un nouveau frontend qu'un existant.
3335

3436
### Ajouter une redirection personnalisée depuis l'espace client OVHcloud
3537

36-
Il est possible de définir une redirection personnalisée depuis l'[espace client OVHcloud](/links/manager) dans la partie `Bare Metal Cloud`{.action} puis `Load Balancer`{.action}.
38+
Il est possible de définir une redirection personnalisée depuis l'[espace client OVHcloud](/links/manager), dans la partie `Bare Metal Cloud`{.action} puis `Load Balancer`{.action}.
3739
Cela peut-être effectué tant sur un nouveau frontend pendant sa création, que sur un frontend existant.
3840

3941
#### Ajout d'un nouveau frontend
@@ -48,7 +50,7 @@ Dans les paramètres avancés, renseignez la `Redirection HTTP`{.action}.
4850
#### Édition d'un frontend existant
4951

5052
Dans la section `Frontends`{.action}, cliquez que le bouton `...`{.action} à droite du frontend concerné et sélectionnez `Modifier`{.action}.<br>
51-
Assurez vous que le frontend choisi soit bien de protocole `HTTP` ou `HTTPS`. Complétez la configuration si besoin.
53+
Assurez vous que le frontend choisi utilise bien le protocole `HTTP` ou `HTTPS`. Complétez la configuration si besoin.
5254
Il est cependant inutile de préciser la `Ferme par défaut`{.action}, celle-ci ne sera pas utilisée.
5355

5456
Dans les paramètres avancés, renseignez la `Redirection HTTP`{.action}.
@@ -59,17 +61,17 @@ Une fois le frontend configuré, cliquez sur `Ajouter`{.action} ou `Modifier`{.a
5961
N'oubliez pas de déployer la configuration.
6062
Pour ce faire, vous pouvez au choix :
6163

62-
- dans la section `Statut` de l'onglet `Accueil`{.action}, cliquez sur le bouton `...`{.action} de votre Load Balancer puis cliquez sur `Appliquer la configuration`{.action}.
64+
- Dans la section `Statut` de l'onglet `Accueil`{.action}, cliquez sur le bouton `...`{.action} de votre Load Balancer puis cliquez sur `Appliquer la configuration`{.action}.
6365

64-
- dans le bandeau de rappel vous précisant que la configuration n'est pas appliquée, cliquez sur `Appliquer la configuration`{.action}.
66+
- Dans le bandeau de rappel vous précisant que la configuration n'est pas appliquée, cliquez sur `Appliquer la configuration`{.action}.
6567

6668
![Application d'une Configuration d'un Load Balancer](images/apply_configuration.png){.thumbnail}
6769

6870
### Ajouter une redirection personnalisée depuis l'API OVHcloud
6971

7072
Dans l'[API OVHcloud](/links/api), les redirections sont spécifiées dans la chaîne de caractère redirectLocation :
7173

72-
#### Création d'un nouveau frontend
74+
**Création d'un nouveau frontend**
7375

7476
> [!api]
7577
>
@@ -83,7 +85,7 @@ Dans l'[API OVHcloud](/links/api), les redirections sont spécifiées dans la ch
8385
|zone|Zone de déploiement du frontend|
8486
|redirectLocation|URL de redirection HTTP|
8587

86-
#### Mise à jour d'un frontend existant
88+
**Mise à jour d'un frontend existant**
8789

8890
> [!api]
8991
>
@@ -96,7 +98,7 @@ Dans l'[API OVHcloud](/links/api), les redirections sont spécifiées dans la ch
9698
|frontendId|Identifiant du frontend à mettre à jour|
9799
|redirectLocation|URL de redirection HTTP|
98100

99-
#### Appliquer les modifications :
101+
**Appliquer les modifications**
100102

101103
> [!api]
102104
>

0 commit comments

Comments
 (0)