Skip to content

Commit 5900bd9

Browse files
authored
Merge pull request #192944 from seligj95/patch-2
fixing issue for missing content
2 parents 96320c8 + 80a4ede commit 5900bd9

File tree

1 file changed

+12
-12
lines changed

1 file changed

+12
-12
lines changed

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

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Use the migration feature to migrate App Service Environment v2 to App Se
33
description: Learn how to migrate your App Service Environment v2 to App Service Environment v3 using the migration feature
44
author: seligj95
55
ms.topic: tutorial
6-
ms.date: 2/2/2022
6+
ms.date: 3/25/2022
77
ms.author: jordanselig
88
zone_pivot_groups: app-service-cli-portal
99
---
@@ -25,7 +25,7 @@ The recommended experience for the migration feature is using the [Azure portal]
2525

2626
For this guide, [install the Azure CLI](/cli/azure/install-azure-cli) or use the [Azure Cloud Shell](https://shell.azure.com/).
2727

28-
## 1. Get your App Service Environment ID
28+
## Get your App Service Environment ID
2929

3030
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.
3131

@@ -35,7 +35,7 @@ ASE_RG=<Your-Resource-Group>
3535
ASE_ID=$(az appservice ase show --name $ASE_NAME --resource-group $ASE_RG --query id --output tsv)
3636
```
3737

38-
## 2. Validate migration is supported
38+
## Validate migration is supported
3939

4040
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).
4141

@@ -45,7 +45,7 @@ az rest --method post --uri "${ASE_ID}/migrate?api-version=2021-02-01&phase=vali
4545

4646
If there are no errors, your migration is supported and you can continue to the next step.
4747

48-
## 3. Generate IP addresses for your new App Service Environment v3
48+
## Generate IP addresses for your new App Service Environment v3
4949

5050
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.
5151

@@ -65,11 +65,11 @@ If it's in progress, you'll get a status of "Migrating". Once you get a status o
6565
az rest --method get --uri "${ASE_ID}/configurations/networking?api-version=2021-02-01"
6666
```
6767

68-
## 4. Update dependent resources with new IPs
68+
## Update dependent resources with new IPs
6969

7070
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.
7171

72-
## 5. Delegate your App Service Environment subnet
72+
## Delegate your App Service Environment subnet
7373

7474
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).
7575

@@ -79,7 +79,7 @@ az network vnet subnet update -g $ASE_RG -n <subnet-name> --vnet-name <vnet-name
7979

8080
![subnet delegation sample](./media/migration/subnet-delegation.png)
8181

82-
## 6. Migrate to App Service Environment v3
82+
## Migrate to App Service Environment v3
8383

8484
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.
8585

@@ -105,7 +105,7 @@ az appservice ase show --name $ASE_NAME --resource-group $ASE_RG
105105

106106
::: zone pivot="experience-azp"
107107

108-
## 1. Validate migration is supported
108+
## Validate migration is supported
109109

110110
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.
111111

@@ -121,25 +121,25 @@ The migration page will guide you through the series of steps to complete the mi
121121

122122
![migration page sample](./media/migration/migration-ux-pre.png)
123123

124-
## 2. Generate IP addresses for your new App Service Environment v3
124+
## Generate IP addresses for your new App Service Environment v3
125125

126126
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.
127127

128128
![pre-migration request to refresh](./media/migration/pre-migration-refresh.png)
129129

130-
## 3. Update dependent resources with new IPs
130+
## Update dependent resources with new IPs
131131

132132
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.
133133

134134
![sample IPs](./media/migration/ip-sample.png)
135135

136-
## 4. Delegate your App Service Environment subnet
136+
## Delegate your App Service Environment subnet
137137

138138
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.
139139

140140
![ux subnet delegation sample](./media/migration/subnet-delegation-ux.png)
141141

142-
## 5. Migrate to App Service Environment v3
142+
## Migrate to App Service Environment v3
143143

144144
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.
145145

0 commit comments

Comments
 (0)