Skip to content

Commit bdca2a1

Browse files
committed
fix(interlink): add links
1 parent fb86d05 commit bdca2a1

File tree

12 files changed

+192
-57
lines changed

12 files changed

+192
-57
lines changed

network/interlink/concepts.mdx

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,10 @@ categories:
1414
- networks
1515
---
1616

17+
<Message type="important">
18+
InterLink is currently in [Private Beta](https://www.scaleway.com/en/betas/), and only available to selected testers.
19+
</Message>
20+
1721
## Allowed routes list
1822

1923
The default rule blocks any and all routes from being propagated over InterLink. Attaching an allowed routes list (aka **routing policy**) allows you to define the ranges of routes that should be whitelisted. When creating an allowed routes list, you specify one or many IP ranges representing the outgoing routes to announce from the Scaleway VPC, and one or many IP ranges representing the incoming route announcements to accept from the external infrastructure.
@@ -34,7 +38,7 @@ Every InterLink has a defined bandwidth, representing the maximum data transfer
3438

3539
## InterLink
3640

37-
InterLink is Scaleway's product to let you create a secure, private connection between your external infrastructure, and your Scaleway VPC. This allows you to direct your traffic safely from your Scaleway infrastructure to your on-premises infrastructure, away from the public internet.
41+
InterLink, currently in Private Beta, is Scaleway's product to let you create a secure, private connection between your external infrastructure, and your Scaleway VPC. This allows you to direct your traffic safely from your Scaleway infrastructure to your on-premises infrastructure, away from the public internet.
3842

3943
Currently, InterLink is available in **hosted** version only. This means that you must choose a compatible [partner](#partner) to facilitate the physical connection between the external infrastructure and the Scaleway VPC. The physical connection may be shared between several clients, each allocated a specific amount of bandwidth for their InterLink.
4044

network/interlink/how-to/index.mdx

Lines changed: 0 additions & 9 deletions
This file was deleted.

network/interlink/how-to/order-interlink.mdx

Lines changed: 0 additions & 15 deletions
This file was deleted.

network/interlink/index.mdx

Lines changed: 8 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,13 @@ meta:
55
noindex: true
66
---
77

8+
<Alert
9+
sentiment="info"
10+
title="InterLink is now in Private Beta"
11+
>
12+
InterLink is currently available in [Private Beta](https://www.scaleway.com/en/betas/) only, for selected testers.
13+
</Alert>
14+
815
<ProductHeader
916
productName="InterLink"
1017
productLogo="interlink"
@@ -16,31 +23,17 @@ meta:
1623
## Getting Started
1724

1825
<Grid>
19-
<SummaryCard
20-
title="Quickstart"
21-
icon="rocket"
22-
description="Learn how to get started with InterLink."
23-
label="View Quickstart"
24-
url="/network/interlink/quickstart/"
25-
/>
2626
<SummaryCard
2727
title="Concepts"
2828
icon="info"
2929
description="Core concepts that give you a better understanding of InterLink."
3030
label="View Concepts"
3131
url="/network/interlink/concepts/"
32-
/>
33-
<SummaryCard
34-
title="How-tos"
35-
icon="help-circle-outline"
36-
description="Check our guides to creating and configuring an InterLink."
37-
label="View How-tos"
38-
url="/network/interlink/how-to/"
3932
/>
4033
<SummaryCard
4134
title="Additional Content"
4235
icon="book-open-outline"
43-
description="Go beyond the basics with detailed, in-depth guides to configuring InterLink."
36+
description="Read our in-depth guides to provisioning and configuring your InterLink."
4437
label="Read more"
4538
url="/network/interlink/reference-content/"
4639
/>

network/interlink/quickstart.mdx

Lines changed: 0 additions & 17 deletions
This file was deleted.
35.5 KB
Loading
45 KB
Loading
37.1 KB
Loading
33.7 KB
Loading
Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
---
2+
meta:
3+
title: Configuring an InterLink
4+
description: Find out how to set up your Scaleway InterLink so that traffic can flow between your external infrastructure and your Scaleway resources. Understand how to attach a VPC, create an allowed routes list to whitelist route announcements, and activate route propagation across the connection.
5+
noindex: true
6+
content:
7+
h1: Configuring an InterLink
8+
paragraph: Find out how to set up your Scaleway InterLink so that traffic can flow between your external infrastructure and your Scaleway resources. Understand how to attach a VPC, create an allowed routes list to whitelist route announcements, and activate route propagation across the connection.
9+
tags: interlink configuration attach-vpc whitelist route-range ip-prefix route-propagation
10+
categories:
11+
- interlink
12+
- network
13+
dates:
14+
validation: 2024-10-24
15+
posted: 2024-10-24
16+
---
17+
18+
<Message type="important">
19+
InterLink is currently in [Private Beta](https://www.scaleway.com/en/betas/), and only available to selected testers.
20+
</Message>
21+
22+
Once your InterLink has been created and the [provisioning process](/network/interlink/reference-content/provisioning/) is complete, you must complete a number of configuration steps to enable traffic to flow across the InterLink.
23+
24+
This document explains the process in full, and gives tips for troubleshooting any potential issues.
25+
26+
## Configuration overview
27+
28+
<Lightbox src="scaleway-interlink-config.webp" alt="A four step flow chart shows the following steps: 1. Create InterLink, 2. Attach VPC, 3. Attach allowed routes list, 4. Activate route propagation. After these steps are complete, traffic can flow across the InterLink" />
29+
30+
The diagram above shows the four configuration steps necessary for an InterLink. Only when all steps have been completed can traffic flow across the InterLink, connecting the Scaleway VPC to the external (on-premises) infrastructure.
31+
32+
Read more about each step, and possible errors at each stage, in the following sections.
33+
34+
### 1. Create the InterLink
35+
36+
Creating an InterLink is itself a multi-step process, that requires action on both the Scaleway side, and on the partner side. This process is explained in full in [Provisioning an InterLink](/network/interlink/reference-content/provisioning/).
37+
38+
You must wait until the InterLink has reached `Active` [status](/network/interlink/reference-content/statuses/) before you can continue with the following configuration steps.
39+
40+
### 2. Attach VPC
41+
42+
Attaching an InterLink to a VPC allows you to complete the connection from your external infrastructure, across the InterLink, to the Scaleway resources in the selected VPC.
43+
z
44+
The VPC must be in the same region region as the InterLink. An InterLink can only be attached to one VPC at a time, but you are free to detach the VPC and attach a different one whenever you like.
45+
46+
You can use the [Attach a VPC](https://www.scaleway.com/en/developers/api/interlink/v1beta1/#path-links-attach-a-vpc) endpoint to attach a VPC to a given InterLink.
47+
48+
### 3. Attach allowed routes list (routing policy)
49+
50+
By default, all routes across an InterLink are blocked by default. You must create and attach an [allowed routes list](/network/interlink/concepts/#allowed-routes-list) aka routing policy, to set IP prefix filters for the routes you want to whitelist. This facilitates traffic flow across the InterLink.
51+
52+
You can [create](https://www.scaleway.com/en/developers/api/interlink/v1beta1/#path-routing-policies-create-a-routing-policy) and [attach](https://www.scaleway.com/en/developers/api/interlink/v1beta1/#path-links-attach-a-routing-policy) allowed routes lists via the API.
53+
54+
When setting the route ranges to whitelist, you must separately define the IP prefixes to accept from the external infrastructure (incoming ranges of route announcements to accept), and the IP prefix filters to advertise from the Scaleway VPC to the peer (outgoing ranges of routes to advertise). For example, adding `172.16.4.0/22` whitelists all 1,024 IPs in this block, from `172.16.4.0` to `172.16.7.255`.
55+
56+
Only one allowed routes list (routing policy) can be attached to an InterLink at a given time. However, you can reuse the same list by attaching it to multiple InterLinks, for example if you have a second InterLink attached to the same VPC/external infrastructure for redundance purposes. You can update, delete or reattach a list at any time.
57+
58+
### 4. Activate route propagation.
59+
60+
Once you have attached a VPC and defined the routing policy/allowed routes, you must [activate route propagation](https://www.scaleway.com/en/developers/api/interlink/v1beta1/#path-links-enable-route-propagation) to allow traffic to flow over the InterLink. This enables all prefixes whitelisted in your allowed routes list / routing policy to be announced in the BGP session, so that traffic can flow along these routes.
61+
62+
<Message type="important">
63+
Even when route propagation is activated, remember that all routes are blocked by default. It is essential to attach a routing policy (aka allowed routes list) to the InterLink to allow traffic to flow.
64+
</Message>
65+
66+
You can deactivate route propagation via the dedicated endpoint at any time. When you do this, all routes are blocked and removed from the VPC's route table. No traffic can flow across the InterLink until route propagation is reactivated.

0 commit comments

Comments
 (0)