UniversalPackages@0 - 유니버설 패키지 v0 작업

이 작업을 사용하여 유니버설 패키지를 다운로드하거나 패키지하고 게시할 수 있습니다.

Syntax

# Universal packages v0
# Download or publish Universal Packages.
- task: UniversalPackages@0
  inputs:
    command: 'download' # 'download' | 'publish'. Required. Command. Default: download.
    downloadDirectory: '$(System.DefaultWorkingDirectory)' # string. Required when command = download. Destination directory. Default: $(System.DefaultWorkingDirectory).
    #publishDirectory: '$(Build.ArtifactStagingDirectory)' # string. Required when command = publish. Path to file(s) to publish. Default: $(Build.ArtifactStagingDirectory).
  # Feed & package details
    feedsToUse: 'internal' # 'internal' | 'external'. Alias: internalOrExternalDownload. Required when command = download. Feed location. Default: internal.
    #externalFeedCredentials: # string. Alias: externalEndpoint. Optional. Use when internalOrExternalDownload = external && command = download. organization/collection connection. 
    #vstsFeed: # string. Alias: feedListDownload. Required when internalOrExternalDownload = internal && command = download. Feed. 
    #vstsFeedPackage: # string. Alias: packageListDownload. Required when internalOrExternalDownload = internal && command = download. Package name. 
    #vstsPackageVersion: # string. Alias: versionListDownload. Required when internalOrExternalDownload = internal && command = download. Version. 
    #feedDownloadExternal: # string. Required when internalOrExternalDownload = external && command = download. Feed (or Project/Feed if the feed was created in a project). 
    #packageDownloadExternal: # string. Required when internalOrExternalDownload = external && command = download. Package name. 
    #versionDownloadExternal: # string. Required when internalOrExternalDownload = external && command = download. Version. 
  # Feed & package details
    #feedsToUsePublish: 'internal' # 'internal' | 'external'. Alias: internalOrExternalPublish. Required when command = publish. Feed location. Default: internal.
    #publishFeedCredentials: # string. Alias: externalEndpoints. Required when internalOrExternalPublish = external && command = publish. organization/collection connection. 
    #vstsFeedPublish: # string. Alias: feedListPublish. Required when internalOrExternalPublish = internal && command = publish. Destination Feed. 
    #vstsFeedPackagePublish: # string. Alias: packageListPublish. Required when internalOrExternalPublish = internal && command = publish. Package name. 
    #feedPublishExternal: # string. Required when internalOrExternalPublish = external && command = publish. Feed (or Project/Feed if the feed was created in a project). 
    #packagePublishExternal: # string. Required when internalOrExternalPublish = external && command = publish. Package name. 
    #versionOption: 'patch' # 'major' | 'minor' | 'patch' | 'custom'. Alias: versionPublishSelector. Required when command = publish. Version. Default: patch.
    #versionPublish: # string. Required when versionPublishSelector = custom && command = publish. Custom version. 
    #packagePublishDescription: # string. Optional. Use when command = publish. Description. 
  # Advanced
    #publishPackageMetadata: true # boolean. Optional. Use when command = publish && internalOrExternalPublish = internal. Publish pipeline metadata. Default: true.
    #verbosity: 'None' # 'None' | 'Trace' | 'Debug' | 'Information' | 'Warning' | 'Error' | 'Critical'. Verbosity. Default: None.
  # Output
    #publishedPackageVar: # string. Optional. Use when command = publish. Package Output Variable.

입력

command - 명령
string. 필수 요소. 허용되는 값: download, publish. 기본값은 download입니다.

실행할 NuGet 명령을 지정합니다.

downloadDirectory - 대상 디렉터리
string. 필요한 경우 command = download입니다. 기본값은 $(System.DefaultWorkingDirectory)입니다.

태스크가 패키지의 콘텐츠를 다운로드하는 폴더 경로를 지정합니다.

feedsToUse - 피드 위치
입력 별칭: internalOrExternalDownload. string. 필요한 경우 command = download입니다. 허용되는 값: internal (이 organization/컬렉션), external (다른 organization/컬렉션). 기본값은 internal입니다.

이 컬렉션의 피드 또는 Azure Artifacts의 다른 컬렉션을 지정합니다.

externalFeedCredentials - organization/컬렉션 연결
입력 별칭: externalEndpoint. string. 선택 사항입니다. 을 사용할 때 internalOrExternalDownload = external && command = download사용합니다.

선택한 NuGet.config에 있는 외부 레지스트리에 사용할 자격 증명을 지정합니다. 이 organization 또는 컬렉션의 피드의 경우 이 값을 비워 둡니다. 빌드의 자격 증명이 자동으로 사용됩니다.

vstsFeed - 피드
입력 별칭: feedListDownload. string. 필요한 경우 internalOrExternalDownload = internal && command = download입니다.

선택한 피드를 포함합니다. 여기에서 피드를 선택하려면 Azure Artifacts가 설치되고 라이선스가 있어야 합니다. organization 범위 피드의 FeedName과 프로젝트 범위 피드의 projectName/FeedName 또는 ProjectID/FeedID를 지정합니다.

vstsFeedPackage - 패키지 이름
입력 별칭: packageListDownload. string. 필요한 경우 internalOrExternalDownload = internal && command = download입니다.

다운로드할 작업의 패키지 이름을 지정합니다.

vstsPackageVersion - 버전
입력 별칭: versionListDownload. string. 필요한 경우 internalOrExternalDownload = internal && command = download입니다.

패키지 버전을 지정하거나 다운로드할 버전이 포함된 변수를 사용합니다. 이 항목은 가장 높은 버전을 가져오기 위해 와 같은 *와일드카드 식일 수도 있습니다. 예: 1.* 주 버전 1에서 가장 높은 버전을 가져오고 주 버전 1 및 1.2.* 부 버전 2를 사용하여 가장 높은 패치 릴리스를 가져옵니다.

feedDownloadExternal - 피드(또는 프로젝트에서 피드를 만든 경우 프로젝트/피드)
string. 필요한 경우 internalOrExternalDownload = external && command = download입니다.

다른 organization/컬렉션의 피드를 지정합니다.

프로젝트 범위 피드의 경우 값은 이어야 Project/Feed합니다. 여기서 Project 는 프로젝트의 이름 또는 ID이고 Feed 는 피드의 이름/ID입니다. organization 범위 피드의 경우 값은 피드 이름만이어야 합니다.

packageDownloadExternal - 패키지 이름
string. 필요한 경우 internalOrExternalDownload = external && command = download입니다.

다운로드할 패키지 이름을 지정합니다.

versionDownloadExternal - 버전
string. 필요한 경우 internalOrExternalDownload = external && command = download입니다.

패키지 버전을 지정하거나 다운로드할 버전이 포함된 변수를 사용합니다. 이 항목은 가장 높은 버전을 가져오기 위해 와 같은 *와일드카드 식일 수도 있습니다. 예: 1.* 주 버전 1에서 가장 높은 버전을 가져오고 주 버전 1 및 1.2.* 부 버전 2를 사용하여 가장 높은 패치 릴리스를 가져옵니다. 와일드카드 패턴은 시험판 패키지에서 지원되지 않습니다.

publishDirectory - 게시할 파일 경로
string. 필요한 경우 command = publish입니다. 기본값은 $(Build.ArtifactStagingDirectory)입니다.

게시할 파일 목록의 경로를 지정합니다.

feedsToUsePublish - 피드 위치
입력 별칭: internalOrExternalPublish. string. 필요한 경우 command = publish입니다. 허용되는 값: internal (이 organization/컬렉션), external (다른 organization/컬렉션). 기본값은 internal입니다.

이 컬렉션의 피드 또는 Azure Artifacts의 다른 컬렉션을 지정합니다.

publishFeedCredentials - organization/컬렉션 연결
입력 별칭: externalEndpoints. string. 필요한 경우 internalOrExternalPublish = external && command = publish입니다.

외부 피드에 사용할 자격 증명을 지정합니다.

vstsFeedPublish - 대상 피드
입력 별칭: feedListPublish. string. 필요한 경우 internalOrExternalPublish = internal && command = publish입니다.

게시할 프로젝트 및 피드의 이름/GUID를 지정합니다.

publishPackageMetadata - 파이프라인 메타데이터 게시
boolean. 선택 사항입니다. 을 사용할 때 command = publish && internalOrExternalPublish = internal사용합니다. 기본값은 true입니다.

이 빌드/릴리스 파이프라인의 메타데이터(예: 실행 # 및 소스 코드 정보)를 패키지와 연결합니다.

vstsFeedPackagePublish - 패키지 이름
입력 별칭: packageListPublish. string. 필요한 경우 internalOrExternalPublish = internal && command = publish입니다.

이전에 이 패키지 버전을 게시한 적이 없는 경우 게시할 패키지 ID를 지정하거나 새 패키지 ID를 만듭니다. 패키지 이름은 소문자여야 하며 문자, 숫자 및 대시(-)만 사용할 수 있습니다.

feedPublishExternal - 피드(또는 프로젝트에서 피드를 만든 경우 프로젝트/피드)
string. 필요한 경우 internalOrExternalPublish = external && command = publish입니다.

게시할 외부 피드 이름을 지정합니다.

프로젝트에서 피드를 만든 경우 값은 이어야 Project/Feed합니다. 여기서 Project 는 프로젝트의 이름 또는 ID이고 Feed 는 피드의 이름입니다. 프로젝트에서 피드를 만들지 않은 경우 값은 피드 이름만이어야 합니다.

packagePublishExternal - 패키지 이름
string. 필요한 경우 internalOrExternalPublish = external && command = publish입니다.

외부 피드에 게시할 때 패키지 이름을 지정합니다.

versionOption - 버전
입력 별칭: versionPublishSelector. string. 필요한 경우 command = publish입니다. 허용되는 값: major (다음 주), minor (다음 부), patch (다음 패치), custom. 기본값은 patch입니다.

버전 증분 전략을 지정합니다. custom 패키지 버전을 수동으로 입력할 값입니다. 새 패키지의 경우 를 지정하면 첫 번째 버전은 1.0.0이 되고, 를 지정 major하면 0.1.0, 를 지정 minor하면 0.0.1이 됩니다 patch. 자세한 내용은 의미 체계 버전 지정 사양 을 참조하세요.

versionPublish - 사용자 지정 버전
string. 필요한 경우 versionPublishSelector = custom && command = publish입니다.

패키지에 대한 사용자 지정 버전 스키마를 지정합니다.

packagePublishDescription - 설명
string. 선택 사항입니다. 을 사용할 때 command = publish사용합니다.

패키지 내용 및/또는 이 버전의 패키지에서 변경한 내용에 대한 설명을 지정합니다.

verbosity - 세부 정보 표시
string. 허용되는 값: None, , Trace, DebugInformation, Warning, , Error, Critical. 기본값은 None입니다.

출력에 표시되는 세부 정보의 양을 지정합니다.

publishedPackageVar - 패키지 출력 변수
string. 선택 사항입니다. 을 사용할 때 command = publish사용합니다.

게시된 패키지 이름 및 버전을 포함할 변수의 이름을 지정합니다.

작업 제어 옵션

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

출력 변수

없음

설명

이 작업을 사용하여 유니버설 패키지를 다운로드하거나 패키지하고 게시할 수 있습니다.

내 파이프라인이 다른 프로젝트의 피드에 액세스해야 합니다.

파이프라인이 피드를 호스트하는 프로젝트와 다른 프로젝트에서 실행되는 경우 빌드 서비스에 대한 읽기/쓰기 액세스 권한을 부여하도록 다른 프로젝트를 설정해야 합니다. 자세한 내용은 Azure Pipelines의 패키지 권한을 참조하세요.

예제

유니버설 패키지 작업을 시작하는 가장 간단한 방법은 파이프라인 태스크 편집기를 사용하여 YAML을 생성하는 것입니다. 그런 다음 생성된 코드를 프로젝트의 azure-pipelines.yml 파일에 복사할 수 있습니다. 이 예제에서는 GatsbyJS PWA(프로그레시브 웹앱)를 빌드하는 파이프라인을 사용하여 YAML을 빠르게 생성하는 방법을 보여 줍니다.

유니버설 패키지는 웹앱을 캡슐화하고 버전을 지정하는 유용한 방법입니다. 웹앱을 유니버설 패키지로 패키징하면 특정 버전의 사이트로 빠르게 롤백할 수 있으며 배포 파이프라인에서 사이트를 빌드할 필요가 없습니다.

이 예제 파이프라인은 프로젝트 내의 피드에서 도구를 가져오는 방법을 보여 줍니다. 유니버설 패키지 작업은 도구를 다운로드하고, 빌드를 실행하고, 유니버설 패키지 작업을 다시 사용하여 컴파일된 전체 GatsbyJS PWA를 버전이 지정된 유니버설 패키지로 피드에 게시하는 데 사용됩니다.

유니버설 패키지 작업을 사용하여 패키지 다운로드

샘플 프로젝트의 두 번째 작업은 유니버설 패키지 작업을 사용하여 동일한 organization 다른 프로젝트 내에 있는 피드에서 도구 imagemagick을 가져옵니다. imagemagick 도구는 이미지 크기를 조정하는 후속 빌드 단계에서 필요합니다.

1. 더하기 아이콘을 클릭하고, 검색 상자에 "universal"을 입력하고, 추가 단추를 클릭하여 파이프라인에 작업을 추가하여 유니버설 패키지 작업을 추가합니다.

   

2. 새로 추가된 유니버설 패키지 작업 및 에 대한 명령을Download클릭합니다.

3. 도구 다운로드에 사용할 대상 디렉터리를 선택합니다.

4. 도구가 포함된 원본 피드를 선택하고, 패키지 이름을 설정하고, 원본 피드에서 imagemagick 도구의 버전을 선택합니다.

   

5. 필드를 완료한 후 YAML 보기를 클릭하여 생성된 YAML을 확인합니다.

   

6. 유니버설 패키지 작업 작성기에서는 기본값이 아닌 값이 포함된 간소화된 YAML을 생성합니다. 생성된 YAML azure-pipelines.yml 을 프로젝트 git 리포지토리의 루트에 있는 파일에 복사합니다.

   # Download Universal Package
   steps:
   - task: UniversalPackages@0
     displayName: 'Universal download'
     inputs:
       downloadDirectory: Application
       vstsFeed: '00000000-0000-0000-0000-000000000000/00000000-0000-0000-0000-000000000001'
       vstsFeedPackage: imagemagick
       vstsPackageVersion: 1.0.0
   

유니버설 패키지 작업을 사용하여 패키지 게시

이 샘플 파이프라인의 마지막 단계에서는 유니버설 패키지 작업을 사용하여 버전이 지정된 유니버설 패키지로 피드에 대한 단계에서 생성된 Run gatsby build 프로덕션 준비 Gatsby PWA를 업로드합니다. 피드에 완료되면 호스팅 공급자에 배포하고 로 시작할 수 있는 전체 사이트의 영구 복사본이 gatsby serve있습니다.

1. 더하기 아이콘을 클릭하고 검색 상자에 "유니버설"을 입력하고 추가 단추를 클릭하여 파이프라인 끝에 다른 유니버설 패키지 작업을 추가합니다. 이 작업은 단계에서 생성된 Run gatsby build 프로덕션 준비 자산을 모두 수집하고, 버전이 지정된 유니버설 패키지를 생성하고, 패키지를 피드에 게시합니다.

   

2. 명령을Publish로 설정합니다.

3. 파일 경로를 설정하여 GatsbyJS 프로젝트의 package.json가 포함된 디렉터리에 게시합니다.

4. 대상 피드, 패키지 이름을 선택하고 버전 관리 전략을 설정합니다.

   

5. 필수 필드를 완료한 후 YAML 보기를 클릭합니다.

6. 결과 YAML을 이전과 같이 파일에 복사합니다 azure-pipelines.yml . 이 샘플 프로젝트의 YAML은 아래에 표시됩니다.

   # Publish Universal Package
   steps:
   - task: UniversalPackages@0
     displayName: 'Universal publish'
     inputs:
       command: publish
       publishDirectory: Application
       vstsFeedPublish: '00000000-0000-0000-0000-000000000000/00000000-0000-0000-0000-000000000002' # You can also use '<projectName>/<feedName>' instead of the GUIDs
       vstsFeedPackagePublish: mygatsbysite
       packagePublishDescription: 'A test package'
   

이 예제에서는 파이프라인 작업 작성기를 사용하여 유니버설 패키지 태스크에 대한 YAML을 신속하게 생성한 다음 파일에 배치 azure-pipelines.yml 할 수 있는 방법을 보여 줍니다. 유니버설 패키지 작업 작성기에서는 유니버설 패키지 태스크의 인수를 사용하여 만들 수 있는 모든 고급 구성을 지원합니다.

참고

뷰에 직접 패키지를 게시하는 것은 Azure Artifacts에서 지원되지 않습니다. 먼저 피드에 패키지를 게시한 다음 보기로 승격해야 합니다.

요구 사항

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