다음을 통해 공유


DownloadPipelineArtifact@2 - 파이프라인 아티팩트 v2 작업 다운로드

이 작업을 사용하여 이 파이프라인의 이전 단계 또는 다른 파이프라인에서 파이프라인 아티팩트 다운로드

참고

Azure CLI 명령을 비롯한 자세한 내용은 아티팩트 다운로드를 참조하세요.

이 작업을 사용하여 이 파이프라인의 이전 단계 또는 다른 파이프라인에서 파이프라인 아티팩트 다운로드

중요

이 작업은 Azure DevOps Services만 지원됩니다. Azure DevOps Server 사용하는 경우 Azure DevOps Server 또는 TFS 2018을 사용하는 경우 빌드 아티팩트 다운로드 사용과 유사한 Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. 오류 메시지가 표시됩니다.

Syntax

# Download Pipeline Artifacts v2
# Download build and pipeline artifacts.
- task: DownloadPipelineArtifact@2
  inputs:
    buildType: 'current' # 'current' | 'specific'. Alias: source. Required. Download artifacts produced by. Default: current.
    #project: # string. Required when source == specific. Project. 
    #definition: # string. Alias: pipeline. Required when source == specific. Build pipeline. 
    #specificBuildWithTriggering: false # boolean. Alias: preferTriggeringPipeline. Optional. Use when source == specific. When appropriate, download artifacts from the triggering build. Default: false.
    #buildVersionToDownload: 'latest' # 'latest' | 'latestFromBranch' | 'specific'. Alias: runVersion. Required when source == specific. Build version to download. Default: latest.
    #branchName: 'refs/heads/master' # string. Alias: runBranch. Required when source == specific && runVersion == latestFromBranch. Branch name. Default: refs/heads/master.
    #pipelineId: # string. Alias: runId | buildId. Required when source == specific && runVersion == specific. Build. 
    #tags: # string. Optional. Use when source == specific && runVersion != specific. Build Tags. 
    #allowPartiallySucceededBuilds: false # boolean. Optional. Use when source == specific && runVersion != specific. Download artifacts from partially succeeded builds. Default: false.
    #allowFailedBuilds: false # boolean. Optional. Use when source == specific && runVersion != specific. Download artifacts from failed builds. Default: false.
    #artifactName: # string. Alias: artifact. Artifact name. 
    #itemPattern: '**' # string. Alias: patterns. Matching patterns. Default: **.
    targetPath: '$(Pipeline.Workspace)' # string. Alias: path | downloadPath. Required. Destination directory. Default: $(Pipeline.Workspace).

입력

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

현재 파이프라인 실행 또는 특정 파이프라인 실행에서 생성된 아티팩트 다운로드


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

파이프라인 아티팩트 다운로드할 프로젝트 이름 또는 GUID를 지정합니다.


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

파이프라인의 정의 ID입니다. 실행 중인 파이프라인에서 은 definitionIdSystem.DefinitionId 변수에서 찾을 수 있습니다. definitionId Azure DevOps 포털의 파이프라인 개요 페이지의 URL에서 를 검색할 수도 있습니다. 다음 URL 예제 definitionId 에서 은 78입니다 https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. 특정 파이프라인 정의에서 아티팩트 다운로드하려면 해당 파이프라인에서 를 캡처 definitionId 하고 매개 변수로 pipeline 지정합니다.


specificBuildWithTriggering - 적절한 경우 트리거 빌드에서 아티팩트 다운로드
입력 별칭: preferTriggeringPipeline. boolean. 선택 사항입니다. 를 사용하는 경우 source == specific를 사용합니다. 기본값은 false입니다.

이 옵션을 선택하면 작업에서 트리거 빌드에서 아티팩트가 다운로드됩니다. 지정된 파이프라인에서 트리거되는 빌드가 없는 경우 작업은 아래 옵션에 지정된 빌드에서 아티팩트 다운로드합니다.


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

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


branchName - 분기 이름
입력 별칭: runBranch. string. 필요한 경우 source == specific && runVersion == latestFromBranch입니다. 기본값은 refs/heads/master입니다.

분기/ref 이름에 대한 필터를 지정합니다. 예: refs/heads/develop


pipelineId - 빌드
입력 별칭: runId | buildId. string. 필요한 경우 source == specific && runVersion == specific입니다.

아티팩트 다운로드할 파이프라인의 식별자입니다. 실행 중인 파이프라인에서 는 buildIdBuild.BuildId 변수에서 찾을 수 있습니다. Azure buildId DevOps 포털의 파이프라인 실행 요약 페이지의 URL에서 를 검색할 수도 있습니다. 다음 URL 예제 buildId 에서 은 1088입니다 https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. 특정 파이프라인 실행에서 아티팩트 다운로드하려면 해당 실행에서 를 캡처 buildId 하고 매개 변수로 buildId 지정합니다.


tags - 빌드 태그
string. 선택 사항입니다. 를 사용하는 경우 source == specific && runVersion != specific를 사용합니다.

태스크가 태그가 지정된 빌드를 반환하는 데 사용하는 쉼표로 구분된 태그 목록입니다. 태그가 지정되지 않은 빌드는 반환되지 않습니다.


allowPartiallySucceededBuilds - 부분적으로 성공한 빌드에서 아티팩트 다운로드
boolean. 선택 사항입니다. 를 사용하는 경우 source == specific && runVersion != specific를 사용합니다. 기본값은 false입니다.

빌드 태스크가 빌드 성공 또는 부분적으로 성공하는지 여부를 아티팩트 다운로드할지 여부를 지정합니다.


allowFailedBuilds - 실패한 빌드에서 아티팩트 다운로드
boolean. 선택 사항입니다. 를 사용하는 경우 source == specific && runVersion != specific를 사용합니다. 기본값은 false입니다.

이 옵션을 선택하면 빌드 태스크에서 빌드 성공 또는 실패 여부에 관계없이 아티팩트가 다운로드됩니다.


artifactName - 아티팩트 이름
입력 별칭: artifact. string.

다운로드할 아티팩트 이름을 지정합니다. 값이 비어 있으면 작업은 파이프라인 실행과 연결된 모든 아티팩트 다운로드를 수행합니다.


itemPattern - 일치 패턴
입력 별칭: patterns. string. 기본값은 **입니다.

다운로드한 파일을 제한하는 파일 일치 패턴입니다. 값은 새 줄로 구분된 하나 이상의 파일 일치 패턴일 수 있습니다. 파일 일치 패턴에 대해 자세히 알아봅니다.


targetPath - 대상 디렉터리
입력 별칭: path | downloadPath. string. 필수 요소. 기본값은 $(Pipeline.Workspace)입니다.

아티팩트가 다운로드될 에이전트 머신의 상대 또는 절대 경로를 지정합니다. 다중 다운로드 옵션이 적용되는 경우(빈 아티팩트 이름을 남겨 두면) 각 다운로드에 대해 하위 디렉터리가 만들어집니다. Azure Pipelines의 아티팩트 에 대해 자세히 알아봅니다.


작업 제어 옵션

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

출력 변수

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

BuildNumber
파이프라인 아티팩트 원본의 빌드 번호를 저장합니다.

이전 버전과의 호환성으로 인해 이 변수는 BuildId를 반환합니다.

빌드 변수에 대해 자세히 알아봅니다.

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

BuildNumber
파이프라인 아티팩트 원본의 빌드 번호를 저장합니다.

설명

중요

이 작업은 Azure DevOps Services만 지원됩니다. Azure DevOps Server 사용하는 경우 Azure DevOps Server 또는 TFS 2018을 사용하는 경우 빌드 아티팩트 다운로드 사용과 유사한 Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. 오류 메시지가 표시됩니다.

이 작업을 사용하여 이 파이프라인의 이전 단계 또는 다른 파이프라인에서 파이프라인 아티팩트 다운로드 기본적으로 아티팩트가 에 다운로드됩니다 $(Pipeline.Workspace). 아티팩트 이름을 지정하지 않으면 다운로드한 각 아티팩트마다 하위 디렉터리가 만들어집니다. 파일 일치 패턴을 사용하여 다운로드하려는 파일을 제한할 수 있습니다.

게시다운로드 키워드는 파이프라인 아티팩트 게시다운로드를 위한 작업 바로 가기입니다.

아티팩트를 다운로드하려는 파이프라인의 ID를 찾으려면 어떻게 해야 하나요?

특정 파이프라인 정의에 대한 definitionId를 찾으려면

실행 중인 파이프라인에서 은 definitionIdSystem.DefinitionId 변수에서 찾을 수 있습니다. definitionId Azure DevOps 포털의 파이프라인 개요 페이지의 URL에서 를 검색할 수도 있습니다. 다음 URL 예제 definitionId 에서 은 78입니다 https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. 특정 파이프라인 정의에서 아티팩트 다운로드하려면 해당 파이프라인에서 를 캡처 definitionId 하고 매개 변수로 pipeline 지정합니다.

특정 파이프라인 실행에 대한 buildId를 찾으려면

아티팩트 다운로드할 파이프라인의 식별자입니다. 실행 중인 파이프라인에서 는 buildIdBuild.BuildId 변수에서 찾을 수 있습니다. Azure buildId DevOps 포털의 파이프라인 실행 요약 페이지의 URL에서 를 검색할 수도 있습니다. 다음 URL 예제 buildId 에서 은 1088입니다 https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. 특정 파이프라인 실행에서 아티팩트 다운로드하려면 해당 실행에서 를 캡처 buildId 하고 매개 변수로 buildId 지정합니다.

예제

특정 아티팩트 다운로드

# Download an artifact named 'WebApp' to 'bin' in $(Build.SourcesDirectory)
- task: DownloadPipelineArtifact@2
  inputs:
    artifactName: 'WebApp'
    targetPath: $(Build.SourcesDirectory)/bin

특정 프로젝트/파이프라인에서 아티팩트 다운로드

# Download artifacts from a specific pipeline.
- task: DownloadPipelineArtifact@2
  inputs:
    buildType: 'specific'
    project: 'FabrikamFiber'
    definition: 12
    buildVersionToDownload: 'latest'

특정 분기에서 아티팩트 다운로드

# Download artifacts from a specific branch with a tag
- task: DownloadPipelineArtifact@2
  inputs:
    buildType: 'specific'
    project: 'FabrikamFiber'
    definition: 12
    buildVersionToDownload: 'latestFromBranch'
    branchName: 'refs/heads/master'
    tags: 'testTag'

특정 빌드 실행에서 아티팩트 다운로드

# Download an artifact named 'WebApp' from a specific build run to 'bin' in $(Build.SourcesDirectory)
- task: DownloadPipelineArtifact@2
  inputs:
    buildType: 'specific'
    artifactName: 'WebApp'
    targetPath: $(Build.SourcesDirectory)/bin
    project: 'FabrikamFiber'
    definition: 12
    buildVersionToDownload: 'specific'
    pipelineId: 40

요구 사항

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