快速入门:使用 Visual Studio Code 创建 Azure 资源管理器模板

了解如何使用 Visual Studio Code 和 Azure 资源管理器工具扩展创建和编辑 Azure 资源管理器模板。 可以在 Visual Studio Code 中不使用扩展创建资源管理器模板,但是该扩展提供自动完成选项,可以简化模板开发。 若要了解与部署和管理 Azure 解决方案相关联的概念,请参阅 Azure Resource Manager 概述

在本教程中,你将部署存储帐户:

资源管理器模板快速入门 visual studio 代码关系图

如果没有 Azure 订阅,请在开始前创建一个试用帐户

先决条件

若要完成本文,需要做好以下准备:

  • Visual Studio Code

  • 资源管理器工具扩展。 若要安装此扩展,请使用以下步骤:

    1. 打开 Visual Studio Code。
    2. CTRL+SHIFT+X 打开“扩展”窗格
    3. 搜索“Azure 资源管理器工具”,然后选择“安装”。
    4. 选择“重新加载”完成扩展安装。

打开快速入门模板

无需从头开始创建模板,可以通过 Azure 快速入门模板打开一个模板。 Azure 快速入门模板是资源管理器模板的存储库。

本快速入门中使用的模板称为创建标准存储帐户。 该模板定义 Azure 存储帐户资源。

  1. 在 Visual Studio Code 中,选择“文件”>“打开文件”。

  2. 在“文件名”中粘贴以下 URL:

    https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-storage-account-create/azuredeploy.json
    
  3. 选择“打开”以打开该文件。

  4. 选择“文件”>“另存为”,将该文件作为 azuredeploy.json 保存到本地计算机。

编辑模板

若要体验如何使用 Visual Studio Code 来编辑模板,请将额外的一个元素添加到 outputs 节以显示存储 URI。

  1. 将额外的一个输出添加到导出的模板:

    "storageUri": {
      "type": "string",
      "value": "[reference(variables('storageAccountName')).primaryEndpoints.blob]"
    }
    

    完成后,outputs 节如下所示:

    "outputs": {
      "storageAccountName": {
        "type": "string",
        "value": "[variables('storageAccountName')]"
      },
      "storageUri": {
        "type": "string",
        "value": "[reference(variables('storageAccountName')).primaryEndpoints.blob]"
      }
    }
    

    如果在 Visual Studio Code 中复制并粘贴了代码,请尝试重新键入 value 元素,以体验资源管理器工具扩展的 IntelliSense 功能。

    资源管理器模板 - Visual Studio Code - IntelliSense

  2. 选择“文件”>“保存”以保存文件。

部署模板

可通过多种方法来部署模板。 在本快速入门中,使用 Azure 本地 Shell 或 Azure PowerShell 部署模板。

Note

本文进行了更新,以便使用新的 Azure PowerShell Az 模块。 若要详细了解新的 Az 模块和 AzureRM 兼容性,请参阅新 Azure Powershell Az 模块简介。 有关安装说明,请参阅安装 Azure PowerShell

  1. 从 Azure 本地 shell 运行以下命令。 选择用于显示 PowerShell 代码或 CLI 代码的选项卡。

    az cloud set -n AzureChinaCloud
    az login
    echo "Enter the Resource Group name:" &&
    read resourceGroupName &&
    echo "Enter the name for this deployment:" &&
    read deploymentName &&
    echo "Enter the location (i.e. chinaeast):" &&
    read location &&
    az group create --name $resourceGroupName --location $location &&
    az group deployment create --name $deploymentName --resource-group $resourceGroupName --template-file "azuredeploy.json"
    

    如果将模板文件保存到了 azuredeploy.json 之外的其他文件中,其更新其名称。

    以下屏幕截图显示了示例部署:

    输出部分的存储帐户名称和存储 URL 在屏幕截图上突出显示。 在下一步需要此存储帐户名称。

  2. 运行以下 CLI 或 PowerShell 命令,列出新建的存储帐户:

    echo "Enter the Resource Group name:" &&
    read resourceGroupName &&
    echo "Enter the Storage Account name:" &&
    read storageAccountName &&
    az storage account show --resource-group $resourceGroupName --name $storageAccountName
    

若要详细了解如何使用 Azure 存储帐户,请参阅快速入门:使用 Azure 门户上传、下载和列出 Blob

清理资源

不再需要 Azure 资源时,请通过删除资源组来清理部署的资源。

  1. 在 Azure 门户上的左侧菜单中选择“资源组”。
  2. 在“按名称筛选”字段中输入资源组名称。
  3. 选择资源组名称。 应会看到,该资源组中总共有六个资源。
  4. 在顶部菜单中选择“删除资源组”。

后续步骤

本快速入门的主要关注点是如何使用 Visual Studio Code 编辑 Azure 快速入门模板中的现有模板。 此外还介绍了如何通过本地电脑使用 CLI 或 PowerShell 部署模板。 Azure 快速入门模板中的模板可能并未提供你所需的一切。 下一教程介绍如何从模板参考中查找信息,以便创建加密的 Azure 存储帐户。