다음을 통해 공유


npm 레지스트리에서 패키지 사용

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Azure Artifacts 업스트림 소스를 사용하면 개발자가 npmjs.com 같은 공용 레지스트리에서 패키지를 소비할 수 있습니다. 피드에서 업스트림 원본을 사용하도록 설정하면 Azure Artifacts는 업스트림 원본에서 설치된 패키지의 복사본을 피드에 자동으로 저장합니다. 이 설정은 가장 뛰어난 유연성을 제공하므로 모든 퍼블릭 레지스트리의 패키지를 포함하여 범위가 지정된 패키지와 비 범위 패키지의 혼합을 단일 피드 내에서 사용할 수 있습니다. 또한 이 설정을 사용하면 업스트림 원본을 일시적으로 사용할 수 없게 되는 경우에도 해당 패키지에 계속 액세스할 수 있습니다.

필수 조건

제품 요구 사항
Azure DevOps - 하나의 Azure DevOps 조직.
- Azure DevOps 프로젝트.
- Node.js 및 npm을 다운로드하여 설치합니다.

도구 가져오기

머신에서 npm과 함께 Azure Artifacts를 처음 사용하는 경우 아래 단계에 따라 환경을 설정합니다.

Node.js 및 npm을 설치했는지 확인한 다음 다음 명령을 실행하여 설치vsts-npm-auth합니다.

npm install -g vsts-npm-auth --registry https://registry.npmjs.com --always-auth false

피드 만들기

Azure Artifacts 피드가 이미 있는 경우 다음 섹션으로 건너뜁니다. 그렇지 않으면 다음과 같이 새 새로 만듭니다.

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

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

  3. 피드의 이름을 입력하고, 표시 유형을 설정하여 패키지를 볼 수 있는 사용자를 정의하고, 피드 범위를 선택합니다. 공용 원본에서 패키지 포함 확인란을 선택하여 업스트림 원본을 사용하도록 설정하고 공용 레지스트리에서 패키지를 사용할 수 있도록 해야 합니다.

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

npmjs 업스트림 추가

피드를 만드는 동안 업스트림 원본 확인란을 선택한 경우 npmjs 가 피드의 업스트림 원본 목록에 자동으로 추가됩니다. 그렇지 않은 경우 다음과 같이 수동으로 추가할 수 있습니다.

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

  2. 아티팩트를 선택한 후 드롭다운 메뉴에서 피드를 선택합니다.

  3. 기어 아이콘 단추 기어 아이콘 을 선택하여 피드 설정을 엽니다.

  4. 업스트림 원본을 선택한 다음 업스트림 추가를 선택합니다.

  5. 공용 원본을 선택한 다음, 드롭다운 메뉴에서 npmjs(https://registry.npmjs.org/)를 선택합니다.

  6. 완료되면 추가를 선택합니다.

  7. 오른쪽 위 모서리에서 저장 을 선택하여 변경 내용을 적용합니다.

피드에 연결

업스트림 원본에서 피드로 패키지를 저장하기 전에 먼저 프로젝트를 설정하고 피드에 연결해야 합니다.

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

  2. 아티팩트를 선택한 후 드롭다운 메뉴에서 피드를 선택합니다.

  3. 피드에 연결을 선택한 다음, 왼쪽 패널에서 npm을 선택합니다.

  4. 프로젝트 설정 섹션의 단계에 따라 .npmrc 파일을 구성하고 피드를 사용하여 인증합니다. 자세한 내용은 npm 프로젝트 설정을 참조하세요 .

npmjs에서 패키지 설치

피드를 사용하여 인증했으므로 이제 npmjs.com 같은 공용 레지스트리에서 패키지 설치를 시작할 수 있습니다. 업스트림 원본에서 패키지를 설치하면 Azure Artifacts는 해당 패키지의 복사본을 피드에 자동으로 저장합니다. 이 예제에서는 Node.js 애플리케이션에서 스키마 정의, 데이터 유효성 검사 및 개체 모델링에 도움이 되는 MongoDB ODM(개체 데이터 모델링) 라이브러리인 Mongoose를 설치합니다.

참고

업스트림에서 패키지를 저장하려면 피드 및 업스트림 판독기(협력자) 역할 이상이 있어야 합니다. 자세한 내용은 피드 역할 및 사용 권한을 참조하세요.

  1. https://www.npmjs.com로 이동합니다.

  2. Mongoose 패키지를 검색한 다음, 선택하여 세부 정보 페이지로 이동합니다.

  3. 설치 명령을 클립보드에 복사합니다.

  4. 명령 프롬프트 창에서 프로젝트 디렉터리로 이동하여 설치 명령을 실행합니다.

    npm i mongoose
    

저장된 패키지 보기

이제 npm 레지스트리에서 패키지를 설치했으므로 Azure Artifacts가 해당 패키지의 복사본을 피드에 자동으로 저장하는 방법을 확인할 수 있습니다. 다음 단계에 따라 패키지가 피드에 추가되었는지 확인합니다.

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

  2. 아티팩트를 선택한 후 드롭다운 메뉴에서 피드를 선택합니다.

  3. 오른쪽 위 모서리에 있는 원본 메뉴에서 npmjs를 선택하여 npm 레지스트리에서 패키지를 필터링합니다.

  4. 이전 단계에서 설치한 mongoose 패키지가 이제 피드에 표시됩니다. Azure Artifacts는 설치 명령을 실행할 때 복사본을 자동으로 저장했습니다.

    공용 npm 레지스트리에서 저장된 새 Mongoose 패키지를 표시하는 스크린샷.