Node.js 패키지 작업

Artifact Registry는 npm으로 관리하는 Node.js 패키지를 지원합니다.

패키지 관리는 알파 버전입니다. 이 기능은 알파 사용자에게만 제공되며 컨테이너 관리에 사용할 수 있는 모든 기능이 포함되지 않을 수 있습니다. 알파 버전을 신청하려면 가입 양식을 작성하세요.

개요

Artifact Registry의 Node.js 패키지에 익숙해지려면 빠른 시작을 사용해 보세요.

자세히 알아보려면 다음 정보를 읽어보세요.

  1. npm을 처음 사용하는 경우 다음 개념을 참조하세요.
  2. 패키지의 npm 저장소를 만듭니다.
  3. 저장소와 연결할 계정에 권한을 부여합니다. Artifact Registry와의 일반적인 통합을 위한 서비스 계정에는 동일한 프로젝트의 저장소에 대한 기본 권한이 있습니다.
  4. npm을 구성하여 저장소로 인증하도록 합니다.
  5. 패키지 관리 알아보기

범위 사용

npm 범위는 패키지를 그룹화하는 라벨입니다. 다음과 같이 여러 npm 레지스트리에서 작업하는 경우 범위가 필요합니다.

  • 한 레지스트리에서 다른 레지스트리로 전환할 필요가 없는 다른 레지스트리에 패키지를 게시하고 설치하는 경우. 예를 들어 빌드에는 공개 npm 레지스트리와 Artifact Registry 저장소의 패키지가 모두 포함될 수 있습니다.
  • 패키지 이름 충돌 없이 Google Cloud 프로젝트뿐만 아니라 다른 npm 레지스트리의 여러 Artifact Registry 저장소에 동일한 패키지를 게시하는 경우.

항상 저장소 범위를 설정하는 것이 좋습니다. 패키지를 게시하거나 설치할 때 범위를 지정하지 않으면 npm은 공개 npm 레지스트리와 같은 구성된 기본 레지스트리를 사용합니다.

.npmrc 구성 파일에서 각 Artifact Registry 저장소의 범위를 설정합니다. 인증에 동일한 사용자 인증 정보가 저장소에 적용됩니다.

다음 예시에서는 서로 다른 프로젝트의 Artifact Registry 저장소 구성을 보여줍니다.

  • @blue 범위는 blue-project 프로젝트의 저장소에 사용됩니다.
  • @green 범위는 green-project 프로젝트의 저장소에 사용됩니다.
@blue:registry=https://us-central1-npm.pkg.dev/blue-project/blue-npm-repo/
//us-central1-npm.pkg.dev/blue-project/blue-npm-repo/:_authToken=""
//us-central1-npm.pkg.dev/blue-project/blue-npm-repo/:always-auth=true

@green:registry=https://us-central1-npm.pkg.dev/green-project/green-npm-repo/
//us-central1-npm.pkg.dev/green-project/green-npm-repo/:_authToken=""
//us-central1-npm.pkg.dev/green-project/green-npm-repo/:always-auth=true

Artifact Registry에 대한 인증을 받은 후에는 적절한 범위를 사용하여 특정 저장소에 패키지를 업로드할 수 있습니다. 예를 들어 다음 명령어는 blue-project 프로젝트의 blue-npm-repo에 패키지를 업로드합니다.

npm publish @blue/blue-npm-repo

범위에 관한 자세한 내용은 npm 문서를 참조하세요.

사용자 인증 정보 저장

인증에 사용되는 설정은 npm 구성 파일에 저장됩니다. 이러한 파일의 이름은 .npmrc입니다. Artifact Registry에는 다음 설정이 사용됩니다.

  • 공개 npm 레지스트리의 사용자 인증 정보

    다른 사용자가 사용할 수 없도록 공개 사용자 npm 레지스트리(https://registry.npmjs.org/)의 사용자 인증 정보를 사용자별 구성 파일에 저장합니다. 이 파일은 사용자 홈 디렉터리에 있거나 npm --userconfig 매개변수 또는 $NPM_CONFIG_USERCONFIG 환경 변수로 설정됩니다. Artifact Registry 저장소로 인증하기 위한 Artifact Registry 도구는 공개 npm 레지스트리에 있습니다.

  • Artifact Registry 저장소에 연결하기 위한 설정

    Artifact Registry 저장소 설정을 다음 npm 구성 파일 중 하나에 저장할 수 있습니다.

    • 프로젝트별 구성 파일. 이 .npmrc 파일은 일반적으로 npm 프로젝트의 package.json 파일과 동일한 디렉터리에 있습니다. 이것이 가장 간단한 옵션입니다.

    • 사용자별 구성 파일: 이 파일은 사용자 홈 디렉터리에 있거나 npm --userconfig 매개변수 또는 $NPM_CONFIG_USERCONFIG 환경 변수로 설정됩니다.

    • 전역 구성 파일, $PREFIX/etc/npmrc $PREFIX 값을 가져오려면 npm prefix -g 명령어를 실행합니다.

npmrc 파일에 구성된 기존 기본 레지스트리를 유지해야 합니다. 기본값은 일반적으로 https://registry.npmjs.org/의 공개 npm 레지스트리로 설정됩니다.

현재 기본 레지스트리 값을 확인하려면 다음 명령어를 실행합니다.

npm get registry

npm 구성 파일에 대한 자세한 내용은 npm 구성 파일 문서를 참조하세요.