练习 - 使用 Azure 资源管理器变量存储表达式

已完成

在本练习中,你将 Azure 存储帐户名称表达式存储在 Azure 资源管理器 (ARM) 模板变量中。 然后,使用该变量指定要创建的存储帐户的名称。

本练习使用适用于 Visual Studio Code 的 Azure 资源管理器工具。 请务必在 Visual Studio Code 中安装此扩展。

添加变量

添加一个变量,用于将存储帐户名称表达式存储在模板中的某个位置。

  1. 在 Visual Studio Code 中,将光标放在 azuredeploy.json 文件中变量块 "variables":{} 的大括号内,然后按 Enter

  2. 在括号内键入 var。 你将看到相关代码片段的列表。 选择 arm-variable:

    Screenshot of Visual Studio Code that shows the snippets for Azure Resource Manager template variables.

  3. 变量部分类似于以下代码:

    "variables": {"variable1": "value"},
    
  4. 将变量的名称更改为 uniqueStorageName,并将值更改为 "[toLower(concat(parameters('storagePrefix'),uniqueString(resourceGroup().id)))]"。 变量部分类似于以下代码:

    "variables": {
        "uniqueStorageName": "[toLower(concat(parameters('storagePrefix'),uniqueString(resourceGroup().id)))]"
      },
    

    请注意,在表达式中使用的是 storagePrefix 参数,而不是文本字符串。 否则,该表达式就和上一个单元中了解的表达式一样了。

  5. 在资源部分使用该变量。 将 name:displayName 特性的值更改为 "[variables('uniqueStorageName')]"

  6. 整个文件如以下示例所示:

    {
        "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
        "contentVersion": "1.0.0.0",
        "parameters": {
           "storagePrefix": {
               "type": "string",
               "minLength": 3,
               "maxLength": 11
           },
            "storageSKU": {
                "type": "string",
                "defaultValue": "Standard_LRS",
                "allowedValues": [
                    "Standard_LRS",
                    "Standard_GRS",
                    "Standard_RAGRS",
                    "Standard_ZRS",
                    "Premium_LRS",
                    "Premium_ZRS",
                    "Standard_GZRS",
                    "Standard_RAGZRS"
                ]
            }
       },
        "functions": [],
        "variables": {
        "uniqueStorageName": "[toLower(concat(parameters('storagePrefix'),uniqueString(resourceGroup().id)))]"
      },
        "resources": [{
            "name": "[variables('uniqueStorageName')]",
            "type": "Microsoft.Storage/storageAccounts",
            "apiVersion": "2019-06-01",
            "tags": {
                "displayName": "[variables('uniqueStorageName')]"
            },
            "location": "[resourceGroup().location]",
            "kind": "StorageV2",
            "sku": {
             "name": "[parameters('storageSKU')]"
           }
        }],
        "outputs": {}
    }
    

(可选)部署模板

已更新的模板不会对你部署的资源进行任何更改,因此部署此模板不会对你的 Azure 环境进行任何更改。

如果你想部署此模板,以查看其是否成功,可使用以下 Azure CLI 命令。 请务必使用你在上一部署中使用的相同 storagePrefix 参数值。

templateFile="azuredeploy.json"
today=$(date +"%d-%b-%Y")
DeploymentName="addVariable-"$today

az deployment group create \
  --name $DeploymentName \
  --template-file $templateFile \
  --parameters storagePrefix={your-Prefix}

如果你想部署此模板,观看成功部署它的过程,可使用以下 Azure PowerShell 命令。 请务必使用你在上一部署中使用的相同 storagePrefix 参数值。

$templateFile = "azuredeploy.json"
$today=Get-Date -Format "MM-dd-yyyy"
$deploymentName="addVariable-"+"$today"
New-AzResourceGroupDeployment `
  -Name $deploymentName `
  -TemplateFile $templateFile `
  -storagePrefix {your-Prefix}