DevOps中如何用Cache任务配合NodeTool缓存NodeJS工具？

1. 可行性确认 #

完全可以通过Cache任务实现NodeJS工具版本的缓存，跳过重复下载，解决间歇性下载失败问题，同时支持多流水线共享缓存内容。

2. 关键配置步骤 #

首次运行缓存NodeJS #

• 先执行NodeTool任务指定目标Node版本，任务会自动将NodeJS下载到代理机器的默认工具目录（比如Windows下为$(Agent.ToolsDirectory)/node/<版本号>，Linux/macOS下路径类似）。
• 紧接着添加Cache任务：设置缓存键为nodejs-$(Agent.OS)-$(NodeVersion)（确保不同系统、不同Node版本的缓存互不冲突），缓存路径填写NodeTool下载的NodeJS根目录。

后续运行优先读取缓存 #

• 在NodeTool任务前添加相同配置的Cache任务，任务会自动检查缓存是否存在。若命中缓存，会直接将缓存的NodeJS恢复到指定路径。
• 给NodeTool任务添加运行条件：仅当缓存未命中时才执行下载操作。通过Cache任务输出的CacheHit变量判断，配置条件为eq(variables['CacheHit'], 'false')。

3. 路径匹配注意事项 #

• 若不确定NodeTool的默认安装路径，可先运行一次NodeTool任务，再通过脚本输出路径：Windows用where node，Linux/macOS用which node，截取到版本对应的根目录作为缓存路径即可。
• 例如，Windows下Node路径为C:\agents\1\externals\node\18.17.0\node.exe，则缓存路径设为C:\agents\1\externals\node\18.17.0。

4. 多流水线共享缓存的前提 #

• 所有需要共享缓存的流水线必须使用同一组代理机器，或配置了组织级的分布式缓存存储（如Azure DevOps的共享缓存功能）。
• 各流水线的缓存键需完全一致，确保能命中同一版本的缓存。

示例流水线片段（Azure DevOps） #

variables:
  NodeVersion: '18.17.0'

steps:
- task: Cache@2
  displayName: 'Cache NodeJS $(NodeVersion)'
  inputs:
    key: 'nodejs | "$(Agent.OS)" | "$(NodeVersion)"'
    path: '$(Agent.ToolsDirectory)/node/$(NodeVersion)'
    cacheHitVar: 'CacheHit'

- task: NodeTool@0
  displayName: 'Install Node.js $(NodeVersion)'
  condition: eq(variables['CacheHit'], 'false')
  inputs:
    versionSpec: '$(NodeVersion)'

注：$(Agent.ToolsDirectory)是代理的工具目录变量，若环境存在差异，可先通过echo $(Agent.ToolsDirectory)脚本确认实际路径。

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