NavigationContentFooter
Jump toSuggest an edit

How to create an Edge Services pipeline for a Load Balancer

Reviewed on 15 October 2024Published on 24 July 2024

Edge Services is an additional feature for Scaleway Load Balancers and Object Storage buckets.

Creating an Edge Services pipeline for your Load Balancer helps to reduce load on your Load Balancer's backend servers. The origin configuration you define is used by Edge Services to connect to your Load Balancer and request content, which is then stored in the cache. Then, when your Load Balancer origin is accessed via its customizable Edge Services endpoint, the requested content is served from the cache (if present), without the need to fetch this content via the Load Balancer and its backend servers.

Edge Services lets you:

  • Define the specific origin (Load Balancer, frontend port, and host) for a given pipeline and its associated cache
  • Choose the TTL for cached objects, and purge the entire cache or specific cached objects at any time (cache invalidation)
  • Customize your Edge Services pipeline endpoint using a subdomain of your own domain
  • Add an SSL/TLS certificate so that Edge Services can serve content over HTTPS for your subdomain

An Edge Services pipeline can be created for any Load Balancer with a public IP address. Load Balancers with frontends/backends using both TCP and/or HTTP are supported. Private Load Balancers are not compatible with Edge Services.

Before you start

To complete the actions presented below, you must have:

  • A Scaleway account logged into the console
  • Owner status or IAM permissions allowing you to perform actions in the intended Organization
  • An active Edge Services subscription
  • A Load Balancer

How to create an Edge Services pipeline for Load Balancer

Tip

You can create an Edge Services pipeline from the Load Balancer section of the console, via the Edge Services tab there. However, in this documentation, we describe how to create a pipeline directly from the Edge Services section of the console.

  1. Click Edge Services in the Network section of the Scaleway console side menu.

  2. Click Create pipeline. The pipeline creation wizard displays.

  3. Configure the origin for this pipeline:

    • Select Load Balancer as the origin type.
    • Select the origin Load Balancer from the dropdown list. The Edge Services pipeline will connect to this Load Balancer when requesting content.
    • Select a frontend associated with the origin Load Balancer from the dropdown list. The Edge Services pipeline will connect to the Load Balancer on this port when requesting content. We recommend that you select an HTTPS port, e.g. 443. Note that if you are creating multiple pipelines for the same origin Load Balancer, each one must be configured for a different frontend.
    Tip

    For Kubernetes Load Balancers, see our dedicated documentation for help selecting the correct Load Balancer and frontend.

  4. Define the protocol and origin host for this pipeline:

    • Select the protocol that Edge Services should use when making requests to the origin, either HTTP or HTTPS (recommended). Choose the protocol that corresponds with your Load Balancer setup.
    • Optionally, enter an origin host associated with your Load Balancer for this pipeline. When specified, this host replaces the Load Balancer IP address in the HTTP Host Header of the requests made from Edge Services to your Load Balancer.
  5. Enter a name for this Edge Services pipeline, or leave the auto-generated name in place.

    The summary cost for the creation of this pipeline is displayed, notably whether it falls within the limits of your current subscription plan

  6. Click Create Edge Services pipeline to finish.

    You are returned to the Pipelines tab, where the newly created pipeline now displays.

    Click on the pipeline to go to its Overview page and start configuration. From the Overview, you can see the endpoint from which you can access your Load Balancer origin via Edge Services, e.g. https://pipeline-id.edge.scw.cloud.

Troubleshooting pipeline creation

If you see the message Edge Services was unable to contact the host via the Load Balancer Please check your origin configuration settings and try again, check the following elements of your configuration:

  • Protocol: Ensure you did not select the wrong protocol, e.g. HTTP selected while the frontend chosen is configured to receive HTTPS, or the opposite.
  • Origin host: Ensure that you entered the correct origin host, with no typos, for a host that exists behind the selected Load Balancer.
  • Load Balancer ACLs: Ensure that there are no ACLs configured on your Load Balancer which are blocking traffic from Edge Services.

Help for Kubernetes Load Balancers

If you are setting up an Edge Services pipeline for a Kubernetes Kapsule Load Balancer, follow these steps to determine which Load Balancer and frontend to configure for your pipeline:

  1. Run kubectl describe svc.

    An output displays.

  2. Locate the section of the output that relates to your LoadBalancer service. It should look something like this:

    Name: myloadbalancer
    Namespace: default
    Labels: app=mydeployment
    Annotations: service.beta.kubernetes.io/scw-loadbalancer-id: fr-par-1/a92de52e-262f-99f9-be66-5220003a2e42
    Selector: app=mydeployment
    Type: LoadBalancer
    IP Family Policy: SingleStack
    IP Families: IPv4
    IP: 10.32.220.60
    IPs: 10.32.220.60
    LoadBalancer Ingress: 51.159.25.111
    Port: http 8000/TCP
    TargetPort: 8000/TCP
    NodePort: http 32041/TCP
    Endpoints:
    Session Affinity: None
    External Traffic Policy: Cluster
  3. Find the service.beta.kubernetes.io/scw-loadbalancer-id annotation, and note your Load Balancer ID (e.g. a92de52e-262f-99f9-be66-5220003a2e42). Check your Load Balancer list in the console to find the Load Balancer name that corresponds to this ID. This is the Load Balancer you should select for the Edge Services pipeline.

  4. Find the NodePort line and note the port mentioned (in the case above, 32041). In the console, find the frontend of the Load Balancer from step 3 that corresponds with this port. This is the frontend and port you should select for the Edge Services pipeline.

How to edit an Edge Services pipeline origin

You can edit the protocol, origin host, and name of an Edge Services pipeline as follows.

  1. Click Load Balancers in the Network section of the Scaleway console side menu. The list of your Load Balancers displays.

  2. Click the Edge Services tab.

  3. Click the Edge Services pipeline you want to edit. The Overview page for the pipeline displays.

  4. In the top right corner, click Edit. A pop-up displays.

  5. Make the edits required. You can:

    • Change the protocol
    • Change the origin host
    • Change the pipeline name
  6. Click Save.

See also
How to create an Object Storage pipelineHow to configure a custom domain
Was this page helpful?
API DocsScaleway consoleDedibox consoleScaleway LearningScaleway.comPricingBlogCareers
© 2023-2024 – Scaleway