Azure DevOps流水线中Artifactory Gradle构建失败问题

问题详情 #

使用Azure DevOps流水线结合JFrogGradle任务构建Android包，采用自托管代理且已手动安装Gradle，环境变量配置如下：

GRADLE_HOME=/opt/gradle-8.0.2
PATH=/opt/gradle-8.0.2/bin 

流水线任务配置：

- task: JFrogGradle@1
  inputs:
    gradleBuildFile: 'build.gradle'
    workDir: 'Android'
    tasks: 'artifactoryPublish'
    artifactoryResolverService: 'artifactory-central'
    collectBuildInfo: true
    buildName: '$(Build.DefinitionName)'
    buildNumber: '$(Build.BuildNumber)'
    usesPlugin: true
    useWrapper: true

构建触发后报错：

##[error]No agent found in pool which satisfies the following demand: gradle. All demands: agent.name -equals azdevops, java, gradle, Agent.Version -gtVersion 2.170.

核心原因 #

JFrogGradle任务会自动向流水线添加gradle代理需求，但你的自托管代理未在Azure DevOps中注册Gradle能力，导致流水线无法匹配到符合要求的代理。

解决方法 #

1. 为自托管代理注册Gradle能力 #

这是最规范的处理方式，让Azure DevOps识别到代理已安装Gradle：

• 进入Azure DevOps项目设置 → 代理池 → 目标代理池 → 选择你的自托管代理（azdevops）
• 点击「添加能力」，类型选择「工具」，名称填写gradle，值填写已安装的Gradle版本（如8.0.2）
• 保存后，代理会被标记为具备gradle能力，流水线即可正常匹配

2. 移除流水线的Gradle需求 #

若无需强制校验Gradle，可直接覆盖任务的需求列表：
修改流水线任务配置，添加demands字段，只保留必要需求：

- task: JFrogGradle@1
  inputs:
    gradleBuildFile: 'build.gradle'
    workDir: 'Android'
    tasks: 'artifactoryPublish'
    artifactoryResolverService: 'artifactory-central'
    collectBuildInfo: true
    buildName: '$(Build.DefinitionName)'
    buildNumber: '$(Build.BuildNumber)'
    usesPlugin: true
    useWrapper: true
  demands:
    - agent.name -equals azdevops
    - java
    - Agent.Version -gtVersion 2.170

3. 验证环境变量与Gradle可用性 #

• 登录自托管代理服务器，执行gradle -v，确认能正常输出版本信息，验证环境变量生效
• 若刚配置环境变量，需重启代理服务，确保新环境变量被加载

4. 检查Gradle Wrapper配置 #

因任务启用了useWrapper: true，需确保项目中gradle/wrapper/gradle-wrapper.properties的distributionUrl指向可访问的Gradle分发包，避免Wrapper下载失败影响构建

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