DownloadPipelineArtifact@1 - 파이프라인 아티팩트 v1 작업 다운로드
이 작업을 사용하여 이 파이프라인의 이전 단계 또는 다른 파이프라인에서 파이프라인 아티팩트 다운로드
이 작업의 최신 버전이 있습니다. 자세한 내용은 DownloadPipelineArtifact@2참조하세요.
비고
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. 사용과 유사한 오류 메시지가 표시됩니다.
구문론
# 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 변수에서 찾을 수 있습니다. azure DevOps 포털의 파이프라인 개요 페이지의 URL에서 definitionId 검색할 수도 있습니다. 다음 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 변수에서 찾을 수 있습니다. azure DevOps 포털의 파이프라인 실행 요약 페이지의 URL에서 buildId 검색할 수도 있습니다. 다음 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 변수에서 찾을 수 있습니다. azure DevOps 포털의 파이프라인 개요 페이지의 URL에서 definitionId 검색할 수도 있습니다. 다음 URL 예제에서 definitionId 78입니다. https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. 특정 파이프라인 정의에서 아티팩트를 다운로드하려면 해당 파이프라인에서 definitionId 캡처하고 pipeline 매개 변수로 지정합니다.
특정 파이프라인에 대한 buildId를 찾으려면
아티팩트 다운로드할 파이프라인 실행의 식별자입니다. 실행 중인 파이프라인에서 buildIdBuild.BuildId 변수에서 찾을 수 있습니다. azure DevOps 포털의 파이프라인 실행 요약 페이지의 URL에서 buildId 검색할 수도 있습니다. 다음 URL 예제에서 buildId 1088: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. 특정 파이프라인 실행에서 아티팩트를 다운로드하려면 해당 실행에서 buildId 캡처하고 buildId 매개 변수로 지정합니다.