레지스트리

추가된 버전: v11.23.0

The registries setting in pnpm-workspace.yaml declares each registry a project installs from, once, keyed by the registry's URL. pnpm이 레지스트리에 대해 아는 모든 정보는 해당 항목에 담깁니다. 즉, 그 레지스트리로 라우팅되는 스코프, 그 레지스트리가 응답하는 bare specifier 접두사, 그리고 그 뒤에 있는 서버의 특성입니다.

registries:
  https://npm.corp.example.com/:
    serverType: artifactory
    scopes: ["@acme", "@corp-tools"]
    prefix: work
  https://verdaccio.corp.example.com/:
    scopes: ["@"]
    supportsTimeField: true

항목의 모든 정보가 해당 서버에 관한 정보이기 때문에 URL이 키가 됩니다. 만약 tarball 레이아웃의 키가 스코프라면, 레이아웃은 스코프가 현재 가리키는 대상에 묶이게 되고, 스코프가 서로 다르게 해석되는 두 개발자는 어떤 URL을 생략할 수 있는지에 대해 서로 다른 lockfile을 작성하게 됩니다.

항목에는 다음 필드를 포함할 수 있습니다:

그 밖의 필드는 거부됩니다. In particular, credentials (_authToken, _auth, _password, username, tokenHelper) and TLS material (ca, cafile, cert, certfile, key, keyfile) are refused rather than silently ignored. pnpm-workspace.yaml is committed to the repository, so they belong in .npmrc (e.g. //npm.corp.example.com/:_authToken=...). 같은 이유로 user:pass@ 자격 증명이 포함된 URL 키도 거부됩니다.

패키지를 레지스트리로 라우팅하기#

scopes#

패키지가 이 레지스트리에서 해석되는 스코프로, @ 접두사를 붙입니다. A bare "@" routes the scope-less default registry, the same registry the registry setting names:

registries:
  https://npm.corp.example.com/:
    scopes: ["@acme"]
  https://registry.internal.example.com/:
    scopes: ["@"]

하나의 스코프는 정확히 하나의 레지스트리로 해석되므로, 두 항목에서 같은 스코프를 라우팅하면 오류가 발생합니다.

prefix#

"lib": "work:^2.0.0"에서처럼 이 레지스트리가 응답하는 이름 있는 레지스트리 접두사입니다:

registries:
  https://npm.work.example.com/:
    prefix: work

pnpm add work:@corp/lib@^2.0.0

각 항목은 최대 하나의 접두사를 선언하며, 두 항목이 같은 접두사를 선언할 수 없습니다. 접두사는 lockfile 패키지 키(foo@work:1.0.0)에서 레지스트리의 식별자이므로, 두 번째 표기가 있으면 같은 레지스트리의 같은 패키지가 두 번 키로 지정되기 때문입니다.

Prefixes declared here follow the same rules as the deprecated namedRegistries setting they replace: the built-in gh: and npmjs: aliases can be overridden by declaring their prefix on your own URL, reserved names are rejected, and packages resolved from a registry that declares a prefix get registry-qualified lockfile keys, whether a dependency names the prefix or a scopes entry routes it there.

서버 설명하기#

serverType#

모든 레지스트리가 npm 레지스트리와 같은 방식으로 tarball URL을 구성하는 것은 아닙니다. pnpm omits a tarball URL from pnpm-lock.yaml when it can rebuild the URL from the package's name, version, and registry. The lockfile then carries no host-specific URL for that package, and renaming or moving the registry does not churn the lockfile. Whether pnpm can rebuild a URL depends on the server, and serverType is where you declare it:

JFrog Artifactory 레지스트리의 경우, 이 설정에 따라 lockfile이 모든 스코프 패키지에 대해 호스트별 tarball URL을 기록하거나 하나도 기록하지 않게 됩니다:

registries:
  https://acme.jfrog.example.com/artifactory/api/npm/npm-virtual/:
    serverType: artifactory
    scopes: ["@acme"]

일반적인 서버별 값:

레이아웃은 추론되지 않고 반드시 선언해야 합니다. 가상 저장소는 각 패키지가 업스트림에서 동기화되었는지 로컬에서 게시되었는지에 따라 두 레이아웃을 동시에 제공할 수 있으므로, pnpm이 감지할 수 있는 레지스트리 수준의 신호가 없기 때문입니다. 또한 명시적으로 선언하면 잘못된 값이 조용한 오작동이 아니라 수정 가능한 설정 오류로 남습니다.

supportsTimeField#

이 레지스트리의 축약 메타데이터에 time 필드가 포함되는지 여부입니다. registry.npmjs.org의 축약 메타데이터에는 이 필드가 없습니다. 그래서 기본값이 false이며, minimumReleaseAge와 같은 시간 기반 해석 기능은 훨씬 큰 전체 메타데이터 문서를 대신 사용합니다. A registry that does carry it (Verdaccio v5.15.1+ and several proxies) is worth declaring:

registries:
  https://verdaccio.corp.example.com/:
    scopes: ["@"]
    supportsTimeField: true

이는 registrySupportsTimeField 설정의 레지스트리별 형태입니다. 대체 동작은 레지스트리별로 결정됩니다. 전체 메타데이터가 필요한 레지스트리가 하나 있더라도 다른 레지스트리에서는 더 이상 그 비용이 들지 않으며, 프로젝트가 설명하지 않은 모든 레지스트리에는 여전히 registrySupportsTimeField가 적용됩니다.

설정을 둘 수 있는 위치#

lockfile이 이 설정에 의존하므로 이 설정은 .npmrc나 전역 설정이 아닌 pnpm-workspace.yaml에 두어야 합니다. 한 개발자가 생략한 tarball URL을 다른 개발자가 다르게 재구성하면 frozen 설치가 실패하기 때문입니다.

The global configuration file (config.yaml) may declare the routes (scopes and prefix) so that a scope or an alias like work: applies to every project on the machine. 위와 같은 이유로 서버 설명(serverType 및 supportsTimeField)은 pnpm-workspace.yaml에서만 읽습니다.

An entry that declares no routes describes a registry configured elsewhere. For example, the default registry set in .npmrc. 이러한 항목은 해당 URL이 프로젝트가 실제로 해석에 사용하는 레지스트리일 때만 적용됩니다. 설정된 어떤 레지스트리와도 일치하지 않는 항목은 아무 효과 없이 남아 있게 되므로 pnpm이 경고합니다(오래된 URL, 이동된 스코프).

이 설정의 URL 키에서는 환경 변수가 확장되지 않습니다. 이는 다른 pnpm-workspace.yaml의 레지스트리 URL에서 확장되지 않는 것과 같은 이유입니다. 이 파일은 커밋되며, 환경 변수를 요청 대상으로 확장하면 공격자가 제어하는 호스트로 비밀 정보가 유출될 수 있습니다. ${...} 자리 표시자가 포함된 키는 무시됩니다.

이전 형식#

v11.23.0 이전에는 registries가 스코프를 URL에 매핑했으며, default 키로 기본 레지스트리를 지정했습니다:

registries:
  default: https://registry.npmjs.org/
  "@acme": https://npm.corp.example.com/

이 형식은 여전히 허용되며 이전과 같이 동작합니다. 두 형식은 하나의 맵에서 혼용할 수 없습니다. An entry whose value is a string is a scope route, and a scope route keyed by a URL is an error.

namedRegistries 설정은 사용 중단되었으며 prefix로 대체되었습니다. 이 설정은 여전히 읽히지만 registries가 선언하지 않은 접두사에 대해서만 적용되며, 둘 다 접두사를 선언하면 pnpm이 경고합니다.