DownloadBuildArtifacts@1 - Scaricare gli artefatti di compilazione v1

Usare questa attività per scaricare i file salvati come artefatti di una compilazione completata.

Se si usa Azure DevOps Services, è consigliabile usare Scarica artefatti della pipeline e Pubblica artefatti della pipeline 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 (build specifica). Valore predefinito: current.

Indica se scaricare gli artefatti prodotti dalla compilazione corrente o da una compilazione specifica.

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

Progetto da cui scaricare gli artefatti di compilazione.

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

Specifica il nome della pipeline di compilazione.

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

Se true, questa attività di compilazione tenta di scaricare gli artefatti dalla compilazione di attivazione. Se non è presente alcuna compilazione attiva dalla pipeline specificata, 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 della build da scaricare.

• Scegliere latest di scaricare la versione di build più recente disponibile.
• Scegliere latestFromBranch di scaricare la versione di build disponibile più recente del ramo specificato da branchName e i tag specificati da tags.
• Scegliere specific di scaricare la versione di compilazione specificata da buildId.

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

Se true, questa attività di compilazione tenta di scaricare gli artefatti se la compilazione ha esito positivo o parziale.

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

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

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

Compilazione da cui scaricare gli artefatti.

tags - Tag di compilazione
string. facoltativo. 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 vuole specificare un solo artefatto specifico specificato 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'artefatto da scaricare.

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

Specifica i file da scaricare come modello minimatch multilinea. 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.

cleanDestinationFolder - Pulire la cartella di destinazione
boolean. Valore predefinito: false.

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

parallelizationLimit - Limite di parallelizzazione
string. Valore predefinito: 8.

Numero di file da scaricare contemporaneamente.

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

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

retryDownloadCount - Numero di tentativi
string. Valore predefinito: 4.

Numero di tentativi di download di un artefatto di compilazione se il download ha esito negativo.

extractTars - Estrarre tutti i file archiviati all'interno di archivi tar
boolean.

Impostare su true per estrarre tutti i file scaricati con estensione tar . Ciò è utile perché è necessario comprimere i file di artefatti in tar se si desidera mantenere le autorizzazioni per i file Unix. L'abilitazione dell'opzione StoreAsTar nell'attività Pubblica artefatti di compilazione archivierà automaticamente gli artefatti 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 altre informazioni, vedere Variabili.