Skip to content

Commit 395f9fa

Browse files
ntroghntrogh
committed
Refresh content
1 parent fed088c commit 395f9fa

File tree

1 file changed

+70
-47
lines changed

1 file changed

+70
-47
lines changed

‎articles/load-testing/how-to-move-between-regions.md

Lines changed: 70 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -7,29 +7,51 @@ ms.service: load-testing
77
ms.custom: subject-moving-resources
88
ms.author: ninallam
99
author: ninallam
10-
ms.date: 04/12/2022
10+
ms.date: 04/05/2023
1111
ms.topic: how-to
1212
---
1313

14-
# Move an Azure Load Testing resource to another region
14+
# Move an Azure load testing resource to another region
1515

16-
This article describes how to move your Azure Load Testing resource to another Azure region. You might want to move your resource for a number of reasons. For example, to take advantage of a new Azure region, to meet internal policy and governance requirements, or in response to capacity planning requirements.
16+
This article describes how to move your Azure load testing resource to another Azure region. You might want to move your resource for a number of reasons. For example, to take advantage of a new Azure region, to generate load from a different location, to meet internal policy and governance requirements, or in response to capacity planning requirements.
1717

18-
Azure Load Testing resources are region-specific and can't be moved across regions automatically. You can use an Azure Resource Manager template (ARM template) to export the existing configuration of your Load Testing resource instead. Then, stage the resource in another region and create the tests in the new resource.
18+
Azure load testing resources are region-specific and can't be moved across regions automatically. When you recreate the Azure load testing resource in the target Azure region, you need to recreate existing load tests in the new resource.
19+
20+
Go through the following steps to move your resource to another region:
21+
22+
1. Export the configuration of your Azure load testing resource in an Azure Resource Manager template (ARM template).
23+
24+
1. Optionally, download any test artifacts from existing load tests.
25+
26+
1. Create a new Azure load testing resource in the target region by using the ARM template.
27+
28+
1. Recreate the load tests in the new resource.
29+
30+
1. Optionally, delete the Azure load testing resource in the previous region.
1931

2032
## Prerequisites
2133

22-
- Make sure that the target region supports Azure Load Testing.
34+
- The target Azure region supports Azure Load Testing. Learn more about the [regional availability](https://azure.microsoft.com/explore/global-infrastructure/products-by-region/?products=load-testing) for Azure Load Testing.
2335

24-
- Have access to the tests in the resource you're migrating.
36+
- You have access to the tests in the resource you're migrating. Learn more about how to [manage access in Azure Load Testing](./how-to-assign-roles.md).
2537

2638
## Prepare
2739

28-
To get started, you'll need to export and then modify an ARM template. You will also need to download artifacts for any exiting tests in the resource.
40+
To get started, export the ARM template for the Azure load testing resource and download the input artifacts for existing load tests. Later, you'll update the ARM template to deploy the resource in the target Azure region.
2941

3042
1. Export the ARM template that contains settings and information for your Azure Load Testing resource by following the steps mentioned [here](../azure-resource-manager/templates/export-template-portal.md).
3143

32-
1. Download the input artifacts for all the existing tests from the resource. Navigate to the **Tests** section in the resource and then click on the test name. **Download the input file** for the test by clicking the More button (...) on the right side of the latest test run.
44+
:::image type="content" source="media/how-to-move-an-azure-load-testing-resource/load-testing-export-arm-template.png" alt-text="Screenshot that shows the ARM template to export an Azure load testing resource in the Azure portal.":::
45+
46+
1. Download the input artifacts for each existing test in the resource:
47+
48+
1. Navigate to the **Tests** section for the load testing resource.
49+
50+
1. Select the test name to go to the list of test runs.
51+
52+
1. Select **...**, and then select **Download input file** for a test run.
53+
54+
The browser should now start downloading a zipped folder that contains all input files for the test, such as the [test configuration YAML file](./reference-test-config-yaml.md), the JMeter script, and any configuration or data files.
3355

3456
:::image type="content" source="media/how-to-move-an-azure-load-testing-resource/download-input-artifacts.png" alt-text="Screenshot that shows how to download input files for a test.":::
3557

@@ -38,77 +60,78 @@ To get started, you'll need to export and then modify an ARM template. You will
3860
3961
## Move
4062

41-
Load and modify the template so you can create a new Azure Load Testing resource in the target region and then create tests in the new resource.
63+
To move the resource to the target Azure region, modify the ARM template, create a new resource by using the template, and recreate the load tests in the new resource.
4264

4365
### Move the resource
4466

4567
1. In the Azure portal, select **Create a resource**.
4668

47-
1. In the Marketplace, search for **template deployment**. Select **Template deployment (deploy using custom templates)**.
69+
1. In the Marketplace, search for **template deployment**. Select **Template deployment (deploy using custom templates)**, and then select **Create**.
4870

49-
1. Select **Create**.
71+
:::image type="content" source="media/how-to-move-an-azure-load-testing-resource/azure-marketplace-template-deployment.png" alt-text="Screenshot that shows the Template deployment option in the Azure Marketplace, highlighting the Create button.":::
5072

5173
1. Select **Build your own template in the editor**.
5274

53-
1. Select **Load file**, and then select the template.json file that you downloaded in the last section.
75+
1. Select **Load file**, and then select the `template.json` file that you exported previously.
5476

55-
1. In the uploaded template.json file, name the target Azure Load Testing resource by entering a new **defaultValue** for the resource name This example sets the defaultValue of the resource name to `myLoadTestResource`.
77+
1. Update the JSON contents:
5678

57-
```json
58-
{
59-
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
60-
"contentVersion": "1.0.0.0",
61-
"parameters": {
62-
"loadtest_name": {
63-
"defaultValue": "myLoadTestResource",
64-
"type": "String"
65-
}
66-
},
67-
```
79+
1. Update the name of the target Azure load testing resource by updating the `defaultValue` property.
80+
81+
```json
82+
{
83+
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
84+
"contentVersion": "1.0.0.0",
85+
"parameters": {
86+
"loadtest_name": {
87+
"defaultValue": "{new-resource-name}",
88+
"type": "String"
89+
}
90+
},
91+
```
6892

69-
1. Edit the **location** property to use your target region. This example sets the target region to `eastus`.
93+
1. Edit the **location** property to use your target region. The following example sets the target region to `eastus`.
7094

71-
```json
72-
"resources": [
73-
{
74-
"type": "Microsoft.LoadTestService/loadtests",
75-
"apiVersion": "2021-12-01-preview",
76-
"name": "[parameters('loadtest_name')]",
77-
"location": "eastus",
78-
```
79-
To obtain region location codes, see [Azure Locations](https://azure.microsoft.com/global-infrastructure/data-residency/). The code for a region is the region name with no spaces. For example, East US = eastus.
95+
```json
96+
"resources": [
97+
{
98+
"type": "Microsoft.LoadTestService/loadtests",
99+
"apiVersion": "2021-12-01-preview",
100+
"name": "[parameters('loadtest_name')]",
101+
"location": "eastus",
102+
```
80103

81-
1. Click on **Save**.
104+
To obtain region location codes, see [Azure Locations](https://azure.microsoft.com/global-infrastructure/data-residency/). The code for a region is the region name with no spaces. For example, East US = eastus.
105+
106+
1. Select **Save**.
82107

83108
1. Enter the **Subscription** and **Resource group** for the target resource.
84109

85-
1. Select **Review and create**, then select **Create**.
110+
1. Select **Review and create**, then select **Create** to create a new Azure load testing resource in the target Azure region.
86111

87112
### Create tests
88113

89-
Once the resource is created in the target location, you can create new tests by following the steps mentioned [here](how-to-create-and-run-load-test-with-jmeter-script.md#create-a-load-test).
90-
91-
1. You can refer to the test configuration in the config.yaml file of the input artifacts downloaded earlier.
114+
After creating the Azure load testing resource, you can [recreate the load tests in the Azure portal](how-to-create-and-run-load-test-with-jmeter-script.md#create-a-load-test).
92115

93-
1. Upload the Apache JMeter script and optional configuration files from the downloaded input artifacts.
116+
Refer to the test configuration in the `config.yaml` files you downloaded earlier for configuring the load test settings. Upload the Apache JMeter script and optional configuration files from the downloaded input artifacts.
94117

95-
If you are invoking the previous Azure Load Testing resource in a CI/CD workflow you can update the `loadTestResource` parameter in the [Azure Load testing task](/azure/devops/pipelines/tasks/test/azure-load-testing) or [Azure Load Testing action](https://github.com/marketplace/actions/azure-load-testing) of your workflow.
118+
If you invoke the load tests in a CI/CD workflow, update the `loadTestResource` parameter in the CI/CD pipeline definition to match the new Azure load testing resource name.
96119

97120
> [!NOTE]
98-
> If you have configured any of your load test with secrets from Azure Key Vault, make sure to grant the new resource access to the Key Vault following the steps mentioned [here](./how-to-use-a-managed-identity.md?tabs=azure-portal#grant-access-to-your-azure-key-vault).
121+
> If you have configured any of your load test with secrets from Azure Key Vault, make sure to [grant the new resource access to the Key Vault](./how-to-use-a-managed-identity.md?tabs=azure-portal#grant-access-to-your-azure-key-vault).
99122

100123
## Clean up source resources
101124

102-
After the move is complete, delete the Azure Load Testing resource from the source region. You pay for resources, even when the resource is not being utilized.
125+
After the move is complete, delete the Azure load testing resource from the source region. You pay for resources, even when you're not using them.
103126

104127
1. In the Azure portal, search and select **Azure Load Testing**.
105128

106-
1. Select your Azure Load Testing resource.
129+
1. Select your Azure load testing resource.
107130

108-
1. On the resource overview page, Select **Delete**, and then confirm.
131+
1. On the resource **Overview** page, select **Delete**, and then confirm.
109132

110-
> [!NOTE]
111-
> Test results for the test runs in the previous resource will be lost once the resource is deleted.
133+
> [!CAUTION]
134+
> When you delete an Azure load testing resource, you can no longer view the associated test runs and test results.
112135

113136
## Next steps
114137

0 commit comments

Comments
 (0)