Share via

DownloadBuildArtifacts@1 - Build-artefacten v1-taak downloaden

  • Artikel

Gebruik deze taak om bestanden te downloaden die zijn opgeslagen als artefacten van een voltooide build.

Als u Azure DevOps Services gebruikt, raden we u aan Pijplijnartefacten downloaden te gebruiken en Pijplijnartefacten te publiceren voor snellere prestaties.

Syntax

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

Invoerwaarden

buildType - Artefacten downloaden die zijn geproduceerd door
string. Vereist. Toegestane waarden: current (Huidige build), specific (Specifieke build). Standaardwaarde: current.

Of artefacten moeten worden gedownload die zijn geproduceerd door de huidige build of van een specifieke build.


project - Project
string. Vereist wanneer buildType == specific.

Het project van waaruit de buildartefacten moeten worden gedownload.


pipeline - Build-pijplijn
Invoeralias: definition. string. Vereist wanneer buildType == specific.

Hiermee geeft u de naam van de build-pijplijn op.


specificBuildWithTriggering - Download, indien van toepassing, artefacten van de activerende build.
boolean. Optioneel. Gebruik wanneer buildType == specific. Standaardwaarde: false.

Als true, probeert deze buildtaak artefacten te downloaden van de activerende build. Als er geen build wordt geactiveerd vanuit de opgegeven pijplijn, worden artefacten gedownload van de build die is opgegeven in de onderstaande opties.


buildVersionToDownload - Buildversie om te downloaden
string. Vereist wanneer buildType == specific. Toegestane waarden: latest, latestFromBranch (Meest recente van specifieke vertakking en opgegeven buildtags), specific (specifieke versie). Standaardwaarde: latest.

Hiermee geeft u op welke versie van de build moet worden gedownload.

  • Kies om latest de meest recente beschikbare buildversie te downloaden.
  • Kies om latestFromBranch de meest recente beschikbare buildversie van de vertakking te downloaden die is opgegeven door branchName en tags die zijn opgegeven door tags.
  • Kies ervoor specific om de buildversie te downloaden die is opgegeven door buildId.

allowPartiallySucceededBuilds - Download artefacten zelfs van gedeeltelijk geslaagde builds.
boolean. Optioneel. Gebruik wanneer buildType == specific && buildVersionToDownload != specific. Standaardwaarde: false.

Als true, probeert deze buildtaak artefacten te downloaden, ongeacht of de build slaagt of gedeeltelijk slaagt.


branchName - Naam van vertakking
string. Vereist wanneer buildType == specific && buildVersionToDownload == latestFromBranch. Standaardwaarde: refs/heads/master.

Hiermee geeft u op of u wilt filteren op vertakkings-/verw-naam, bijvoorbeeld: refs/heads/develop.


buildId - Bouwen
string. Vereist wanneer buildType == specific && buildVersionToDownload == specific.

De build van waaruit u de artefacten wilt downloaden.


tags - BuildTags
string. Optioneel. Gebruik wanneer buildType == specific && buildVersionToDownload != specific.

Een door komma's gescheiden lijst met tags. Alleen builds met deze tags worden geretourneerd.


downloadType - Downloadtype
string. Vereist. Toegestane waarden: single (Specifiek artefact), specific (Specifieke bestanden). Standaardwaarde: single.

Hiermee downloadt u een specifiek artefact of specifieke bestanden uit de build.

  • Kies single (Specifiek artefact) als u slechts één specifiek artefact wilt opgeven door artifactName
  • Kies specific (Specifieke bestanden) wanneer u alle artefacten van de geselecteerde build wilt

artifactName - Naam van artefact
string. Vereist wanneer downloadType == single.

De naam van het artefact dat moet worden gedownload.


itemPattern - Overeenkomend patroon
string. Standaardwaarde: **.

Hiermee geeft u de bestanden die moeten worden gedownload als een minimatchpatroon met meerdere regels. Zie Naslaginformatie over bestandsmatchingspatronen voor meer informatie.

Met het standaardpatroon \*\* worden alle bestanden voor alle artefacten in de build gedownload als u de optie Specifieke bestanden kiest. Als u alle bestanden in de artefact-drop wilt downloaden, gebruikt u drop/**.


downloadPath - Doelmap
string. Vereist. Standaardwaarde: $(System.ArtifactsDirectory).

Het pad op de agentcomputer waar de artefacten worden gedownload.


cleanDestinationFolder - Doelmap opschonen
boolean. Standaardwaarde: false.

Verwijder alle bestaande bestanden in de doelmap voordat het artefact wordt gedownload.


parallelizationLimit - Parallellisatielimiet
string. Standaardwaarde: 8.

Het aantal bestanden dat tegelijkertijd moet worden gedownload.


checkDownloadedFiles - Gedownloade bestanden controleren
boolean. Standaardwaarde: false.

Als true, controleert deze buildtaak of alle bestanden volledig zijn gedownload.


retryDownloadCount - Aantal nieuwe pogingen
string. Standaardwaarde: 4.

Het aantal keren dat een buildartefact opnieuw moet worden gedownload als het downloaden mislukt.


extractTars - Alle bestanden uitpakken die zijn opgeslagen in tar-archieven
boolean.

Stel in op true om alle gedownloade bestanden met de extensie .tar uit te pakken. Dit is handig omdat u uw artefactbestanden in tar moet inpakken als u machtigingen voor Unix-bestanden wilt behouden. Als u de StoreAsTar optie inschakelt in de taak Build-artefacten publiceren , worden artefacten automatisch opgeslagen als TAR-bestanden .


Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties voor besturingselementen en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Deze taak definieert de volgende uitvoervariabelen, die u kunt gebruiken in downstreamstappen, taken en fasen.

BuildNumber
Hiermee wordt het buildnummer van de bron van het build-artefact opgeslagen.

Houd er rekening mee dat deze invoer BuildId retourneert vanwege compatibiliteit met eerdere versies. Zie Variabelen voor meer informatie.

Opmerkingen

Notitie

Het Azure Pipelines-team raadt aan om een upgrade uit te voeren van buildartefacten naar Pijplijnartefacten voor snellere prestaties.

Vereisten

Vereiste Beschrijving
Pijplijntypen YAML, klassieke build, klassieke release
Wordt uitgevoerd op Agent, DeploymentGroup
Eisen Geen
Functies Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen Alle
Instelbare variabelen Alle
Agentversie 2.191.1 of hoger
Taakcategorie Hulpprogramma