Skip to content

Commit 4a47e21

Browse files
committed
DTL - move schedule 2nd draft, fixed feedback, updated image, updated TOC.
1 parent 0b4c52f commit 4a47e21

File tree

4 files changed

+34
-49
lines changed

4 files changed

+34
-49
lines changed

articles/devtest-labs/TOC.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -259,6 +259,8 @@
259259
href: create-alerts.md
260260
- name: Move to new region
261261
href: how-to-move-labs.md
262+
- name: Move Microsoft.DevtestLab/schedules to another region
263+
href: how-to-move-schedule-to-new-region.md
262264
- name: Reference
263265
items:
264266
- name: CLI

articles/devtest-labs/how-to-move-labs.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -265,3 +265,4 @@ In this article, you moved a DevTest lab from one region to another and cleaned
265265

266266
- [Move resources to a new resource group or subscription](../azure-resource-manager/management/move-resource-group-and-subscription.md)
267267
- [Move Azure VMs to another region](../site-recovery/azure-to-azure-tutorial-migrate.md)
268+
- [Move Microsoft.DevtestLab/schedules to another region](./how-to-move-schedule-to-new-region.md)
Lines changed: 31 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -1,103 +1,85 @@
11
---
2-
title: How to move a DevTest Labs schedule to another region
3-
description: Shows you how to move a DevTest Labs schedule to another region.
2+
title: How to move a Microsoft.DevtestLab/schedules to another region
3+
description: This article explains how to move a Microsoft.DevtestLab/schedules to another Azure region.
44
ms.topic: how-to
55
ms.author: rosemalcolm
66
author: RoseHJM
77
ms.date: 05/09/2022
88
---
9-
# Move a lab schedule to another region
9+
# Move Microsoft.DevtestLab/schedules to another region
10+
11+
Microsoft.DevtestLab/schedules apply only to Compute Virtual Machines (VMs). They are often referred to as top level schedules, or simply schedules. In this article, you'll learn how to move schedules.
12+
13+
Microsoft.DevTestLab/labs/schedules apply only to DevTest Labs (DTL) VMs. They are often referred to as Lab schedules. This type of schedule is not covered in this article.
14+
15+
To move schedules, use an Azure Resource Manager (ARM) template to create a copy of the existing schedules in another region.
1016

1117
In this article, you'll learn how to:
1218
> [!div class="checklist"]
1319
> >
14-
> - Export an Azure Resource Manager (ARM) template of your lab.
20+
> - Export an ARM template that contains your Microsoft.DevtestLab/schedules.
1521
> - Modify the template by adding or updating the target region and other parameters.
16-
> - Deploy the template to create the new lab in the target region.
17-
> - Configure the new lab.
18-
> - Move data to the new lab.
1922
> - Delete the resources in the source region.
2023
2124
## Prerequisites
2225

2326
- Ensure that the services and features that your account uses are supported in the target region.
2427
- For preview features, ensure that your subscription is allowlisted for the target region.
25-
- DevTest Labs doesn't include secrets and passwords in the exported ARM template. You'll need the following:
26-
- the VMs
27-
- the Stored Secrets
28-
- PAT tokens of the private Artifact Repos to move the private repos together with the lab.
29-
30-
## Prepare to move
31-
32-
To get started, you'll export and modify a Resource Manager template that contains the schedule settings.
33-
34-
### Prepare your Virtual Network
35-
36-
1. Sign in to the [Azure portal](https://portal.azure.com).
28+
- Ensure a Compute VM exists in the target region.
3729

38-
1. If you don't have a [Resource Group](../azure/azure-resource-manager/management/manage-resource-groups-portal.md#create-resource-groups) under the target region, create one now.
39-
40-
1. Move your current DevTest Lab to the new region and resource group by using the steps included in the article, [Move a DevTest Labs to another region](./how-to-move-labs.md).
41-
42-
1. Optionally, move your current virtual network to the new region and resource group by using the steps included in the article, [Move an Azure virtual network to another region](../virtual-network/move-across-regions-vnet-portal.md).
43-
44-
Alternately, you can create a new virtual network, if you don't have to keep the original one.
45-
46-
1. Move your virtual machines to the new region by using the steps included in the article, [Tutorial: Move Azure VMs across regions](../resource-mover/tutorial-move-region-virtual-machines.md).
47-
48-
49-
## Move the schedule
50-
There are two ways to move a lab schedule:
30+
## Move an existing schedule
31+
There are two ways to move a schedule:
5132

5233
- Manually recreate the schedules on the moved VMs. This process can be time consuming and error prone. This approach is most useful when you have a few schedules and VMs.
5334
- Export and redeploy the schedules by using ARM templates.
5435

55-
Alternately, you can move your existing schedules by using the following steps:
36+
Move your existing schedule by using the following steps:
5637

5738
1. Sign in to the [Azure portal](https://portal.azure.com).
5839

5940
2. Go to the source resource group that held your VMs.
6041

61-
3. On the **Resource Group Overview** page, under **Resources**, and then:<br>
62-
(1) Select **Show hidden types**<br>
63-
(2) Select all resources with the type **Microsoft.DevTestLab/Schedules**<br>
64-
(3) Select **Export template**<br>
42+
3. On the **Resource Group Overview** page, under **Resources**, select **Show hidden types**.
43+
44+
4. Select all resources with the type **Microsoft.DevTestLab/Schedules**.
45+
46+
5. Select **Export template**.
6547

6648
:::image type="content" source="./media/how-to-move-schedule-to-new-region/move-compute-schedule.png" alt-text="Screenshot that shows the hidden resources in a resource group, with schedules selected.":::
6749

68-
5. On the **Export resource group template** page, select **Deploy**.
50+
6. On the **Export resource group template** page, select **Deploy**.
6951

70-
6. On the **Custom deployment** page, select **Edit template**.
52+
7. On the **Custom deployment** page, select **Edit template**.
7153

72-
7. In the template code, change all instances of '"location": "<*old location*>"' to '"location": "<*new location*>"' and then select **Save**.
54+
8. In the template code, change all instances of `"location": "<old location>"` to `"location": "<new location>"` and then select **Save**.
7355

74-
8. On the **Custom deployment** page, enter values that match the target VM:
56+
9. On the **Custom deployment** page, enter values that match the target VM:
7557

7658
|Name|Value|
7759
|----|----|
7860
|**Subscription**|Select an Azure subscription.|
7961
|**Resource group**|Select the resource group name. |
8062
|**Region**|Select a location for the lab schedule. For example, **Central US**. |
81-
|**Schedule Name**|Must be a different name. |
82-
|**VirtualMachine_xxx_externalId**|Must be the moved one, or the new one you just created. |
63+
|**Schedule Name**|Must be a globally unique name. |
64+
|**VirtualMachine_xxx_externalId**|Must be the target VM. |
8365

8466
:::image type="content" source="./media/how-to-move-schedule-to-new-region/move-schedule-custom-deployment.png" alt-text="Screenshot that shows the custom deployment page, with new location values for the relevant settings.":::
8567

8668
>[!IMPORTANT]
87-
>Each schedule must have a globally unique name, so remember to change the schedule name for the new location.
69+
>Each schedule must have a globally unique name; you will need to change the schedule name for the new location.
8870
89-
9. Select **Review and create** to create the deployment.
71+
10. Select **Review and create** to create the deployment.
9072

91-
10. When the deployment is complete, verify that the new schedule is configured correctly on the new VM.
73+
11. When the deployment is complete, verify that the new schedule is configured correctly on the new VM.
9274

9375
## Discard or clean up
9476

95-
Now you can choose to clean up the original schedules if they're longer used. Go to the original schedule resource group (where you exported templates from in step 3 above), and delete the schedule resource.
77+
Now you can choose to clean up the original schedules if they're longer used. Go to the original schedule resource group (where you exported templates from in step 5 above), and delete the schedule resource.
9678

9779
## Next steps
9880

99-
In this article, you moved a DevTest Labs schedule from one region to another and cleaned up the source resources. To learn more about moving resources between regions and disaster recovery in Azure, refer to:
81+
In this article, you moved a schedule from one region to another and cleaned up the source resources. To learn more about moving resources between regions and disaster recovery in Azure, refer to:
10082

101-
- [Move a DevTest Labs to another region](./how-to-move-labs).
83+
- [Move a DevTest Labs to another region](./how-to-move-labs.md).
10284
- [Move resources to a new resource group or subscription](../azure-resource-manager/management/move-resource-group-and-subscription.md).
10385
- [Move Azure VMs to another region](../site-recovery/azure-to-azure-tutorial-migrate.md).
-4.72 KB
Loading

0 commit comments

Comments
 (0)