다음을 통해 공유

DownloadBuildArtifacts@1 - 빌드 아티팩트 v1 작업 다운로드

  • 아티클

이 작업을 사용하여 완료된 빌드의 아티팩트로 저장된 파일을 다운로드합니다.

Azure DevOps Services 사용하는 경우 더 빠른 성능을 위해 파이프라인 아티팩트 다운로드 및 파이프라인 아티팩트 게시를 사용하는 것이 좋습니다.

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.

입력

buildType - 에서 생성한 아티팩트 다운로드
string. 필수 요소. 허용되는 값: current (현재 빌드), specific (특정 빌드). 기본값은 current입니다.

현재 빌드 또는 특정 빌드에서 생성된 아티팩트 다운로드 여부입니다.


project - 프로젝트
string. 필요한 경우 buildType == specific입니다.

빌드 아티팩트 다운로드할 프로젝트입니다.


pipeline - 빌드 파이프라인
입력 별칭: definition. string. 필요한 경우 buildType == specific입니다.

빌드 파이프라인 이름을 지정합니다.


specificBuildWithTriggering - 적절한 경우 트리거 빌드에서 아티팩트 다운로드
boolean. 선택 사항입니다. 을 사용할 때 buildType == specific사용합니다. 기본값은 false입니다.

이면 true이 빌드 태스크가 트리거 빌드에서 아티팩트 다운로드를 시도합니다. 지정된 파이프라인에서 트리거 빌드가 없는 경우 아래 옵션에 지정된 빌드에서 아티팩트가 다운로드됩니다.


buildVersionToDownload - 다운로드할 빌드 버전
string. 필요한 경우 buildType == specific입니다. 허용되는 값: latest, latestFromBranch (특정 분기의 최신 버전 및 지정된 빌드 태그), specific (특정 버전). 기본값은 latest입니다.

다운로드할 빌드 버전을 지정합니다.

  • 사용 가능한 최신 빌드 버전을 다운로드하도록 선택합니다 latest .
  • 로 지정된 branchName 분기의 사용 가능한 최신 빌드 버전과 에 지정된 태그를 tags다운로드하도록 선택합니다latestFromBranch.
  • 에서 지정buildId한 빌드 버전을 다운로드하도록 선택합니다specific.

allowPartiallySucceededBuilds - 부분적으로 성공한 빌드에서도 아티팩트 다운로드
boolean. 선택 사항입니다. 을 사용할 때 buildType == specific && buildVersionToDownload != specific사용합니다. 기본값은 false입니다.

이면 true이 빌드 태스크는 빌드 성공 또는 부분적으로 성공 여부에 관계없이 아티팩트 다운로드를 시도합니다.


branchName - 분기 이름
string. 필요한 경우 buildType == specific && buildVersionToDownload == latestFromBranch입니다. 기본값은 refs/heads/master입니다.

분기/ref 이름(예: refs/heads/develop)을 필터링할지 여부를 지정합니다.


buildId - 빌드
string. 필요한 경우 buildType == specific && buildVersionToDownload == specific입니다.

아티팩트 다운로드하려는 빌드입니다.


tags - 빌드 태그
string. 선택 사항입니다. 을 사용할 때 buildType == specific && buildVersionToDownload != specific사용합니다.

쉼표로 구분된 태그 목록입니다. 이러한 태그가 있는 빌드만 반환됩니다.


downloadType - 다운로드 유형
string. 필수 요소. 허용되는 값: single (특정 아티팩트), specific (특정 파일). 기본값은 single입니다.

빌드에서 특정 아티팩트 또는 특정 파일을 다운로드합니다.

  • 에서 지정한 특정 아티팩트 하나만 원하는 경우 (특정 아티팩트) 선택 singleartifactName
  • 선택한 빌드의 모든 아티팩트가 원하는 경우 (특정 파일) 선택 specific

artifactName - 아티팩트 이름
string. 필요한 경우 downloadType == single입니다.

다운로드할 아티팩트 이름입니다.


itemPattern - 일치 패턴
string. 기본값은 **입니다.

여러 줄 미니매치 패턴으로 다운로드할 파일을 지정합니다. 자세한 내용은 파일 일치 패턴 참조를 참조하세요.

기본 패턴 \*\* 은 특정 파일 옵션을 선택하는 경우 빌드의 모든 아티팩트에서 모든 파일을 다운로드합니다. 아티팩트 드롭 내의 모든 파일을 다운로드하려면 를 사용합니다 drop/**.


downloadPath - 대상 디렉터리
string. 필수 요소. 기본값은 $(System.ArtifactsDirectory)입니다.

아티팩트가 다운로드되는 에이전트 컴퓨터의 경로입니다.


cleanDestinationFolder - 대상 폴더 정리
boolean. 기본값은 false입니다.

아티팩트 다운로드 전에 대상 폴더의 모든 기존 파일을 삭제합니다.


parallelizationLimit - 병렬화 제한
string. 기본값은 8입니다.

동시에 다운로드할 파일 수입니다.


checkDownloadedFiles - 다운로드한 파일 확인
boolean. 기본값은 false입니다.

이면 true이 빌드 태스크는 모든 파일이 완전히 다운로드되었는지 확인합니다.


retryDownloadCount - 재시도 횟수
string. 기본값은 4입니다.

다운로드가 실패할 경우 빌드 아티팩트 다운로드를 다시 시도할 횟수입니다.


extractTars - tar 보관 파일에 저장된 모든 파일 추출
boolean.

true.tar 확장명이 있는 다운로드한 모든 파일을 추출하려면 로 설정합니다. 이는 Unix 파일 권한을 유지하려는 경우 아티팩트 파일을 tar로 압축해야 하기 때문에 유용합니다. StoreAsTar빌드 아티팩트 게시 작업에서 옵션을 사용하도록 설정하면 아티팩트가 자동으로 .tar 파일로 저장됩니다.


작업 제어 옵션

모든 작업에는 작업 입력 외에 제어 옵션이 있습니다. 자세한 내용은 컨트롤 옵션 및 일반적인 작업 속성을 참조하세요.

출력 변수

이 작업은 다운스트림 단계, 작업 및 단계에서 사용할 수 있는 다음 출력 변수를 정의합니다.

BuildNumber
빌드 아티팩트 원본의 빌드 번호를 저장합니다.

이 입력은 이전 버전과의 호환성으로 인해 BuildId 를 반환합니다. 자세한 내용은 변수를 참조하세요.

설명

참고

Azure Pipelines 팀은 더 빠른 성능을 위해 빌드 아티팩 트에서 파이프라인 아티팩트 로 업그레이드하는 것이 좋습니다.

요구 사항

요구 사항 Description
파이프라인 유형 YAML, 클래식 빌드, 클래식 릴리스
실행 중 에이전트, DeploymentGroup
요청 없음
Capabilities 이 작업은 작업의 후속 작업에 대한 요구를 충족하지 않습니다.
명령 제한 사항 모두
Settable 변수 모두
에이전트 버전 2.191.1 이상
작업 범주 유틸리티