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
+12-12Lines changed: 12 additions & 12 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 App Service Environment v2 to App Se
3
3
description: Learn how to migrate your App Service Environment v2 to App Service Environment v3 using the migration feature
4
4
author: seligj95
5
5
ms.topic: tutorial
6
-
ms.date: 2/2/2022
6
+
ms.date: 3/25/2022
7
7
ms.author: jordanselig
8
8
zone_pivot_groups: app-service-cli-portal
9
9
---
@@ -25,7 +25,7 @@ The recommended experience for the migration feature is using the [Azure portal]
25
25
26
26
For this guide, [install the Azure CLI](/cli/azure/install-azure-cli) or use the [Azure Cloud Shell](https://shell.azure.com/).
27
27
28
-
## 1. Get your App Service Environment ID
28
+
## Get your App Service Environment ID
29
29
30
30
Run these commands to get your App Service Environment ID and store it as an environment variable. Replace the placeholders for name and resource group with your values for the App Service Environment you want to migrate.
31
31
@@ -35,7 +35,7 @@ ASE_RG=<Your-Resource-Group>
35
35
ASE_ID=$(az appservice ase show --name $ASE_NAME --resource-group $ASE_RG --query id --output tsv)
36
36
```
37
37
38
-
## 2. Validate migration is supported
38
+
## Validate migration is supported
39
39
40
40
The following command will check whether your App Service Environment is supported for migration. If you receive an error or if your App Service Environment is in an unhealthy or suspended state, you can't migrate at this time. If your environment [won't be supported for migration](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).
41
41
@@ -45,7 +45,7 @@ az rest --method post --uri "${ASE_ID}/migrate?api-version=2021-02-01&phase=vali
45
45
46
46
If there are no errors, your migration is supported and you can continue to the next step.
47
47
48
-
## 3. Generate IP addresses for your new App Service Environment v3
48
+
## Generate IP addresses for your new App Service Environment v3
49
49
50
50
Run the following command to create the new IPs. This step will take about 15 minutes to complete. Don't scale or make changes to your existing App Service Environment during this time.
51
51
@@ -65,11 +65,11 @@ If it's in progress, you'll get a status of "Migrating". Once you get a status o
65
65
az rest --method get --uri "${ASE_ID}/configurations/networking?api-version=2021-02-01"
66
66
```
67
67
68
-
## 4. Update dependent resources with new IPs
68
+
## Update dependent resources with new IPs
69
69
70
70
Don't move on to migration immediately after completing the previous step. 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.
71
71
72
-
## 5. Delegate your App Service Environment subnet
72
+
## Delegate your App Service Environment subnet
73
73
74
74
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 update the delegation if needed before migrating. You can update the delegation either by running the following command or by navigating to the subnet in the [Azure portal](https://portal.azure.com).
Only start this step once you've completed all pre-migration actions listed previously and understand the [implications of migration](migrate.md#migrate-to-app-service-environment-v3) including what will happen during this time. There will be about one hour of downtime. Scaling and modifications to your existing App Service Environment will be blocked during this step.
85
85
@@ -105,7 +105,7 @@ az appservice ase show --name $ASE_NAME --resource-group $ASE_RG
105
105
106
106
::: zone pivot="experience-azp"
107
107
108
-
## 1. Validate migration is supported
108
+
## Validate migration is supported
109
109
110
110
From the [Azure portal](https://portal.azure.com), navigate to the **Overview** page for the App Service Environment you'll be migrating. The platform will validate if migration is supported for your App Service Environment. Wait a couple seconds after the page loads for this validation to take place.
111
111
@@ -121,25 +121,25 @@ The migration page will guide you through the series of steps to complete the mi
## 2. Generate IP addresses for your new App Service Environment v3
124
+
## Generate IP addresses for your new App Service Environment v3
125
125
126
126
Under **Generate new IP addresses**, confirm you understand the implications and start the process. This step will take about 15 minutes to complete. Don't scale or make changes to your existing App Service Environment during this time. If you may see a message a few minutes after starting this step asking you to refresh the page, select refresh as shown in the sample to allow your new IP addresses to appear.
127
127
128
128

129
129
130
-
## 3. Update dependent resources with new IPs
130
+
## Update dependent resources with new IPs
131
131
132
132
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.
133
133
134
134

135
135
136
-
## 4. Delegate your App Service Environment subnet
136
+
## Delegate your App Service Environment subnet
137
137
138
138
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 update the delegation if needed before migrating. A link to your subnet is given so that you can confirm and update as needed.
Once you've completed all of the above steps, you can start migration. Make sure you understand the [implications of migration](migrate.md#migrate-to-app-service-environment-v3) including what will happen during this time. There will be about one hour of downtime. Scaling and modifications to your existing App Service Environment will be blocked during this step.
0 commit comments