You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/frontdoor/migrate-cdn-to-front-door.md
+27-23Lines changed: 27 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,15 +19,19 @@ Azure Traffic Manager initially routes all traffic to the Azure CDN from Edgio.
19
19
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.
20
20
21
21
> [!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
+
23
25
24
26
## Prerequisites
25
27
26
28
- 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
28
29
- You need access to a VM connected to the internet that can run Wget on Linux or Invoke-WebRequest on Windows using PowerShell.
29
30
- 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.
30
31
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
+
31
35
## Migrate your workloads
32
36
33
37
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
48
52
49
53
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).
50
54
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.
52
56
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.
54
58
55
59
1. Enter the URL into the monitoring tool to understand the geographic availability of your URL.
56
60
@@ -79,12 +83,12 @@ The followings steps assume you're using an Azure Blob Storage account as your o
79
83
80
84
1. Leave the rest of the settings as default and select **Add**.
81
85
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.
83
87
84
88
> [!NOTE]
85
89
> Azure CDN from Edgio *Standard-cache* is equivalent to Azure Front Door *Ignore query string* caching.
86
90
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.
88
92
89
93
1. Select **Add** to create the route.
90
94
@@ -112,47 +116,47 @@ The steps in this section need to be repeated for each endpoint in your Azure CD
112
116
113
117
1. Enter a name for the endpoint and leave the **Enable Endpoint** checked.
114
118
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`.
116
120
117
121
1. Set the **Weight** to 100.
118
122
119
123
1. For *Health check*, select **Always serve traffic**. This setting disables the health check and always routes traffic to the endpoint.
120
124
121
125
:::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.":::
122
126
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**.
124
128
125
129
1. Enter a name for the endpoint and uncheck the **Enable Endpoint** setting.
126
130
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`.
128
132
129
133
1. Set the **Weight** to 1.
130
134
131
135
1. Since the endpoint is disabled, the **Health check** setting isn't relevant.
132
136
133
137
### Internal testing of Traffic Manager profile
134
138
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`.
136
140
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:
138
142
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.
140
144
141
145
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`.
142
146
143
147
1. For Windows, the hosts file is located at `C:\Windows\System32\drivers\etc\hosts`.
144
148
145
149
1. For Linux, the hosts file is located at `/etc/hosts`.
146
150
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.
148
152
149
153
1. Remove the entry from the hosts file when testing is complete.
150
154
151
155
### Configure Traffic Manager with CNAME
152
156
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.
154
158
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.
156
160
157
161
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).
158
162
@@ -164,22 +168,22 @@ We only recommend this step after you have fully tested the Azure Front Door pro
164
168
165
169
1. Use a tool like dig or nslookup to verify that the DNS change propagated and pointed to the correct Traffic Manager profile.
166
170
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.
168
172
169
173
### Gradual traffic shift
170
174
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.
172
176
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.
174
178
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.
176
180
177
181
> [!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.
179
183
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.
181
185
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.
183
187
184
188
1. Ensure the Azure Front Door endpoint is enabled, Weight is set to 100, and the health check is set to **Always serve traffic**.
185
189
@@ -190,7 +194,7 @@ The initial traffic distribution starts by routing a small percentage of traffic
190
194
191
195
### Remove Azure Traffic Manager
192
196
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`.
194
198
195
199
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.
0 commit comments