Azure DevOps管道：如何在对象类型参数内嵌套循环标签

核心方案：利用Azure DevOps模板的嵌套循环表达式，结合Azure CLI实现批量资源标签的创建/更新 #

首先需要调整参数结构，将资源ID与对应标签键值对封装为数组对象，这样就能通过两层循环实现遍历：外层循环遍历资源，内层循环遍历每个资源的标签键值对。

1. 定义正确的模板参数结构 #

在template.yaml中，将资源和标签定义为数组类型的参数，每个元素包含资源ID和对应的标签对象：

parameters:
  # 原有的环境列表参数（如果需要按环境分组）
  - name: environments
    type: array
    default: ['dev', 'prod']
  
  # 新增：资源-标签映射数组，每个元素对应一个资源及其标签
  - name: resourcesWithTags
    type: array
    default:
      - resourceId: '/subscriptions/你的订阅ID/resourceGroups/rg-dev/providers/Microsoft.Compute/virtualMachines/vm-dev'
        tags:
          Environment: 'dev'
          Owner: 'DevTeam'
          Project: 'Demo'
      - resourceId: '/subscriptions/你的订阅ID/resourceGroups/rg-prod/providers/Microsoft.Storage/storageAccounts/storprod01'
        tags:
          Environment: 'prod'
          Owner: 'ProdTeam'
          CostCenter: 'CC-001'

如果需要按环境分组管理资源，可以调整参数结构为嵌套数组：

parameters:
  - name: environmentResourceGroups
    type: array
    default:
      - environment: 'dev'
        resources:
          - resourceId: '/subscriptions/xxx/resourceGroups/rg-dev/providers/Microsoft.Compute/virtualMachines/vm-dev'
            tags:
              Environment: 'dev'
              Owner: 'DevTeam'
      - environment: 'prod'
        resources:
          - resourceId: '/subscriptions/xxx/resourceGroups/rg-prod/providers/Microsoft.Storage/storageAccounts/storprod01'
            tags:
              Environment: 'prod'
              Owner: 'ProdTeam'

2. 实现嵌套循环的管道步骤 #

在管道中使用Azure DevOps的${{ each }}表达式实现嵌套循环，将标签键值对转换为Azure CLI可识别的格式后执行更新命令。

基础版：遍历资源-标签数组 #

steps:
  # 外层循环：遍历每个资源
  - ${{ each resource in parameters.resourcesWithTags }}:
    - task: AzureCLI@2
      displayName: "Update tags for resource: ${{ resource.resourceId }}"
      inputs:
        azureSubscription: '你的Azure服务连接名称'
        scriptType: 'bash'
        scriptLocation: 'inlineScript'
        inlineScript: |
          # 初始化标签字符串
          TAGS_STR=""
          # 内层循环：遍历当前资源的所有标签键值对
          ${{ each tag in resource.tags }}:
            TAGS_STR+="${{ tag.key }}=${{ tag.value }} "
          # 执行Azure CLI更新标签（--merge参数用于保留原有标签，仅新增/更新指定标签；若要覆盖则移除--merge）
          az resource update --id "${{ resource.resourceId }}" --tags $TAGS_STR --merge

按环境分组版：三层嵌套循环 #

如果使用环境分组的参数结构，可添加一层环境循环：

steps:
  # 第一层循环：遍历环境分组
  - ${{ each envGroup in parameters.environmentResourceGroups }}:
    # 第二层循环：遍历当前环境下的所有资源
    - ${{ each resource in envGroup.resources }}:
      - task: AzureCLI@2
        displayName: "[${{ envGroup.environment }}] Update tags for ${{ resource.resourceId }}"
        inputs:
          azureSubscription: '你的Azure服务连接名称'
          scriptType: 'bash'
          scriptLocation: 'inlineScript'
          inlineScript: |
            TAGS_STR=""
            ${{ each tag in resource.tags }}:
              TAGS_STR+="${{ tag.key }}=${{ tag.value }} "
            az resource update --id "${{ resource.resourceId }}" --tags $TAGS_STR --merge

关键注意事项 #

• 标签值含空格处理：如果标签值包含空格，需要将键值对用单引号包裹，比如TAGS_STR+="${{ tag.key }}='${{ tag.value }}' "
• 权限要求：确保Azure DevOps服务连接对应的服务主体拥有Resource Contributor或Microsoft.Resources/tags/write权限
• 覆盖/合并模式：使用--merge参数会保留资源原有标签，仅更新指定标签；移除该参数则会用新标签完全覆盖原有标签

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