Azure Artifacts에서 npm 패키지 시작

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Azure Artifacts를 사용하여 피드 및 공용 레지스트리(예: npmjs.com)에서 npm 패키지를 게시하고 다운로드할 수 있습니다. 이 빠른 시작에서는 피드를 만들고, 프로젝트를 구성하고, Azure Artifacts 피드를 사용하여 npm 패키지를 관리하는 방법을 안내합니다.

필수 조건

• Azure DevOps 조직. 체험 계정 만들기

• Azure DevOps 프로젝트입니다. 새 프로젝트가 없는 경우 새 프로젝트를 만듭니다.

• Node.js 및 npm을 다운로드하여 설치합니다.

피드 만들기

1. Azure DevOps 조직에 로그인한 다음, 프로젝트로 이동합니다.

2. 아티팩트 및 피드 만들기를 선택합니다.

3. 이름에 피드의 설명이 포함된 이름을 입력합니다.

   표시 여부의 경우 피드 내에서 패키지를 볼 수 있는 사용자를 나타내는 옵션을 선택합니다.

   공용 원본의 패키지를 포함하려면 업스트림 원본에서 확인란을 선택합니다.

   범위의 경우 피드의 범위가 프로젝트인지 조직인지 지정합니다.

4. 완료되면 만들기를 선택합니다.

   

참고 항목

기본적으로 새로 만든 피드에는 프로젝트의 빌드 서비스 값이 피드 및 업스트림 판독기 (협력자)로 설정됩니다.

피드에 연결

참고 항목

vsts-npm-auth 은 Azure DevOps Server에서 지원되지 않습니다.

Azure Artifacts는 두 개의 .npmrc 파일을 사용하는 것이 좋습니다. 첫 번째 디렉터리는 $home 디렉터리(Linux/macOS) 또는 $env 배치해야 합니다. HOME(Windows)을 사용하여 자격 증명을 안전하게 저장합니다. 이렇게 하면 npm 클라이언트가 파일을 찾고 인증을 위해 자격 증명을 검색할 수 있으므로 자격 증명을 노출하지 않고도 구성 파일을 공유할 수 있습니다. 이 섹션에서는 package.json 파일과 동일한 디렉터리에 배치해야 하는 두 번째 .npmrc 파일을 설정합니다.

1. Azure DevOps 조직에 로그인한 다음 프로젝트로 이동합니다.

2. 아티팩트 선택, 피드에 연결 선택

3. 왼쪽 탐색 영역에서 npm을 선택합니다. npm에서 Azure Artifacts를 처음 사용하는 경우 필수 구성 요소를 설치했는지 확인합니다.

4. 프로젝트 설정 섹션의 지침에 따라 구성 파일을 설정하고 피드에 연결합니다.

   

Important

npm은 .npmrc 파일에서 단일 registry 을 지원합니다. 범위 및 업스트림 원본을 사용하여 여러 레지스트리를 사용할 수 있습니다.

패키지 게시

프로젝트 디렉터리에서 다음 명령을 실행하여 npm 패키지를 게시합니다.

npm publish

Important

publishConfig 게시 시 레지스트리 구성 매개 변수를 재정의하는 데 속성을 사용하는 것은 지원되지 않습니다.

패키지 복원

프로젝트 디렉터리에서 다음 명령을 실행하여 npm 패키지를 복원합니다.

npm install

특정 npm 패키지를 복원하려면 프로젝트 디렉터리에서 다음 명령을 실행합니다.

npm install --save <PACKAGE_NAME>

관련된 문서

• npm 패키지 게시(YAML/클래식)
• npmjs.com 패키지 사용
• npm 범위 사용