다음을 통해 공유


Azure Artifacts에서 npm 패키지 시작

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

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

필수 조건

피드 만들기

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

  2. 아티팩트를 선택한 다음 피드 만들기를 선택하여 새 피드를 만듭니다.

  3. 피드에 대한 설명이 포함된 이름을 입력하고 피드 내의 패키지를 볼 수 있는 사용자를 나타내는 표시 유형을 정의합니다. 피드의 범위를 지정하고 퍼블릭 원본의 패키지를 포함하려는 경우 업스트림 원본을 검사 상자로 표시합니다.

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

    Azure DevOps Services에서 새 피드를 만드는 방법을 보여 주는 스크린샷

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

  2. 아티팩트를 선택한 다음 피드 만들기를 선택하여 새 피드를 만듭니다.

  3. 피드에 대한 설명이 포함된 이름을 입력하고 피드 내의 패키지를 볼 수 있는 사용자를 나타내는 표시 유형을 정의합니다. 피드의 범위를 지정하고 퍼블릭 원본의 패키지를 포함하려는 경우 업스트림 원본을 검사 상자로 표시합니다.

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

    Azure DevOps 2022에서 새 피드를 만드는 방법을 보여 주는 스크린샷

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

    Azure DevOps 2020에서 새 피드를 만드는 방법을 보여 주는 스크린샷

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

  2. 아티팩트, 새 피드를 선택합니다.

  3. 피드에 대한 설명이 포함된 이름을 입력하고 피드 내의 패키지를 볼 수 있는 사용자를 나타내는 표시 유형을 정의합니다. 공용 원본의 패키지를 포함하려면 이 피드 옵션을 통해 공용 원본에서 패키지 사용을 선택합니다.

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

    Azure DevOps 2019에서 새 피드를 만드는 방법을 보여 주는 스크린샷

참고 항목

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

피드에 커넥트

참고 항목

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. 프로젝트 설정 섹션의 지침에 따라 구성 파일을 설정하고 피드에 연결합니다.

    npm 프로젝트를 설정하고 Azure DevOps Services에서 Azure Artifacts 피드에 연결하는 방법을 보여 주는 스크린샷

  1. Azure DevOps 컬렉션에 로그인한 다음 프로젝트로 이동합니다.

  2. 아티팩트, 피드 커넥트 선택합니다.

  3. 왼쪽에서 npm을 선택한 다음 프로젝트 설정 섹션의 지침에 따라 피드에 연결합니다.

    npm 프로젝트를 설정하고 Azure DevOps Server 2022에서 Azure Artifacts 피드에 연결하는 방법을 보여 주는 스크린샷

  1. Azure DevOps 컬렉션에 로그인한 다음 프로젝트로 이동합니다.

  2. 아티팩트 및 피드할 커넥트 선택합니다.

  3. 왼쪽에서 npm을 선택한 다음 Project 설치의 지침에 따라 구성 파일을 설정하고 피드에 연결합니다.

    npm 프로젝트를 설정하고 Azure DevOps Server 2020에서 Azure Artifacts 피드에 연결하는 방법을 보여 주는 스크린샷

  1. Azure DevOps 컬렉션에 로그인한 다음 프로젝트로 이동합니다.

  2. 아티팩트 및 피드할 커넥트 선택합니다.

  3. 새 창이 표시됩니다. 왼쪽 탐색 창에서 npm을 선택하고 지침에 따라 프로젝트user.npmrc 파일을 설정합니다.

    npm 프로젝트를 설정하고 Azure DevOps Server 2019에서 Azure Artifacts 피드에 연결하는 방법을 보여 주는 스크린샷

Important

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

패키지 게시

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

npm publish

Important

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

패키지 복원

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

npm install

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

npm install --save <PACKAGE_NAME>