Node.js 패키지 관리

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

개요

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

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

  1. npm을 처음 사용하는 경우 다음 개념을 참조하세요.
  2. 패키지의 Node.js 패키지 저장소를 만듭니다.
  3. 저장소와 연결할 계정에 권한을 부여합니다. Artifact Registry와의 일반적인 통합을 위한 서비스 계정에는 동일한 프로젝트의 저장소에 대한 기본 권한이 있습니다.
  4. 도구를 구성합니다.
  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/: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 구성 파일에 저장됩니다. .npmrc 파일을 프로젝트, 사용자 또는 전역 수준에서 구성할 수 있습니다.

Artifact Registry로 인증을 구성할 때 연결할 저장소와 인증을 위한 사용자 인증 정보를 정의합니다.

Artifact Registry 저장소

프로젝트별 구성 파일에서 저장소 목록을 설정하는 것이 좋습니다. 이 파일은 일반적으로 npm 프로젝트의 package.json 파일과 같은 디렉터리에 있습니다. Artifact Registry 사용자 인증 정보 도우미는 기본적으로 이 .npmrc 파일에서 저장소를 확인합니다.

소스 제어 시스템에 저장소 경로를 노출하지 않으려면 다음을 수행합니다.

  • 소스 컨트롤의 무시할 파일 목록에 .npmrc 파일 이름을 추가합니다.
  • 대신 사용자별 confg 파일에 저장소 목록을 저장합니다. 사용자별 .npmrc 파일은 사용자 홈 디렉터리에 있거나 npm --userconfig 매개변수 또는 $NPM_CONFIG_USERCONFIG 환경 변수를 사용하여 설정됩니다. 사용자별 구성 파일의 설정은 프로젝트 수준에서 재정의하지 않는 한 모든 프로젝트에 적용됩니다.
Artifact Registry 사용자 인증 정보

Artifact Registry의 사용자 인증 정보를 다른 사용자가 사용할 수 없도록 사용자별 구성 파일에 저장합니다. 이 파일은 사용자 홈 디렉터리에 있거나 npm --userconfig 매개변수 또는 $NPM_CONFIG_USERCONFIG 환경 변수를 사용하여 설정됩니다.

Artifact Registry 사용자 인증 정보 도우미는 공개 npm 레지스트리에 저장되며 설치할 인증이 필요하지 않습니다.

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

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

npm get registry

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