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