DownloadBuildArtifacts@1 - Scarica l'attività Build Artifacts v1

Utilizzare questa attività per scaricare i file salvati come elementi di una compilazione completata.

Se si usa Azure DevOps Services, è consigliabile usare Download Pipeline Artifacts e Publish Pipeline Artifacts per ottenere prestazioni più veloci.

# Download build artifacts v1
# Download files that were saved as artifacts of a completed build.
- task: DownloadBuildArtifacts@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.
    #allowPartiallySucceededBuilds: false # boolean. Optional. Use when buildType == specific && buildVersionToDownload != specific. Download artifacts even from partially succeeded builds. Default: false.
    #branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
    #buildId: # string. Required when buildType == specific && buildVersionToDownload == specific. Build. 
    #tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags. 
    downloadType: 'single' # 'single' | 'specific'. Required. Download type. Default: single.
    artifactName: # string. Required when downloadType == single. Artifact name. 
    #itemPattern: '**' # string. Matching pattern. Default: **.
    downloadPath: '$(System.ArtifactsDirectory)' # string. Required. Destination directory. Default: $(System.ArtifactsDirectory).
    #cleanDestinationFolder: false # boolean. Clean destination folder. Default: false.
  # Advanced
    #parallelizationLimit: '8' # string. Parallelization limit. Default: 8.
    #checkDownloadedFiles: false # boolean. Check downloaded files. Default: false.
    #retryDownloadCount: '4' # string. Retry count. Default: 4.
    #extractTars: # boolean. Extract all files that are stored inside tar archives.

buildType - Scaricare gli artefatti prodotti da
string. Obbligatorio. Valori consentiti: current (build corrente), specific (compilazione specifica). Valore predefinito: current

Se scaricare gli artefatti prodotti dalla build corrente o da una build specifica.

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

Progetto da cui scaricare gli elementi di compilazione.

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

Specifica il nome della pipeline di compilazione.

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

Se true, questa attività di compilazione tenta di scaricare gli elementi dalla compilazione di attivazione. Se non è presente alcuna compilazione di attivazione dalla pipeline specificata, scarica gli artefatti dalla compilazione specificata nelle opzioni seguenti.

buildVersionToDownload - Versione di compilazione per 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 della build da scaricare.

• Scegli latest di scaricare l'ultima versione build disponibile.
• Scegliere latestFromBranch di scaricare l'ultima versione di build disponibile del ramo specificato da branchName e i tag specificati da tags.
• Scegliere specific di scaricare la versione build specificata da buildId.

allowPartiallySucceededBuilds - Scarica gli artefatti anche da build parzialmente riuscite.
boolean. Opzionale. Usare quando buildType == specific && buildVersionToDownload != specific. Valore predefinito: false

Se true, questa attività di compilazione tenta di scaricare gli elementi, indipendentemente dal fatto che la compilazione riesca o abbia esito parzialmente positivo.

branchName - nome ramo
string. Obbligatorio quando buildType == specific && buildVersionToDownload == latestFromBranch. Valore predefinito: refs/heads/master

Specifica se filtrare in base al nome del ramo/riferimento, ad esempio: refs/heads/develop.

buildId - Creazione
string. Obbligatorio quando buildType == specific && buildVersionToDownload == specific.

La build da cui si desidera scaricare gli artefatti.

tag di compilazione tags -
string. Opzionale. Usare quando buildType == specific && buildVersionToDownload != specific.

Elenco delimitato da virgole di tag. Vengono restituite solo le compilazioni con questi tag.

downloadType - Tipo di download
string. Obbligatorio. Valori consentiti: single (Artefatto specifico), specific (File specifici). Valore predefinito: single

Scarica un artefatto specifico o file specifici dalla compilazione.

• Scegliere single (Artefatto specifico) quando si desidera specificare un solo artefatto specifico da artifactName
• Scegliere specific (File specifici) quando si desidera che tutti gli artefatti della compilazione selezionata

artifactName - nome artefatto
string. Obbligatorio quando downloadType == single.

Nome dell'elemento da scaricare.

itemPattern - modello di corrispondenza
string. Valore predefinito: **

Specifica i file da scaricare come modello di minicorrispondenza su più righe. Per altre informazioni, vedere Informazioni di riferimento sui modelli di corrispondenza dei file.

Il modello \*\* predefinito scarica tutti i file in tutti gli artefatti della compilazione se si sceglie l'opzione File specifici . Per scaricare tutti i file all'interno dell'eliminazione dell'artefatto, usare drop/**.

downloadPath - directory di destinazione
string. Obbligatorio. Valore predefinito: $(System.ArtifactsDirectory)

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

Per ulteriori informazioni su System.ArtifactsDirectory, vedere Utilizzare le variabili nelle pipeline di versione classica.

cleanDestinationFolder - Pulisci cartella di destinazione
boolean. Valore predefinito: false

Elimina tutti i file esistenti nella cartella di destinazione prima del download dell'artefatto.

parallelizationLimit - limite di parallelizzazione
string. Valore predefinito: 8

Il numero di file da scaricare contemporaneamente.

checkDownloadedFiles - Controlla i file scaricati
boolean. Valore predefinito: false

Se true, questa attività di compilazione verifica che tutti i file siano stati scaricati completamente.

retryDownloadCount - Conteggio tentativi
string. Valore predefinito: 4

Numero di tentativi di download di un artefatto di compilazione se il download non riesce.

extractTars - Estrai tutti i file che sono memorizzati all'interno degli archivi tar
boolean.

Impostare su true per estrarre tutti i file scaricati con l'estensione .tar . Questo è utile perché è necessario comprimere i file degli artefatti in tar se si desidera preservare i permessi dei file Unix. Abilitando l'opzione StoreAsTar nell'attività Pubblica artefatti di compilazione , gli artefatti verranno archiviati automaticamente come file .tar .

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

Si noti che questo input restituisce BuildId a causa della compatibilità con le versioni precedenti. Per ulteriori informazioni, vedere Variabili.