HomeNetworkLoad BalancersHow to
Create and manage routes
Jump toUpdate content

How to create and manage routes

Reviewed on 16 August 2023Published on 08 February 2023

Routes allow you to specify, for a given frontend, which backends it should direct traffic to depending on the requested host. For HTTP frontends/backends, routes are based on HTTP Host headers. For TCP frontends/backends, they are based on Server Name Identification (SNI). You can configure multiple routes on a single frontend. When no route rules match for an incoming connection/request, the frontend will forward to its default backend.

Security & Identity (IAM):

You may need certain IAM permissions to carry out some actions described on this page. This means:

  • you are the Owner of the Scaleway Organization in which the actions will be carried out, or
  • you are an IAM user of the Organization, with a policy granting you the necessary permission sets
Requirements:

How to create routes

  1. Click Load Balancers in the Network section of the Scaleway console side menu.

  2. Click the Load Balancer you want to create a route for.

  3. Click the Frontends tab.

  4. Click the frontend you want to create a route on.

  5. Click the Routes tab.

  6. Click «Plus Icon» Create route to create a new route.

  7. Enter the following information to configure the route:

    • Source frontend: The current frontend is pre-set.
    • Target backend: Select the backend to which the frontend should direct traffic to for this rule.

    If you have selected an HTTP frontend/backend pair:

    • HTTP Host header: Enter an HTTP Host header value to filter for (for example www.example-domain.com). Traffic with a matching value in its HTTP Host header will be directed to the specified target backend.

    If you have selected a TCP frontend/backend pair:

    • SNI value: Enter an SNI value to filter for (for example www.example-domain.com). Traffic with a matching SNI value will be directed to the specified target backend.
  8. Click Create route to finish.

Your route is created, and you are taken to the list of all your routes for this Load Balancer.

You can repeat this process to create as many routes as you want.

How to edit routes

  1. Click Load Balancers in the Network section of the Scaleway console side menu.

  2. Click the Load Balancer you want to edit routes for.

  3. Click the Frontends tab.

  4. Click the frontend you want to edit a route on.

  5. Click the Routes tab.

  6. Click the «See more Icon» icon next to the route you want to edit, and select Edit from the drop-down list.

  7. Edit the backend and/or SNI/HTTP Host header value as required.

  8. Click Edit route to finish.

Your route is edited, and you are returned to the list of routes.

How to delete routes

  1. Click Load Balancers in the Network section of the Scaleway console side menu.

  2. Click the Load Balancer you want to delete routes for.

  3. Click the Frontends tab.

  4. Click the frontend you want to delete routes on.

  5. Click the Routes tab.

  6. Click the «See more Icon» icon next to the route you want to delete, and select Delete.

  7. Confirm the action by clicking Delete route.

See Also