Condividi tramite


DownloadPipelineArtifact@1 - Scaricare l'attività artefatto della pipeline v1

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

È disponibile una versione più recente di questa attività. Per altre informazioni, vedere DownloadPipelineArtifact@2.

Nota

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

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

Sintassi

# Download Pipeline Artifacts v1
# Download a named artifact from a pipeline to a local path.
- task: DownloadPipelineArtifact@1
  inputs:
    buildType: 'current' # 'current' | 'specific'. Required. Download artifacts produced by. Default: current.
    #project: # string. Required when buildType == specific. Project. 
    #pipeline: # string. Alias: definition. Required when buildType == specific. Build pipeline. 
    #specificBuildWithTriggering: false # boolean. Optional. Use when buildType == specific. When appropriate, download artifacts from the triggering build. Default: false.
    #buildVersionToDownload: 'latest' # 'latest' | 'latestFromBranch' | 'specific'. Required when buildType == specific. Build version to download. Default: latest.
    #branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
    #pipelineId: # string. Alias: buildId. Required when buildType == specific && buildVersionToDownload == specific. Build. 
    #tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags. 
    #artifactName: # string. Artifact name. 
    #itemPattern: '**' # string. Matching pattern. Default: **.
    targetPath: '$(System.ArtifactsDirectory)' # string. Alias: downloadPath. Required. Destination directory. Default: $(System.ArtifactsDirectory).
# Download Pipeline Artifacts v1
# Download Pipeline Artifact.
- task: DownloadPipelineArtifact@1
  inputs:
    buildType: 'current' # 'current' | 'specific'. Required. Download artifacts produced by. Default: current.
    #project: # string. Required when buildType == specific. Project. 
    #pipeline: # string. Alias: definition. Required when buildType == specific. Build pipeline. 
    #specificBuildWithTriggering: false # boolean. Optional. Use when buildType == specific. When appropriate, download artifacts from the triggering build. Default: false.
    #buildVersionToDownload: 'latest' # 'latest' | 'latestFromBranch' | 'specific'. Required when buildType == specific. Build version to download. Default: latest.
    #branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
    #pipelineId: # string. Alias: buildId. Required when buildType == specific && buildVersionToDownload == specific. Build. 
    #tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags. 
    #artifactName: # string. Artifact name. 
    #itemPattern: '**' # string. Matching pattern. Default: **.
    targetPath: '$(System.ArtifactsDirectory)' # string. Alias: downloadPath. Required. Destination directory. Default: $(System.ArtifactsDirectory).

Input

buildType - Scaricare gli artefatti prodotti da
string. Obbligatorio. Valori consentiti: current (build corrente), specific (build 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 buildType == specific.

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


pipeline - Pipeline di compilazione
Alias di input: definition. string. Obbligatorio quando buildType == 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.
boolean. facoltativo. Usare quando buildType == 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
string. Obbligatorio quando buildType == 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
string. Obbligatorio quando buildType == specific && buildVersionToDownload == latestFromBranch. Valore predefinito: refs/heads/master.

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


pipelineId - Costruire
Alias di input: buildId. string. Obbligatorio quando buildType == specific && buildVersionToDownload == 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 buildType == specific && buildVersionToDownload != specific.

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


artifactName - Nome artefatto
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 - Modello di corrispondenza
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: downloadPath. string. Obbligatorio. Valore predefinito: $(System.ArtifactsDirectory).

Percorso nel computer dell'agente in cui verranno scaricati gli artefatti.


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

Nessuno.

Osservazioni

È disponibile una versione più recente di questa attività. Per altre informazioni, vedere DownloadPipelineArtifact@2.

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.

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.

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.

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.155.1 o versione successiva
Categoria attività Utilità
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.150.3 o versione successiva
Categoria attività Utilità