Azure DevOps中Maven多模块项目PR流水线仅构建变更子模块及标签触发问询

针对你的需求，以下是实现PR触发时仅构建变更子模块+PR标签条件触发特定任务的完整azure-pipelines.yml配置及关键说明：

核心思路 #

1. 通过git diff对比PR目标分支与当前分支，识别变更的子模块目录
2. 将变更模块列表输出为流水线变量，供后续任务复用
3. 利用Maven的-pl参数指定仅构建目标模块，配合-am可选构建依赖模块
4. 通过PR标签判断，实现全量构建、跳过测试等特殊场景触发

完整流水线配置 #

# 仅通过PR触发流水线，禁用分支自动触发
trigger: none
pr:
  branches:
    include:
      - main # 替换为你的目标分支

# 全局变量定义
variables:
  - name: allModules
    value: 'A B C D E F' # 与父pom的子模块保持一致
  - name: mavenOpts
    value: '-Xmx2048m'
  - name: dockerRegistry
    value: 'your-registry.azurecr.io' # 替换为你的镜像仓库地址

jobs:
  # 作业1：检测变更的子模块，输出全局变量
  - job: DetectChangedModules
    displayName: '识别变更子模块'
    outputs:
      changedModules: ${{ steps.setChangedModules.outputs.changedModules }}
    steps:
      - bash: |
          # 初始化变更模块列表
          changed_modules=""

          # 检查PR是否带full-build标签，触发全量构建
          if [[ "${{ contains(join(' ', parameters.tags), 'full-build') }}" == "true" ]]; then
            changed_modules="${{ variables.allModules }}"
          else
            # 拉取目标分支最新代码，对比差异
            git fetch origin $SYSTEM_PULLREQUEST_TARGETBRANCH
            target_commit=$(git rev-parse origin/$SYSTEM_PULLREQUEST_TARGETBRANCH)

            # 遍历所有子模块，检查是否有文件变更
            for module in ${{ variables.allModules }}; do
              if git diff --name-only $target_commit HEAD | grep -E "^$module/" > /dev/null; then
                changed_modules="$changed_modules $module"
              fi
            done
          fi

          # 格式化为逗号分隔字符串（适配Maven -pl参数）
          changed_modules=$(echo $changed_modules | sed 's/^ //' | tr ' ' ',')
          echo "变更模块列表：$changed_modules"
          echo "##vso[task.setvariable variable=changedModules;isOutput=true]$changed_modules"
        name: setChangedModules
        displayName: '检测并输出变更模块'

  # 作业2：编译+测试变更模块
  - job: BuildAndTest
    displayName: '编译测试变更模块'
    dependsOn: DetectChangedModules
    condition: ne(dependencies.DetectChangedModules.outputs['setChangedModules.changedModules'], '')
    steps:
      - task: Maven@3
        displayName: '执行编译与测试'
        # 若PR带skip-tests标签，跳过测试步骤
        condition: not(contains(join(' ', parameters.tags), 'skip-tests'))
        inputs:
          mavenPomFile: 'pom.xml'
          goals: 'clean test compile'
          options: '-pl ${{ dependencies.DetectChangedModules.outputs['setChangedModules.changedModules'] }} -am'
          mavenOptions: '$(mavenOpts)'
          publishJUnitResults: true
          testResultsFiles: '**/surefire-reports/TEST-*.xml'

      # 跳过测试时仅执行编译
      - task: Maven@3
        displayName: '仅编译（跳过测试）'
        condition: contains(join(' ', parameters.tags), 'skip-tests')
        inputs:
          mavenPomFile: 'pom.xml'
          goals: 'clean compile'
          options: '-pl ${{ dependencies.DetectChangedModules.outputs['setChangedModules.changedModules'] }} -am'
          mavenOptions: '$(mavenOpts)'

  # 作业3：打包变更模块
  - job: Package
    displayName: '打包变更模块'
    dependsOn: BuildAndTest
    condition: ne(dependencies.DetectChangedModules.outputs['setChangedModules.changedModules'], '')
    steps:
      - task: Maven@3
        displayName: '执行打包'
        inputs:
          mavenPomFile: 'pom.xml'
          goals: 'package'
          options: '-pl ${{ dependencies.DetectChangedModules.outputs['setChangedModules.changedModules'] }} -am -DskipTests'
          mavenOptions: '$(mavenOpts)'
          publishJUnitResults: false

  # 作业4：构建并推送Docker镜像
  - job: BuildDockerImages
    displayName: '构建变更模块镜像'
    dependsOn: Package
    condition: ne(dependencies.DetectChangedModules.outputs['setChangedModules.changedModules'], '')
    steps:
      - bash: |
          # 将逗号分隔的模块列表转为数组
          IFS=',' read -ra MODULES <<< "${{ dependencies.DetectChangedModules.outputs['setChangedModules.changedModules'] }}"
          for module in "${MODULES[@]}"; do
            echo "开始构建模块[$module]的Docker镜像"
            # 替换为你的镜像构建命令，示例：
            docker build -t $(dockerRegistry)/$module:$(Build.BuildId) ./$module
            docker push $(dockerRegistry)/$module:$(Build.BuildId)
          done
        displayName: '批量构建并推送镜像'

关键配置说明 #

1. 变更检测逻辑

   • 通过git diff对比PR目标分支与当前分支的文件差异，筛选出有变更的子模块目录
   • 若PR带有full-build标签，直接触发所有模块的全量构建

2. Maven参数说明

   • -pl：指定要构建的模块，支持逗号分隔的模块名列表
   • -am：自动构建指定模块依赖的其他模块（若不需要可删除）
   • -DskipTests：打包阶段跳过测试，避免重复执行

3. PR标签触发规则

   • full-build：触发所有模块的全量构建，忽略变更检测结果
   • skip-tests：跳过编译阶段的测试步骤，仅执行编译与打包

4. 条件控制

   • 所有业务作业通过condition判断变更模块列表是否为空，避免无变更时触发冗余任务
   • 测试步骤通过标签判断是否跳过，适配特殊场景需求

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