Edit

Cache NuGet packages

  • Article
  • 2 minutes to read

Azure DevOps Services

With pipeline caching, you can reduce your build time by caching your dependencies to be reused in later runs. In this article, you will learn how to use the Cache task to cache and restore your NuGet packages.

Lock dependencies

To set up the cache task, we must first lock our project's dependencies and create a package.lock.json file. We will use the hash of the content of this file to generate a unique key for our cache.

To lock your project's dependencies, set the RestorePackagesWithLockFile property in your csproj file to true. NuGet restore will generate a lock file packages.lock.json at the root directory of your project. Make sure you check your packages.lock.json file into your source code.

<PropertyGroup>
  <RestorePackagesWithLockFile>true</RestorePackagesWithLockFile>
</PropertyGroup>

Cache NuGet packages

We will need to create a pipeline variable to point to the location of our packages on the agent running the pipeline.

In this example, the content of the packages.lock.json will be hashed to produce a dynamic cache key. This will ensure that every time the file is modified, a new cache key will be generated.

A screenshot showing how the cache key is generated in Azure Pipelines. 

variables:
  NUGET_PACKAGES: $(Pipeline.Workspace)/.nuget/packages

- task: Cache@2
  displayName: Cache
  inputs:
    key: 'nuget | "$(Agent.OS)" | **/packages.lock.json,!**/bin/**,!**/obj/**'
    restoreKeys: |
       nuget | "$(Agent.OS)"
       nuget
    path: '$(NUGET_PACKAGES)'
    cacheHitVar: 'CACHE_RESTORED'

Restore cache

This task will only run if the CACHE_RESTORED variable is false.

- task: NuGetCommand@2
  condition: ne(variables.CACHE_RESTORED, true)
  inputs:
    command: 'restore'
    restoreSolution: '**/*.sln'

Performance comparison

Pipeline caching is a great way to speed up your pipeline execution. Here is a side-by-side performance comparison for two different pipelines. Before adding the caching task (right), the restore task took approximately 41 seconds. We added the caching task to a second pipeline (left) and configured the restore task to run when a cache miss is encountered. The restore task in this case took 8 seconds to complete.

A screenshot showing the pipeline performance with and without caching.

Below is the full YAML pipeline for reference:

pool:
  vmImage: 'windows-latest'

variables:
  solution: '**/*.sln'
  buildPlatform: 'Any CPU'
  buildConfiguration: 'Release'
  NUGET_PACKAGES: $(Pipeline.Workspace)/.nuget/packages

steps:
- task: NuGetToolInstaller@1
  displayName: 'NuGet tool installer'

- task: Cache@2
  displayName: 'NuGet Cache'
  inputs:
    key: 'nuget | "$(Agent.OS)" | **/packages.lock.json,!**/bin/**,!**/obj/**'
    restoreKeys: |
       nuget | "$(Agent.OS)"
       nuget
    path: '$(NUGET_PACKAGES)'
    cacheHitVar: 'CACHE_RESTORED'

- task: NuGetCommand@2
  displayName: 'NuGet restore'
  condition: ne(variables.CACHE_RESTORED, true)
  inputs:
    command: 'restore'
    restoreSolution: '$(solution)'

- task: VSBuild@1
  displayName: 'Visual Studio Build'
  inputs:
    solution: '$(solution)'
    platform: '$(buildPlatform)'
    configuration: '$(buildConfiguration)'