制品库管理-Npm

1. 概述

统一制品库（NPM）主要用来管理NPM包，项目所有者可创建NPM仓库，给项目成员分配权限，拥有权限的用户可以上传、查看包。

2. 前置条件

具有管理项目制品库的权限，例如项目所有者。各角色所拥有权限详情如下：

项目成员：查看NPM仓库列表、查看包列表、查看配置指引、查看权限列表
项目所有者：创建NPM仓库、查看NPM仓库、查看包列表、查看操作日志
项目所有者&&制品库权限角色为“项目管理员”：还可以分配用户权限、修改NPM仓库、删除/上传包
组织管理员：查看NPM仓库列表、查看包列表、查看权限列表、查看操作日志

3. 添加自定义nexus服务

创建NPM制品仓库时，可以使用默认的nexus服务，若不想使用Choerodon默认的nexus服务。也可以在该项目下添加nexus服务使用，添加服务要求版本在3.21.0及其以上

进入项目层菜单“基础>制品库管理”，点击自定义nexus服务，可看到当前项目下nexus服务列表
字段描述
- 服务名称：该服务的名称
- 服务地址：nexus服务的访问地址。如：http://192.168.179.2:8081
- 管理用户：管理员用户（admin）
- 用户密码：管理用户的密码
- 是否启用匿名访问控制：是/否，若开启访问控制，则在创建NPM库时，可以做是否可匿名的配置。当选择【是】时，需要参照【匿名访问控制说明】在nexus服务上做相应的配置。当选择【否】时，不需要额外配置
- 匿名用户：开启匿名访问控制时，需要配置
- 匿名用户对应角色：开启匿名访问控制时，需要配置

4. 创建NPM仓库

进入项目层菜单“基础>制品库管理”，点击创建制品库
选择制品库类型为“NPM”，选择“创建仓库”
字段描述
- 仓库类型：本地仓库（hosted）、代理仓库（proxy）、仓库组（group）
- 仓库名称：仓库的唯一标识
- 版本策略：允许覆盖、禁止覆盖、只读。（向nexus服务发布NPM包时，使用的策略）
- 是否允许匿名访问：当启用的nexus服务(可在自定义nexus服务查看当前使用的nexus服务)，开启了【匿名访问控制】时。可做该配置
创建后，会在nexus服务生成相应账号，并赋予当前用户该仓库的访问权限。登录名为Choerodon登录名，生成默认随机密码（个人信息>个人设置>制品库设置TAB可查看）

5. 关联NPM仓库

功能描述：当nexus服务上已经创建了仓库，若想要将让仓库在Choerodon上管理，则可以使用关联仓库功能
字段描述
- 仓库列表：需要纳入在该项目下管理的仓库
- 管理员用户：管理员用户名
- 密码：管理员用户的密码

6. 修改NPM仓库

在制品库列表，选择操作修改配置
本地仓库（hosted）修改字段
- 仓库策略
- 匿名访问控制

代理仓库（proxy）修改字段
- 代理仓库地址
- 代理仓库用户名/密码
- 匿名访问控制

仓库组（group）修改字段
- 仓库组成员
- 匿名访问控制

7. 仓库失效/启用

在制品库列表，选择操作失效/启用仓库
- 失效：分配的用户权限会失效掉。同时将禁止更新、分配用户权限等操作
- 启用：将该仓库先前分配的用户权限重新赋予、同时将禁用的操作限制放开

8. 包管理

在制品库列表，点击进入详情页，选择包列表tab页
包管理提供：包列表查询、包列表删除、如何引用该NPM包的配置指引、如何向该仓库发布NPM包的配置指引等功能

9. 权限管理

在制品库列表，点击进入详情页，选择用户权限tab页
包管理提供功能
- 分配权限：点击添加成员，可以进行权限分配，选择用户信息、权限角色、过期时间即可。
- 更新权限：可修改权限信息
- 删除权限：可删除分配权限。制品库创建者的权限信息不可更改也不可删除
分配权限时，可分配以下角色权限
- 仓库管理员：push包、pull包、删除包、修改仓库配置(且用户同时是项目所有者)、管理用户权限(且用户同时是项目所有者)、查看日志
- 开发人员：push包、pull包、删除包
- 访客：pull包

10. 操作日志

在制品库列表，点击进入详情页，选择操作日志tab页
操作日志记录该仓库权限分配更新的操作日志