Skip to content

Commit 91641d2

Browse files
committed
updates
1 parent e9500d4 commit 91641d2

File tree

9 files changed

+55
-41
lines changed

9 files changed

+55
-41
lines changed

articles/app-service/environment/how-to-migrate.md

Lines changed: 42 additions & 32 deletions
Large diffs are not rendered by default.
220 KB
Loading
99.8 KB
Loading
36.7 KB
Loading
144 KB
Loading
7.9 KB
Loading
69.8 KB
Loading
59.4 KB
Loading

articles/app-service/environment/migrate.md

Lines changed: 13 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Migrate to App Service Environment v3 by using the migration feature
33
description: Overview of the migration feature for migration to App Service Environment v3
44
author: seligj95
55
ms.topic: article
6-
ms.date: 06/08/2023
6+
ms.date: 08/07/2023
77
ms.author: jordanselig
88
ms.custom: references_regions
99
---
@@ -19,12 +19,12 @@ App Service can now automate migration of your App Service Environment v1 and v2
1919

2020
At this time, the migration feature doesn't support migrations to App Service Environment v3 in the following regions:
2121

22-
### Azure Public:
22+
### Azure Public
2323

2424
- Jio India West
2525
- UAE Central
2626

27-
### Azure China:
27+
### Azure China
2828

2929
- China East 2
3030
- China North 2
@@ -40,7 +40,7 @@ The following App Service Environment configurations can be migrated using the m
4040
|ELB App Service Environment v1 |ELB App Service Environment v3 |
4141
|ILB App Service Environment v1 with a custom domain suffix |ILB App Service Environment v3 with a custom domain suffix |
4242

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).
4444

4545
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.
4646

@@ -51,7 +51,7 @@ The following are limitations when using the migration feature:
5151
- Your new App Service Environment v3 is in the existing subnet that was used for your old environment.
5252
- You can't change the region your App Service Environment is located in.
5353
- 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.
5555
- If you no longer want to use a custom domain suffix, you can remove it once the migration is complete.
5656

5757
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
106106

107107
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.
108108

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+
109113
### Ensure there are no locks on your resources
110114

111115
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
118122
> 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.
119123
>
120124
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.
122126

123127
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.
124128

125129
### Migrate to App Service Environment v3
126130

127131
After completing the previous steps, you should continue with migration as soon as possible.
128132

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:
130134

131135
- The existing App Service Environment is shut down and replaced by the new App Service Environment v3.
132136
- 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
144148

145149
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).
146150

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

149153
### Scale down your App Service plans
150154

@@ -207,7 +211,7 @@ For more scenarios on cost changes and savings opportunities with App Service En
207211
- **Will I need to do anything to my apps after the migration to get them running on the new App Service Environment?**
208212
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.
209213
- **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.
211215
- **What if my App Service Environment is zone pinned?**
212216
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).
213217
- **What properties of my App Service Environment will change?**

0 commit comments

Comments
 (0)