Azure Pipelines中仓库标签引用通配符使用可行性咨询

可行性说明 #

原生resources.repositories.ref字段不支持直接填写通配符匹配标签，直接写refs/tags/version-1.3.*无法生效，需要通过自定义脚本的方式实现需求。

正确配置指导 #

核心逻辑是先拉取仓库默认分支，再通过git命令筛选出符合通配符规则的最新标签，再切换到对应版本，完整配置示例如下：

全平台通用基础配置 #

resources:
  repositories:
  - repository: my_repo
    type: git
    name: myProject/repo
    ref: main # 填写仓库默认分支即可，后续会切换到目标标签

steps:
- checkout: my_repo
  path: s/my_repo
  persistCredentials: true # 保留git操作凭证

Windows代理下的标签切换脚本 #

- pwsh: |
    git fetch --tags
    # 筛选符合规则的标签并按语义化版本倒序取最新
    $latestTag = git tag -l "version-1.3.*" | Sort-Object { [version]($_ -replace 'version-', '') } -Descending | Select-Object -First 1
    if (-not $latestTag) {
      Write-Error "未找到匹配version-1.3.*的标签"
      exit 1
    }
    Write-Host "匹配到最新标签：$latestTag"
    git checkout $latestTag
    # 输出到管道变量供后续任务使用
    echo "##vso[task.setvariable variable=LATEST_MATCH_TAG]$latestTag"
  workingDirectory: $(Build.SourcesDirectory)/my_repo
  displayName: 切换到最新匹配标签

Linux/Mac代理下的标签切换脚本 #

- bash: |
    git fetch --tags
    latestTag=$(git tag -l "version-1.3.*" | sort -rV | head -n 1)
    if [ -z "$latestTag" ]; then
      echo "未找到匹配version-1.3.*的标签"
      exit 1
    fi
    echo "匹配到最新标签：$latestTag"
    git checkout $latestTag
    echo "##vso[task.setvariable variable=LATEST_MATCH_TAG]$latestTag"
  workingDirectory: $(Build.SourcesDirectory)/my_repo
  displayName: 切换到最新匹配标签

注意事项 #

• 标签命名需要符合语义化版本规则，否则排序逻辑可能无法得到正确的最新版本，如有自定义命名规则可自行调整排序逻辑。
• 如果需要多阶段复用该仓库，可将切换标签步骤放在各阶段开头，或配置管道缓存复用已拉取切换后的仓库内容。

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