Skip to content

Commit b126741

Browse files
Merge pull request #292415 from Harikrishnan-M-B/patch-24
fixed terminology
2 parents 0dd3c50 + 861e69c commit b126741

File tree

1 file changed

+27
-23
lines changed

1 file changed

+27
-23
lines changed

articles/frontdoor/migrate-cdn-to-front-door.md

Lines changed: 27 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -19,15 +19,19 @@ Azure Traffic Manager initially routes all traffic to the Azure CDN from Edgio.
1919
We recommend that your plan this migration well in advance and test the functionality over the course of a few days to ensure a smooth transition.
2020

2121
> [!IMPORTANT]
22-
> If you plan to migrate to Azure Front Door, set the Feature Flag **DoNotForceMigrateEdgioCDNProfiles** before January 7, 2025 using [Set up preview feature](../azure-resource-manager/management/preview-features.md). This will prevent Microsoft from auto-migrating your profiles to Azure Front Door. Auto-migration is on a *best effort* basis and may cause issues with billing, features, availability, and performance. Note you will have until January 14, 2025 to complete your migration to another CDN, but again Microsoft cannot guarantee your services will be available on the Edgio platform before this date.
22+
> - If you plan to migrate to Azure Front Door, set the Feature Flag **DoNotForceMigrateEdgioCDNProfiles** before January 7, 2025 using [Set up preview feature](../azure-resource-manager/management/preview-features.md). This will prevent Microsoft from auto-migrating your profiles to Azure Front Door. Auto-migration is on a *best effort* basis and may cause issues with billing, features, availability, and performance. Note you will have until January 14, 2025 to complete your migration to another CDN, but again Microsoft cannot guarantee your services will be available on the Edgio platform before this date.
23+
> - This guide only works if you are already using custom domains on Azure CDN from Edgio. If you don't use custom domains, you won't be able to use traffic manager to gradually shift traffic to Front Door. You will have to update the clients to directly point to the new Front Door endpoint. Another temporary option will be to migrate to Front Door while [retaining your `<endpointname>.azureedge.net` domain.](../cdn/migrate-cdn-to-front-door-retain-edge-domain.md)
24+
2325

2426
## Prerequisites
2527

2628
- Review the [feature differences](front-door-cdn-comparison.md) between Azure CDN and Azure Front Door to determine if there are any compatibility gaps.
27-
- You are already using custom domains on Azure CDN from Edgio
2829
- You need access to a VM connected to the internet that can run Wget on Linux or Invoke-WebRequest on Windows using PowerShell.
2930
- You need access to a monitoring tool such as CatchPoint or ThousandEyes to verify the availability of your URLs before and after the migration. These tools are the most ideal because they can monitor the availability of your URLs from different locations around the world. `webpagetest.org` is another option, but it only provides a limited view of your URLs from a few locations.
3031

32+
> [!NOTE]
33+
> If you have multiple endpoints in your Azure CDN from Edgio profile, you will have to repeat the migration steps for each endpoint. You will have to create corresponding endpoints in Azure Front Door for facilitating migration.
34+
3135
## Migrate your workloads
3236

3337
The followings steps assume you're using an Azure Blob Storage account as your origin. If you're using a different origin, adjust the steps accordingly.
@@ -48,9 +52,9 @@ The followings steps assume you're using an Azure Blob Storage account as your o
4852

4953
1. Determine which tier of Azure Front Door is suitable for your workloads. For more information, see [Azure Front Door comparison](../frontdoor/front-door-cdn-comparison.md).
5054

51-
1. Review the origin settings in your Azure CDN from Edgio profile.
55+
1. Review the origin settings of your Azure CDN from Edgio endpoint.
5256

53-
1. Determine a test URL with your Azure CDN from Edgio profile and perform a `wget` or `Invoke-WebRequest` to obtain the HTTP header information.
57+
1. Determine a test URL with your Azure CDN from Edgio endpoint and perform a `wget` or `Invoke-WebRequest` to obtain the HTTP header information.
5458

5559
1. Enter the URL into the monitoring tool to understand the geographic availability of your URL.
5660

@@ -79,12 +83,12 @@ The followings steps assume you're using an Azure Blob Storage account as your o
7983

8084
1. Leave the rest of the settings as default and select **Add**.
8185

82-
1. If caching was enabled in your Azure CDN from Edgio profile, select **Enable caching** and set the caching rules.
86+
1. If caching was enabled in your Azure CDN from Edgio endpoint, select **Enable caching** and set the caching rules.
8387

8488
> [!NOTE]
8589
> Azure CDN from Edgio *Standard-cache* is equivalent to Azure Front Door *Ignore query string* caching.
8690
87-
1. Select **Enable compression** if you have compression enabled in your Azure CDN from Edgio profile. Ensure the origin path matches the path in your Azure CDN from Edgio profile. If this isn't set correctly, the origin won't be able to serve the content and will return a 4xx error.
91+
1. Select **Enable compression** if you have compression enabled in your Azure CDN from Edgio endpoint. Ensure the origin path matches the path in your Azure CDN from Edgio endpoint. If this isn't set correctly, the origin won't be able to serve the content and will return a 4xx error.
8892

8993
1. Select **Add** to create the route.
9094

@@ -112,47 +116,47 @@ The steps in this section need to be repeated for each endpoint in your Azure CD
112116

113117
1. Enter a name for the endpoint and leave the **Enable Endpoint** checked.
114118

115-
1. Enter the **Fully-qualified domain name (FQDN)** of the Azure CDN from Edgio profile. For example, `yourdomain.azureedge.net`.
119+
1. Enter the **Fully-qualified domain name (FQDN)** of the Azure CDN from Edgio endpoint. For example, `yourdomain.azureedge.net`.
116120

117121
1. Set the **Weight** to 100.
118122

119123
1. For *Health check*, select **Always serve traffic**. This setting disables the health check and always routes traffic to the endpoint.
120124

121125
:::image type="content" source="./media/migrate-cdn-to-front-door/cdn-endpoint.png" alt-text="Screenshot of adding the Azure CDN from Edgio as an endpoint in Azure Traffic Manager.":::
122126

123-
1. Add another endpoint for the Azure Front Door profile and select **External endpoint**.
127+
1. Add another endpoint for the Azure Front Door endpoint and select **External endpoint**.
124128

125129
1. Enter a name for the endpoint and uncheck the **Enable Endpoint** setting.
126130

127-
1. Enter the **Fully-qualified domain name (FQDN)** of the Azure Front Door profile. For example, `your-new-endpoint-name.azurefd.net`.
131+
1. Enter the **Fully-qualified domain name (FQDN)** of the Azure Front Door endpoint. For example, `your-new-endpoint-name.azurefd.net`.
128132

129133
1. Set the **Weight** to 1.
130134

131135
1. Since the endpoint is disabled, the **Health check** setting isn't relevant.
132136

133137
### Internal testing of Traffic Manager profile
134138

135-
1. Perform a DNS dig to test the Traffic Manager profile: `dig your-profile.trafficmanager.net`. The dig command should always return the CNAME of the Azure CDN from Edgio profile: `yourdomain.azureedge.net`.
139+
1. Perform a DNS dig to test the Traffic Manager profile: `dig your-profile.trafficmanager.net`. The dig command should always return the CNAME of the Azure CDN from Edgio endpoint: `yourdomain.azureedge.net`.
136140

137-
1. Test the Azure Front Door profile by manually adding a DNS entry in your local hosts file pointing to the Azure Front Door profile:
141+
1. Test the Azure Front Door endpoint by manually adding a DNS entry in your local hosts file pointing to the Azure Front Door endpoint:
138142

139-
1. Get the IP address of the Azure Front Door profile by performing a DNS dig.
143+
1. Get the IP address of the Azure Front Door endpoint by performing a DNS dig.
140144

141145
1. Add a new line to your hosts file with the IP address followed by a space and then `your-new-endpoint-name.azurefd.net`. For example, `203.0.113.254 your-new-endpoint-name.azurefd.net`.
142146

143147
1. For Windows, the hosts file is located at `C:\Windows\System32\drivers\etc\hosts`.
144148

145149
1. For Linux, the hosts file is located at `/etc/hosts`.
146150

147-
1. Test the functionality of the Azure Front Door profile locally and ensure everything is working as expected.
151+
1. Test the functionality of the Azure Front Door endpoint locally and ensure everything is working as expected.
148152

149153
1. Remove the entry from the hosts file when testing is complete.
150154

151155
### Configure Traffic Manager with CNAME
152156

153-
We only recommend this step after you have fully tested the Azure Front Door profile and are confident that it is working as expected.
157+
We only recommend this step after you have fully tested the Azure Front Door endpoint and are confident that it is working as expected.
154158

155-
1. Sign into your DNS provider and locate the CNAME record for the Azure CDN from Edgio profile.
159+
1. Sign into your DNS provider and locate the CNAME record for the Azure CDN from Edgio endpoint.
156160

157161
1. Locate the custom domain you want to migrate to Azure Front Door and set the time-to-live (TTL) to 600 secs (10 minutes).
158162

@@ -164,22 +168,22 @@ We only recommend this step after you have fully tested the Azure Front Door pro
164168

165169
1. Use a tool like dig or nslookup to verify that the DNS change propagated and pointed to the correct Traffic Manager profile.
166170

167-
1. Verify that the Azure CDN from Edgio profile is working properly by checking the monitoring tool you set up earlier.
171+
1. Verify that the Azure CDN from Edgio endpoint is working properly by checking the monitoring tool you set up earlier.
168172

169173
### Gradual traffic shift
170174

171-
The initial traffic distribution starts by routing a small percentage of traffic to the Azure Front Door profile. Monitor the performance of the Azure Front Door profile and gradually increase the traffic percentage until all traffic is routed to the Azure Front Door profile.
175+
The initial traffic distribution starts by routing a small percentage of traffic to the Azure Front Door endpoint. Monitor the performance of the Azure Front Door endpoint and gradually increase the traffic percentage until all traffic is routed to the Azure Front Door endpoint.
172176

173-
1. Start by routing 10% of the traffic to the Azure Front Door profile and the rest to the Azure CDN from Edgio profile.
177+
1. Start by routing 10% of the traffic to the Azure Front Door endpoint and the rest to the Azure CDN from Edgio endpoint.
174178

175-
1. Monitor the performance of the Azure Front Door profile and the Azure CDN from Edgio profile using the monitoring tool you set up earlier. Review your internal applications and systems logs to ensure that the Azure Front Door profile is working as expected. Look at metrics and logs to observe for 4xx/5xx errors, cache/byte hit ratios, and origin health.
179+
1. Monitor the performance of the Azure Front Door endpoint and the Azure CDN from Edgio endpoint using the monitoring tool you set up earlier. Review your internal applications and systems logs to ensure that the Azure Front Door endpoint is working as expected. Look at metrics and logs to observe for 4xx/5xx errors, cache/byte hit ratios, and origin health.
176180

177181
> [!NOTE]
178-
> If you don't have access to a third-party tool, you can use [Webpagetest](https://webpagetest.org) to verify the availability of your endpoint from a remote location. However, this tool only provides a limited view of your URLs from a few locations around the world, so you may not see any changes until you have fully shifted traffic to the Azure Front Door profile.
182+
> If you don't have access to a third-party tool, you can use [Webpagetest](https://webpagetest.org) to verify the availability of your endpoint from a remote location. However, this tool only provides a limited view of your URLs from a few locations around the world, so you may not see any changes until you have fully shifted traffic to the Azure Front Door endpoint.
179183
180-
1. Gradually increase the traffic percentage to the Azure Front Door profile by 10% increments until all traffic is routed to the Azure Front Door profile. Ensure that you're testing and monitoring the performance of the Azure Front Door profile at each increment.
184+
1. Gradually increase the traffic percentage to the Azure Front Door endpoint by 10% increments until all traffic is routed to the Azure Front Door endpoint. Ensure that you're testing and monitoring the performance of the Azure Front Door endpoint at each increment.
181185

182-
1. Once you're confident that the Azure Front Door profile is working as expected, update the Traffic Manager profile to route all traffic to the Azure Front Door profile.
186+
1. Once you're confident that the Azure Front Door endpoint is working as expected, update the Traffic Manager profile to route all traffic to the Azure Front Door endpoint.
183187

184188
1. Ensure the Azure Front Door endpoint is enabled, Weight is set to 100, and the health check is set to **Always serve traffic**.
185189

@@ -190,7 +194,7 @@ The initial traffic distribution starts by routing a small percentage of traffic
190194
191195
### Remove Azure Traffic Manager
192196

193-
1. Sign in to your DNS provider. Change the CNAME record from the Traffic Manager profile to the Azure Front Door profile: `<endpointname>-<hash>.xxx.azurefd.net`.
197+
1. Sign in to your DNS provider. Change the CNAME record from the Traffic Manager profile to the Azure Front Door endpoint: `<endpointname>-<hash>.xxx.azurefd.net`.
194198

195199
1. Over the next few hours, begin testing using dig, and monitor using the monitoring tool to ensure the DNS is fully propagated correctly around the world.
196200

0 commit comments

Comments
 (0)