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

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

이 작업의 최신 버전이 있습니다. 자세한 내용은 DownloadPipelineArtifact@2 참조하세요.

참고

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

Syntax

# Download Pipeline Artifacts v1
# Download a named artifact from a pipeline to a local path.
- task: DownloadPipelineArtifact@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.
    #branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
    #pipelineId: # string. Alias: buildId. Required when buildType == specific && buildVersionToDownload == specific. Build. 
    #tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags. 
    #artifactName: # string. Artifact name. 
    #itemPattern: '**' # string. Matching pattern. Default: **.
    targetPath: '$(System.ArtifactsDirectory)' # string. Alias: downloadPath. Required. Destination directory. Default: $(System.ArtifactsDirectory).

입력

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

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

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

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

pipeline - 빌드 파이프라인
입력 별칭: definition. string. 필요한 경우 buildType == 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 - 적절한 경우 트리거 빌드에서 아티팩트 다운로드
boolean. 선택 사항입니다. 을 사용할 때 buildType == specific사용합니다. 기본값은 false입니다.

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

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

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

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

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

pipelineId - 빌드
입력 별칭: buildId. string. 필요한 경우 buildType == specific && buildVersionToDownload == specific입니다.

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

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

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

artifactName - 아티팩트 이름
string.

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

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

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

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

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

작업 제어 옵션

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

출력 변수

없음

설명

이 작업의 최신 버전이 있습니다. 자세한 내용은 DownloadPipelineArtifact@2 참조하세요.

중요

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

요구 사항

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