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/how-to-migrate.md
+9-5Lines changed: 9 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@ title: Use the migration feature to migrate your App Service Environment to App
3
3
description: Learn how to migrate your App Service Environment to App Service Environment v3 using the migration feature
4
4
author: seligj95
5
5
ms.topic: tutorial
6
-
ms.date: 9/15/2022
6
+
ms.date: 10/21/2022
7
7
ms.author: jordanselig
8
8
zone_pivot_groups: app-service-cli-portal
9
9
---
@@ -19,6 +19,10 @@ An App Service Environment v1 and v2 can be automatically migrated to an [App Se
19
19
20
20
Ensure you understand how migrating to an App Service Environment v3 will affect your applications. Review the [migration process](migrate.md#overview-of-the-migration-process-using-the-migration-feature) to understand the process timeline and where and when you'll need to get involved. Also review the [FAQs](migrate.md#frequently-asked-questions), which may answer some questions you currently have.
21
21
22
+
Ensure there are no locks on your virtual network. Virtual network locks will block platform operations during migration.
23
+
24
+
:::image type="content" source="./media/migration/vnet-locks.png" alt-text="Screenshot that shows where to find and update virtual network locks.":::
25
+
22
26
::: zone pivot="experience-azcli"
23
27
24
28
The recommended experience for the migration feature is using the [Azure portal](how-to-migrate.md?pivots=experience-azp). If you decide to use the Azure CLI to carry out the migration, you should follow the steps described here in order and as written since you'll be making Azure REST API calls. The recommended way for making these API calls is by using the [Azure CLI](/cli/azure/). For information about other methods, see [Getting Started with Azure REST](/rest/api/azure/).
@@ -175,11 +179,11 @@ From the [Azure portal](https://portal.azure.com), navigate to the **Migration**
175
179
176
180
On the migration page, the platform will validate if migration is supported for your App Service Environment. If your environment isn't supported for migration, a banner will appear at the top of the page and include an error message with a reason. See the [troubleshooting](migrate.md#troubleshooting) section for descriptions of the error messages you may see if you aren't eligible for migration. If your App Service Environment isn't supported for migration at this time or your environment is in an unhealthy or suspended state, you won't be able to use the migration feature. If your environment [won't be supported for migration with the migration feature](migrate.md#supported-scenarios) or you want to migrate to App Service Environment v3 without using the migration feature, see the [manual migration options](migration-alternatives.md).
177
181
178
-
:::image type="content" source="./media/migration/migration-not-supported.png" alt-text="Migration not supported sample.":::
182
+
:::image type="content" source="./media/migration/migration-not-supported.png" alt-text="Screenshot that shows what the portal looks like when migration is not supported.":::
179
183
180
184
If migration is supported for your App Service Environment, you'll be able to proceed to the next step in the process. The migration page will guide you through the series of steps to complete the migration.
:::image type="content" source="./media/migration/migration-ux-pre.png" alt-text="Screenshot that shows a sample migration page.":::
183
187
184
188
## 2. Generate IP addresses for your new App Service Environment v3
185
189
@@ -189,13 +193,13 @@ Under **Get new IP addresses**, confirm you understand the implications and star
189
193
190
194
When the previous step finishes, you'll be shown the IP addresses for your new App Service Environment v3. Using the new IPs, update any resources and networking components to ensure your new environment functions as intended once migration is complete. It's your responsibility to make any necessary updates. Don't move on to the next step until you confirm that you have made these updates.
191
195
192
-
:::image type="content" source="./media/migration/ip-sample.png" alt-text="Sample IPs generated during pre-migration.":::
196
+
:::image type="content" source="./media/migration/ip-sample.png" alt-text="Screenshot that shows sample IPs generated during pre-migration.":::
193
197
194
198
## 4. Delegate your App Service Environment subnet
195
199
196
200
App Service Environment v3 requires the subnet it's in to have a single delegation of `Microsoft.Web/hostingEnvironments`. Previous versions didn't require this delegation. You'll need to confirm your subnet is delegated properly and/or update the delegation if needed before migrating. A link to your subnet is given so that you can confirm and update as needed.
197
201
198
-
:::image type="content" source="./media/migration/subnet-delegation-ux.png" alt-text="Subnet delegation using the portal.":::
202
+
:::image type="content" source="./media/migration/subnet-delegation-ux.png" alt-text="Screenshot that shows subnet delegation using the portal.":::
0 commit comments