PublishPipelineArtifact@1 - 파이프라인 아티팩트 v1 작업 게시

이 작업을 사용하여 파일 또는 디렉터리를 현재 실행의 명명된 아티팩트로 게시(업로드)합니다.

Syntax

# Publish Pipeline Artifacts v1
# Publish (upload) a file or directory as a named artifact for the current run.
- task: PublishPipelineArtifact@1
  inputs:
    targetPath: '$(Pipeline.Workspace)' # string. Alias: path. Required. File or directory path. Default: $(Pipeline.Workspace).
    #artifact: # string. Alias: artifactName. Artifact name. 
    publishLocation: 'pipeline' # 'pipeline' | 'filepath'. Alias: artifactType. Required. Artifact publish location. Default: pipeline.
    #fileSharePath: # string. Required when artifactType = filepath. File share path. 
    #parallel: false # boolean. Optional. Use when artifactType = filepath. Parallel copy. Default: false.
    #parallelCount: '8' # string. Optional. Use when artifactType = filepath && parallel = true. Parallel count. Default: 8.
    #properties: # string. Custom properties.

입력

targetPath - 파일 또는 디렉터리 경로
입력 별칭: path. string. 필수 요소. 기본값은 $(Pipeline.Workspace)입니다.

게시할 파일 또는 디렉터리의 경로를 지정합니다. 절대 또는 기본 작업 디렉터리에 상대적일 수 있습니다. 변수를 포함할 수 있지만 와일드카드는 지원되지 않습니다. 자세한 내용은 Azure Pipelines의 아티팩트 를 참조하세요.

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

게시할 아티팩트 이름을 지정합니다. 예를 들어 drop선택한 이름일 수 있습니다. 설정하지 않으면 기본값은 작업 범위가 지정된 고유 ID입니다.

중요

아티팩트 이름에는 , , /, ", :, ><, |, 또는 ?가 *포함될 \수 없습니다.

publishLocation - 아티팩트 게시 위치
입력 별칭: artifactType. string. 필수 요소. 허용되는 값: pipeline (Azure Pipelines), filepath (파일 공유). 기본값은 pipeline입니다.

아티팩트 를 Azure Pipelines에 저장할지 또는 파이프라인 에이전트에서 액세스할 수 있어야 하는 파일 공유에 복사할지를 지정합니다.

fileSharePath - 파일 공유 경로
string. 필요한 경우 artifactType = filepath입니다.

아티팩트 파일이 복사되는 파일 공유를 지정합니다. 여기에는 변수(예 \\my\\share\\$(Build.DefinitionName)\\$(Build.BuildNumber): )가 포함될 수 있습니다. Linux 또는 macOS 에이전트에서 파일 공유로 아티팩트 게시는 지원되지 않습니다(예 \\server\folderName: ).

parallel - 병렬 복사
boolean. 선택 사항입니다. 를 사용하는 경우 artifactType = filepath를 사용합니다. 기본값은 false입니다.

잠재적 처리량을 높이기 위해 여러 스레드를 사용하여 파일을 병렬로 복사할지 여부를 지정합니다. 이 설정을 사용하도록 설정하지 않으면 하나의 스레드가 사용됩니다.

parallelCount - 병렬 개수
string. 선택 사항입니다. 를 사용하는 경우 artifactType = filepath && parallel = true를 사용합니다. 기본값은 8입니다.

복사를 수행하는 데 사용되는 병렬 처리 수준 또는 스레드 수를 지정합니다. 값은 1에서 128 사이여야 합니다.

properties - 사용자 지정 속성
string.

아티팩트와 연결할 사용자 지정 속성을 지정합니다. 모든 키에 접두사 user- 로 유효한 JSON 문자열을 사용합니다.

작업 제어 옵션

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

출력 변수

없음

설명

클래식 릴리스 파이프라인에서는 게시가 지원되지 않습니다.

참고

파이프라인 아티팩트 게시는 온-프레미스에서 지원되지 않습니다. Azure DevOps Server 또는 TFS 2018을 사용하는 경우 빌드 아티팩트 게시를 사용하세요. Azure DevOps Server 사용하는 경우와 유사한 Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead.오류 메시지가 표시됩니다.

publish 및 download 키워드는 PublishPipelineArtifact@1 및 DownloadPipelineArtifact@2 작업의 바로 가기입니다. 자세한 내용은 steps.publish 및 steps.download 를 참조하세요.

팁

.artifactignore 파일을 사용하여 게시할 파일을 제어할 수 있습니다.

아티팩트 게시에 문제가 있습니다. 자세한 로그를 보려면 어떻게 해야 하나요?

파이프라인에 대한 자세한 로그를 사용하도록 설정하려면 다음을 수행합니다.

1. 파이프라인 편집 및 변수 선택
2. 이름과 System.Debug 값을 사용하여 새 변수 추가 true
3. 저장

어떤 변수를 사용할 수 있나요?

A: $(Build.SourcesDirectory) 및 $(Agent.BuildDirectory) 는 파이프라인에서 사용할 수 있는 변수 중 몇 가지에 불과합니다. 변수는 식 또는 스크립트로 사용할 수 있습니다.

다양한 유형의 변수에 대해 알아보려면 변수, 미리 정의된 변수및 클래식 릴리스 및 아티팩트 변수 정의를 참조하세요.

작업을 통해 yaml 파이프라인의 배포 작업에서 아티팩트 게시를 할 수 있지만 다운스트림 파이프라인에서 사용할 수 없나요?

A: 배포 작업에는 원본 분기의 컨텍스트가 없으므로 아티팩트 게시에 적합하지 않습니다. 주로 아티팩트 사용을 위해 설계되었습니다. 해결 방법은 해당 논리를 별도의 작업(배포 작업에 대한 종속성 포함)으로 격리하는 것입니다.

요구 사항

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

추가 정보

• 빌드 아티팩트 시작을 찾고 계신가요? Azure Pipelines의 아티팩트 를 참조하세요.