如何通过Azure CLI向Bicep模板传递动态Azure标签参数

我需要实现向Bicep部署传递动态标签，目前先测试单个标签，后续会扩展为传递多个标签。

现有Bicep模板 #

param tagValues object = {}
resource storageAccount 'Microsoft.Storage/storageAccounts@2021-09-01' = {
  name: 'storage123x01'
  location: 'westeurope'
  tags: tagValues
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'StorageV2'
  properties: {
    allowBlobPublicAccess: false
    networkAcls: {
      defaultAction: 'Deny'
    }
  }
}

硬编码标签的可行测试 #

当我在Bicep模板中直接给tagValues参数赋值时，部署可以正常工作：

param tagValues object = {
  commonTag1: 'commonValue1'
}

Azure DevOps任务配置问题 #

由于标签需要根据部署时的动态因素生成，不能硬编码在模板中，我尝试用Azure DevOps的Azure CLI任务传递参数，但多次尝试均失败。当前测试用的任务配置如下：

- task: AzureCLI@2
  displayName: "Create Storage Account" 
  inputs:
    azureSubscription: $(SPN)
    scriptType: 'ps'
    scriptLocation: 'inlineScript'
    inlineScript: |
      az deployment group create `
      --resource-group $(resourceGroup) `
      --template-file $(storageAccountTemplate) `
      --parameters `
        tagValues="commonTag2`:` 'commonValue2'"

可行解决方案 #

问题核心在于Bicep的tagValues是object类型，Azure CLI传递object参数必须使用标准JSON格式，之前的写法无法被正确解析为object。以下是两种可行的实现方式：

方式1：直接传递JSON格式字符串（测试用） #

直接构造符合要求的JSON字符串作为参数值，注意PowerShell中要正确处理引号：

- task: AzureCLI@2
  displayName: "Create Storage Account" 
  inputs:
    azureSubscription: $(SPN)
    scriptType: 'ps'
    scriptLocation: 'inlineScript'
    inlineScript: |
      az deployment group create `
      --resource-group $(resourceGroup) `
      --template-file $(storageAccountTemplate) `
      --parameters tagValues='{"commonTag2": "commonValue2"}'

方式2：动态生成标签（生产场景） #

如果需要从Azure DevOps变量或其他动态来源生成标签，可以用PowerShell构造哈希表，再转换为压缩的JSON字符串传递：

- task: AzureCLI@2
  displayName: "Create Storage Account" 
  inputs:
    azureSubscription: $(SPN)
    scriptType: 'ps'
    scriptLocation: 'inlineScript'
    inlineScript: |
      # 动态构造标签哈希表，可结合AzDO变量
      $dynamicTags = @{
        Environment = $(Environment)
        Project = $(ProjectName)
        DeploymentDate = (Get-Date -Format "yyyy-MM-dd")
        commonTag2 = "commonValue2"
      }

      # 转换为压缩的JSON字符串，避免格式问题
      $tagsJson = $dynamicTags | ConvertTo-Json -Compress

      az deployment group create `
      --resource-group $(resourceGroup) `
      --template-file $(storageAccountTemplate) `
      --parameters tagValues=$tagsJson

注意事项 #

• 确保JSON格式正确，键值对都用双引号包裹
• 使用ConvertTo-Json -Compress可以避免换行和空格导致的解析问题
• 多个标签只需在哈希表中添加更多键值对即可，Bicep会自动将整个object应用为资源标签

内容的提问来源于stack exchange，提问作者Clumsyhands