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/app-service/environment/migrate.md
+13-9Lines changed: 13 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@ title: Migrate to App Service Environment v3 by using the migration feature
3
3
description: Overview of the migration feature for migration to App Service Environment v3
4
4
author: seligj95
5
5
ms.topic: article
6
-
ms.date: 06/08/2023
6
+
ms.date: 08/07/2023
7
7
ms.author: jordanselig
8
8
ms.custom: references_regions
9
9
---
@@ -19,12 +19,12 @@ App Service can now automate migration of your App Service Environment v1 and v2
19
19
20
20
At this time, the migration feature doesn't support migrations to App Service Environment v3 in the following regions:
21
21
22
-
### Azure Public:
22
+
### Azure Public
23
23
24
24
- Jio India West
25
25
- UAE Central
26
26
27
-
### Azure China:
27
+
### Azure China
28
28
29
29
- China East 2
30
30
- China North 2
@@ -40,7 +40,7 @@ The following App Service Environment configurations can be migrated using the m
40
40
|ELB App Service Environment v1 |ELB App Service Environment v3 |
41
41
|ILB App Service Environment v1 with a custom domain suffix |ILB App Service Environment v3 with a custom domain suffix |
42
42
43
-
If you want your new App Service Environment v3 to use a custom domain suffix and you aren't using one currently, custom domain suffix can be configured at any time once migration is complete. For more information, see [Configure custom domain suffix for App Service Environment](./how-to-custom-domain-suffix.md).
43
+
If you want your new App Service Environment v3 to use a custom domain suffix and you aren't using one currently, custom domain suffix can be configured at any time once migration is complete. For more information, see [Configure custom domain suffix for App Service Environment](./how-to-custom-domain-suffix.md).
44
44
45
45
You can find the version of your App Service Environment by navigating to your App Service Environment in the [Azure portal](https://portal.azure.com) and selecting **Configuration** under **Settings** on the left-hand side. You can also use [Azure Resource Explorer](https://resources.azure.com/) and review the value of the `kind` property for your App Service Environment.
46
46
@@ -51,7 +51,7 @@ The following are limitations when using the migration feature:
51
51
- Your new App Service Environment v3 is in the existing subnet that was used for your old environment.
52
52
- You can't change the region your App Service Environment is located in.
53
53
- ELB App Service Environment can’t be migrated to ILB App Service Environment v3 and vice versa.
54
-
- If your existing App Service Environment uses a custom domain suffix, you have to configure custom domain suffix for your App Service Environment v3 during the migration process.
54
+
- If your existing App Service Environment uses a custom domain suffix, you have to configure custom domain suffix for your App Service Environment v3 during the migration process.
55
55
- If you no longer want to use a custom domain suffix, you can remove it once the migration is complete.
56
56
57
57
App Service Environment v3 doesn't support the following features that you may be using with your current App Service Environment v1 or v2.
@@ -106,6 +106,10 @@ Once the new IPs are created, you have the new default outbound to the internet
106
106
107
107
App Service Environment v3 requires the subnet it's in to have a single delegation of `Microsoft.Web/hostingEnvironments`. Migration can't succeed if the App Service Environment's subnet isn't delegated or it's delegated to a different resource.
108
108
109
+
### Acknowledge instance size changes
110
+
111
+
Your App Service plans are converted from Isolated to the corresponding Isolated v2 SKU as part of the migration. For example, I2 is converted to I2v2. Your apps may be over-provisioned after the migration since the Isolated v2 tier has more memory and CPU per corresponding instance size. You have the opportunity to scale your environment as needed once migration is complete. For more information, review the [SKU details](https://azure.microsoft.com/pricing/details/app-service/windows/).
112
+
109
113
### Ensure there are no locks on your resources
110
114
111
115
Virtual network locks block platform operations during migration. If your virtual network has locks, you need to remove them before migrating. The locks can be readded if needed once migration is complete. Locks can exist at three different scopes: subscription, resource group, and resource. When you apply a lock at a parent scope, all resources within that scope inherit the same lock. If you have locks applied at the subscription, resource group, or resource scope, they need to be removed before the migration. For more information on locks and lock inheritance, see [Lock your resources to protect your infrastructure](../../azure-resource-manager/management/lock-resources.md).
@@ -118,15 +122,15 @@ Your App Service Environment v3 can be deployed across availability zones in the
118
122
> Enabling zone redundancy can lead to additional charges. Review the [zone redundancy pricing model](../../availability-zones/migrate-app-service-environment.md#pricing) for more information.
119
123
>
120
124
121
-
If your existing App Service Environment uses a custom domain suffix, you're prompted to configure a custom domain suffix for your new App Service Environment v3. You need to provide the custom domain name, managed identity, and certificate. For more information on App Service Environment v3 custom domain suffix including requirements, step-by-step instructions, and best practices, see [Configure custom domain suffix for App Service Environment](./how-to-custom-domain-suffix.md). You must configure a custom domain suffix for your new environment even if you no longer want to use it. Once migration is complete, you can remove the custom domain suffix configuration if needed.
125
+
If your existing App Service Environment uses a custom domain suffix, you're prompted to configure a custom domain suffix for your new App Service Environment v3. You need to provide the custom domain name, managed identity, and certificate. For more information on App Service Environment v3 custom domain suffix including requirements, step-by-step instructions, and best practices, see [Configure custom domain suffix for App Service Environment](./how-to-custom-domain-suffix.md). You must configure a custom domain suffix for your new environment even if you no longer want to use it. Once migration is complete, you can remove the custom domain suffix configuration if needed.
122
126
123
127
If your migration includes a custom domain suffix, for App Service Environment v3, the custom domain isn't displayed in the **Essentials** section of the **Overview** page of the portal as it is for App Service Environment v1/v2. Instead, for App Service Environment v3, go to the **Custom domain suffix** page where you can confirm your custom domain suffix is configured correctly.
124
128
125
129
### Migrate to App Service Environment v3
126
130
127
131
After completing the previous steps, you should continue with migration as soon as possible.
128
132
129
-
Migration requires up to a three hour service window for App Service Environment v2 to v3 migrations. Up to a six hour service window is required depending on environment size for v1 to v3 migrations. During migration, scaling and environment configurations are blocked and the following events occur:
133
+
Migration requires a three to six hour service window for App Service Environment v2 to v3 migrations. Up to a six hour service window is required depending on environment size for v1 to v3 migrations. During migration, scaling and environment configurations are blocked and the following events occur:
130
134
131
135
- The existing App Service Environment is shut down and replaced by the new App Service Environment v3.
132
136
- All App Service plans in the App Service Environment are converted from the Isolated to Isolated v2 SKU.
@@ -144,7 +148,7 @@ As in the IP generation step, you can't scale, modify your App Service Environme
144
148
145
149
There's no cost to migrate your App Service Environment. You stop being charged for your previous App Service Environment as soon as it shuts down during the migration process, and you begin getting charged for your new App Service Environment v3 as soon as it's deployed. For more information about App Service Environment v3 pricing, see the [pricing details](overview.md#pricing).
146
150
147
-
When you migrate to App Service Environment v3 from previous versions, there are scenarios that you should consider that can potentially reduce your monthly cost.
151
+
When you migrate to App Service Environment v3 from previous versions, there are scenarios that you should consider that can potentially reduce your monthly cost.
148
152
149
153
### Scale down your App Service plans
150
154
@@ -207,7 +211,7 @@ For more scenarios on cost changes and savings opportunities with App Service En
207
211
-**Will I need to do anything to my apps after the migration to get them running on the new App Service Environment?**
208
212
No, all of your apps running on the old environment are automatically migrated to the new environment and run like before. No user input is needed.
209
213
-**What if my App Service Environment has a custom domain suffix?**
210
-
The migration feature supports this [migration scenario](#supported-scenarios). You can migrate using a manual method if you don't want to use the migration feature. You can configure your [custom domain suffix](./how-to-custom-domain-suffix.md) when creating your App Service Environment v3 or any time after.
214
+
The migration feature supports this [migration scenario](#supported-scenarios). You can migrate using a manual method if you don't want to use the migration feature. You can configure your [custom domain suffix](./how-to-custom-domain-suffix.md) when creating your App Service Environment v3 or any time after.
211
215
-**What if my App Service Environment is zone pinned?**
212
216
Zone pinned App Service Environment is currently not a supported scenario for migration using the migration feature. App Service Environment v3 doesn't support zone pinning. To migrate to App Service Environment v3, see the [manual migration options](migration-alternatives.md).
213
217
-**What properties of my App Service Environment will change?**
0 commit comments