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
@@ -51,7 +51,7 @@ az rest --method post --uri "${ASE_ID}/migrate?api-version=2021-02-01&phase=vali
51
51
52
52
If there are no errors, your migration is supported, and you can continue to the next step.
53
53
54
-
## 3. Generate IP addresses for your new App Service Environment v3 instance
54
+
## 3. Generate IP addresses for your new App Service Environment v3 resource
55
55
56
56
Run the following command to create new IP addresses. This step takes about 15 minutes to complete. Don't scale or make changes to your existing App Service Environment during this time.
57
57
@@ -107,11 +107,11 @@ For related commands to check if your subscription or resource group has locks,
107
107
108
108
## 7. Prepare your configurations
109
109
110
-
You can make your new App Service Environment v3 instance zone redundant if your existing environment is in a [region that supports zone redundancy](./overview.md#regions). You can configure zone redundancy by setting the `zoneRedundant` property to `true`.
110
+
You can make your new App Service Environment v3 resource zone redundant if your existing environment is in a [region that supports zone redundancy](./overview.md#regions). You can configure zone redundancy by setting the `zoneRedundant` property to `true`.
111
111
112
-
Zone redundancy is an optional configuration. You can set it only during the creation of your new App Service Environment v3 instance. You can't remove it at a later time. For more information, see [Choose your App Service Environment v3 configurations](./migrate.md#choose-your-app-service-environment-v3-configurations). If you don't want to configure zone redundancy, don't include the `zoneRedundant` parameter.
112
+
Zone redundancy is an optional configuration. You can set it only during the creation of your new App Service Environment v3 resource. You can't remove it at a later time. For more information, see [Choose your App Service Environment v3 configurations](./migrate.md#choose-your-app-service-environment-v3-configurations). If you don't want to configure zone redundancy, don't include the `zoneRedundant` parameter.
113
113
114
-
If your existing App Service Environment uses a custom domain suffix, you need to [configure one for your new App Service Environment v3 instance during the migration process](./migrate.md#choose-your-app-service-environment-v3-configurations). Migration fails if you don't configure a custom domain suffix and are using one currently. Migration also fails if you try to add a custom domain suffix during migration to an environment that doesn't have one configured. For more information on App Service Environment v3 custom domain suffixes, including requirements, step-by-step instructions, and best practices, see [Custom domain suffix for App Service Environments](./how-to-custom-domain-suffix.md).
114
+
If your existing App Service Environment uses a custom domain suffix, you need to [configure one for your new App Service Environment v3 resource during the migration process](./migrate.md#choose-your-app-service-environment-v3-configurations). Migration fails if you don't configure a custom domain suffix and are using one currently. Migration also fails if you try to add a custom domain suffix during migration to an environment that doesn't have one configured. For more information on App Service Environment v3 custom domain suffixes, including requirements, step-by-step instructions, and best practices, see [Custom domain suffix for App Service Environments](./how-to-custom-domain-suffix.md).
115
115
116
116
> [!NOTE]
117
117
> If you're configuring a custom domain suffix, when you're adding the network permissions on your Azure key vault, be sure that your key vault allows access from your App Service Environment's new outbound IP addresses that were generated in step 3.
@@ -197,7 +197,7 @@ Replace the placeholder for the operation ID in the following command with the v
197
197
az rest --method get --uri "${ASE_ID}/operations/<operation-id>/details/default?api-version=2022-09-01"
198
198
```
199
199
200
-
After you get a status of `Ready`, migration is done, and you have an App Service Environment v3 instance. Your apps are now running in your new environment.
200
+
After you get a status of `Ready`, migration is done, and you have an App Service Environment v3 resource. Your apps are now running in your new environment.
201
201
202
202
Get the details of your new environment by running the following command or by going to the [Azure portal](https://portal.azure.com).
203
203
@@ -229,13 +229,13 @@ If migration is supported for your App Service Environment, proceed to the next
229
229
230
230
:::image type="content" source="./media/migration/migration-ux-pre.png" alt-text="Screenshot that shows a sample migration page with unfinished steps in the process.":::
231
231
232
-
## 2. Generate IP addresses for your new App Service Environment v3 instance
232
+
## 2. Generate IP addresses for your new App Service Environment v3 resource
233
233
234
234
Under **Get new IP addresses**, confirm that you understand the implications and select the **Start** button. This step takes about 15 minutes to complete. You can't scale or make changes to your existing App Service Environment during this time.
235
235
236
236
## 3. Update dependent resources with new IPs
237
237
238
-
When the previous step finishes, the IP addresses for your new App Service Environment v3 instance appear. Use the new IPs to update any resources and networking components so that your new environment functions as intended after migration is complete. It's your responsibility to make any necessary updates.
238
+
When the previous step finishes, the IP addresses for your new App Service Environment v3 resource appear. Use the new IPs to update any resources and networking components so that your new environment functions as intended after migration is complete. It's your responsibility to make any necessary updates.
239
239
240
240
This step is also a good time to review the [inbound and outbound network](networking.md#ports-and-network-restrictions) dependency changes in moving to App Service Environment v3. These changes include the port change for Azure Load Balancer, which now uses port 80. Don't move to the next step until you confirm that you made these updates.
241
241
@@ -265,15 +265,15 @@ For details on how to check if your subscription or resource group has locks, se
265
265
266
266
## 7. Choose your configurations
267
267
268
-
You can make your new App Service Environment v3 instance zone redundant if your existing environment is in a [region that supports zone redundancy](./overview.md#regions). Zone redundancy is an optional configuration. You can set it only during the creation of your new App Service Environment v3 instance. You can't remove it at a later time. For more information, see [Choose your App Service Environment v3 configurations](./migrate.md#choose-your-app-service-environment-v3-configurations).
268
+
You can make your new App Service Environment v3 resource zone redundant if your existing environment is in a [region that supports zone redundancy](./overview.md#regions). Zone redundancy is an optional configuration. You can set it only during the creation of your new App Service Environment v3 resource. You can't remove it at a later time. For more information, see [Choose your App Service Environment v3 configurations](./migrate.md#choose-your-app-service-environment-v3-configurations).
269
269
270
270
Select the **Enabled** checkbox if you want to configure zone redundancy.
271
271
272
272
:::image type="content" source="./media/migration/zone-redundancy-supported.png" alt-text="Screenshot that shows the checkbox for enabling zone redundancy for an App Service Environment in a supported region.":::
273
273
274
-
If your environment is in a region that doesn't support zone redundancy, the checkbox is unavailable. If you need a zone-redundant App Service Environment v3 instance, use one of the manual migration options and create the instance in one of the regions that supports zone redundancy.
274
+
If your environment is in a region that doesn't support zone redundancy, the checkbox is unavailable. If you need a zone-redundant App Service Environment v3 resource, use one of the manual migration options and create the resource in one of the regions that supports zone redundancy.
275
275
276
-
If your existing App Service Environment uses a [custom domain suffix](./migrate.md#choose-your-app-service-environment-v3-configurations), you must configure one for your new App Service Environment v3 instance. The configuration options for a custom domain suffix appear if this situation applies to you. You can't migrate until you provide the required information.
276
+
If your existing App Service Environment uses a [custom domain suffix](./migrate.md#choose-your-app-service-environment-v3-configurations), you must configure one for your new App Service Environment v3 resource. The configuration options for a custom domain suffix appear if this situation applies to you. You can't migrate until you provide the required information.
277
277
278
278
If you want to use a custom domain suffix but don't currently have one configured, you can configure one after migration is complete. For more information on App Service Environment v3 custom domain suffixes, including requirements, step-by-step instructions, and best practices, see [Custom domain suffix for App Service Environments](./how-to-custom-domain-suffix.md).
279
279
@@ -299,7 +299,7 @@ This step takes three to six hours for v2 to v3 migrations and up to six hours f
299
299
300
300
At this time, detailed migration statuses are available only when you're using the Azure CLI. For more information, see the [Azure CLI section for migrating to App Service Environment v3](#8-migrate-to-app-service-environment-v3-and-check-status).
301
301
302
-
When migration is complete, you have an App Service Environment v3 instance, and all of your apps are running in your new environment. You can confirm the environment's version by checking the **Configuration** page for your App Service Environment.
302
+
When migration is complete, you have an App Service Environment v3 resource, and all of your apps are running in your new environment. You can confirm the environment's version by checking the **Configuration** page for your App Service Environment.
303
303
304
304
If your migration included a custom domain suffix, the domain appeared in the **Essentials** section of the **Overview** page of the portal for App Service Environment v1/v2, but it no longer appears there in App Service Environment v3. Instead, for App Service Environment v3, go to the **Custom domain suffix** page to confirm that your custom domain suffix is configured correctly. You can also remove the configuration if you no longer need it or configure one if you didn't have one previously.
305
305
@@ -310,7 +310,7 @@ If your migration included a custom domain suffix, the domain appeared in the **
310
310
## Next steps
311
311
312
312
> [!div class="nextstepaction"]
313
-
> [Use an App Service Environment v3 instance](using.md)
313
+
> [Use an App Service Environment v3 resource](using.md)
314
314
315
315
> [!div class="nextstepaction"]
316
316
> [App Service Environment v3 networking](networking.md)
0 commit comments