教程：部署本地 ARM 模板

项目
06/06/2023

了解如何从本地计算机部署 Azure 资源管理器模板（ARM 模板）。完成本教程大约需要 8 分钟。

本文是相关教学系列的第一篇教程。在学习该系列时，你将通过创建链接模板来将模板模块化，将链接模板存储在存储帐户中，使用 SAS 令牌保护链接模板，并了解如何创建 DevOps 管道来部署模板。该系列重点介绍模板部署。如果希望了解模板开发，请参阅初学者教程。

获取工具

首先，请确保已获取部署模板所需的工具。

命令行部署

你需要使用 Azure PowerShell 或 Azure CLI 来部署模板。有关安装说明，请参阅：

安装 Azure PowerShell 或 Azure CLI 后，请务必完成首次登录。有关帮助，请参阅登录 - PowerShell 或登录 - Azure CLI。

编辑器（可选）

模板是一些 JSON 文件。若要查看/编辑模板，需要一个好用的 JSON 编辑器。我们建议使用带有资源管理器工具扩展的 Visual Studio Code。如果需要安装这些工具，请参阅快速入门：使用 Visual Studio Code 创建 ARM 模板。

审阅模板

模板部署一个存储帐户、应用服务计划和 Web 应用。如果对创建模板感兴趣，则可完成关于快速入门模板的教程。但这不是完成本教程所必需的。

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "projectName": {
      "type": "string",
      "maxLength": 11,
      "minLength": 3,
      "metadata": {
        "description": "Specify a project name that is used to generate resource names."
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Specify a location for the resources."
      }
    },
    "storageSKU": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "allowedValues": [
        "Standard_LRS",
        "Standard_GRS",
        "Standard_RAGRS",
        "Standard_ZRS",
        "Premium_LRS",
        "Premium_ZRS",
        "Standard_GZRS",
        "Standard_RAGZRS"
      ],
      "metadata": {
        "description": "Specify the storage account type."
      }
    },
    "linuxFxVersion": {
      "type": "string",
      "defaultValue": "php|7.0",
      "metadata": {
        "description": "Specify the Runtime stack of current web app"
      }
    }
  },
  "variables": {
    "storageAccountName": "[format('{0}{1}', parameters('projectName'), uniqueString(resourceGroup().id))]",
    "webAppName": "[format('{0}WebApp', parameters('projectName'))]",
    "appServicePlanName": "[format('{0}Plan', parameters('projectName'))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2022-09-01",
      "name": "[variables('storageAccountName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('storageSKU')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    },
    {
      "type": "Microsoft.Web/serverfarms",
      "apiVersion": "2022-09-01",
      "name": "[variables('appServicePlanName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "B1",
        "tier": "Basic",
        "size": "B1",
        "family": "B",
        "capacity": 1
      },
      "kind": "linux",
      "properties": {
        "perSiteScaling": false,
        "reserved": true,
        "targetWorkerCount": 0,
        "targetWorkerSizeId": 0
      }
    },
    {
      "type": "Microsoft.Web/sites",
      "apiVersion": "2022-09-01",
      "name": "[variables('webAppName')]",
      "location": "[parameters('location')]",
      "kind": "app",
      "properties": {
        "serverFarmId": "[resourceId('Microsoft.Web/serverfarms', variables('appServicePlanName'))]",
        "siteConfig": {
          "linuxFxVersion": "[parameters('linuxFxVersion')]"
        }
      },
      "dependsOn": [
        "appServicePlan"
      ]
    }
  ],
  "outputs": {
    "storageEndpoint": {
      "type": "object",
      "value": "[reference(variables('storageAccountName')).primaryEndpoints]"
    }
  }
}

重要

存储帐户名称必须唯一，长度为 3 到 24 个字符，只能使用数字和小写字母。示例模板的 storageAccountName 变量将 projectName 参数的最大值（11 个字符）与 uniqueString 值（13 个字符）组合在一起。

以 .json 为扩展名将模板的副本保存到本地计算机，例如 azuredeploy.json 。稍后在本教程中将部署此模板。

若要开始使用 Azure PowerShell/Azure CLI 来部署模板，请使用你的 Azure 凭据登录。

PowerShell
Azure CLI

Connect-AzAccount -Environment AzureChinaCloud

注意

在可以在由世纪互联运营的 Microsoft Azure 中使用 Azure CLI 之前，请先运行 az cloud set -n AzureChinaCloud 来更改云环境。若要切换回 Azure 公有云，请再次运行 az cloud set -n AzureCloud。

az cloud set -n AzureChinaCloud
az login

如果你有多个 Azure 订阅，请选择要使用的订阅。将 [SubscriptionID/SubscriptionName] 和方括号 [] 替换为你的订阅信息：

PowerShell
Azure CLI

Set-AzContext [SubscriptionID/SubscriptionName]

az account set --subscription [SubscriptionID/SubscriptionName]

创建资源组

部署模板时，请指定一个包含资源的资源组。在运行部署命令之前，请使用 Azure CLI 或 Azure PowerShell 创建该资源组。使用以下代码部分中的选项卡在 Azure PowerShell 与 Azure CLI 之间进行选择。本文中的 CLI 示例针对 Bash shell 编写。

PowerShell
Azure CLI

$projectName = Read-Host -Prompt "Enter a project name that is used to generate resource and resource group names"
$resourceGroupName = "${projectName}rg"

New-AzResourceGroup `
  -Name $resourceGroupName `
  -Location "China North"

echo "Enter a project name that is used to generate resource and resource group names:"
read projectName
resourceGroupName="${projectName}rg"

az group create \
  --name $resourceGroupName \
  --location "China North"

部署模板

使用一个或两个部署选项来部署模板。

PowerShell
Azure CLI

$projectName = Read-Host -Prompt "Enter the same project name"
$templateFile = Read-Host -Prompt "Enter the template file path and file name"
$resourceGroupName = "${projectName}rg"

New-AzResourceGroupDeployment `
  -Name DeployLocalTemplate `
  -ResourceGroupName $resourceGroupName `
  -TemplateFile $templateFile `
  -projectName $projectName `
  -verbose

若要详细了解如何使用 Azure PowerShell 部署模板，请参阅使用 ARM 模板和 Azure PowerShell 部署资源。

echo "Enter the same project name:"
read projectName
echo "Enter the template file path and file name:"
read templateFile
resourceGroupName="${projectName}rg"

az deployment group create \
  --name DeployLocalTemplate \
  --resource-group $resourceGroupName \
  --template-file $templateFile \
  --parameters projectName=$projectName \
  --verbose

若要详细了解如何使用 Azure CLI 部署模板，请参阅使用 ARM 模板和 Azure CLI 部署资源。

清理资源

通过删除资源组来清理你部署的资源。

在 Azure 门户上的左侧菜单中选择“资源组” 。
在“按名称筛选”字段中输入资源组名称。
选择资源组名称。
在顶部菜单中选择“删除资源组”。

后续步骤

现在，你已了解了如何部署本地模板。在下一教程中，你需要将该模板拆分为一个主模板和一个链接模板，并了解如何存储和保护链接模板。

部署链接模板