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?
displayName: string # Human-readable name for the task.
target: string | target # Environment in which to run this task.
enabled: boolean # Run this task when the job runs?
env: # Variables to map into the process's environment.
string: string # Name/value pairs
name: string # ID of the step.
timeoutInMinutes: string # Time to wait for this task to complete before the server kills it.
retryCountOnTaskFailure: string # Number of retries if the task fails.
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?
displayName: string # Human-readable name for the task.
target: string | target # Environment in which to run this task.
enabled: boolean # Run this task when the job runs?
env: # Variables to map into the process's environment.
string: string # Name/value pairs
name: string # ID of the step.
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?
displayName: string # Human-readable name for the task.
enabled: boolean # Run this task when the job runs?
env: # Variables to map into the process's environment.
string: string # Name/value pairs
name: string # ID of the step.
timeoutInMinutes: string # Time to wait for this task to complete before the server kills it.
Definitions that reference this definition: steps
Properties
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?
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 dictionary.
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.
Note
Pipelines may be configured with a job level timeout. If the job level timeout interval elapses before your step completes, the running job (including your step) is terminated, even if the step is configured with a longer timeoutInMinutes
interval. For more information, see Timeouts.
retryCountOnTaskFailure
string.
Number of retries if the task fails.
Remarks
The download
keyword downloads artifact resources.
Depending on the type of referenced artifact (or artifacts), download
calls Download Pipeline Artifacts (for Pipeline artifacts, if your pipeline is running in Azure DevOps Services), Download Build Artifacts (for build artifacts), or Download artifacts from file share (for file share artifacts).
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