Azure Pipelines를 사용하여 유니버설 패키지 게시 및 다운로드

아티클
2025-04-01

Azure DevOps Services

유니버설 패키지를 사용하면 유형에 관계없이 팀 또는 대상 그룹과 원하는 수의 파일을 패키지하고 공유할 수 있습니다. Azure Pipelines의 유니버설 패키지 작업을 사용하여 4TiB에 대한 패키지를 압축, 게시 및 다운로드할 수 있습니다. 각 패키지는 고유한 이름 및 버전 번호로 식별됩니다. Azure CLI 또는 Azure Pipelines를 사용하여 아티팩트 피드에서 패키지를 게시하고 다운로드할 수 있습니다.

메모

유니버설 패키지는 Azure DevOps Services에서만 사용할 수 있습니다.

필수 조건

제품	요구 사항
Azure DevOps	- Azure DevOps 프로젝트. - 권한: - 프로젝트의 모든 파이프라인에 대한 액세스 권한을 부여하려면 Project Administrators 그룹구성원이어야 합니다. - 서비스 연결을 만들려면, 관리자 또는 생성자 역할이서비스 연결에 대해 있어야 합니다.

파일 복사

Azure Pipelines의 유니버설 패키지 작업은 게시하려는 파일의 기본 위치로 $(Build.ArtifactStagingDirectory) 사용합니다. 게시할 유니버설 패키지를 준비하려면 게시할 파일을 이 디렉터리로 이동합니다. 파일 복사 유틸리티 작업을 사용하여 파일을 게시 디렉터리에 복사할 수도 있습니다.

Azure DevOps 조직에 로그인한 다음 프로젝트로 이동합니다.
파이프라인선택한 다음 파이프라인 정의를 선택합니다.

편집을 선택한 다음 YAML 파이프라인에 다음 코드 조각을 추가합니다.

- task: UniversalPackages@0
  displayName: Publish
  inputs:
    command: publish
    publishDirectory: '$(Build.ArtifactStagingDirectory)'        ## Location of the files you wish to publish
    vstsFeedPublish: '<PROJECT_NAME>/<FEED_NAME>'                ## The project and feed name to publish to. If you're working with an organization-scoped feed, specify only the feed name
    vstsFeedPackagePublish: '<PACKAGE_NAME>'                     ## The package name. Must be lower case. Use only letters, numbers, and dashes
    packagePublishDescription: '<PACKAGE_DESCRIPTION>'           ## Description of the package content

Azure DevOps 조직에 로그인한 다음 프로젝트로 이동합니다.
파이프라인선택한 다음 파이프라인 정의를 선택합니다.
편집을 선택한 다음 + 기호를 선택하여 새 작업을 추가합니다. 유니버설 패키지 작업을 추가하고 다음과 같이 구성합니다.

명령: 게시
게시할 파일 경로 : 게시할 파일의 경로를 지정합니다. 기본값: $(Build.ArtifactStagingDirectory).
피드 위치: 현재 조직 또는 다른 조직의 Azure Artifacts 피드에 게시합니다.
대상 피드: 패키지를 게시할 피드를 선택합니다.
패키지 이름: 기존 패키지를 선택하여 새 버전을 게시하거나 새 패키지 이름을 입력하여 새 패키지의 첫 번째 버전을 게시합니다.

메모

프로젝트의 파이프라인에서 피드에 패키지를 게시하려면, Project Collection Build Service 및 Build Service ID가 피드 설정에서 피드 게시자(기여자) 역할이 부여되었는지 확인해야 합니다. 자세한 내용은 권한 관리를 참조하세요.

패키지 버전 관리

유니버설 패키지는 주, 부 및 패치의 세 가지 숫자 구성 요소를 기반으로 하는 의미 체계 버전 관리를 준수합니다. 버전 관리 형식이 Major.Minor.Patch.

새 기능이 추가되어 이전 버전과 호환 가능할 때 부 버전이 증가합니다. 이 경우 부 버전이 증가하며 패치 버전이 0으로 다시 설정됩니다(예: 1.4.17에서 1.5.0으로).
주 버전은 이전 버전과의 호환성을 손상시킬 수 있는 중요한 변경 내용이 있는 경우 증가하여 부 버전과 패치 버전을 모두 0으로 다시 설정합니다(예: 2.6.5에서 3.0.0).
패치 버전은 버그 수정 또는 호환성에 영향을 미치지 않는 기타 작은 변경 내용이 적용될 때 증가합니다(예: 1.0.0에서 1.0.1).

새 패키지를 게시할 때 유니버설 패키지 작업은 자동으로 다음 주 버전, 부 버전 또는 패치 버전을 선택합니다.

YAML
클래식

패키지에 대한 버전 관리를 사용하도록 설정하려면 UniversagePackage 작업에 versionOption 입력을 추가합니다. 새 버전을 게시하는 데 사용할 수 있는 옵션은 major, minor, patch또는 custom.

custom 선택하면 패키지 버전을 수동으로 지정할 수 있습니다. 다른 옵션은 피드에서 최신 패키지 버전을 가져오고 선택한 버전 세그먼트를 1씩 증분합니다. 예를 들어 패키지 testPackage 1.0.0이 있는 경우:

major 선택하면 버전이 testPackage 2.0.0으로 업데이트됩니다.
minor 선택하면 버전이 1.1.0으로 업데이트됩니다.
patch 선택하면 버전이 1.0.1로 업데이트됩니다.

custom 옵션을 선택하는 경우 다음과 같이 versionPublish 값을 지정해야 합니다.

- task: UniversalPackages@0
  displayName: Publish
  inputs:
    command: publish
    publishDirectory: '$(Build.ArtifactStagingDirectory)'             ## Location of the files you wish to publish
    vstsFeedPublish: '<PROJECT_NAME>/<FEED_NAME>'                     ## The project and feed name to publish to. If you're working with an organization-scoped feed, specify only the feed name
    vstsFeedPackagePublish: '<PACKAGE_NAME>'                          ## The package name. Must be lower case. Use only letters, numbers, and dashes
    versionOption: custom                                             ## Select a versioning strategy. Options: `major`, `minor`, `patch`, `custom`
    versionPublish: '<PACKAGE_VERSION>'                               ## The custom package version
    packagePublishDescription: '<PACKAGE_DESCRIPTION>'                ## Description of the package content

Azure DevOps 조직에 로그인한 다음 프로젝트로 이동합니다.
파이프라인선택한 다음 파이프라인 정의를 선택합니다.
편집을 선택한 다음 + 기호를 선택하여 새 작업을 추가합니다. 유니버설 패키지 작업을 추가하고 다음과 같이 구성합니다.

명령: 게시
게시할 파일 경로 : 게시할 파일의 경로를 지정합니다. 기본값: $(Build.ArtifactStagingDirectory).
피드 위치: 현재 조직 또는 다른 조직의 Azure Artifacts 피드에 게시합니다.
대상 피드: 패키지를 게시할 피드를 선택합니다.
패키지 이름: 기존 패키지를 선택하여 새 버전을 게시하거나 새 패키지 이름을 입력하여 새 패키지의 첫 번째 버전을 게시합니다.
버전 버전 관리 전략을 선택하거나 사용자 지정 선택하고 패키지 버전을 수동으로 입력합니다.

유니버설 패키지 다운로드

YAML
클래식

Azure DevOps 조직에 로그인한 다음 프로젝트로 이동합니다.
파이프라인선택한 다음 파이프라인 정의를 선택합니다.

편집을 선택한 다음 YAML 파이프라인에 다음 코드 조각을 추가합니다.

steps:
- task: UniversalPackages@0
  displayName: Download
  inputs:
    command: download
    vstsFeed: '<PROJECT_NAME>/<FEED_NAME>'                        ## The Artifacts feed hosting the package to be downloaded
    vstsFeedPackage: '<PACKAGE_NAME>'                             ## Name of the package to be downloaded
    vstsPackageVersion: '<PACKAGE_VERSION>'                       ## Version of the package to be downloaded
    downloadDirectory: '$(Build.SourcesDirectory)\someFolder'     ## The download folder. Default value: $(System.DefaultWorkingDirectory).

외부 원본에서 유니버설 패키지를 다운로드하려면 다음 예제를 사용할 수 있습니다.

steps:
- task: UniversalPackages@0
  displayName: Download a Universal Package
  inputs:
    command: download
    feedsToUse: external                                        ## Set the value to `external` when downloading from an external source 
    externalFeedCredentials: 'MSENG2'                           ## Name of the service connection to the external feed
    feedDownloadExternal: 'fabrikamFeedExternal'                ## Name of the external feed
    packageDownloadExternal: 'fabrikam-package'                 ## The package name you wish to download
    versionDownloadExternal: 1.0.0                              ## The version of the package you wish to download

Azure DevOps 조직에 로그인한 다음 프로젝트로 이동합니다.
파이프라인선택한 다음 파이프라인 정의를 선택합니다.
편집을 선택한 다음 + 기호를 선택하여 새 작업을 추가합니다. 유니버설 패키지 작업을 추가하고 다음과 같이 구성합니다.

명령: 다운로드
대상 디렉터리: 패키지를 다운로드할 폴더 경로입니다. 기본값: $(System.DefaultWorkingDirectory).
피드 위치: 조직 또는 다른 조직의 피드에서 유니버설 패키지를 다운로드합니다.
피드: 다운로드하려는 피드입니다.
패키지 이름: 다운로드할 패키지의 이름입니다.
버전: 다운로드하려는 패키지의 버전입니다.

팁

와일드카드를 사용하여 최신 버전의 유니버설 패키지를 다운로드할 수 있습니다. 자세한 내용은 최신 버전 다운로드를 참조하세요.