如何在Azure DevOps流水线中缓存Sonar插件以避免重复下载？

要避免每次运行流水线重复下载Sonar插件，你可以通过Azure DevOps的Cache任务针对Sonar插件存储目录做缓存，以下是具体配置步骤和示例：

1. 确定Sonar插件的存储路径 #

SonarQube Scanner的插件默认存储路径因操作系统而异：

• Linux/macOS：~/.sonar/cache/plugins
• Windows：%USERPROFILE%\.sonar\cache\plugins

流水线中可使用预定义变量统一处理：$(Agent.HomeDirectory)/.sonar/cache/plugins，该路径在多数代理环境下通用。

2. 配置Cache任务 #

将Cache任务放在SonarQube分析任务之前，确保先读取缓存再执行Sonar扫描。缓存键需包含能标识插件版本的信息，比如Sonar扫描器版本、SonarQube服务器版本，确保仅当插件版本变化时才重新下载并更新缓存。

完整YAML示例 #

steps:
  # 缓存Sonar插件
  - task: Cache@2
    inputs:
      key: 'sonarPlugins | "$(Agent.OS)" | $(SONAR_SCANNER_VERSION)'
      path: '$(Agent.HomeDirectory)/.sonar/cache/plugins'
      cacheHitVar: 'SONAR_PLUGINS_CACHED'
    displayName: 'Cache SonarQube Plugins'

  # SonarQube准备任务
  - task: SonarQubePrepare@5
    inputs:
      SonarQube: '你的SonarQube服务连接名称'
      scannerMode: 'MSBuild'
      projectKey: '你的项目Key'
      projectName: '你的项目名称'

  # 构建项目（按需配置）
  - task: MSBuild@1
    inputs:
      solution: '**/*.sln'
      configuration: 'Release'

  # SonarQube分析任务
  - task: SonarQubeAnalyze@5

3. 关键配置说明 #

• 缓存键（key）：sonarPlugins | "$(Agent.OS)" | $(SONAR_SCANNER_VERSION) 中，sonarPlugins为缓存前缀，$(Agent.OS)区分不同操作系统的缓存，$(SONAR_SCANNER_VERSION)确保扫描器版本变化时触发缓存更新。你也可以加入SonarQube服务器版本号，进一步精准控制缓存失效时机。
• 缓存路径（path）：必须与Sonar扫描器实际使用的插件存储目录一致。
• cacheHitVar：可选变量，标记是否命中缓存，后续可基于该变量添加条件逻辑（一般场景下无需额外配置）。

4. 注意事项 #

• 若SonarQube服务器更新了插件，需手动清除旧缓存，或修改缓存键（如添加版本后缀）触发重新下载。
• 确保代理机器拥有缓存目录的读写权限，避免缓存操作失败。
• 自托管代理的缓存存储在本地，微软托管代理的缓存存储在Azure远程存储中，可跨代理实例共享。

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