npm-access(1) —— 在发布的包上设置访问级别

基于 npm-access(1) 官方文档翻译版本

译者注:访问级别指的是包的读写权限,只读 或者 读写,对应为 read-only | read-write

SYNOPSIS 概要

npm access public [<package>]
npm access restricted [<package>]

npm access grant <read-only|read-write> <scope:team> [<package>]
npm access revoke <scope:team> [<package>]

npm access ls-packages [<user>|<scope>|<scope:team>]
npm access ls-collaborators [<package> [<user>]]
npm access edit [<package>]

DESCRIPTION 描述

用于设置私有包的访问控制

对于所有的子命令,如果没有带包名,那么 npm acccess 的操作将在当前工作目录的包中执行。

  • public / restricted: 设置一个包是公开访问的还是受限的。
  • grant / revoke: 添加或删除用户和团队对于包的读写权限。
  • ls-packages: 显示用户或组能够访问的所有包以及其访问级别,除了只读公共包(它不会打印整个注册列表)。
  • ls-collaborators: 显示包的所有访问权限。这将显示你至少有只读权限的包。如果 <user> 这个参数传入,那这个列表将过滤只属于该用户、组的包。
  • edit: 使用 $EDITOR 为一个包设置访问权限。

DETAILS 详解

npm access 总是直接作用于当前注册表,在命令行使用 --registry=<registry url> 进行配置。

无作用域包始终是公开的。 (译者注:作用域包和非作用域包说明请参考 npm-scope(7))

作用域包默认是受限制的,但是你也可以使用 npm publish --access=public 命令来发布它们,或者在它们被初次发布后使用 npm access public 命令来将其的访问权限设置为公开。 (译者注:例如 @angular/core 这个包就是作用域包设置为公开)

你必须有设置包的访问权限:

  • 你是无作用域或作用域包的所有者。
  • 你是拥有作用域的团队成员。
  • 你已获得包的读写权限,无论是作为一个团队的一员,或是其所有者。

如果你的帐户没有支付(译者注:private modules 付费用户),除非你使用 --access=public 命令,否则在你尝试发布作用域包时 将会失败,并带有 HTTP 402 状态码(逻辑上允许的情况下)。

团队和团队成员的管理是通过 npm team 命令完成的。

SEE ALSO 亦可参阅

results matching ""

    No results matching ""