Skip to content

Commit 685d2d9

Browse files
committed
first round of edits for use exported template tutorial
1 parent 5340552 commit 685d2d9

File tree

1 file changed

+24
-24
lines changed

1 file changed

+24
-24
lines changed

articles/azure-resource-manager/templates/template-tutorial-export-template.md

Lines changed: 24 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -2,25 +2,25 @@
22
title: Tutorial - Export template from the Azure portal
33
description: Learn how to use an exported template to complete your template development.
44
author: mumian
5-
ms.date: 09/09/2020
5+
ms.date: 08/17/2022
66
ms.topic: tutorial
77
ms.author: jgao
88
ms.custom:
99
---
1010

1111
# Tutorial: Use exported template from the Azure portal
1212

13-
In this tutorial series, you've created a template to deploy an Azure storage account. In the next two tutorials, you add an *App Service plan* and a *website*. Instead of creating templates from scratch, you learn how to export templates from the Azure portal and how to use sample templates from the [Azure Quickstart templates](https://azure.microsoft.com/resources/templates/). You customize those templates for your use. This tutorial focuses on exporting templates, and customizing the result for your template. It takes about **14 minutes** to complete.
13+
In this tutorial series, you create a template to deploy an Azure storage account. In the next two tutorials, you add an **App Service plan** and a **website**. Instead of creating templates from scratch, you learn how to export templates from the Azure portal and how to use sample templates from the [Azure Quickstart Templates](https://azure.microsoft.com/resources/templates/). You customize those templates for your use. This tutorial focuses on exporting templates and customizing the result for your template. This instruction takes **14 minutes** to complete.
1414

1515
## Prerequisites
1616

1717
We recommend that you complete the [tutorial about outputs](template-tutorial-add-outputs.md), but it's not required.
1818

19-
You must have Visual Studio Code with the Resource Manager Tools extension, and either Azure PowerShell or Azure CLI. For more information, see [template tools](template-tutorial-create-first-template.md#get-tools).
19+
You need to have Visual Studio Code with the Resource Manager Tools extension and either Azure PowerShell or Azure Command-Line Interface (CLI). For more information, see [template tools](template-tutorial-create-first-template.md#get-tools).
2020

2121
## Review template
2222

23-
At the end of the previous tutorial, your template had the following JSON:
23+
At the end of the previous tutorial, your template had the following JSON file:
2424

2525
:::code language="json" source="~/resourcemanager-templates/get-started-with-templates/add-outputs/azuredeploy.json":::
2626

@@ -30,16 +30,16 @@ This template works well for deploying storage accounts, but you might want to a
3030

3131
1. Sign in to the [Azure portal](https://portal.azure.com).
3232
1. Select **Create a resource**.
33-
1. In **Search the Marketplace**, enter **App Service plan**, and then select **App Service plan**. Don't select **App Service plan (classic)**
33+
1. In **Search services and Marketplace**, enter **App Service Plan**, and then select **App Service Plan**.
3434
1. Select **Create**.
35-
1. Enter:
35+
1. On the **Create App Service Plan** page, enter the following:
3636

37-
- **Subscription**: select your Azure subscription.
38-
- **Resource Group**: Select **Create new** and then specify a name. Provide a different resource group name than the one you have been using in this tutorial series.
39-
- **Name**: enter a name for the App service plan.
40-
- **Operating System**: select **Linux**.
41-
- **Region**: select an Azure location. For example, **Central US**.
42-
- **Pricing tier**: to save costs, change the SKU to **Basic B1** (under Dev/Test).
37+
- **Subscription**: Select your Azure subscription from the drop-down menu.
38+
- **Resource Group**: Select **Create new** and then specify a name. Provide a different resource group name than the one you've been using in this tutorial series.
39+
- **Name**: enter a name for the App Service Plan.
40+
- **Operating System**: Select **Linux**.
41+
- **Region**: Select an Azure location from the drop-down menu, such as **Central US**.
42+
- **Pricing Tier**: To save costs, select **Change size** to change the **SKU and size** to **first Basic (B1)**, under **Dev / Test** for less demanding workloads.
4343

4444
![Resource Manager template export template portal](./media/template-tutorial-export-template/resource-manager-template-export.png)
4545
1. Select **Review and create**.
@@ -51,7 +51,7 @@ This template works well for deploying storage accounts, but you might want to a
5151

5252
![Go to resource](./media/template-tutorial-export-template/resource-manager-template-export-go-to-resource.png)
5353

54-
1. Select **Export template**.
54+
1. From the left menu, under **Automation**, select **Export template**.
5555

5656
![Resource Manager template export template](./media/template-tutorial-export-template/resource-manager-template-export-template.png)
5757

@@ -62,11 +62,11 @@ This template works well for deploying storage accounts, but you might want to a
6262
![Resource Manager template export template exported template](./media/template-tutorial-export-template/resource-manager-template-exported-template.png)
6363

6464
> [!IMPORTANT]
65-
> Typically, the exported template is more verbose than you might want when creating a template. For example, the SKU object in the exported template has five properties. This template works, but you could just use the `name` property. You can start with the exported template, and then modify it as you like to fit your requirements.
65+
> Typically, the exported template is more verbose than you might want when creating a template. The SKU object, for example, in the exported template has five properties. This template works, but you could just use the `name` property. You can start with the exported template and then modify it as you like to fit your requirements.
6666
6767
## Revise existing template
6868

69-
The exported template gives you most of the JSON you need, but you need to customize it for your template. Pay particular attention to differences in parameters and variables between your template and the exported template. Obviously, the export process doesn't know the parameters and variables that you've already defined in your template.
69+
The exported template gives you most of the JSON you need, but you have to customize it for your template. Pay particular attention to differences in parameters and variables between your template and the exported template. Obviously, the export process doesn't know the parameters and variables that you've already defined in your template.
7070

7171
The following example highlights the additions to your template. It contains the exported code plus some changes. First, it changes the name of the parameter to match your naming convention. Second, it uses your location parameter for the location of the app service plan. Third, it removes some of the properties where the default value is fine.
7272

@@ -93,7 +93,7 @@ New-AzResourceGroupDeployment `
9393

9494
# [Azure CLI](#tab/azure-cli)
9595

96-
To run this deployment command, you must have the [latest version](/cli/azure/install-azure-cli) of Azure CLI.
96+
To run this deployment command, you need to have the [latest version](/cli/azure/install-azure-cli) of Azure CLI.
9797

9898
```azurecli
9999
az deployment group create \
@@ -106,7 +106,7 @@ az deployment group create \
106106
---
107107

108108
> [!NOTE]
109-
> If the deployment failed, use the `verbose` switch to get information about the resources being created. Use the `debug` switch to get more information for debugging.
109+
> If the deployment fails, use the `verbose` switch to get information about the resources you're creating. Use the `debug` switch to get more information for debugging.
110110
111111
## Verify deployment
112112

@@ -115,22 +115,22 @@ You can verify the deployment by exploring the resource group from the Azure por
115115
1. Sign in to the [Azure portal](https://portal.azure.com).
116116
1. From the left menu, select **Resource groups**.
117117
1. Select the resource group you deployed to.
118-
1. The resource group contains a storage account and an App Service plan.
118+
1. The resource group contains a storage account and an App Service Plan.
119119

120120
## Clean up resources
121121

122122
If you're moving on to the next tutorial, you don't need to delete the resource group.
123123

124-
If you're stopping now, you might want to clean up the resources you deployed by deleting the resource group.
124+
If you're stopping now, you might want to delete the resource group.
125125

126-
1. From the Azure portal, select **Resource group** from the left menu.
127-
2. Enter the resource group name in the **Filter by name** field.
128-
3. Select the resource group name.
126+
1. From the Azure portal, select **Resource groups** from the left menu.
127+
2. Type the resource group name in the **Filter for any field...** text field.
128+
3. Check the box next to **myResourceGroup** and select **myResourceGroup** or your resource group name.
129129
4. Select **Delete resource group** from the top menu.
130130

131131
## Next steps
132132

133-
You learned how to export a template from the Azure portal, and how to use the exported template for your template development. You can also use the Azure Quickstart templates to simplify template development.
133+
You learned how to export a template from the Azure portal and how to use the exported template for your template development. You can also use the Azure Quickstart Templates to simplify template development.
134134

135135
> [!div class="nextstepaction"]
136-
> [Use Azure Quickstart templates](template-tutorial-quickstart-template.md)
136+
> [Use Azure Quickstart Templates](template-tutorial-quickstart-template.md)

0 commit comments

Comments
 (0)