Edit

Cache@2 - Cache v2 task

  • Article
  • 2 minutes to read

Improve build performance by using this task to cache files, like dependencies, between pipeline runs.

Syntax

# Cache v2
# Cache files between runs.
- task: Cache@2
  inputs:
    key: # string. Required. Key. 
    path: # string. Required. Path. 
    #cacheHitVar: # string. Cache hit variable. 
    #restoreKeys: # string. Additional restore key prefixes.

Inputs

key - Key
string. Required.

The key (unique identifier) for the cache. This should be a string that can be segmented using |. File paths can be absolute or relative to $(System.DefaultWorkingDirectory).


path - Path
string. Required.

The path of the folder to cache. Can be fully qualified or relative to $(System.DefaultWorkingDirectory). Wildcards are not supported. Variables are supported.


cacheHitVar - Cache hit variable
string.

The variable to set to true when the cache is restored (i.e. a cache hit). Otherwise, sets the variable to false.


restoreKeys - Additional restore key prefixes
string.

The additional restore key prefixes that the task uses if the primary key misses. This can be a newline-delimited list of key prefixes.


Task control options

All tasks have control options in addition to their task inputs. For more information, see Control options and common task properties.

Output variables

None.

Remarks

Improve build performance by caching files, like dependencies, between pipeline runs.

Requirements

Requirement Description
Pipeline types YAML, Classic build, Classic release
Runs on Agent, DeploymentGroup
Demands None
Capabilities This task does not satisfy any demands for subsequent tasks in the job.
Command restrictions Any
Settable variables Any
Agent version 2.160.0 or greater
Task category Utility

See also