Azure Artifacts에서 유니버설 패키지 게시 및 다운로드
Azure DevOps Services
유니버설 패키지를 사용하면 개발자가 NuGet, npm, Python 패키지 등과 같은 기존 패키지 형식을 넘어서 다양한 패키지 형식을 저장할 수 있습니다. Azure CLI를 사용하면 명령줄에서 직접 유니버설 패키지를 게시하고 다운로드할 수 있습니다. 게시된 패키지의 크기는 최대 4TB까지 다양할 수 있지만 항상 이름 및 버전 번호를 포함하는 필수 요구 사항을 유지해야 합니다. 이 문서에서는 Azure Artifacts 피드에서 유니버설 패키지를 게시하고 다운로드하는 단계를 안내합니다.
필수 구성 요소
Azure CLI설치.
Azure DevOps 확장 버전 0.14.0 이상을 설치합니다.
피드 만들기
피드가 이미 있는 경우 다음 섹션으로 이동할 수 있습니다. 그렇지 않으면 아래 단계에 따라 새 Azure Artifacts 피드를 만듭니다.
Azure DevOps 조직에 로그인한 다음 프로젝트로 이동합니다.
아티팩트을 선택하고, 피드 만들기을 선택합니다.
피드에 대한 설명용 이름 을 설정하고 누가 피드에서 패키지를 볼 수 있는지에 대한 가시성을 설정합니다. 피드의 범위 정의한 다음, 공용 레지스트리의 패키지를 포함하려는 경우 업스트림 원본 확인란을 선택합니다.
완료되면 만들기을 선택합니다.
메모
새로 생성된 피드는 기본적으로 프로젝트의 Build Service 역할을 "피드 및 업스트림 리더(협력자)"로 지정합니다.
Azure DevOps 확장 설치
CLI를 사용하면 작업을 간소화할 수 있습니다. 계속하기 전에 Azure CLI(버전 2.10.1 이상)를 설치했는지 확인합니다. 또한 명령줄에서 Azure DevOps 서비스를 관리하기 위해 Azure DevOps 확장을 설치해야 합니다.
다음 명령을 실행하여 Azure DevOps 확장을 설치합니다.
az extension add --name azure-devopsAzure DevOps 확장이 이미 설치되어 있고 최신 버전으로 업데이트하려면 다음 명령을 실행합니다.
az extension update --name azure-devops
피드에 연결
Azure DevOps 조직에 로그인한 다음 프로젝트로 이동합니다.
""아티팩트"을 선택한 후 드롭다운 메뉴에서 피드를 선택합니다."
연결을 선택하여 피드에 연결합니다. 그런 다음 왼쪽 탐색 창에서 유니버설 패키지을 선택합니다.
프로젝트 설정 섹션의 지침에 따라 피드에 연결합니다.
다음 명령을 실행하여 Azure CLI에 로그인합니다.
az login다음 명령을 실행하여 프로젝트 및 조직을 CLI의 기본 구성으로 설정합니다.
az devops configure --defaults project=<YOUR_PROJECT_NAME> organization=https://dev.azure.com/<YOUR_ORGANIZATION_NAME>
메모
조직에서 방화벽 또는 프록시 서버를 사용하는 경우 Azure Artifacts 도메인 URL과 IP 주소을 허용해야 합니다.
유니버설 패키지 게시
유니버설 패키지를 피드에 게시하려면 패키지 이름과 버전 번호를 제공해야 합니다.
패키지 이름은 소문자로 작성되어야 하며, 문자나 숫자로 시작하고 끝나야 하고, 문자, 숫자, 그리고 연속되지 않는 대시, 밑줄, 마침표만 포함해야 합니다. 패키지 버전도 소문자여야 하며 빌드 메타데이터(+ 접미사)를 포함하면 안 됩니다. 자세한 내용은 시맨틱 버전 관리 참조하십시오.
다음 명령을 실행하여 유니버설 패키지를 피드에 게시합니다.
조직 내 피드:
az artifacts universal publish --organization https://dev.azure.com/<YOUR_ORGANIZATION> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <PACKAGE_DIRECTORY> --description <PACKAGE_DESCRIPTION>프로젝트에 대한 피드
az artifacts universal publish --organization https://dev.azure.com/<YOUR_ORGANIZATION> --project <PROJECT_NAME> --scope project --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <PACKAGE_DIRECTORY> --description <PACKAGE_DESCRIPTION>
메모
매우 많은 수의 파일(100K 이상)이 포함된 유니버설 패키지는 게시하지 못할 수 있습니다. 이 경우 파일을 ZIP 또는 TAR 보관 파일에 묶어 파일 수를 줄이는 것이 좋습니다.
게시된 패키지 보기
Azure DevOps 조직에 로그인한 다음 프로젝트로 이동합니다.
아티팩트선택한 다음 드롭다운 메뉴에서 피드를 선택합니다. 게시 프로세스가 성공적으로 완료되면 피드에서 패키지를 사용할 수 있어야 합니다.
유니버설 패키지 다운로드
다음 명령을 실행하여 Azure CLI를 사용하여 피드에서 특정 유니버설 패키지를 다운로드합니다.
조직에 한정된 피드:
az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH>프로젝트 범위 피드:
az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --project <PROJECT_NAME> --scope project --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH>
특정 파일 다운로드
특정 파일만 다운로드하려면 --file-filter 매개 변수를 사용하여 파일의 하위 집합을 가져옵니다. 자세한 내용은 파일 일치 패턴에 대한 참고 사항을 참조하세요.
조직 범위 피드:
az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH> --file-filter <MATCH_PATTERN>프로젝트 범위 피드:
az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --project <PROJECT_NAME> --scope project --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH> --file-filter <MATCH_PATTERN>
예제: 예를 들어 --file-filter logs/.log 사용하면 모든 파일이 "로그"를 포함하고 확장명 ".log"(예: build_logs.log)으로 끝나는 파일 이름과 일치합니다.
최신 버전 다운로드
와일드카드 * 사용하여 최신 버전의 유니버설 패키지를 다운로드할 수 있습니다.
예제:
--version '*': 최신 버전을 다운로드합니다.--version '1.*': 주요 버전 1을 사용하여 최신 버전을 다운로드하십시오.--version '1.2.*': 주요 버전 1, 부 버전 2의 최신 패치 릴리스를 다운로드하세요.
메모
와일드카드 패턴은 시험판 버전(버전 번호에 대시가 있는 패키지)에서 지원되지 않습니다.