steps.download definition

The download step downloads artifacts associated with the current run or from another Azure pipeline that is associated as a pipeline resource.

steps:
- download: string # Required as first property. Specify current, pipeline resource identifier, or none to disable automatic download. 
  artifact: string # Artifact name.. 
  patterns: string # Pattern to download files from artifact. 
  condition: string # Evaluate this condition expression to determine whether to run this task. 
  continueOnError: boolean # Continue running even on failure?.  (false,n,no,off,on,true,y,yes)
  displayName: string # Human-readable name for the task. 
  enabled: boolean # Run this task when the job runs?.  (false,n,no,off,on,true,y,yes)
  env:  # Variables to map into the process's environment
    string: string # Name/value pairs.
  name: string # ID of the step.  ([-_A-Za-z0-9]*)
  timeoutInMinutes: string # Time to wait for this task to complete before the server kills it. 

Properties that use this definition: steps

Properties

download

string

Required as first parameter. Specify current, pipeline resource identifier, or none to disable automatic download.

---

artifact

string

Artifact name.

---

patterns

string

Pattern to download files from artifact.

---

condition

string

Evaluate this condition expression to determine whether to run this task.

---

continueOnError

boolean

Continue running even on failure?

---

displayName

string

Human-readable name for the task.

---

enabled

boolean

Run this task when the job runs?

---

env

string name/value pairs

Variables to map into the process's environment.

---

name

string

ID of the step. Acceptable values: [_A-Za-z0-9]*

---

timeoutInMinutes

string

Time to wait for this task to complete before the server kills it.

---

steps:
- download: string # Required as first property. Specify current, pipeline resource identifier, or none to disable automatic download. 
  artifact: string # Artifact name.. 
  patterns: string # Pattern to download files from artifact. 
  condition: string # Evaluate this condition expression to determine whether to run this task. 
  continueOnError: boolean # Continue running even on failure?.  (false,n,no,off,on,true,y,yes)
  displayName: string # Human-readable name for the task. 
  enabled: boolean # Run this task when the job runs?.  (false,n,no,off,on,true,y,yes)
  env:  # Variables to map into the process's environment
    string: string # Name/value pairs.
  name: string # ID of the step.  ([-_A-Za-z0-9]*)
  timeoutInMinutes: string # Time to wait for this task to complete before the server kills it. 

Properties that use this definition: steps

Properties

download

string

Required as first parameter. Specify current, pipeline resource identifier, or none to disable automatic download.

---

artifact

string

Artifact name.

---

patterns

string

Pattern to download files from artifact.

---

condition

string

Evaluate this condition expression to determine whether to run this task.

---

continueOnError

boolean

Continue running even on failure?

---

displayName

string

Human-readable name for the task.

---

enabled

boolean

Run this task when the job runs?

---

env

string name/value pairs

Variables to map into the process's environment.

---

name

string

ID of the step. Acceptable values: [_A-Za-z0-9]*

---

timeoutInMinutes

string

Time to wait for this task to complete before the server kills it.

---

steps:
- download: string # Required as first property. Specify current, pipeline resource identifier, or none to disable automatic download. 
  artifact: string # Artifact name.. 
  patterns: string # Pattern to download files from artifact. 
  condition: string # Evaluate this condition expression to determine whether to run this task. 
  continueOnError: boolean # Continue running even on failure?.  (false,n,no,off,on,true,y,yes)
  displayName: string # Human-readable name for the task. 
  target: stepTarget # Environment in which to run this task
  enabled: boolean # Run this task when the job runs?.  (false,n,no,off,on,true,y,yes)
  env:  # Variables to map into the process's environment
    string: string # Name/value pairs.
  name: string # ID of the step.  ([-_A-Za-z0-9]*)
  timeoutInMinutes: string # Time to wait for this task to complete before the server kills it. 

Properties that use this definition: steps

Properties

download

string

Required as first parameter. Specify current, pipeline resource identifier, or none to disable automatic download.

---

artifact

string

Artifact name.

---

patterns

string

Pattern to download files from artifact.

---

condition

string

Evaluate this condition expression to determine whether to run this task.

---

continueOnError

boolean

Continue running even on failure?

---

displayName

string

Human-readable name for the task.

---

target

target

Environment in which to run this task.

---

enabled

boolean

Run this task when the job runs?

---

env

string name/value pairs

Variables to map into the process's environment.

---

name

string

ID of the step. Acceptable values: [_A-Za-z0-9]*

---

timeoutInMinutes

string

Time to wait for this task to complete before the server kills it.

---

steps:
- download: string # Required as first property. Specify current, pipeline resource identifier, or none to disable automatic download. 
  artifact: string # Artifact name.. 
  patterns: string # Pattern to download files from artifact. 
  condition: string # Evaluate this condition expression to determine whether to run this task. 
  continueOnError: boolean # Continue running even on failure?.  (false,n,no,off,on,true,y,yes)
  displayName: string # Human-readable name for the task. 
  target: stepTarget # Environment in which to run this task
  enabled: boolean # Run this task when the job runs?.  (false,n,no,off,on,true,y,yes)
  env:  # Variables to map into the process's environment
    string: string # Name/value pairs.
  name: string # ID of the step.  ([-_A-Za-z0-9]*)
  timeoutInMinutes: string # Time to wait for this task to complete before the server kills it. 

Properties that use this definition: steps

Properties

download

string

Required as first parameter. Specify current, pipeline resource identifier, or none to disable automatic download.

---

artifact

string

Artifact name.

---

patterns

string

Pattern to download files from artifact.

---

condition

string

Evaluate this condition expression to determine whether to run this task.

---

continueOnError

boolean

Continue running even on failure?

---

displayName

string

Human-readable name for the task.

---

target

target

Environment in which to run this task.

---

enabled

boolean

Run this task when the job runs?

---

env

string name/value pairs

Variables to map into the process's environment.

---

name

string

ID of the step. Acceptable values: [_A-Za-z0-9]*

---

timeoutInMinutes

string

Time to wait for this task to complete before the server kills it.

---

steps:
- download: string # Required as first property. Specify current, pipeline resource identifier, or none to disable automatic download. 
  artifact: string # Artifact name.. 
  patterns: string # Pattern to download files from artifact. 
  condition: string # Evaluate this condition expression to determine whether to run this task. 
  continueOnError: boolean # Continue running even on failure?.  (false,n,no,off,on,true,y,yes)
  displayName: string # Human-readable name for the task. 
  target: stepTarget # Environment in which to run this task
  enabled: boolean # Run this task when the job runs?.  (false,n,no,off,on,true,y,yes)
  env:  # Variables to map into the process's environment
    string: string # Name/value pairs.
  name: string # ID of the step.  ([-_A-Za-z0-9]*)
  timeoutInMinutes: string # Time to wait for this task to complete before the server kills it. 
  retryCountOnTaskFailure: string # Number of retries if the task fails. 

Properties that use this definition: steps

Properties

download

string

Required as first parameter. Specify current, pipeline resource identifier, or none to disable automatic download.

---

artifact

string

Artifact name.

---

patterns

string

Pattern to download files from artifact.

---

condition

string

Evaluate this condition expression to determine whether to run this task.

---

continueOnError

boolean

Continue running even on failure?

---

displayName

string

Human-readable name for the task.

---

target

target

Environment in which to run this task.

---

enabled

boolean

Run this task when the job runs?

---

env

string name/value pairs

Variables to map into the process's environment.

---

name

string

ID of the step. Acceptable values: [-_A-Za-z0-9]*

---

timeoutInMinutes

string

Time to wait for this task to complete before the server kills it.

---

retryCountOnTaskFailure

string

Number of retries if the task fails.

---

Remarks

The download keyword is a shortcut for the Download Pipeline Artifacts task.

Artifact download location

Artifacts from the current pipeline are downloaded to $(**Pipeline.Workspace**)/<artifact name>.

Artifacts from the associated pipeline resource are downloaded to $(**Pipeline.Workspace**)/\<pipeline resource identifier\>/<artifact name>.

Automatic download in deployment jobs

All available artifacts from the current pipeline and from the associated pipeline resources are automatically downloaded in deployment jobs and made available for your deployment.

To prevent downloads, specify download: none.

Examples

steps:
- download: current  # refers to artifacts published by current pipeline
  artifact: WebApp
  patterns: '**/.js'
  displayName: Download artifact WebApp
- download: MyAppA   # downloads artifacts available as part of the pipeline resource specified as MyAppA

See also

• Publish and download pipeline Artifacts
• Download Pipeline Artifacts task