Upgrade to App Service Environment v3

Article
02/20/2024

Important

If you're currently using App Service Environment v1 or v2, you must migrate your workloads to App Service Environment v3. App Service Environment v1 and v2 will be retired on 31 August 2024. Failure to migrate by that date will result in loss of the environments, running applications, and all application data.

As of 29 January 2024, you can no longer create new App Service Environment v1 and v2 resources using any of the available methods including ARM/Bicep templates, Azure Portal, Azure CLI, or REST API.

This page is your one-stop shop for guidance and resources to help you upgrade successfully with minimal downtime. Follow the guidance to plan and complete your upgrade as soon as possible. This page is updated with the latest information as it becomes available.

Upgrade steps

Step	Action	Resources
1	Pre-flight check	Determine if your environment meets the prerequisites to automate your upgrade using one of the automated migration features. Decide whether an in-place or side-by-side migration is right for your use case. - Migration path decision tree - Automated upgrade using the in-place migration feature - Automated upgrade using the side-by-side migration feature If not, you can upgrade manually. - Manual migration
2	Migrate	Based on results of your review, either upgrade using one of the automated migration features or follow the manual steps. - Use the in-place automated migration feature - Use the side-by-side automated migration feature - Migrate manually
3	Testing and troubleshooting	Upgrading using one of the automated migration features requires a 3-6 hour service window. If you use the side-by-side migration feature, you have the opportunity to test and validate your App Service Environment v3 before completing the upgrade. Support teams are monitoring upgrades to ensure success. If you have a support plan and you need technical help, create a support request.
4	Optimize your App Service plans	Once your upgrade is complete, you can optimize the App Service plans for additional benefits. Review the autoselected Isolated v2 SKU sizes and scale up or scale down your App Service plans as needed. - Scale down your App Service plans - App Service Environment post-migration scaling guidance Explore reserved instance pricing, savings plans, and check out the pricing estimates if needed. - App Service pricing page - How reservation discounts apply to Isolated v2 instances - Azure pricing calculator
5	Learn more	On-demand: Learn Live webinar with Azure FastTrack Architects. Need more help? Submit a request to contact FastTrack. Frequently asked questions Community support

Additional information

What are the benefits of upgrading?

App Service Environment v3 is the latest version of App Service Environment. It's easier to use, runs on more powerful infrastructure that can go up to 64 cores and 256-GB RAM with faster scaling speeds for both Windows and Linux, and has simpler network topology. For more information about these and other benefits, see the following resources.

What changes when upgrading to App Service Environment v3?

What tooling is available to help with the upgrade to App Service Environment v3?

There are two automated migration features available to help you upgrade to App Service Environment v3.

In-place migration feature migrates your App Service Environment to App Service Environment v3 in-place. In-place means that your App Service Environment v3 replaces your existing App Service Environment in the same subnet. There's application downtime during the migration because a subnet can only have a single App Service Environment at a given time. For more information about this feature, see Automated upgrade using the in-place migration feature.
Side-by-side migration feature creates a new App Service Environment v3 in a different subnet that you choose and recreates all of your App Service plans and apps in that new environment. Your existing environment is up and running during the entire migration. Once the new App Service Environment v3 is ready, you can redirect traffic to the new environment and complete the migration. There's no application downtime during the migration. For more information about this feature, see Automated upgrade using the side-by-side migration feature.
Manual migration options are available if you can't use the automated migration features. For more information about these options, see Migration alternatives.

Migration path decision tree

Use the following decision tree to determine which migration path is right for you.

Cost saving opportunities after upgrading to App Service Environment v3

The App Service plan SKUs available for App Service Environment v3 run on the Isolated v2 (Iv2) tier. The number of cores and amount of RAM are effectively doubled per corresponding tier compared the Isolated tier. When you migrate, your App Service plans are converted to the corresponding tier. For example, your I2 instances are converted to I2v2. While I2 has two cores and 7-GB RAM, I2v2 has four cores and 16-GB RAM. If you expect your capacity requirements to stay the same, you're over-provisioned and paying for compute and memory you're not using. For this scenario, you can scale down your I2v2 instance to I1v2 and end up with a similar number of cores and RAM that you had previously.

Note

All scenarios are calculated using costs based on Linux $USD pricing in East US. The payment option is set to monthly. Estimates are based on the prices applicable on the day the estimate was created. Actual total estimates may vary. For the most up-to-date estimates, see the Azure pricing calculator.

To demonstrate the cost saving opportunity for this scenario, use the pricing calculator to estimate the monthly savings as a result of scaling down your App Service plans. For this example, your App Service Environment v2 has 1 I2 instance. You require two cores and 7-GB RAM. You're using pay-as-you-go pricing. On App Service Environment v2, your monthly payment is the following.

Stamp fee + 1(I2) = $991.34 + $416.10 = $1,407.44

When you migrate this App Service Environment using the migration feature, your new App Service Environment v3 has 1 I2v2 instance, which means you have four cores and 16-GB RAM. If you don't change anything, your monthly payment is the following.

1(I2v2) = $563.56

Your monthly cost is reduced, but you don't need that much compute and capacity. You scale down your instance to I1v2 and your monthly cost is reduced even further.

1(I1v2) = $281.78

Break even point

In most cases, migrating to App Service Environment v3 allows for cost saving opportunities. However, cost savings might not always be possible, especially if you're required to maintain a large number of small instances.

To demonstrate this scenario, you have an App Service Environment v2 with a single I1 instance. Your monthly cost is:

Stamp fee + 1(I1) = $991.34 + $208.05 = $1,199.39

If you migrate this environment to App Service Environment v3, your monthly cost is:

1(I1v2) = $281.78

This change is a significant cost reduction, but you're over-provisioned since you have double the cores and RAM, which you might not need. This excess isn't an issue for this scenario since the new environment is cheaper. However, when you increase your I1 instances in a single App Service Environment, you see how migrating to App Service Environment v3 can increase your monthly cost.

For this scenario, your App Service Environment v2 has 14 I1 instances. Your monthly cost is:

Stamp fee + 14(I1) = $991.34 + $2,912.70 = $3,904.04

When you migrate this environment to App Service Environment v3, your monthly cost is:

14(I1v2) = $3,944.92

Your App Service Environment v3 is now more expensive than your App Service Environment v2. As you start add more I1 instances, and therefore need more I1v2 instances when you migrate, the difference in price becomes more significant. If this scenario is a requirement for your environment, you might need to plan for an increase in your monthly cost. The following graph visually depicts the point where App Service Environment v3 becomes more expensive than App Service Environment v2 for this specific scenario.

Note

This calculation was done with Linux $USD prices in East US. Break even points will vary due to price variances in the different regions. For an estimate that reflects your situation, see the Azure pricing calculator.

Graph that shows the point where App Service Environment v3 becomes more expensive than v2 for the scenario where you only have small instances.