Azure Pipelines：如何为Git子模块选择分支或提交

动态下拉选项（推荐） #

通过Azure Pipelines的运行时参数+REST API，可以动态拉取子模块仓库的分支/标签/提交记录生成下拉列表，完全替代Jenkins git-parameter插件的功能：

1. 定义动态参数
   在流水线YAML开头定义参数，后续通过前置步骤的输出值填充下拉选项：

parameters:
  - name: targetSubmoduleRef
    type: string
    default: 'main'
    values: [] # 动态填充占位

2. 拉取子模块的分支/标签
   添加前置步骤调用Azure DevOps REST API（或对应Git平台的API）获取子模块的分支列表，以Azure DevOps仓库为例：

steps:
  - script: |
      # 登录Azure DevOps（使用流水线内置系统令牌）
      az devops login --organization $(System.CollectionUri) --token $(System.AccessToken)
      
      # 拉取子模块仓库的分支列表，过滤掉heads/前缀
      az repos ref list \
        --repository "你的子模块仓库名" \
        --organization $(System.CollectionUri) \
        --filter "heads/" \
        --query "[].name | replace(@, 'refs/heads/', '')" \
        -o json > submodule_branches.json
    displayName: '获取子模块分支列表'
    name: fetchSubmoduleRefs

  # 将分支列表转为输出变量供参数使用
  - script: |
      echo "##vso[task.setVariable variable=submoduleRefs;isOutput=true]$(cat submodule_branches.json)"
    displayName: '设置分支列表变量'
    name: setRefsVariable

3. 更新参数选项并切换子模块
   通过表达式引用输出变量生成下拉选项，然后执行子模块切换操作：

parameters:
  - name: targetSubmoduleRef
    type: string
    default: 'main'
    values: ${{ fromJSON(steps.setRefsVariable.outputs.submoduleRefs) }}

steps:
  - script: |
      if [ -n "${{ parameters.targetSubmoduleRef }}" ]; then
        cd "你的子模块路径"
        git checkout --detach ${{ parameters.targetSubmoduleRef }}
        # 可选：拉取最新代码
        git pull
      fi
    displayName: '切换子模块到指定引用'

静态下拉选项（快速实现） #

如果子模块的分支/标签相对固定，直接定义静态下拉选项更高效：

parameters:
  - name: targetSubmoduleRef
    type: string
    default: 'main'
    values:
      - main
      - develop
      - feature/test-build
      - 'v1.2.0' # 支持标签
      - 'a1b2c3d' # 支持提交哈希

后续切换子模块的脚本与上述方案一致。

注意事项 #

• 动态方案需要确保流水线代理有权限访问子模块仓库，使用$(System.AccessToken)可自动获取流水线权限。
• 若要支持提交哈希，可修改API调用逻辑拉取仓库最近提交记录（如az repos commit list），但提交哈希数量较多时下拉体验不佳，仅建议测试场景使用。

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