Skip to content

Commit 36d299d

Browse files
authored
Merge pull request #208419 from sheisanchez/0818-use-quickstart-template
first round of edits for use quickstart template tutorial
2 parents b17c415 + b9fc7e3 commit 36d299d

File tree

1 file changed

+16
-17
lines changed

1 file changed

+16
-17
lines changed

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

Lines changed: 16 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,39 +1,38 @@
11
---
22
title: Tutorial - Use quickstart templates
3-
description: Learn how to use Azure Quickstart templates to complete your template development.
3+
description: Learn how to use Azure Quickstart Templates to complete your template development.
44
author: mumian
5-
ms.date: 03/27/2020
5+
ms.date: 08/17/2022
66
ms.topic: tutorial
77
ms.author: jgao
88
ms.custom:
99
---
1010

11-
# Tutorial: Use Azure Quickstart templates
11+
# Tutorial: Use Azure Quickstart Templates
1212

13-
[Azure Quickstart templates](https://azure.microsoft.com/resources/templates/) is a repository of community contributed templates. You can use the sample templates in your template development. In this tutorial, you find a website resource definition, and add it to your own template. It takes about **12 minutes** to complete.
13+
[Azure Quickstart Templates](https://azure.microsoft.com/resources/templates/) is a repository of community contributed templates. You can use the sample templates in your template development. In this tutorial, you find a website resource definition and add it to your own template. This instruction takes **12 minutes** to complete.
1414

1515
## Prerequisites
1616

1717
We recommend that you complete the [tutorial about exported templates](template-tutorial-export-template.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/export-template/azuredeploy.json":::
2626

2727
This template works for deploying storage accounts and app service plans, but you might want to add a website to it. You can use pre-built templates to quickly discover the JSON required for deploying a resource.
2828

2929
## Find template
3030

31-
1. Open [Azure Quickstart templates](https://azure.microsoft.com/resources/templates/)
32-
1. In **Search**, enter _deploy linux web app_.
31+
1. Open [Azure Quickstart Templates](https://azure.microsoft.com/resources/templates/)
3332
1. Select the tile with the title **Deploy a basic Linux web app**. If you have trouble finding it, here's the [direct link](https://azure.microsoft.com/resources/templates/webapp-basic-linux/).
3433
1. Select **Browse on GitHub**.
3534
1. Select _azuredeploy.json_.
36-
1. Review the template. In particular, look for the `Microsoft.Web/sites` resource.
35+
1. Review the template. Look for the `Microsoft.Web/sites` resource.
3736

3837
![Resource Manager template quickstart web site](./media/template-tutorial-quickstart-template/resource-manager-template-quickstart-template-web-site.png)
3938

@@ -43,13 +42,13 @@ Merge the quickstart template with the existing template:
4342

4443
:::code language="json" source="~/resourcemanager-templates/get-started-with-templates/quickstart-template/azuredeploy.json" range="1-108" highlight="32-45,49,85-100":::
4544

46-
The web app name needs to be unique across Azure. To prevent having duplicate names, the `webAppPortalName` variable has been updated from `"webAppPortalName": "[concat(parameters('webAppName'), '-webapp')]"` to `"webAppPortalName": "[concat(parameters('webAppName'), uniqueString(resourceGroup().id))]"`.
45+
The web app name needs to be unique across Azure. To prevent having duplicate names, the `webAppPortalName` variable is updated from `"webAppPortalName": "[concat(parameters('webAppName'), '-webapp')]"` to `"webAppPortalName": "[concat(parameters('webAppName'), uniqueString(resourceGroup().id))]"`.
4746

4847
Add a comma at the end of the `Microsoft.Web/serverfarms` definition to separate the resource definition from the `Microsoft.Web/sites` definition.
4948

5049
There are a couple of important features to note in this new resource.
5150

52-
You'll notice it has an element named `dependsOn` that's set to the app service plan. This setting is required because the app service plan must exist before the web app is created. The `dependsOn` element tells Resource Manager how to order the resources for deployment.
51+
It has an element named `dependsOn` that's set to the app service plan. This setting is required because the app service plan needs to exist before the web app is created. The `dependsOn` element tells Resource Manager how to order the resources for deployment.
5352

5453
The `serverFarmId` property uses the [resourceId](template-functions-resource.md#resourceid) function. This function gets the unique identifier for a resource. In this case, it gets the unique identifier for the app service plan. The web app is associated with one specific app service plan.
5554

@@ -73,7 +72,7 @@ New-AzResourceGroupDeployment `
7372

7473
# [Azure CLI](#tab/azure-cli)
7574

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

7877
```azurecli
7978
az deployment group create \
@@ -86,17 +85,17 @@ az deployment group create \
8685
---
8786

8887
> [!NOTE]
89-
> 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.
88+
> 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.
9089
9190
## Clean up resources
9291

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

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

97-
1. From the Azure portal, select **Resource group** from the left menu.
98-
2. Enter the resource group name in the **Filter by name** field.
99-
3. Select the resource group name.
96+
1. From the Azure portal, select **Resource groups** from the left menu.
97+
2. Type the resource group name in the **Filter for any field...** text field.
98+
3. Check the box next to **myResourceGroup** and select **myResourceGroup** or your resource group name.
10099
4. Select **Delete resource group** from the top menu.
101100

102101
## Next steps

0 commit comments

Comments
 (0)