Azure DevOps特性分支自动版本控制优化方案及最佳实践咨询

当前使用的版本控制配置 #

variables:
  major: '1'
  minor: '1'
  revision: $[counter(variables['minor'], 1)] # 每次minor版本提升时，revision会重置
  ${{ if eq( variables['Build.SourceBranchName'], 'master' ) }}: 
    nugetVersion: '$(major).$(minor).$(revision)'
  ${{ else }} : 
    nugetVersion: '$(major).$(minor).$(revision)-$(Build.SourceBranchName)'

现有方案的问题 #

major和minor版本需手动修改，revision会在minor变更时重置为1并随流水线运行递增。但多分支开发时，非master分支的流水线运行也会触发revision递增，导致master分支版本号跳号，无法保持连贯序列。

你的设想及优化实现 #

你提出的基于master最新版本、在分支名后添加独立递增号的思路完全可行，且符合语义化版本（SemVer）规范。以下是具体实现方案：

优化后的流水线配置示例

variables:
  # 手动维护主版本和次版本，也可移至变量组统一管理
  major: '1'
  minor: '1'
  # 拉取master分支的最新revision（示例通过git读取版本文件，也可直接查询NuGet源）
  masterRevision: $[script('git fetch origin master && cat $(Build.SourcesDirectory)/version.txt | awk -F. "{print $3}"')]

  # master分支沿用原有逻辑，保持版本连贯
  ${{ if eq(variables['Build.SourceBranchName'], 'master') }}:
    revision: $[counter(variables['minor'], 1)]
    nugetVersion: '$(major).$(minor).$(revision)'
    # 构建成功后更新version文件，方便其他分支读取
    postBuildScript: 'echo $(nugetVersion) > $(Build.SourcesDirectory)/version.txt && git commit -m "Update version to $(nugetVersion)" && git push'
  # 其他分支使用master基准版本+分支独立计数器
  ${{ else }}:
    # 每个分支单独维护计数器，不影响master的revision序列
    branchBuildCounter: $[counter(variables['Build.SourceBranchName'], 1)]
    nugetVersion: '$(major).$(minor).$(masterRevision)-$(Build.SourceBranchName).$(branchBuildCounter)'

行业通用最佳实践 #

• 严格遵循语义化版本（SemVer）：预发布版本格式采用主版本.次版本.修订号-预发布标识.构建号，你的方案完全贴合这个标准，便于工具解析和团队理解。
• 分支隔离计数器：每个分支使用独立的计数器键（比如分支名），彻底避免跨分支的版本号干扰，保证master分支版本严格按构建次数递增。
• 版本持久化存储：在master分支根目录维护version.txt或Directory.Build.props文件，流水线读取该文件作为版本基准，比硬编码变量更易维护和追溯。
• 预发布标识规范化：建议将分支名转换为更简洁的标识，比如feature分支用feature-xxx，bugfix分支用bugfix-xxx，避免特殊字符导致版本解析问题。

额外实用建议 #

• 把major和minor移至Azure DevOps的变量组中，无需修改流水线配置即可更新版本，更适合团队协作场景。
• 可在分支版本中添加日期戳，比如1.0.9-foo.20240520.1，进一步提升版本的可追溯性，方便定位构建时间。

内容的提问来源于stack exchange，提问作者Luis Angel Urena Lopez