DownloadPipelineArtifact@2 - Scaricare l'attività Artefatti della pipeline v2

Usare questa attività per scaricare gli artefatti della pipeline dalle fasi precedenti di questa pipeline o da un'altra pipeline.

Nota

Per altre informazioni, inclusi i comandi dell'interfaccia della riga di comando di Azure, vedere Download degli artefatti.

Sintassi

# Download Pipeline Artifacts v2
# Download build and pipeline artifacts.
- task: DownloadPipelineArtifact@2
  inputs:
    buildType: 'current' # 'current' | 'specific'. Alias: source. Required. Download artifacts produced by. Default: current.
    #project: # string. Required when source == specific. Project. 
    #definition: # string. Alias: pipeline. Required when source == specific. Build pipeline. 
    #specificBuildWithTriggering: false # boolean. Alias: preferTriggeringPipeline. Optional. Use when source == specific. When appropriate, download artifacts from the triggering build. Default: false.
    #buildVersionToDownload: 'latest' # 'latest' | 'latestFromBranch' | 'specific'. Alias: runVersion. Required when source == specific. Build version to download. Default: latest.
    #branchName: 'refs/heads/master' # string. Alias: runBranch. Required when source == specific && runVersion == latestFromBranch. Branch name. Default: refs/heads/master.
    #pipelineId: # string. Alias: runId | buildId. Required when source == specific && runVersion == specific. Build. 
    #tags: # string. Optional. Use when source == specific && runVersion != specific. Build Tags. 
    #allowPartiallySucceededBuilds: false # boolean. Optional. Use when source == specific && runVersion != specific. Download artifacts from partially succeeded builds. Default: false.
    #allowFailedBuilds: false # boolean. Optional. Use when source == specific && runVersion != specific. Download artifacts from failed builds. Default: false.
    #artifactName: # string. Alias: artifact. Artifact name. 
    #itemPattern: '**' # string. Alias: patterns. Matching patterns. Default: **.
    targetPath: '$(Pipeline.Workspace)' # string. Alias: path | downloadPath. Required. Destination directory. Default: $(Pipeline.Workspace).

Input

buildType - Scaricare gli artefatti prodotti da
Alias di input: source. string. Obbligatorio. Valori consentiti: current (esecuzione corrente), specific (esecuzione specifica). Valore predefinito: current.

Scarica gli artefatti prodotti dall'esecuzione della pipeline corrente o da un'esecuzione specifica della pipeline.

project - Progetto
string. Obbligatorio quando source == specific.

Specifica il nome o il GUID del progetto da cui scaricare gli artefatti della pipeline.

definition - Pipeline di compilazione
Alias di input: pipeline. string. Obbligatorio quando source == specific.

ID di definizione della pipeline. In una pipeline in esecuzione è definitionId possibile trovare nella variabile System.DefinitionId . Può definitionId anche essere recuperato dall'URL nella pagina di panoramica della pipeline nel portale di Azure DevOps. Nell'esempio di URL seguente, è definitionId 78: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. Per scaricare gli artefatti da una definizione di pipeline specifica, acquisire l'oggetto definitionId da tale pipeline e specificarlo come pipeline parametro.

specificBuildWithTriggering - Se appropriato, scaricare gli artefatti dalla compilazione di attivazione.
Alias di input: preferTriggeringPipeline. boolean. facoltativo. Usare quando source == specific. Valore predefinito: false.

Se selezionata, l'attività scarica gli artefatti dalla compilazione di attivazione. Se non è presente alcuna compilazione attiva dalla pipeline specificata, l'attività scarica gli artefatti dalla compilazione specificata nelle opzioni seguenti.

buildVersionToDownload - Versione di compilazione da scaricare
Alias di input: runVersion. string. Obbligatorio quando source == specific. Valori consentiti: latest, latestFromBranch (più recente da un ramo specifico e tag di compilazione specificati), specific (versione specifica). Valore predefinito: latest.

Specifica la versione di compilazione da scaricare.

branchName - Nome ramo
Alias di input: runBranch. string. Obbligatorio quando source == specific && runVersion == latestFromBranch. Valore predefinito: refs/heads/master.

Specifica il filtro sul nome di ramo/riferimento. Ad esempio: refs/heads/develop.

pipelineId - Costruire
Alias di input: runId | buildId. string. Obbligatorio quando source == specific && runVersion == specific.

Identificatore dell'esecuzione della pipeline da cui scaricare gli artefatti. In una pipeline in esecuzione è buildId possibile trovare nella variabile Build.BuildId . Può buildId anche essere recuperato dall'URL nella pagina di riepilogo dell'esecuzione della pipeline nel portale di Azure DevOps. Nell'esempio di URL seguente, è buildId 1088: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. Per scaricare gli artefatti da un'esecuzione specifica della pipeline, acquisire l'oggetto buildId da tale esecuzione e specificarlo come buildId parametro.

tags - Tag di compilazione
string. facoltativo. Usare quando source == specific && runVersion != specific.

Elenco delimitato da virgole di tag usato dall'attività per restituire compilazioni con tag. Le compilazioni senza tag non vengono restituite.

allowPartiallySucceededBuilds - Scaricare gli artefatti da compilazioni parzialmente riuscite.
boolean. facoltativo. Usare quando source == specific && runVersion != specific. Valore predefinito: false.

Specifica se l'attività di compilazione scarica gli artefatti se la compilazione ha esito positivo o parziale.

allowFailedBuilds - Scaricare gli artefatti dalle compilazioni non riuscite.
boolean. facoltativo. Usare quando source == specific && runVersion != specific. Valore predefinito: false.

Se selezionata, l'attività di compilazione scarica gli artefatti se la compilazione ha esito positivo o negativo.

artifactName - Nome artefatto
Alias di input: artifact. string.

Specifica il nome dell'artefatto da scaricare. Se il valore viene lasciato vuoto, l'attività scarica tutti gli artefatti associati all'esecuzione della pipeline.

itemPattern - Criteri di corrispondenza
Alias di input: patterns. string. Valore predefinito: **.

Modelli di corrispondenza dei file che limitano i file scaricati. Il valore può essere uno o più modelli di corrispondenza di file delimitati da una nuova riga. Altre informazioni sui modelli di corrispondenza dei file.

targetPath - Directory di destinazione
Alias di input: path | downloadPath. string. Obbligatorio. Valore predefinito: $(Pipeline.Workspace).

Specifica un percorso relativo o assoluto nel computer dell'agente in cui verranno scaricati gli artefatti. Se viene applicata l'opzione multi-download (lasciando un nome di artefatto vuoto), verrà creata una sottodirectory per ogni download. Altre informazioni sugli artefatti in Azure Pipelines.

Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Questa attività definisce le variabili di output seguenti, che è possibile utilizzare nei passaggi downstream, nei processi e nelle fasi.

BuildNumber
Archivia il numero di build dell'origine dell'artefatto della pipeline.

A causa della compatibilità con le versioni precedenti, questa variabile restituisce BuildId.

Altre informazioni sulle variabili di compilazione.

Commenti

Importante

Questa attività è supportata solo in Azure DevOps Services. Se lo si usa in Azure DevOps Server, verrà visualizzato un messaggio di errore simile a Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. Use Download Build Artifacts if you're using Azure DevOps Server or TFS 2018.

Usare questa attività per scaricare gli artefatti della pipeline dalle fasi precedenti di questa pipeline o da un'altra pipeline. Per impostazione predefinita, gli artefatti vengono scaricati in $(Pipeline.Workspace). Se non si specifica un nome di artefatto, verrà creata una sottodirectory per ogni artefatto scaricato. È possibile usare i criteri di ricerca dei file per limitare i file da scaricare.

Le parole chiave di pubblicazione e download sono collegamenti alle attività per pubblicare e scaricare gli artefatti della pipeline.

Come è possibile trovare l'ID della pipeline da cui si vuole scaricare un artefatto?

Per trovare il definitionId per una definizione di pipeline specifica

In una pipeline in esecuzione, è definitionId possibile trovare nella variabile System.DefinitionId . Può definitionId anche essere recuperato dall'URL nella pagina di panoramica della pipeline nel portale di Azure DevOps. Nell'esempio di URL seguente, è definitionId 78: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. Per scaricare gli artefatti da una definizione di pipeline specifica, acquisire l'oggetto definitionId da tale pipeline e specificarlo come pipeline parametro.

Per trovare il valore buildId per un'esecuzione specifica della pipeline

Identificatore dell'esecuzione della pipeline da cui scaricare gli artefatti. In una pipeline in esecuzione è buildId possibile trovare nella variabile Build.BuildId . Può buildId anche essere recuperato dall'URL nella pagina di riepilogo dell'esecuzione della pipeline nel portale di Azure DevOps. Nell'esempio di URL seguente, è buildId 1088: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. Per scaricare gli artefatti da un'esecuzione specifica della pipeline, acquisire l'oggetto buildId da tale esecuzione e specificarlo come buildId parametro.

Esempio

Scaricare un elemento specifico

# Download an artifact named 'WebApp' to 'bin' in $(Build.SourcesDirectory)
- task: DownloadPipelineArtifact@2
  inputs:
    artifactName: 'WebApp'
    targetPath: $(Build.SourcesDirectory)/bin

Scaricare gli artefatti da un progetto/pipeline specifico

# Download artifacts from a specific pipeline.
- task: DownloadPipelineArtifact@2
  inputs:
    buildType: 'specific'
    project: 'FabrikamFiber'
    definition: 12
    buildVersionToDownload: 'latest'

Scaricare gli artefatti da un ramo specifico

# Download artifacts from a specific branch with a tag
- task: DownloadPipelineArtifact@2
  inputs:
    buildType: 'specific'
    project: 'FabrikamFiber'
    definition: 12
    buildVersionToDownload: 'latestFromBranch'
    branchName: 'refs/heads/master'
    tags: 'testTag'

Scaricare un artefatto da un'esecuzione di compilazione specifica

# Download an artifact named 'WebApp' from a specific build run to 'bin' in $(Build.SourcesDirectory)
- task: DownloadPipelineArtifact@2
  inputs:
    buildType: 'specific'
    artifactName: 'WebApp'
    targetPath: $(Build.SourcesDirectory)/bin
    project: 'FabrikamFiber'
    definition: 12
    buildVersionToDownload: 'specific'
    pipelineId: 40

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Viene eseguito in	Agente, DeploymentGroup
Richieste	Nessuno
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	2.164.1 o versione successiva
Categoria attività	Utilità