Condividi tramite


DownloadPipelineArtifact@2 - Scaricare l'attività Pipeline Artifacts v2

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

Annotazioni

Per altre informazioni, inclusi i comandi dell'interfaccia della riga di comando di Azure, vedere download di elementi.

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

Importante

Questa attività è supportata solo in Azure DevOps Services. Se si usa in Azure DevOps Server, viene visualizzato un messaggio di errore simile a Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. Usare Scaricare gli artefatti di compilazione se si usa Azure DevOps Server o TFS 2018.

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).

Ingressi dati

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 di pipeline specifica.


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

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


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

ID definizione della pipeline. In una pipeline in esecuzione il definitionId è reperibile nella variabile System.DefinitionId. Il definitionId può anche essere recuperato dall'URL nella pagina di panoramica della pipeline nel portale di Azure DevOps. Nell'esempio di URL seguente il 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 il definitionId da tale pipeline e specificarlo come parametro pipeline.


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

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


buildVersionToDownload - Versione di compilazione per 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 - Creazione
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 il buildId è reperibile nella variabile Build.BuildId. Il buildId può essere recuperato anche dall'URL nella pagina di riepilogo dell'esecuzione della pipeline nel portale di Azure DevOps. Nell'esempio di URL seguente il buildId è 1088: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. Per scaricare gli artefatti da un'esecuzione della pipeline specifica, acquisire il buildId da tale esecuzione e specificarlo come parametro buildId.


tag di compilazione tags -
string. Opzionale. 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. Opzionale. Usare quando source == specific && runVersion != specific. Valore predefinito: false

Specifica se scaricare gli artefatti da compilazioni parzialmente riuscite. A tale scopo, è necessario impostare sia allowPartiallySucceededBuilds che allowFailedBuilds su true.


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

Specifica se scaricare gli artefatti dalle compilazioni non riuscite.


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 .

A differenza di altre attività, questa attività scaricherà un file che corrisponde a qualsiasi modello. I modelli di esclusione non possono essere utilizzati per escludere i file inclusi in precedenza e includeranno i file che non corrispondono ad alcun modello di inclusione.


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à hanno opzioni di controllo oltre ai relativi input di attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di uscita

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.

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.

Osservazioni:

Importante

Questa attività è supportata solo in Azure DevOps Services. Se si usa in Azure DevOps Server, viene visualizzato un messaggio di errore simile a Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. Usare Scaricare gli artefatti di compilazione se si usa Azure DevOps Server o 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 modelli di corrispondenza 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 valore definitionId per una definizione di pipeline specifica

In una pipeline in esecuzione, il definitionId è reperibile nella variabile System.DefinitionId. Il definitionId può anche essere recuperato dall'URL nella pagina di panoramica della pipeline nel portale di Azure DevOps. Nell'esempio di URL seguente il 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 il definitionId da tale pipeline e specificarlo come parametro pipeline.

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

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

Esempi

Scaricare un artefatto 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
Funzionalità Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
Restrizioni dei comandi Qualunque
Variabili impostabili Qualunque
Versione agente 2.164.1 o versione successiva
Categoria attività Utilità