diff --git a/menu/navigation.json b/menu/navigation.json index a107c97853..8bcb12a69e 100644 --- a/menu/navigation.json +++ b/menu/navigation.json @@ -3227,6 +3227,90 @@ "label": "Public Gateways", "slug": "public-gateways" }, + { + "items": [ + { + "label": "Overview", + "slug": "../interlink" + }, + { + "label": "Concepts", + "slug": "concepts" + }, + { + "label": "Quickstart", + "slug": "quickstart" + }, + { + "label": "FAQ", + "slug": "faq" + }, + { + "items": [ + { + "label": "Order an InterLink", + "slug": "order-interlink" + }, + { + "label": "Complete InterLink provisioning", + "slug": "complete-provisioning" + }, + { + "label": "Configure an InterLink", + "slug": "configure-interlink" + }, + { + "label": "Create a routing policy", + "slug": "create-routing-policy" + }, + { + "label": "Delete an InterLink", + "slug": "delete-interlink" + } + ], + "label": "How to", + "slug": "how-to" + }, + { + "items": [ + { + "label": "InterLink API Reference", + "slug": "https://www.scaleway.com/en/developers/api/interlink/" + } + ], + "label": "API/CLI", + "slug": "api-cli" + }, + { + "items": [ + { + "label": "InterLink overview", + "slug": "overview" + }, + { + "label": "InterLink provisioning", + "slug": "provisioning" + }, + { + "label": "Configuring an InterLink", + "slug": "configuring" + }, + { + "label": "InterLink statuses", + "slug": "statuses" + }, + { + "label": "Using BGP communities", + "slug": "bgp-communities" + } + ], + "label": "Additional Content", + "slug": "reference-content" + } + ], + "label": "InterLink", + "slug": "interlink" + }, { "items": [ { diff --git a/pages/faq/index.mdx b/pages/faq/index.mdx index 7b754c9c05..68567ccfaa 100644 --- a/pages/faq/index.mdx +++ b/pages/faq/index.mdx @@ -131,6 +131,12 @@ content: label="Instances" /> + + -InterLink is currently in [Private Beta](https://www.scaleway.com/en/betas/), and only available to selected testers. + +InterLink is currently in [Public Beta](https://www.scaleway.com/en/betas/). -## Allowed routes list +## Attached VPC -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. +Each InterLink can be attached to one Scaleway VPC. The InterLink and the VPC must be in the same [region](#region). You can detach the InterLink from the VPC at any time, and attach it to a different VPC in the same region, if you wish. When an InterLink is not attached to any VPC, no traffic can flow. -Each InterLink can have one allowed routes list attached to it, but a single allowed routes list can be attached to multiple InterLinks, if desired. When [route propagation](#route-propagation) is activated, the route ranges defined in the allowed routes list are whitelisted, and traffic can flow across the InterLink along these routes. [Learn more about routing across an InterLink](/interlink/reference-content/overview/#routing-across-an-interLink) +## Bandwidth -You may also know allowed routes lists under the terms "routing policy", or "route filters". +Every InterLink has a defined bandwidth, representing the maximum data transfer rate possible over the link. Measured in megabits per second (Mbps) or gigabits per second (Gbps), it shows how much data can be transmitted over InterLink per second. -## Attached VPC +## Border Gateway Protocol (BGP) -Each InterLink can be attached to one Scaleway VPC. The InterLink and the VPC must be in the same [region](#region). You can detach the InterLink from the VPC at any time, and attach it to a different VPC in the same region, if you wish. When an InterLink is not attached to any VPC, no traffic can flow. +**B**order **G**ateway **P**rotocol (BGP) is a standardized gateway protocol that allows autonomous systems to exchange routing information. InterLink uses BGP to facilitate [route propagation](#route-propagation), so that the Scaleway VPC and the external infrastructure's router can learn each other's routes. -## Bandwidth +## Connection type + +The type of physical connection for an InterLink. In the long term, InterLink will be available in both **hosted** and **self-hosted** connection types. For now, only **hosted** connections (facilitated via a partner) are available: + +- **Hosted InterLink**: The customer provisions an InterLink via a [partner](#partner). The available bandwidth of the partner's physical connection is shared between multiple customers: each gets a specified amount when creating their InterLink. +- **Self-hosted InterLink**: The customer gets sole use of a single InterLink port on Scaleway's router, with the entire bandwidth of that port. They create their own dedicated physical connection, and can use its available bandwidth to provision several InterLinks for themselves. -Every InterLink has a defined bandwidth, representing the maximum data transfer rate possible over the connection. Measured in megabits per second (Mbps) or gigabits per second (Gbps), it shows how much data can be transmitted over InterLink per second. +[Find out more about connection types](/interlink/reference-content/overview/#types-of-interlink). ## InterLink -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. +InterLink, currently in Public 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. 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. @@ -46,17 +50,17 @@ For more information on how InterLink works, see our [detailed overview](/interl ## Location -A location, aka a **P**oint **o**f **P**resence (PoP), is a physical location where you can establish an InterLink connection between your on-premises infrastructure and the Scaleway network. Locations are facilitated by partners. +A location, aka a **P**oint **o**f **P**resence (PoP), is a physical location where you can establish an InterLink between your on-premises infrastructure and the Scaleway network. Locations are facilitated by partners. ## Pairing key -A pairing key is a unique identifier used to establish and authenticate an InterLink connection. It is provided by Scaleway once an InterLink order is made. You must then share this key with your selected partner to facilitate the setup of the physical link. The pairing key ensures that the correct endpoints are securely connected. +A pairing key is a unique identifier used to establish and authenticate an InterLink via a partner. It is provided by Scaleway once an InterLink order is made. You must then share this key with your selected partner to facilitate the setup of the physical link. The pairing key ensures that the correct endpoints are securely connected. ## Partner -A partner is a third party service provider that facilitates a hosted InterLink connection between a client's on-premises infrastructure, and their Scaleway infrastructure. Current partners include [Free Pro](https://pro.free.fr/), with more coming soon. +A partner is a third party service provider that facilitates a hosted InterLink between a client's on-premises infrastructure, and their Scaleway infrastructure. Current partners include [Free Pro](https://pro.free.fr/), with more coming soon. -Partners are generally companies specialized in data transit, with their own fibers at data connection points. To establish an InterLink connection via a partner, generally you must be client of that partner, e.g. with your infrastructure in their datacenter, or on your own premises using the partner as a network provider. See our information on [hosted InterLinks](/interlink/reference-content/overview/#hosted-interlinks) for more information. +Partners are generally companies specialized in data transit, with their own fibers at data connection points. To establish an InterLink via a partner, generally you must be a client of that partner, e.g. with your infrastructure in their datacenter, or on your own premises using the partner as a network provider. See our information on [hosted InterLinks](/interlink/reference-content/overview/#hosted-interlinks) for more information. ## PoP @@ -68,11 +72,10 @@ When creating an InterLink, you must specify a [region](/vpc/concepts/#region-an ## Route propagation -Route propagation can be activated or deactivated at any given time on an InterLink. When activated, the Scaleway VPC and external infrastructure dynamically exchange and update information about their routes. Route propagation must be activated to allow traffic to flow over the InterLink. When deactivated, all pre-learned/announced routes are removed from the VPC's route table, and traffic cannot flow. Note that even with route propagation activated, the default rule blocks all route announcements: you must use an [allowed routes list](#allowed-routes-list) to specify the route ranges to whitelist. [Learn more about routing across an InterLink](/interlink/reference-content/overview/#routing-across-an-interLink) +Route propagation can be activated or deactivated at any given time on an InterLink. When activated, the Scaleway VPC and external infrastructure dynamically exchange and update information about their routes. Route propagation must be activated to allow traffic to flow over the InterLink. When deactivated, all pre-learned/announced routes are removed from the VPC's route table, and traffic cannot flow. Note that even with route propagation activated, the default rule blocks all route announcements: you must attach a [routing policy](#routing-policy) to specify the route ranges to whitelist. [Learn more about routing across an InterLink](/interlink/reference-content/overview/#routing-across-an-interLink) ## Routing policy -See [Allowed routes list](#allowed-routes-list). - - +The default rule blocks any and all routes from being propagated over InterLink. Attaching a routing policy allows you to define the ranges of routes that should be whitelisted. When creating a routing policy, 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. +Each InterLink can have one routing policy attached to it, but a single routing policy can be attached to multiple InterLinks, if desired. When [route propagation](#route-propagation) is activated, the route ranges defined in the routing policy are whitelisted, and traffic can flow across the InterLink along these routes. [Learn more about routing across an InterLink](/interlink/reference-content/overview/#routing-across-an-interLink) \ No newline at end of file diff --git a/pages/interlink/faq.mdx b/pages/interlink/faq.mdx new file mode 100644 index 0000000000..cd1f3c02c5 --- /dev/null +++ b/pages/interlink/faq.mdx @@ -0,0 +1,47 @@ +--- +meta: + title: InterLink FAQ + description: Discover Scaleway InterLink and find answers to your most common questions. +content: + h1: InterLink FAQ +dates: + validation: 2025-03-18 +category: network +productIcon: InterlinkProductIcon +--- + + +InterLink is currently in [Public Beta](https://www.scaleway.com/en/betas/). + + +## What is InterLink and how does it work? + +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. + +Currently, InterLink is available in **hosted** version only. This means that you must choose a compatible **partner** to facilitate your InterLink. The partner provides the physical connection, and this connection may be shared between several clients, each allocated a specific amount of bandwidth for their InterLink. + +At its simplest level, InterLink can be understood as a configurable connection between your own infrastructure, and your Scaleway VPC. You can configure details such as bandwidth, the VPC to connect to, and routing policies. + +## How can I find a partner to provision my InterLink? + +To establish a hosted InterLink via a partner, generally you must be a client of that partner, e.g. with your infrastructure in their data center, or on your own premises using the partner as a network provider. For more details, see our [information on choosing a partner](/interlink/reference-content/overview/how-to-choose-a-partner). + +You can see available partners in the Scaleway console by opening the [InterLink order form](https://console.scaleway.com/interlink/links/order). More partners will be added to Scaleway InterLink as time goes on. + +## I want to create a dedicated InterLink without a partner, how can I do this? + +We plan to make **self-hosted** InterLinks available soon, whereby a single client can provision their own physical connection without a partner, getting sole use of a single InterLink port on Scaleway's router. The bandwidth of this connection can then be used by the client to create several InterLinks just for them. + +You can [contact a sales representative](https://www.scaleway.com/en/contact-sales/) to register your interest in a self-hosted InterLink. + +## What are the benefits of using InterLink compared to other connectivity solutions? + +InterLink allows you to connect your Scaleway VPC to your external infrastructure and bypass the public internet entirely. Compared to a typical internet-based VPN, an InterLink is more reliable, more secure and offers lower latency. + +## How much does InterLink cost? + +See the [pricing page](https://www.scaleway.com/en/pricing/network/) for full details on InterLink pricing. + +## How can I get help with my InterLink? + +Join the `#interlink` channel on the [Scaleway Slack Community](/tutorials/scaleway-slack-community/) to get help and support for your InterLink during the Public Beta phase. \ No newline at end of file diff --git a/pages/interlink/how-to/assets/scaleway-attach-routing-policy.webp b/pages/interlink/how-to/assets/scaleway-attach-routing-policy.webp new file mode 100644 index 0000000000..af217c26f4 Binary files /dev/null and b/pages/interlink/how-to/assets/scaleway-attach-routing-policy.webp differ diff --git a/pages/interlink/how-to/assets/scaleway-create-routing-policy.webp b/pages/interlink/how-to/assets/scaleway-create-routing-policy.webp new file mode 100644 index 0000000000..190ac60f64 Binary files /dev/null and b/pages/interlink/how-to/assets/scaleway-create-routing-policy.webp differ diff --git a/pages/interlink/how-to/assets/scaleway-interlink-attach-vpc.webp b/pages/interlink/how-to/assets/scaleway-interlink-attach-vpc.webp new file mode 100644 index 0000000000..1ae6476457 Binary files /dev/null and b/pages/interlink/how-to/assets/scaleway-interlink-attach-vpc.webp differ diff --git a/pages/interlink/how-to/assets/scaleway-interlink-config.webp b/pages/interlink/how-to/assets/scaleway-interlink-config.webp new file mode 100644 index 0000000000..6454339bc6 Binary files /dev/null and b/pages/interlink/how-to/assets/scaleway-interlink-config.webp differ diff --git a/pages/interlink/how-to/assets/scaleway-interlink-diag-simple.webp b/pages/interlink/how-to/assets/scaleway-interlink-diag-simple.webp new file mode 100644 index 0000000000..ac3bf704c3 Binary files /dev/null and b/pages/interlink/how-to/assets/scaleway-interlink-diag-simple.webp differ diff --git a/pages/interlink/how-to/assets/scaleway-interlink-listing.webp b/pages/interlink/how-to/assets/scaleway-interlink-listing.webp new file mode 100644 index 0000000000..4bca10cf2a Binary files /dev/null and b/pages/interlink/how-to/assets/scaleway-interlink-listing.webp differ diff --git a/pages/interlink/how-to/assets/scaleway-interlink-ordering.webp b/pages/interlink/how-to/assets/scaleway-interlink-ordering.webp new file mode 100644 index 0000000000..6d06561261 Binary files /dev/null and b/pages/interlink/how-to/assets/scaleway-interlink-ordering.webp differ diff --git a/pages/interlink/how-to/assets/scaleway-interlink-overview-requesting.webp b/pages/interlink/how-to/assets/scaleway-interlink-overview-requesting.webp new file mode 100644 index 0000000000..1fd56d561b Binary files /dev/null and b/pages/interlink/how-to/assets/scaleway-interlink-overview-requesting.webp differ diff --git a/pages/interlink/how-to/assets/scaleway-interlink-overview-up.webp b/pages/interlink/how-to/assets/scaleway-interlink-overview-up.webp new file mode 100644 index 0000000000..f746f3a570 Binary files /dev/null and b/pages/interlink/how-to/assets/scaleway-interlink-overview-up.webp differ diff --git a/pages/interlink/how-to/assets/scaleway-order-interlink.webp b/pages/interlink/how-to/assets/scaleway-order-interlink.webp new file mode 100644 index 0000000000..923b555132 Binary files /dev/null and b/pages/interlink/how-to/assets/scaleway-order-interlink.webp differ diff --git a/pages/interlink/how-to/complete-provisioning.mdx b/pages/interlink/how-to/complete-provisioning.mdx new file mode 100644 index 0000000000..56f11f42b4 --- /dev/null +++ b/pages/interlink/how-to/complete-provisioning.mdx @@ -0,0 +1,78 @@ +--- +meta: + title: How to complete InterLink provisioning + description: Learn how to complete the provisioning process for your Scaleway InterLink, to ensure your hosted connection between your on-premises infrastructure and Scaleway VPC is up and running as soon as possible. +content: + h1: How to complete InterLink provisioning + paragraph: Learn how to complete the provisioning process for your Scaleway InterLink, to ensure your hosted connection between your on-premises infrastructure and Scaleway VPC is up and running as soon as possible. +dates: + validation: 2025-03-18 + posted: 2025-03-18 +tags: interlink direct-connect provision hosted partner contact error +categories: + - network +--- + + +InterLink is currently in [Public Beta](https://www.scaleway.com/en/betas/). + + +After you have [ordered your InterLink](/interlink/how-to/order-interlink), further action is required on both the customer side and the [partner](/interlink/concepts/#partner) side before the InterLink is provisioned and ready for active use. This page walks you through the steps to take and how to deal with potential problems that could arise. + + + + + +- A Scaleway account logged into the [console](https://console.scaleway.com) +- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization +- [Ordered an InterLink](/interlink/how-to/order-interlink) + +## Contact partner to request InterLink + +After ordering the InterLink from Scaleway, you **must** contact your chosen partner to request that they provision the connection on their side. Scaleway is not able to automatically do this step for you. + +1. Click **InterLink** in the **Network** section of the [Scaleway console](https://console.scaleway.com) side menu. A listing of your InterLinks displays. + +2. Click on the InterLink that you want to finish provisioning. The InterLink's **Overview** page displays. + + + +3. Note down the [pairing key](/interlink/concepts/#pairing-key) for your InterLink. This is a unique identification number which the partner will need in order to provision your InterLink. + +4. Contact your partner. After [creating your InterLink order](/interlink/how-to/order-interlink/), either their online portal URL, or their email address was displayed to you for this purpose. Use the relevant method to contact your partner, provide the pairing key, and request that they provision your InterLink from their side. + + +You can also use the [Get a partner](https://www.scaleway.com/en/developers/api/interlink/#path-partners-get-a-partner) endpoint in the API to get contact details and other information about your selected partner. + + +Your InterLink will remain in `Requested` status until the partner responds to your request. + +## Wait for partner to accept InterLink request + +Once you have requested the InterLink from your partner, you must wait for them to respond to your request. There is no further action for you to take at this point. You can keep track of your InterLink's [status](/interlink/reference-content/statuses/) via the [InterLink listing](https://console.scaleway.com/interlink/links) in the Scaleway console. + + + +When the partner approves your request, the InterLink moves to `Provisioning` status. This means that the partner has agreed to facilitate your InterLink, and is now preparing the resources and configuration necessary to do so. + +Your InterLink will remain in `Provisioning` status until this process has been completed. + + +If your InterLink does not move to `Provisioning` status, you may see one of the following statuses: + +- `Refused`: The partner did not agree to provision your InterLink. Delete this InterLink resource, and contact your partner for more information. Consider re-ordering with a different partner. +- `Expired`: Your InterLink order timed out: after 10 days, no response was received from the selected partner. Delete the InterLink resource, and create a new order if you wish to try again. + + +## Partner provisions InterLink + +When the partner has finished provisioning your InterLink, it moves to `Active` status. This indicates that the physical link and necessary accompanying configuration have been completed on the partner's side, and your InterLink is ready for use. + +You must still configure your InterLink by attaching it to a VPC, attaching a routing policy, and activating route propagation, before traffic can flow over the InterLink. For help with these steps, see our documentation on [How to configure your InterLink](/interlink/reference-content/configuring/). + + +If you see a `Limited connectivity` status next to your InterLink on the [listing page](https://console.scaleway.com/interlink/links), this indicates that the partner provisioned your InterLink, but either IPv4 or IPv6 connectivity is down. Similarly, a `Down` status indicates the InterLink is provisioned, but both IPv4 **and** IPv6 connectivity are down. Open a Scaleway support ticket, or contact your partner for assistance. + +A `Locked` status indicates, again, that the InterLink was provisioned, but Scaleway Trust and Safety have locked the resource. No actions are possible from you as a user: you should open a support ticket for help and information. + + diff --git a/pages/interlink/how-to/configure-interlink.mdx b/pages/interlink/how-to/configure-interlink.mdx new file mode 100644 index 0000000000..52b91dbc35 --- /dev/null +++ b/pages/interlink/how-to/configure-interlink.mdx @@ -0,0 +1,207 @@ +--- +meta: + title: How to configure your InterLink + description: Learn how to configure your Scaleway InterLink, from attaching a VPC to creating a routing policy and activating route propagation. We walk you through al the steps necessary to start using your hosted connection. +content: + h1: How to configure your InterLink + paragraph: Learn how to configure your Scaleway InterLink, from attaching a VPC to creating a routing policy and activating route propagation. We walk you through al the steps necessary to start using your hosted connection. +dates: + validation: 2025-03-18 + posted: 2025-03-18 +tags: interlink direct-connect configure attach-vpc route-propagation allowed-routes routing-policy +categories: + - network +--- + + +InterLink is currently in [Public Beta](https://www.scaleway.com/en/betas/). + + +Once your InterLink has been [provisioned](/interlink/how-to/complete-provisioning/) by your chosen partner, a number of configuration steps become available to you. These steps must be carried out in order for traffic to successfully flow over your InterLink: + +- Attach a VPC +- Create and attach a routing policy +- Activate route propagation + + + +This document explains how to complete these configuration steps with the Scaleway console. + + + +- A Scaleway account logged into the [console](https://console.scaleway.com) +- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization +- [Ordered an InterLink](/interlink/how-to/order-interlink/) which has been [provisioned](/interlink/how-to/complete-provisioning/) by the partner + +## How to attach a VPC + +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. + +1. Click **InterLink** in the **Network** section of the [Scaleway console](https://console.scaleway.com) side menu. A listing of your InterLinks displays. + +2. Click on the InterLink that you want to configure. The InterLink's **Overview** page displays. + + + +3. In the **Attached VPC** section, click **Attach VPC**. A pop-up displays: + + + +4. Select one of your existing VPCs from the dropdown list. It must be in the same region as the InterLink. Alternatively, click **+ Create VPC** to create and attach a new VPC. + + + 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. + + +5. Click **Attach VPC** + + The VPC is attached and you are returned to the InterLink's **Overview** page. + +To enable traffic to flow across the InterLink, you must still create and attach a routing policy, and activate route propagation. + +## How to attach a routing policy + +After attaching a VPC, the next step in configuring your InterLink is to create and attach a routing policy. + +The VPC and the external infrastructure's routers both announce their routes to each other via [BGP](/interlink/concepts/#border-gateway-protocol-bgp) when route propagation is activated, but all of these routes are blocked by default. Routing policies let you whitelist ranges of route announcements to allow, so that traffic can flow along these routes across the InterLink. + +Each InterLink can have one routing policy attached to it, but a single routing policy can be attached to multiple InterLinks, if desired. + +See the dedicated documentation on [creating a routing policy](/interlink/how-to/create-routing-policy/) to create a policy, then follow these instructions to attach it: + +1. Click **InterLink** in the **Network** section of the [Scaleway console](https://console.scaleway.com) side menu. A listing of your InterLinks displays. + +2. Click on the InterLink that you want to configure. The InterLink's **Overview** page displays. + + +3. In the **Route propagation** section, click **Attach routing policy**. A pop-up displays. + + + +4. Select a routing policy from the drop-down list, and click **Attach policy**. + + + Make sure that the routing policy is suitable for the incoming routes (announced by the Scaleway VPC) and outgoing routes (announced by the external infrastructure) that should be propagated on this InterLink. + + +The policy is attached, ad you are returned to the InterLink's **Overview** page. + +## How to activate route propagation + +Once you have attached a VPC and attached a routing policy, you can activate route propagation. This is the final step in configuring your InterLink so that traffic can flow between the VPC and your external infrastructure: it triggers the dynamic exchange of route information between the VPC and external infrastructure. + +1. Click **InterLink** in the **Network** section of the [Scaleway console](https://console.scaleway.com) side menu. A listing of your InterLinks displays. + +2. Click on the InterLink that you want to configure. The InterLink's **Overview** page displays. + + + +3. In the **Route propagation** section, use the toggle to turn route propagation **ON**. + + A pop-up displays, showing the attached routing policy which will define the incoming and outgoing route announcements to accept. You can change the attached routing policy if you wish. + + It is not possible to activate route propagation without attaching a routing policy, as all route announcements would be blocked, rendering the action ineffective. + +4. Click **Activate route propagation**. + + Route propagation is activated, and you are returned to your InterLink's overview page. + + While route propagation remains active, traffic can flow across the InterLink along the routes allowed by the routing policy. The VPC and external infrastructure will dynamically exchange and update route information. You can deactivate route propagation at any time: if you do so, all routes are blocked and no traffic can flow. + +## How to modify your InterLink configuration + +You can modify the following aspects of your InterLink configuration at any time: + +- The attached Scaleway VPC +- The attached routing policy +- Whether route propagation is on or off + + +It is not possible to modify settings that were defined at the time of creating the InterLink, such as its region, partner, location, or bandwidth. To modify any of those settings, you must delete the InterLink and create a new one. + + +### How to change the attached VPC + +1. Click **InterLink** in the **Network** section of the [Scaleway console](https://console.scaleway.com) side menu. A listing of your InterLinks displays. + +2. Click on the InterLink that you want to configure. The InterLink's **Overview** page displays. + +3. In the **Attached VPC** section, click the unlink icon next to the VPC you want to detach. + + A pop-up displays, confirming that this action will detach the VPC, and the InterLink will not be connected to any Scaleway resources until you reattach a VPC. + + + If route propagation was activated, it will be automatically deactivated when you detach the VPC. + + +4. Click **Detach VPC**. + + The VPC is detached, and you are returned to the InterLink's **Overview** page. No traffic can currently flow over the InterLink, and all associated routes are removed from the VPC's route table. + + Follow the next steps to attach another VPC. + +5. In the **Attached VPC** section, click **Attach VPC**. A pop-up displays: + + + +6. Select one of your existing VPCs from the dropdown list. It must be in the same region as the InterLink. Alternatively, click **+ Create VPC** to create and attach a new VPC. + + + Ensure that the routing policy attached to the InterLink is suitable for the VPC you are attaching. Remember that the outgoing routes in the policy should correspond to the route announcements to whitelist from the VPC itself. + + +7. Click **Attach VPC**. + + The VPC is attached and you are returned to the InterLink's **Overview** page. Remember to check the routing policy and activate route propagation so that traffic can flow across the InterLink. + +### How to change the attached routing policy + +1. Click **InterLink** in the **Network** section of the [Scaleway console](https://console.scaleway.com) side menu. A listing of your InterLinks displays. + +2. Click on the InterLink that you want to configure. The InterLink's **Overview** page displays. + +3. In the **Route propagation** section, click the three dot icon next to the routing policy you want to detach. Then click **Detach policy** in the menu that displays. + + A pop-up confirms that this action will detach the current policy from your InterLink. If route propagation was active, it will be automatically deactivated because with no attached routing policy, the default rule will block the propagation of any new or updated routes. + +4. Click **Detach policy**. + + The policy is detached, and you are returned to your InterLink's Overview page. + +5. In the **Route propagation** section, under **Routing policy** click **+** to add a new policy. See the dedicated documentation on [creating and attaching a routing policy](/interlink/how-to/create-routing-policy/) for a step by step guide. + +### How to edit an existing routing policy + +1. Click **InterLink** in the **Network** section of the [Scaleway console](https://console.scaleway.com) side menu. A listing of your InterLinks displays. + +2. Click on the InterLink that you want to configure. The InterLink's **Overview** page displays. + +3. In the **Route propagation** section, click the three dot icon next to the routing policy. Then click **Edit policy** in the menu that displays. + + + You can also edit routing policies from their dedicated tab in the console, including policies that aren't currently attached to an InterLink. + + + The **Edit routing policy** wizard displays. See the dedicated documentation on [creating and attaching a routing policy](/interlink/how-to/create-routing-policy/) for help with routing policies. + +4. Make the required edits, and click **Edit routing policy** + + A warning displays, to remind you that modifications will immediately be propagated on InterLinks using this policy. + +5. Click **Save**. + +The policy is modified and modifications are immediately applied. + +### How to deactivate route propagation + +1. Click **InterLink** in the **Network** section of the [Scaleway console](https://console.scaleway.com) side menu. A listing of your InterLinks displays. + +2. Click on the InterLink that you want to configure. The InterLink's **Overview** page displays. + +3. In the **Route propagation** section, use the toggle to turn route propagation **OFF**. + + A pop-up displays, confirming that this action will turn off route propagation. All existing InterLink routes will be removed from the VPC route table. Traffic will not be able to flow over the InterLink until route propagation is reactivated. + +4. Click **Deactivate**. + + Route propagation is deactivated, and you are returned to your InterLink's overview page. diff --git a/pages/interlink/how-to/create-routing-policy.mdx b/pages/interlink/how-to/create-routing-policy.mdx new file mode 100644 index 0000000000..c6c5b87777 --- /dev/null +++ b/pages/interlink/how-to/create-routing-policy.mdx @@ -0,0 +1,60 @@ +--- +meta: + title: How to create a routing policy + description: Find out how to create a routing policy for your Scaleway InterLink. Whitelist incoming and outgoing route announcements, so that traffic can flow securely over your InterLink. +content: + h1: How to create a routing policy + paragraph: Find out how to create a routing policy for your Scaleway InterLink. Whitelist incoming and outgoing route announcements, so that traffic can flow securely over your InterLink. +dates: + validation: 2025-03-18 + posted: 2025-03-18 +tags: interlink direct-connect allowed-routes route-propagation whitelist range IP announcements BGP +categories: + - network +--- + + +InterLink is currently in [Public Beta](https://www.scaleway.com/en/betas/). + + +InterLink uses [**B**order **G**ateway **P**rotocol](/interlink/concepts/#border-gateway-protocol-bgp) to exchange routing information between the customer’s infrastructure and the Scaleway VPC. Each side advertises IP prefixes for its own internal subnets and resources, to allow the other side to dynamically learn and update its internal routes, facilitating efficient traffic flow. However, by default, **all routes across an InterLink are blocked**. You must create and attach a [routing policy](/interlink/concepts/#routing-policy), to set IP prefix filters for the route advertisements you want to whitelist. This facilitates traffic flow across the InterLink. + +When creating a routing policy, 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. When [route propagation](#route-propagation) is activated, the route ranges defined in the routing policy are whitelisted, and traffic can flow across the InterLink along these routes. + +Learn more about routing across an InterLink in our [detailed overview](/interlink/reference-content/overview/#routing-across-an-interLink). + +## How to create a routing policy + +1. Click **InterLink** in the **Network** section of the [Scaleway console](https://console.scaleway.com) side menu. A listing of your InterLinks displays. + +2. Click the **Routing policies** tab. A listing of your routing policies displays. + +3. Click **+Create routing policy**. The **Create a routing policy** wizard displays. + + + +4. Enter a name for the policy, or leave the randomly-generated name in place. + +5. Choose a region for the policy. It can only be attached to InterLinks within the same region. + +6. Whitelist the outgoing routes to allow. For each entry: + - Select whether it is of type IPv4 or IPv6. + - Enter an IP prefix to define a range of route announcements to whitelist, e.g. `172.16.4.0/22`. + - Click **Add** when complete. + + + Routes within these destinations will be propagated, allowing traffic from your external infrastructure to be routed via InterLink to your VPC. 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`. + + IPv4 and IPv6 routes must be defined separately. + + +7. Whitelist the incoming routes to allow, in the same way you did for outgoing routes. Outgoing routes concern announcements to accept from the external infrastructure. Traffic can be routed via InterLink from your Scaleway VPC to your external infrastructure along these routes. + +8. Click **Create routing policy**. +The policy is created, and you are returned to the listing of your routing policies. + +Remember to [attach the policy to an InterLink](/interlink/how-to/configure-interlink/#how-to-attach-a-routing-policy) for it to take effect. Each InterLink can have one routing policy attached to it, but a single routing policy can be attached to multiple InterLinks, if desired. + + +See our dedicated documentation on using [BGP communities](/interlink/reference-content/bgp-communities/) to influence route priority for InterLink traffic. + \ No newline at end of file diff --git a/pages/interlink/how-to/delete-interlink.mdx b/pages/interlink/how-to/delete-interlink.mdx new file mode 100644 index 0000000000..ed2cac806d --- /dev/null +++ b/pages/interlink/how-to/delete-interlink.mdx @@ -0,0 +1,46 @@ +--- +meta: + title: How to delete an InterLink + description: Learn how to delete a Scaleway InterLink so that it is correctly deprovisioned on both the Scaleway side and the partner side. Follow our step by step guide. +content: + h1: How to delete an InterLink + paragraph: Learn how to delete a Scaleway InterLink so that it is correctly deprovisioned on both the Scaleway side and the partner side. Follow our step by step guide. +dates: + validation: 2025-03-18 + posted: 2025-03-18 +tags: interlink direct-connect allowed-routes routing-policy route-propagation whitelist range IP announcements BGP +categories: + - network +--- + + +InterLink is currently in [Public Beta](https://www.scaleway.com/en/betas/). + + +You can delete your InterLink at any time. Action is required on both the Scaleway side and the partner side to completely deprovision the InterLink. Follow the steps below. + +## How to delete an InterLink + +1. Click **InterLink** in the **Network** section of the [Scaleway console](https://console.scaleway.com) side menu. A listing of your InterLinks displays. + +2. Click on the InterLink that you want to delete. The InterLink's **Overview** page displays. + + + +3. [Deactivate route propagation](/interlink/how-to/configure-interlink/#how-to-deactivate-route-propagation). + +4. In the **Delete InterLink** panel, click **Delete InterLink**. + + A pop-up displays, confirming that this action will permanently delete your InterLink on the Scaleway side. + +5. Type **DELETE** in the box, and click **Delete InterLink**. + + You are returned to the InterLink's **Overview** page, where its status now shows as **Deprovisioning**. Scaleway stops billing you for your InterLink at this point, and it can no longer be configured, un-deleted, or used to route traffic. + +6. Contact your partner to request that they delete the InterLink resource on their side. They may continue to bill you until you do so, and they deprovision the resource on their side. To get in touch with the partner, you can use the same contact information that you used when [requesting the InterLink from the partner](/interlink/how-to/complete-provisioning/). + + +If the provisioning of your InterLink by the partner was never completed, e.g. you a) never contacted the partner to request provisioning of the InterLink, or b) the partner refused to provision your InterLink, you do not need to contact the partner again to request that they deprovision the resource. Deleting it on the Scaleway side is sufficient. + + +When the InterLink is fully deprovisioned on both sides, it will be deleted from the list of your InterLinks, and its Overview page will no longer be accessible. diff --git a/pages/interlink/how-to/index.mdx b/pages/interlink/how-to/index.mdx new file mode 100644 index 0000000000..d58adcbdb3 --- /dev/null +++ b/pages/interlink/how-to/index.mdx @@ -0,0 +1,9 @@ +--- +meta: + title: InterLink - How Tos + description: Learn how to set up and optimize Scaleway InterLink. These how to guides take you from ordering your InterLink, to completing the provisioning process, and all the configuration you need to get the direct connection between your Scaleway VPC and external or on-premises infrastructure, up and running. + noindex: true +content: + h1: InterLink - How Tos + paragraph: Learn how to set up and optimize Scaleway InterLink. These how to guides take you from ordering your InterLink, to completing the provisioning process, and all the configuration you need to get the direct connection between your Scaleway VPC and external or on-premises infrastructure, up and running. +--- diff --git a/pages/interlink/how-to/order-interlink.mdx b/pages/interlink/how-to/order-interlink.mdx new file mode 100644 index 0000000000..bbc411cc8f --- /dev/null +++ b/pages/interlink/how-to/order-interlink.mdx @@ -0,0 +1,66 @@ +--- +meta: + title: How to order an InterLink + description: Learn how to order a hosted InterLink connection to your Scaleway cloud infrastructure via your chosen partner. Step-by-step guide included. +content: + h1: How to order an InterLink + paragraph: Learn how to order a hosted InterLink connection to your Scaleway cloud infrastructure via your chosen partner. Step-by-step guide included. +dates: + validation: 2025-03-18 + posted: 2025-03-18 +tags: interlink direct-connect order hosted partner pop location +categories: + - network +--- + + +InterLink is currently in [Public Beta](https://www.scaleway.com/en/betas/). + + +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. + +Currently, InterLink is available in **hosted** version only. This means that you must choose a compatible [partner](/interlink/concepts/#partner) to facilitate the physical connection between the external infrastructure and the Scaleway VPC. + + + +This guide takes you through the process of ordering an InterLink via the Scaleway console. + + + +- A Scaleway account logged into the [console](https://console.scaleway.com) +- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization + +## How to order an InterLink + +1. Click **InterLink** in the **Network** section of the [Scaleway console](https://console.scaleway.com) side menu. If you have not already created an InterLink, the product ordering page is displayed. + +2. Click **Order InterLink**. The order wizard displays. + + + +3. Select a [connection type](/interlink/concepts/#connection-type), the type of physical InterLink connection. For now, only **hosted** connections are available. + +4. Select a [partner](/interlink/concepts/#partner). To establish an InterLink connection via a partner, generally you must be a client of that partner, e.g. with your infrastructure in their datacenter, or on your own premises using the partner as a network provider. [Get help with choosing a partner](/interlink/reference-content/overview/#hosted-interlinks). + +5. Choose a [region](/interlink/concepts/#region) for your InterLink. This must correspond to the Scaleway VPC you want to attach later. + +6. Choose a [location](/interlink/concepts/#location) for your InterLink. This represents the physical location where the connection to Scaleway's network will be established. + +7. Choose a [bandwidth](/interlink/concepts/#bandwidth) amount. This represents the maximum bandwidth that will be available over the InterLink. + +8. Enter a name and optional tags for your InterLink. + +9. Check the estimated cost for your InterLink. Note that Scaleway will start billing you for the InterLInk as soon as you order it. You must then wait for your partner to provision the connection, who may charge you additional fees. + +10. Click **Order InterLink**. + +Your InterLink is ordered, and its status briefly shows as `Configuring`, then `Requested`. **You must now contact your chosen partner to request they provision your InterLink from their end.** + + + +For full details of the provisioning process, including how to contact your partner and what other steps you need to take, see the page [How to complete InterLink provisioning](/interlink/how-to/complete-provisioning/). + + +If you see a `Failed` status, it means there was a configuration error on the Scaleway side as we attempted to create the InterLink. Our technical team is automatically made aware of such a problem, and will intervene to resolve it. When the problem is resolved, the InterLink should automatically move to `Requested` status, and you can proceed to [completing provisioning](/interlink/how-to/complete-provisioning/). If you have any concerns, open a support ticket. + + diff --git a/pages/interlink/index.mdx b/pages/interlink/index.mdx index f9ec0575fe..70b030e0ad 100644 --- a/pages/interlink/index.mdx +++ b/pages/interlink/index.mdx @@ -2,15 +2,14 @@ meta: title: InterLink Documentation description: Dive into Scaleway InterLink with our quickstart guides, how-tos, tutorials and more. - noindex: true --- - InterLink is currently available in [Private Beta](https://www.scaleway.com/en/betas/) only, for selected testers. Watch this space for more information on public availability. - + InterLink is now available in [Public Beta](https://www.scaleway.com/en/betas/). Check it out on the [Scaleway console](https://console.scaleway.com/interlink/) or [API](https://www.scaleway.com/en/developers/api/interlink/), and order your InterLink today. + - + + diff --git a/pages/interlink/quickstart.mdx b/pages/interlink/quickstart.mdx new file mode 100644 index 0000000000..bcb78ed0ab --- /dev/null +++ b/pages/interlink/quickstart.mdx @@ -0,0 +1,185 @@ +--- +meta: + title: InterLink - Quickstart + description: Get started with Scaleway InterLink in minutes. Follow this quickstart guide to order, provision and configure your InterLink to get traffic flowing as soon as possible. +content: + h1: InterLink - Quickstart + paragraph: Get started with Scaleway InterLink in minutes. Follow this quickstart guide to order, provision and configure your InterLink to get traffic flowing as soon as possible. +tags: load-balancer load balancer frontend backend +dates: + validation: 2025-03-18 + posted: 2025-03-18 +categories: + - network +--- + + +InterLink is currently in [Public Beta](https://www.scaleway.com/en/betas/). + + +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. + + + + + +- A Scaleway account logged into the [console](https://console.scaleway.com) +- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization + +## How to order an InterLink + + + +1. Click **InterLink** in the **Network** section of the [Scaleway console](https://console.scaleway.com) side menu. If you have not already created an InterLink, the product ordering page is displayed. + +2. Click **Order InterLink**. The order wizard displays. + + + +3. Select a [connection type](/interlink/concepts/#connection-type), the type of physical InterLink connection. For now, only **hosted** connections are available. + +4. Select a [partner](/interlink/concepts/#partner) to facilitate the physical connection between the external infrastructure and the Scaleway VPC. Generally, you must be client of the chosen partner, e.g. with your infrastructure in their datacenter, or on your own premises using the partner as a network provider. [Get help with choosing a partner](/interlink/reference-content/overview/#hosted-interlinks). + +5. Choose a [region](/interlink/concepts/#region) for your InterLink. This must correspond to the Scaleway VPC you want to attach later. + +6. Choose a [location](/interlink/concepts/#location) for your InterLink. This represents the physical location where the connection to Scaleway's network will be established. + +7. Choose a [bandwidth](/interlink/concepts/#bandwidth) amount. This represents the maximum bandwidth that will be available over the InterLink. + +8. Enter a name and optional tags for your InterLink. + +9. Check the estimated cost for your InterLink. Note that Scaleway will start billing you for the InterLInk as soon as you order it. You must then wait for your partner to provision the InterLink, who may charge you additional fees. + +10. Click **Order InterLink**. + +Your InterLink is ordered, and its status briefly shows as `Configuring`, then `Requested`. **You must now contact your chosen partner to request they provision your InterLink from their end.** + +## How to complete InterLink provisioning. + +1. Click **InterLink** in the **Network** section of the [Scaleway console](https://console.scaleway.com) side menu. A listing of your InterLinks displays. + +2. Click on the InterLink that you want to finish provisioning. The InterLink's **Overview** page displays. + + + +3. Note down the [pairing key](/interlink/concepts/#pairing-key) for your InterLink. This is a unique identification number which the partner will need in order to provision your InterLink. + +4. Contact your partner. After [creating your InterLink order](/interlink/how-to/order-interlink/), either their online portal URL, or their email address was displayed to you for this purpose. Use the relevant method to contact your partner, provide the pairing key, and request that they provision your InterLink from their side. + + +You can also use the [Get a partner](https://www.scaleway.com/en/developers/api/interlink/#path-partners-get-a-partner) endpoint in the API to get contact details and other information about your selected partner. + + +Your InterLink will remain in `Requested` status until the partner responds to your request. You can keep track of your InterLink's [status](/interlink/reference-content/statuses/) via the [InterLink listing](https://console.scaleway.com/interlink/links) in the Scaleway console. + + + +When the partner approves your request, the InterLink moves to `Provisioning` status. This means that the partner has agreed to facilitate your InterLink, and is now preparing the resources and configuration necessary to do so. + +When the partner has finished provisioning your InterLink, it moves to `Active` status. This indicates that the physical link and necessary accompanying configuration has been completed on the partner's side, and your InterLink is ready for use. + + +If you experience any unexpected statuses, refer to our [information page on InterLink statuses](/interlink/reference-content/statuses/) for full explanation and guidance. + + +## How to configure your InterLink + +After your InterLink has been provisioned, a number of configuration steps are necessary to enable traffic to flow over the InterLink. + + + +### How to attach a VPC + +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. + +1. Click **InterLink** in the **Network** section of the [Scaleway console](https://console.scaleway.com) side menu. A listing of your InterLinks displays. + +2. Click on the InterLink that you want to configure. The InterLink's **Overview** page displays. + + + +3. In the **Attached VPC** section, click **Attach VPC**. A pop-up displays: + + + +4. Select one of your existing VPCs from the dropdown list. It must be in the same region as the InterLink. Alternatively, click **+ Create VPC** to create and attach a new VPC. + + + 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. + + +5. Click **Attach VPC** + + The VPC is attached and you are returned to the InterLink's **Overview** page. + +### How to attach a routing policy + +After attaching a VPC, the next step in configuring your InterLink is to create and attach a routing policy. + +The VPC and the external infrastructure's routers both announce their routes to each other via [BGP](/interlink/concepts/#border-gateway-protocol-bgp) when route propagation is activated, but all of these routes are blocked by default. Routing policies let you whitelist ranges of route announcements to allow, so that traffic can flow along these routes across the InterLink. + +Each InterLink can have one routing policy attached to it, but a single routing policy can be attached to multiple InterLinks, if desired. + +See the dedicated documentation on [creating a routing policy](/interlink/how-to/create-routing-policy/), then follow these instructions to attach it: + +1. Click **InterLink** in the **Network** section of the [Scaleway console](https://console.scaleway.com) side menu. A listing of your InterLinks displays. + +2. Click on the InterLink that you want to configure. The InterLink's **Overview** page displays. + +3. In the **Route propagation** section, click **Attach routing policy**. A pop-up displays. + + + +4. Select a routing policy from the drop-down list, and click **Attach list**. + + + Make sure that the routing policy is suitable for the incoming routes (announced by the Scaleway VPC) and outgoing routes (announced by the external infrastructure) that should be propagated on this InterLink. + + +The policy is attached, ad you are returned to the InterLink's **Overview** page. + +### How to activate route propagation + +Once you have attached a VPC and attached a routing policy, you can activate route propagation. This is the final step in configuring your InterLink so that traffic can flow between the VPC and your external infrastructure: it triggers the dynamic exchange of route information between the VPC and external infrastructure. + +1. Click **InterLink** in the **Network** section of the [Scaleway console](https://console.scaleway.com) side menu. A listing of your InterLinks displays. + +2. Click on the InterLink that you want to configure. The InterLink's **Overview** page displays. + +3. In the **Route propagation** section, use the toggle to turn route propagation **ON**. + + A pop-up displays, showing the attached routing policy which will define the incoming and outgoing route announcements to accept. You can change the attached routing policy if you wish. + + It is not possible to activate route propagation without attaching a routing policy, as all route announcements would be blocked, rendering the action ineffective. + +4. Click **Activate route propagation**. + + Route propagation is activated, and you are returned to your InterLink's overview page. + + While route propagation remains active, traffic can flow across the routes allowed over the InterLink. The VPC and external infrastructure will dynamically exchange and update route information. You can deactivate route propagation at any time: if you do so, all routes are blocked and no traffic can flow. + +## How to delete an InterLink + +You can delete your InterLink at any time. Action is required on both the Scaleway side and the partner side to completely deprovision the InterLink. Follow the steps below. + +1. Click **InterLink** in the **Network** section of the [Scaleway console](https://console.scaleway.com) side menu. A listing of your InterLinks displays. + +2. Click on the InterLink that you want to delete. The InterLink's **Overview** page displays. + +3. [Deactivate route propagation](/interlink/how-to/configure-interlink/#how-to-deactivate-route-propagation). + +4. In the **Delete InterLink** panel, click **Delete InterLink**. + + A pop-up displays, confirming that this action will permanently delete your InterLink on the Scaleway side. + +5. Type **DELETE** in the box, and click **Delete InterLink**. + + You are returned to the InterLink's **Overview** page, where its status now shows as **Deprovisioning**. Scaleway stops billing you for your InterLink at this point, and it can no longer be configured, un-deleted, or used to route traffic. + +6. Contact your partner to request that they delete the InterLink resource on their side. They may continue to bill you until you do so, and they deprovision the resource on their side. To get in touch with the partner, you can use the same contact information that you used when [requesting the InterLink from the partner](/interlink/how-to/complete-provisioning/). + + +If the provisioning of your InterLink by the partner was never completed, e.g. you a) never contacted the partner to request provisioning of the InterLink, or b) the partner refused to provision your InterLink, you do not need to contact the partner again to request that they deprovision the resource. Deleting it on the Scaleway side is sufficient. + + +When the InterLink is fully deprovisioned on both sides, it will be deleted from the list of your InterLinks, and its Overview page will no longer be accessible. diff --git a/pages/interlink/reference-content/assets/scaleway-interlink-config.webp b/pages/interlink/reference-content/assets/scaleway-interlink-config.webp index e226b9b417..6454339bc6 100644 Binary files a/pages/interlink/reference-content/assets/scaleway-interlink-config.webp and b/pages/interlink/reference-content/assets/scaleway-interlink-config.webp differ diff --git a/pages/interlink/reference-content/bgp-communities.mdx b/pages/interlink/reference-content/bgp-communities.mdx new file mode 100644 index 0000000000..b3de4d1e6b --- /dev/null +++ b/pages/interlink/reference-content/bgp-communities.mdx @@ -0,0 +1,31 @@ +--- +meta: + title: Using BGP communities with InterLink + description: Learn how to use BGP communities to set local preference for incoming traffic via Scaleway InterLink. +content: + h1: Using BGP communities with InterLink + paragraph: Learn how to use BGP communities to set local preference for incoming traffic via Scaleway InterLink. +tags: interlink configuration border-gateway-protocol bgp-tags local-preference local-pref +categories: + - interlink + - network +dates: + validation: 2025-03-26 + posted: 2025-03-26 +--- + +A **B**order **G**ateway **P**rotocol (BGP) community is a group of IP prefixes that share a common attribute. + +Scaleway recognizes three BGP communities, and applies routing priorities based on the community applied. This lets you influence routing between the various Interlinks in a VPC, for traffic flowing from Scaleway to your external network. + +For each prefix that you advertise from your external/on-premises router over a BGP session, you can apply one of the following community tags to indicate the priority of the associated path for returning traffic: + +- `12876:42050` — Low preference +- `12876:42100` — Medium preference +- `12876:42200` — High preference + +These BGP communities are evaluated in order from lowest to highest preference, where the highest preference is preferred. They are mutually exclusive, meaning you can only apply one of them per prefix. + +To apply these communities, you must configure your BGP router or software to add the appropriate community to the routes you advertise. + +You cannot add communities to prefixes advertised by your Scaleway VPC towards your external/on-premises router. \ No newline at end of file diff --git a/pages/interlink/reference-content/configuring.mdx b/pages/interlink/reference-content/configuring.mdx index 74a423e8c9..94e96e8a89 100644 --- a/pages/interlink/reference-content/configuring.mdx +++ b/pages/interlink/reference-content/configuring.mdx @@ -1,22 +1,21 @@ --- meta: title: Configuring an InterLink - 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. - noindex: true + 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 a routing policy to whitelist route announcements, and activate route propagation across the connection. content: h1: Configuring an InterLink - 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. + 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 a routing policy to whitelist route announcements, and activate route propagation across the connection. tags: interlink configuration attach-vpc whitelist route-range ip-prefix route-propagation categories: - interlink - network dates: - validation: 2024-10-24 + validation: 2025-03-18 posted: 2024-10-24 --- - -InterLink is currently in [Private Beta](https://www.scaleway.com/en/betas/), and only available to selected testers. + +InterLink is currently in [Public Beta](https://www.scaleway.com/en/betas/). Once your InterLink has been created and the [provisioning process](/interlink/reference-content/provisioning/) is complete, you must complete a number of configuration steps to enable traffic to flow across the InterLink. @@ -25,7 +24,7 @@ This document explains the process in full, and gives tips for troubleshooting a ## Configuration overview - + 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. @@ -43,24 +42,22 @@ Attaching an InterLink to a VPC allows you to complete the connection from your The VPC must be in the same 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. -You can use the [Attach a VPC](https://www.scaleway.com/en/developers/api/interlink/#path-links-attach-a-vpc) endpoint to attach a VPC to a given InterLink. +Follow the instructions for [attaching a VPC via the console](/interlink/how-to/configure-interlink/#how-to-attach-a-vpc), or use the [Attach a VPC](https://www.scaleway.com/en/developers/api/interlink/#path-links-attach-a-vpc) endpoint of the API. -### 3. Attach allowed routes list (routing policy) +### 3. Attach routing policy -InterLink uses [**B**order **G**ateway **P**rotocol](https://en.wikipedia.org/wiki/Border_Gateway_Protocol) to exchange routing information between the customer’s infrastructure and the Scaleway VPC. Each side advertises IP prefixes for its own internal subnets and resources, to allow the other side to dynamically learn and update its internal routes, facilitating efficient traffic flow. However, by default, **all routes across an InterLink are blocked** . You must create and attach an [allowed routes list](/interlink/concepts/#allowed-routes-list) aka routing policy, to set IP prefix filters for the route advertisements you want to whitelist. This facilitates traffic flow across the InterLink. +InterLink uses [**B**order **G**ateway **P**rotocol](https://en.wikipedia.org/wiki/Border_Gateway_Protocol) to exchange routing information between the customer’s infrastructure and the Scaleway VPC. Each side advertises IP prefixes for its own internal subnets and resources, to allow the other side to dynamically learn and update its internal routes, facilitating efficient traffic flow. However, by default, **all routes across an InterLink are blocked**. You must create and attach a [routing policy](/interlink/concepts/#routing-policy) aka routing policy, to set IP prefix filters for the route advertisements you want to whitelist. This facilitates traffic flow across the InterLink. -You can [create](https://www.scaleway.com/en/developers/api/interlink/#path-routing-policies-create-a-routing-policy) and [attach](https://www.scaleway.com/en/developers/api/interlink/#path-links-attach-a-routing-policy) allowed routes lists via the API. +Follow the instructions and tips for [creating a routing policy](/interlink/how-to/create-routing-policy/), via the console. Alternatively, you can [create](https://www.scaleway.com/en/developers/api/interlink/#path-routing-policies-create-a-routing-policy) and [attach](https://www.scaleway.com/en/developers/api/interlink/#path-links-attach-a-routing-policy) routing policies via the API. -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`. +See our dedicated documentation on using [BGP communities](/interlink/reference-content/bgp-communities/) to influence route priority for InterLink traffic. -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. +### 4. Activate route propagation -### 4. Activate route propagation. +Once you have attached a VPC and defined the routing policy, you must activate route propagation to allow traffic to flow over the InterLink. This enables all prefixes whitelisted in your routing policy to be announced in the BGP session, so that traffic can flow along these routes. See the documentation for activating route propagation via the [API](https://www.scaleway.com/en/developers/api/interlink/#path-links-enable-route-propagation) or the [console](/interlink/how-to/configure-interlink/#how-to-activate-route-propagation) -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/#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. - - -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](/interlink/concepts/#allowed-routes-list) to the InterLink to allow traffic to flow. + +Even when route propagation is activated, remember that all routes are blocked by default. It is essential to attach a routing policy to the InterLink to allow traffic to flow. -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. +You can deactivate route propagation 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. \ No newline at end of file diff --git a/pages/interlink/reference-content/overview.mdx b/pages/interlink/reference-content/overview.mdx index 6cfadb998b..da1b384d99 100644 --- a/pages/interlink/reference-content/overview.mdx +++ b/pages/interlink/reference-content/overview.mdx @@ -2,27 +2,25 @@ meta: title: InterLink - Technical overview description: Dive deeper into understanding Scaleway's InterLink product, with technical diagrams, explanations and more. - noindex: true content: h1: InterLink - Technical overview paragraph: Dive deeper into understanding Scaleway's InterLink product, with technical diagrams, explanations and more. - noindex: true tags: interlink pop infrastructure diagram technical overview categories: - interlink - network dates: - validation: 2024-10-24 + validation: 2025-03-18 posted: 2024-10-24 --- - -InterLink is currently in [Private Beta](https://www.scaleway.com/en/betas/), and only available to selected testers. + +InterLink is currently in [Public Beta](https://www.scaleway.com/en/betas/). 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. Compared to a typical internet-based VPN, an InterLink is more reliable, more secure and offers lower latency. -At its simplest level, InterLink can be understood as a configurable connection between your own infrastructure, and your Scaleway VPC. You can configure details such as available bandwidth, and the routes allowed between the two peers: +At its simplest level, InterLink can be understood as a configurable connection between your own infrastructure, and your Scaleway VPC. You can configure details such as available bandwidth, and the routing policy between the two peers: @@ -36,6 +34,10 @@ A hosted InterLink is provisioned via a [partner](/interlink/concepts/#partner). By choosing a hosted InterLink, you can re-use existing connectivity between a PoP where both you and the partner are present, and the Scaleway network. Layer 2 isolation to your Scaleway VPC is preserved, with guaranteed bandwidth (100Mbps - 25Gbps) across the InterLink. +#### How to choose a partner + +To establish an InterLink connection via a partner, generally you must be a client of that partner, e.g. with your infrastructure in their data center, or on your own premises using the partner as a network provider. + The diagram below shows the architecture of a hosted InterLink. Note that three possibilities are available on the customer side: - The partner's router connects to the customer's router (itself connected to the customer's on-premises infrastructure) via a **M**eet **M**e **R**oom at a PoP where both networks are present. - The partner's router connects directly to the customer's on-premises infrastructure via a last-mile connection facilitated by the partner. @@ -43,9 +45,9 @@ The diagram below shows the architecture of a hosted InterLink. Note that three -### Dedicated InterLink +### Self-hosted InterLink -A dedicated InterLink is provisioned, where the customer gets sole use of a single InterLink port on Scaleway's router, with the entire bandwidth of that port. This type of InterLink is not yet available at Scaleway - [contact a sales representative](https://www.scaleway.com/en/contact-sales/) to register your interest. +A self-hosted InterLink is provisioned, where the customer gets sole use of a single InterLink port on Scaleway's router, with the entire bandwidth of that port. The customer can use available bandwidth of this dedicated physical connection to provision several InterLinks for themselves. This type of InterLink is not yet available at Scaleway - [contact a sales representative](https://www.scaleway.com/en/contact-sales/) to register your interest. ## Provisioning an InterLink @@ -55,22 +57,22 @@ Provisioning an InterLink is a multi-step process. As only hosted InterLinks (vi When you initially create the InterLink, it is not associated with a specific VPC, only with a given Scaleway region. Attaching it to a VPC within the specified region is essential to complete the connection on the Scaleway side. You can only attach a VPC once the provisioning process is complete, and the InterLink has `Active` status. See the [configuration](/interlink/reference-content/configuring/) page for more information. -While each InterLink can only be attached to a single Scaleway VPC, it is possible to attach two InterLinks to the same VPC to ensure redundancy and high availability. In this case, each InterLink must be provisioned and configured separately, and will be billed separately. Note that you can reuse the same [allowed routes lists](#allowed-routes-list) across multiple InterLinks. +While each InterLink can only be attached to a single Scaleway VPC, it is possible to attach two InterLinks to the same VPC to ensure redundancy and high availability. In this case, each InterLink must be provisioned and configured separately, and will be billed separately. Note that you can reuse the same [routing policies](#routing-policy) across multiple InterLinks. ## Routing across an InterLink -InterLink uses [**B**order **G**ateway **P**rotocol](https://en.wikipedia.org/wiki/Border_Gateway_Protocol) to exchange routing information between the customer’s network and the Scaleway VPC. +InterLink uses [**B**order **G**ateway **P**rotocol](/interlink/concepts/#border-gateway-protocol-bgp) to exchange routing information between the customer’s network and the Scaleway VPC. -Each side advertises IP prefixes for its own internal subnets and resources, to allow the other side to dynamically learn and update its internal routes. This facilitates efficient traffic flow across the link towards these destinations, providing that [allowed routes](#allowed-routes-list) and [route propagation](#route-propagation) have been correctly set up. +Each side advertises IP prefixes for its own internal subnets and resources, to allow the other side to dynamically learn and update its internal routes. This facilitates efficient traffic flow across the link towards these destinations, providing that [routing policies](#routing-policies) and [route propagation](#route-propagation) have been correctly set up. In fact, each InterLink has two BGP sessions: one for IPv4 and one for IPv6. Each session handles the exchange of IP prefixes for its respective IP version. The separation of these sessions ensures that IPv4 and IPv6 traffic can be managed independently, and provides compatibility with networks that may only support one of the IP versions. When both BGP sessions are up, the InterLink has `Active` status. If one BGP session is up, and the other down, the status moves to `Limited Connectivity`. If both BGP sessions are down, the status is marked as `Down`. See the page on [InterLink statuses](/interlink/reference-content/statuses) for full information. -### Allowed routes list +### Routing policies -By default, **all route announcements from both sides are blocked** by InterLink. This is part of a safety-net mechanism to allow customers to efficiently and safely control traffic flow across the link. You must create and attach an [allowed routes list](/interlink/concepts/#allowed-routes-list) (aka routing policy), to specify the IP prefix announcements to whitelist from each side. This is step one of two in allowing traffic to flow across the InterLink. See the [configuration](/interlink/reference-content/configuring/) page for more information on allowed routes lists. +By default, **all route announcements from both sides are blocked** by InterLink. This is part of a safety-net mechanism to allow customers to efficiently and safely control traffic flow across the link. You must create and attach a [routing policy](/interlink/concepts/#routing-policy), to specify the IP prefix announcements to whitelist from each side. This is step one of two in allowing traffic to flow across the InterLink. See the [configuration](/interlink/reference-content/configuring/) page for more information on routing policies. ### Route propagation -Even after attaching an allowed route list, traffic cannot flow across your InterLink until you **activate route propagation**. This is the second part of the safety-net mechanism enabling you to fine-tune the traffic that flows across your InterLink. Route propagation can be activated or deactivated whenever you want. See the [configuration](/interlink/reference-content/configuring/) page for more information on route propagation. +Even after attaching a routing policy, traffic cannot flow across your InterLink until you **activate route propagation**. This is the second part of the safety-net mechanism enabling you to fine-tune the traffic that flows across your InterLink. Route propagation can be activated or deactivated whenever you want. See the [configuration](/interlink/reference-content/configuring/) page for more information on route propagation. \ No newline at end of file diff --git a/pages/interlink/reference-content/provisioning.mdx b/pages/interlink/reference-content/provisioning.mdx index 3a3fa23b6f..6139877cf8 100644 --- a/pages/interlink/reference-content/provisioning.mdx +++ b/pages/interlink/reference-content/provisioning.mdx @@ -2,7 +2,6 @@ meta: title: Provisioning an InterLink description: Get help with understanding all the different stages of ordering and provisioning a Scaleway InterLink, from placing the initial order, to dealing with error messages, and deleting the resource if no longer needed. - noindex: true content: h1: Provisioning an InterLink paragraph: Get help with understanding all the different stages of ordering and provisioning a Scaleway InterLink, from placing the initial order, to dealing with error messages, and deleting the resource if no longer needed. @@ -11,12 +10,12 @@ categories: - interlink - network dates: - validation: 2024-10-24 + validation: 2025-03-18 posted: 2024-10-24 --- - -InterLink is currently in [Private Beta](https://www.scaleway.com/en/betas/), and only available to selected testers. + +InterLink is currently in [Public Beta](https://www.scaleway.com/en/betas/). The process of ordering an InterLink has multiple stages: action is required both from Scaleway, the user, and from the selected [partner](/interlink/concepts/#partner). When preparing your InterLink order, you must choose appropriate location (aka **P**oint **o**f **P**resence), partner and region settings to ensure compatibility with your external and Scaleway infrastructure. @@ -35,10 +34,10 @@ For full information about different statuses an InterLink might flow through, s ### 1. User orders InterLink via Scaleway -The order process begins when you order an InterLink via the Scaleway [InterLink API](https://www.scaleway.com/en/developers/api/interlink/) (or, coming soon, via the [Scaleway console](https://console.scaleway.com/) or one of our other [developer tools](https://www.scaleway.com/en/developers/)). To order via the API, use the [Create a link](https://www.scaleway.com/en/developers/api/interlink/#path-links-create-a-link) call. You need to set the following parameters when ordering: +The order process begins when you order an InterLink via the Scaleway [InterLink API](https://www.scaleway.com/en/developers/api/interlink/) or the [Scaleway console](/interlink/how-to/order-interlink/), or one of our other [developer tools](https://www.scaleway.com/en/developers/). When ordering, you set the following parameters: -- **Connection type**: In the long term, dedicated, shared and hosted InterLinks will be available. For now, only **hosted** connections (facilitated via a partner) are available. -- **Partner**: The third-party service provider to facilitate the InterLink. Use the [List available partners](https://www.scaleway.com/en/developers/api/interlink/#path-partners-list-available-partners) call to find available partners. +- **Connection type**: In the long term, both hosted and self-hosted InterLinks will be available. For now, only **hosted** connections (facilitated via a partner) are available. +- **Partner**: The third-party service provider to facilitate the InterLink. A list of available partners is shown in the console, or for the API you can Use the [List available partners](https://www.scaleway.com/en/developers/api/interlink/#path-partners-list-available-partners) call. - **Region**: The region in which to create the InterLink. It must correspond to the region of the Scaleway VPC you want to later attach to the InterLink. - **Location**: The physical **P**oint **o**f **P**resence (PoP) where the connection to Scaleway's network will be established, via the partner. - **Bandwidth**: The maximum bandwidth which you want to be available over the InterLink. @@ -48,55 +47,34 @@ The order process begins when you order an InterLink via the Scaleway [InterLink Scaleway starts charging for the InterLink as soon as your order is placed. You must then wait for the partner to provision the connection, and they may charge you additional fees. -After placing the order via the API, the ID of the InterLink is returned in the response. You can use this ID to [check the status of your InterLink](https://www.scaleway.com/en/developers/api/interlink/#path-links-get-a-link) at any time. - -Immediately after ordering, it is expected that your InterLink will briefly be in `Configuring` status, before moving to `Requested` status. - - -If you see a `Failed` status, it means there was a configuration error on the Scaleway side as we attempted to create the InterLink. Our technical team is automatically made aware of such a problem, and will intervene to resolve it. When the problem is resolved, the InterLink should automatically move to `Requested` status. If you have any concerns, open a support ticket. - +Immediately after ordering, it is expected that your InterLink will briefly be in `Configuring` status, before moving to `Requested` status. See the [statuses documentation](/interlink/reference-content/statuses/) for help with resolving any error statuses. ### 2. User requests InterLink from partner After ordering the InterLink from Scaleway, you **must** contact your chosen partner to request that they provision the connection on their side. Scaleway is not able to automatically do this step for you. -Use the [Get a partner](https://www.scaleway.com/en/developers/api/interlink/#path-partners-get-a-partner) endpoint to get information about your selected partner. Each partner provides either a contact email address, and/or the URL of their online portal. You should make contact with your partner via one of these channels. - -You should also provide the partner with your unique [pairing key](/interlink/concepts/#pairing-key), which you can get via the [Get an InterLink](https://www.scaleway.com/en/developers/api/interlink/#path-links-get-a-link) endpoint. +See [how to contact partner](/interlink/how-to/complete-provisioning/#contact-partner-to-request-interlink) for full details. -Your InterLink will remain in `Requested` status until the partner responds to your request. +Your InterLink will remain in `Requested` status until the partner responds to your request. See the [statuses documentation](/interlink/reference-content/statuses/) for help with resolving any error statuses. ### 3. Partner accepts InterLink request -When the partner approves your request, the InterLink moves to `Provisioning` status. This means that the partner has agreed to facilitate your InterLink, and is now preparing the resources and configuration necessary to establish the physical connection. - -Your InterLink will remain in `Provisioning` status until this process has been completed. +When the partner approves your request, the InterLink moves to `Provisioning` status. This means that the partner has agreed to facilitate your InterLink, and is now preparing the resources and configuration necessary to do so. - -If your InterLink does not move to `Provisioning` status, you may see one of the following statuses: - -- `Refused`: The partner did not agree to provision your InterLink. Delete this InterLink resource, and contact your partner for more information. Consider re-ordering with a different partner. -- `Expired`: Your InterLink order timed out: after 10 days, no response was received from the selected partner. Delete the InterLink resource, and create a new order if you wish to try again. - +Your InterLink will remain in `Provisioning` status until this process has been completed. See the [statuses documentation](/interlink/reference-content/statuses/) for help with resolving any error statuses. ### 4. Partner provisions InterLink -When the partner has finished provisioning your InterLink, it moves to `Active` status. This indicates that the physical link and necessary accompanying configuration has been completed on the partner's side, and your InterLink is ready for use. - -You must still configure your InterLink by attaching it to a VPC, attaching an allowed routes list, and activating route propagation, before traffic can flow over the InterLink. For help with these steps, see our documentation on [configuring your InterLink](/interlink/reference-content/configuring/). +When the partner has finished provisioning your InterLink, it moves to `Active` status. This indicates that the physical link and necessary accompanying configuration has been completed on the partner's side, and your InterLink is ready for use. See the [statuses documentation](/interlink/reference-content/statuses/) for help with resolving any error statuses. - -If you see a `Limited connectivity` status, this indicates that the partner provisioned your InterLink, but either IPv4 or IPv6 connectivity is down. Similarly, a `Down` status indicates the InterLink is provisioned, but both IPv4 **and** IPv6 connectivity are down. Open a Scaleway support ticket, or contact your partner for assistance. - -A `Locked` status indicates, again, that the InterLink was provisioned, but Scaleway Trust and Safety have locked the resource. No actions are possible from you as a user: you should open a support ticket for help and information. - +You must still configure your InterLink by attaching it to a VPC, attaching a routing policy, and activating route propagation, before traffic can flow over the InterLink. For help with these steps, see our documentation on [configuring your InterLink](/interlink/how-to/configure-interlink/). ## Deprovisioning overview -When you no longer want your InterLink connection, you can delete it. The process is as follows: +When you no longer want your InterLink, you can delete it. The process is as follows: 1. Deactivate route propagation. -2. [Delete your InterLink on the Scaleway side](https://www.scaleway.com/en/developers/api/interlink/#path-links-delete-a-link). InterLink status moves to `Deprovisioning`. +2. [Delete your InterLink on the Scaleway side](/interlink/how-to/delete-interlink/). InterLink status moves to `Deprovisioning`. 3. Contact your partner to request they deprovision the InterLink resource on their side. 4. InterLink moves to `Deleted` status once the partner has completed deprovisioning. @@ -104,4 +82,4 @@ Scaleway stops billing you for your InterLink immediately after step 2. Your par If the provisioning of your InterLink by the partner was never completed, e.g. you a) never contacted the partner to request provisioning of the InterLink, or b) the partner refused to provision your InterLink, you do not need to contact the partner again to request that they deprovision the resource. Deleting it on the Scaleway side is sufficient. - + \ No newline at end of file diff --git a/pages/interlink/reference-content/statuses.mdx b/pages/interlink/reference-content/statuses.mdx index 19819cca8a..ca1775eeac 100644 --- a/pages/interlink/reference-content/statuses.mdx +++ b/pages/interlink/reference-content/statuses.mdx @@ -2,7 +2,6 @@ meta: title: Understanding InterLink statuses description: Find out what the different possible statuses of your InterLink mean, and how to take action based on these statuses when necessary. - noindex: true content: h1: Understanding InterLink statuses paragraph: Find out what the different possible statuses of your InterLink mean, and how to take action based on these statuses when necessary. @@ -11,12 +10,12 @@ categories: - interlink - network dates: - validation: 2024-10-24 + validation: 2025-03-18 posted: 2024-10-24 --- - -InterLink is currently in [Private Beta](https://www.scaleway.com/en/betas/), and only available to selected testers. + +InterLink is currently in [Public Beta](https://www.scaleway.com/en/betas/). An InterLink always has a **status**, which can be retrieved via the API using the [Get a link](https://www.scaleway.com/en/developers/api/interlink/#path-links-get-a-link) call. @@ -28,10 +27,10 @@ This document explains the different statuses possible for an InterLink, and how | **Configuring** | InterLink is configuring and is in a transient state. No user actions can be carried out.

This status could occur immediately after creating your InterLink order, while Scaleway processes the order and configures the InterLink, or at any time when a new configuration is being applied. | | **Requesting** | InterLink has been created successfully on the Scaleway side, provisioning must now be requested from the chosen partner.

You must contact your partner to request that they provision your InterLink. Either a contact email address, or a link to the partner’s portal is provided via the Scaleway API. Scaleway does not make the request to the partner, this is the responsibility of the user.

The InterLink will remain in `Requesting` status until the partner accepts the request, at which point it moves into `Provisioning` status. Alternatively, the partner may refuse the request, or the request may time out. | | **Failed** | Scaleway was unable to create the InterLink.

This usually occurs when there is a configuration error on the Scaleway side while attempting to create the InterLink. Our technical team is automatically made aware of such a problem, and will intervene to resolve it. When the problem is resolved, the InterLink should move to `Requesting` status. Wait for technical intervention, or open a support ticket if you require further help. -| **Provisioning** | The partner has accepted the InterLink request, and is now provisioning the connection at their end.

The InterLink is not yet operational: traffic cannot yet flow. You must wait for the partner to finish provisioning the connection. When provisioning is complete, the InterLink should move to `Active` status. | +| **Provisioning** | The partner has accepted the InterLink request, and is now provisioning it at their end.

The InterLink is not yet operational: traffic cannot yet flow. You must wait for the partner to finish provisioning. When provisioning is complete, the InterLink should move to `Active` status. | | **Expired** | No response was received from the selected partner in the 10 days following the creation of the InterLink on the Scaleway side.

If Scaleway does not receive a response from the selected partner after 10 days, the InterLink moves to `Expired` status. It is not possible to take action to move this InterLink to a different status: you must delete the InterLink, and create a new order if you wish to try again. | | **Refused** | The partner refused the request to provision the InterLink.

It is not possible to take action to move this InterLink to a different status: you must delete the InterLink, and create a new order if you wish to try again with a different partner or configuration. | -| **Active** | The InterLink is in a ready state, and traffic can flow.

The InterLink has been provisioned on both the Scaleway side and the partner side, and is now in an active state. Traffic can flow across the InterLink (presuming that allowed routes lists, route propagation, and an attached VPC are correctly configured). | +| **Active** | The InterLink is in a ready state, and traffic can flow.

The InterLink has been provisioned on both the Scaleway side and the partner side, and is now in an active state. Traffic can flow across the InterLink (presuming that routing policies, route propagation, and an attached VPC are correctly configured). | | **Limited Connectivity** | The InterLink is provisioned, but IP connectivity is limited.

This may be the case if either, but not both of, the BGP, IPv4, or IPv6 sessions are down. | | **Down / All down** | The InterLink is provisioned, but there is no IP connectivity.

The InterLink has been provisioned successfully on both sides, but both BGP sessions (IPv4 and IPv6) are down and traffic cannot flow. Open a support ticket with Scaleway, or contact your partner. | | **Locked** | The InterLink has been locked by the Trust and Safety team

You cannot carry out any actions on the InterLink. Open a support ticket. |