• 制品库管理-Npm

    1. 概述

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

    2. 前置条件

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

    3. 添加自定义nexus服务

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

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

    image

    4. 创建NPM仓库

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

    image

    5. 关联NPM仓库

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

    image

    6. 修改NPM仓库

    1. 在制品库列表,选择操作修改配置
    2. 本地仓库(hosted)修改字段
      • 仓库策略
      • 匿名访问控制

    image

    1. 代理仓库(proxy)修改字段
      • 代理仓库地址
      • 代理仓库用户名/密码
      • 匿名访问控制

    image

    1. 仓库组(group)修改字段
      • 仓库组成员
      • 匿名访问控制

    image

    7. 仓库失效/启用

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

    8. 删除仓库

    1. 在制品库列表,选择操作删除
    2. 只有仓库下没有包时,才可以删除仓库

    9. 包管理

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

    image

    10. 权限管理

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

    image

    11. 操作日志

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