Migrate Azure CDN from Edgio to Azure Front Door

Azure CDN from Edgio will be retired on November 4, 2025. You must migrate your workload to Azure Front Door before this date to avoid service disruption. This article provides guidance on how to migrate your workloads from Azure CDN from Edgio to Azure Front Door using Azure Traffic Manager. The migration process in this article can also be used to migrate workloads from a legacy CDN to Azure Front Door.

Azure Traffic Manager initially routes all traffic to the Azure CDN from Edgio. After you set up Azure Front Door, you can update the Traffic Manager profile to incrementally route traffic to the Azure Front Door. This approach allows you to validate if Azure Front Door is compatible with your workloads before fully migrating.

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.

Prerequisites

• Review the feature differences between Azure CDN and Azure Front Door to determine if there are any compatibility gaps.
• You are already using custom domains on Azure CDN from Edgio
• You need access to a VM connected to the internet that can run Wget on Linux or Invoke-WebRequest on Windows using PowerShell.
• 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.

Migrate your workloads

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.

Gather information

1. Collect the following information from your Azure CDN from Edgio profile:

   • Endpoints
   • Origin configurations
   • Custom domains
   • Caching settings
   • Compression settings
   • Web application firewall (WAF) settings
   • Custom rules settings

2. Determine which tier of Azure Front Door is suitable for your workloads. For more information, see Azure Front Door comparison.

3. Review the origin settings in your Azure CDN from Edgio profile.

4. Determine a test URL with your Azure CDN from Edgio profile and perform a wget or Invoke-WebRequest to obtain the HTTP header information.

5. Enter the URL into the monitoring tool to understand the geographic availability of your URL.

Set up Azure Front Door

1. From the Azure portal, select + Create a resource, then search for Front Door.

2. Select Front Door and CDN profiles and then select Create.

3. On the Compare offerings pages, select Azure Front Door and then select Custom create.

4. Select Continue to create a Front Door.

5. Select the subscription and resource group. Enter a name for the Azure Front Door profile. Then select the tier that best suits your workloads and select the Endpoint tab.

6. Select Add an endpoint. Enter a name for the endpoint, then select Add. The endpoint name will look like <endpointname>-<hash>.xxx.azurefd.net.

7. Select + Add a route. Enter a name for the route and note the Domain selected. Leave the Patterns to match and Accepted protocols as the default settings.

   Note

   A CDN profile can have multiple endpoints, so you may need to create multiple routes.

8. Select Add a new origin group. Enter a name for the origin group and select the + Add an origin button. Enter the origin name and select the origin type. This example uses Azure Blob Storage, so select Storage as the origin type. Select the hostname of the Azure Blob Storage account and leave the rest of the settings as default. Select Add.

   

9. Leave the rest of the settings as default and select Add.

10. If caching was enabled in your Azure CDN from Edgio profile, select Enable caching and set the caching rules.

    Note

    Azure CDN from Edgio Standard-cache is equivalent to Azure Front Door Ignore query string caching.

11. 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.

12. Select Add to create the route.

13. Select + Add a policy to set up web application firewall (WAF) settings and set up custom rules you determined in the previous steps.

14. Select Review + create and then select Create.

15. Set up the custom domain for the Azure Front Door profile. For more information, see Custom domains. You may have multiple custom domains in your Azure CDN from Edgio profile. Ensure you add all custom domains to the Azure Front Door profile and associate them with the correct routes.

Set up Traffic Manager

The steps in this section need to be repeated for each endpoint in your Azure CDN from Edgio profile. It is critical that the health check is set up correctly to ensure that the Traffic Manager profile routes traffic to the Azure CDN or Azure Front Door.

1. From the Azure portal, select + Create a resource, then search for Traffic Manager profile.

2. Enter a name for the Traffic Manager profile.

3. Select the routing method Weighted.

4. Select the same subscription and resource group as the Azure Front Door profile then select Create.

5. Select Endpoints from the left-hand menu, and then select + Add.

6. For the Type, select External endpoint.

7. Enter a name for the endpoint and leave the Enable Endpoint checked.

8. Enter the Fully-qualified domain name (FQDN) of the Azure CDN from Edgio profile. For example, yourdomain.azureedge.net.

9. Set the Weight to 100.

10. For Health check, select Always serve traffic. This setting disables the health check and always routes traffic to the endpoint.

    

11. Add another endpoint for the Azure Front Door profile and select External endpoint.

12. Enter a name for the endpoint and uncheck the Enable Endpoint setting.

13. Enter the Fully-qualified domain name (FQDN) of the Azure Front Door profile. For example, your-new-endpoint-name.azurefd.net.

14. Set the Weight to 1.

15. Since the endpoint is disabled, the Health check setting isn't relevant.

Internal testing of Traffic Manager profile

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.

2. Test the Azure Front Door profile by manually adding a DNS entry in your local hosts file pointing to the Azure Front Door profile:

   1. Get the IP address of the Azure Front Door profile by performing a DNS dig.

   2. 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.

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

      2. For Linux, the hosts file is located at /etc/hosts.

   3. Test the functionality of the Azure Front Door profile locally and ensure everything is working as expected.

   4. Remove the entry from the hosts file when testing is complete.

Configure Traffic Manager with CNAME

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

1. Sign into your DNS provider and locate the CNAME record for the Azure CDN from Edgio profile.

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

3. Update the CNAME record to point to the Traffic Manager profile: your-profile.trafficmanager.net.

4. In the Azure portal, navigate to the Traffic Manager profile and select Endpoints.

5. Enable the Azure Front Door endpoint and select Always serve traffic for the health check.

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

7. Verify that the Azure CDN from Edgio profile is working properly by checking the monitoring tool you set up earlier.

Gradual traffic shift

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.

1. Start by routing 10% of the traffic to the Azure Front Door profile and the rest to the Azure CDN from Edgio profile.

2. 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.

   Note

   If you don't have access to a third-party tool, you can use Webpagetest 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.

3. 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.

4. 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.

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

   2. Ensure the Azure CDN from Edgio endpoint is disabled.

Note

If you're currently utilizing azureedge.net within your codebase, you'll need to update your code to utilize `<YourNewAFDEndpoint.azurefd.net>. If this is a significant concern for you organization, contact support for further assistance.

Remove Azure Traffic Manager

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.

2. 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.

3. Set the DNS TTL back to the original value (60 minutes).

At this stage you have fully migrated all traffic from Azure CDN from Edgio to Azure Front Door.

Next steps

Learn about best practices for Azure Front Door.