From 00be5e9dd550f4c86acef075c812f9733401b558 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Fri, 13 Dec 2024 11:02:18 +0000 Subject: [PATCH 1/4] added note and corrected prefix steps --- .../docs/magic-transit/how-to/advertise-prefixes.mdx | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/src/content/docs/magic-transit/how-to/advertise-prefixes.mdx b/src/content/docs/magic-transit/how-to/advertise-prefixes.mdx index 2146172f2406068..9719ba25f73b16d 100644 --- a/src/content/docs/magic-transit/how-to/advertise-prefixes.mdx +++ b/src/content/docs/magic-transit/how-to/advertise-prefixes.mdx @@ -39,14 +39,15 @@ If you do not have an ASN or do not want to bring your ASN to Cloudflare, you ca Current customers who are still using Cloudflare's AS209242 can continue using this same ASN. No further change is required. ::: -## Add an IP prefix +## Advertise your prefix + +You can only advertise your prefix after running pre-flight checks with Cloudflare. If your prefix status is greyed out and shows an _Withdrawn_ status, it means your prefix is locked. Contact your account team to unlock it and close the pre-flight checks phase with you. 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account. 2. Go to **Magic Transit** > **Configuration**. -3. From the **IP Prefixes** tab, select **Create**. -4. Fill out the information for your prefix and select **Add IP Prefix**. - -After you add the prefix, you can edit its status. +3. From the **IP Prefixes** tab select your prefix > **Edit**. +4. Under Status, select _Advertise_ to advertise your prefix. +5. Select **Edit Prefix**. ## Edit the status of a prefix From 296e17f450a1af5c647e7f3ea0994db686f05a1c Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Fri, 13 Dec 2024 11:21:18 +0000 Subject: [PATCH 2/4] improved language --- src/content/docs/magic-transit/get-started.mdx | 2 +- .../magic-transit/how-to/advertise-prefixes.mdx | 14 ++++++-------- 2 files changed, 7 insertions(+), 9 deletions(-) diff --git a/src/content/docs/magic-transit/get-started.mdx b/src/content/docs/magic-transit/get-started.mdx index 226d4efd15cc629..ddaf2fc09ace4fc 100644 --- a/src/content/docs/magic-transit/get-started.mdx +++ b/src/content/docs/magic-transit/get-started.mdx @@ -43,7 +43,7 @@ The LOA must be a PDF. Transit providers may reject the LOA if it is a JPG or PN ### Verify IRR entries -Verify your Internet Routing Registry (IRR) entries match corresponding origin autonomous system numbers (ASNs) to ensure Magic Transit routes traffic to the correct autonomous systems (AS). For guidance, refer to [Verify IRR entries](/byoip/concepts/irr-entries/best-practices/#verify-an-irr-entry). +Verify that your Internet Routing Registry (IRR) entries match your corresponding origin autonomous system numbers (ASNs) to ensure Magic Transit routes traffic to the correct autonomous systems (AS). For guidance, refer to [Verify IRR entries](/byoip/concepts/irr-entries/best-practices/#verify-an-irr-entry). If you are using a Cloudflare IP, you do not need to verify your IRR entries. diff --git a/src/content/docs/magic-transit/how-to/advertise-prefixes.mdx b/src/content/docs/magic-transit/how-to/advertise-prefixes.mdx index 9719ba25f73b16d..3c13a0099f161e0 100644 --- a/src/content/docs/magic-transit/how-to/advertise-prefixes.mdx +++ b/src/content/docs/magic-transit/how-to/advertise-prefixes.mdx @@ -41,13 +41,15 @@ Current customers who are still using Cloudflare's AS209242 can continue using t ## Advertise your prefix -You can only advertise your prefix after running pre-flight checks with Cloudflare. If your prefix status is greyed out and shows an _Withdrawn_ status, it means your prefix is locked. Contact your account team to unlock it and close the pre-flight checks phase with you. +:::note +You can only advertise your prefix [after running pre-flight checks](/magic-transit/get-started/#5-run-pre-flight-checks) with Cloudflare. If your prefix status is greyed out and shows an _Withdrawn_ status, your prefix is locked. Contact your account team to close the pre-flight checks phase with you and unlock it. +::: 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account. 2. Go to **Magic Transit** > **Configuration**. 3. From the **IP Prefixes** tab select your prefix > **Edit**. 4. Under Status, select _Advertise_ to advertise your prefix. -5. Select **Edit Prefix**. +5. Select **Edit Prefix** to save your changes. ## Edit the status of a prefix @@ -56,9 +58,9 @@ You can only advertise your prefix after running pre-flight checks with Cloudfla 3. _(Optional)_ Edit the description for your prefix. 4. Select **Edit IP Prefix** to save your changes. -:::note[Note:] To avoid latency and potentially dropped routes, enable prefix advertisement from Cloudflare before withdrawing the advertisement from your data center. -::: + +You should also be aware that announcing or withdrawing a prefix should propagate across Cloudflare's global network almost instantly, with changes typically taking effect within a few minutes at most. However, Cloudflare has no control over how long ISPs take to refresh their routes. Keep this in mind when announcing or withdrawing a prefix from your account, and plan accordingly. ## Delete a prefix @@ -67,10 +69,6 @@ You can only delete a prefix with an **Unapproved** status. To delete prefixes w 1. From the **IP Prefixes** tab, locate the prefix you want to modify and select **Delete**. 2. Confirm your choice from the modal by selecting **Delete**. -:::note -Withdrawing a prefix should propagate across Cloudflare's global network almost instantly, with changes typically taking effect within a few minutes at most. However, Cloudflare has no control over how long ISPs take to refresh their routes. Keep this in mind when announcing or withdrawing a prefix from your account, and plan accordingly. -::: - ## Border Gateway Protocol (BGP) control for advertisements Use BGP to control the advertisement status of your prefix - advertised or withdrawn - from Cloudflare's global network for on-demand deployment scenarios. BGP Control works by establishing BGP sessions to Cloudflare's globally distributed Route Reflectors, which will initiate propagation of your prefix advertisement across Cloudflare's global network. From b3c4c0d200a20c9ae184a89e3e28114bbf69239f Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Fri, 13 Dec 2024 11:27:50 +0000 Subject: [PATCH 3/4] refined sentence --- src/content/docs/magic-transit/how-to/advertise-prefixes.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/magic-transit/how-to/advertise-prefixes.mdx b/src/content/docs/magic-transit/how-to/advertise-prefixes.mdx index 3c13a0099f161e0..5592b68448983a9 100644 --- a/src/content/docs/magic-transit/how-to/advertise-prefixes.mdx +++ b/src/content/docs/magic-transit/how-to/advertise-prefixes.mdx @@ -42,7 +42,7 @@ Current customers who are still using Cloudflare's AS209242 can continue using t ## Advertise your prefix :::note -You can only advertise your prefix [after running pre-flight checks](/magic-transit/get-started/#5-run-pre-flight-checks) with Cloudflare. If your prefix status is greyed out and shows an _Withdrawn_ status, your prefix is locked. Contact your account team to close the pre-flight checks phase with you and unlock it. +You can only advertise your prefix [after running pre-flight checks](/magic-transit/get-started/#5-run-pre-flight-checks) with Cloudflare. If your prefix status is greyed out and shows an _Withdrawn_ status, your prefix is locked. Contact your account team to close the pre-flight checks phase with you and unlock your prefixes. ::: 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account. From 9c308c3c42d9724fe2c17b25c5c49bb6ac099ebd Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Fri, 13 Dec 2024 11:28:35 +0000 Subject: [PATCH 4/4] refined sentence --- src/content/docs/magic-transit/how-to/advertise-prefixes.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/magic-transit/how-to/advertise-prefixes.mdx b/src/content/docs/magic-transit/how-to/advertise-prefixes.mdx index 5592b68448983a9..663299c43dd66be 100644 --- a/src/content/docs/magic-transit/how-to/advertise-prefixes.mdx +++ b/src/content/docs/magic-transit/how-to/advertise-prefixes.mdx @@ -48,7 +48,7 @@ You can only advertise your prefix [after running pre-flight checks](/magic-tran 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account. 2. Go to **Magic Transit** > **Configuration**. 3. From the **IP Prefixes** tab select your prefix > **Edit**. -4. Under Status, select _Advertise_ to advertise your prefix. +4. Under **Status**, select _Advertise_ to advertise your prefix. 5. Select **Edit Prefix** to save your changes. ## Edit the status of a prefix