nexus资源库使用手册

nexus 资源库使用手册资源库使用手册 作者 魏玮作者 魏玮 本文主要描述的是如何在使用 nexus 进行类库的管理 以及权限的管理 安装配置在 hudson 项目持续集成操作指南项目持续集成操作指南 中有详细描述 这里就不赘述了 已搭建好的仓库地址 http 192 168 22 253 nexus 类库查询类库查询 再浏览器地址栏输入 http 192 168 22 253 nexus 直接看到的就是类库搜索页面 支持 关键词搜索 任何人都可以通过界面查询 如果知道要查找的类库属于哪个仓库 Repository 可以点击页面左侧的 点击 Repositories 会显示所有可用的仓库 选择某 1 个仓库进行搜索 浏览 每个仓库有多个个选项卡 Browse Storage 浏览 搜索 Browse Index 浏览索引 一般不用管 Configuration 对于仓库的基本配置 这里只能修改 name 仓库权限 release 发布版本 snapshot 快照版本 基本不改 其它选项会在添加仓库的步骤中讲到 Mirrors 镜像服务器 用于该仓库正常访问时备份服务器 一般不用管 Summery 该资源仓库的摘要 一般不用管 Artifact Upload 将类库上传到仓库中 重要 将类库上传到仓库中 重要 类库上传步骤说明类库上传步骤说明 首先需要选择上传的类库的定义方式 有 2 种一般选择 From POM GAV Parameters 一般情况用 GAV Parameters 上传时填写参数表单 如果自定义了 POM 文件可以用第一种 这里着重说 GAV Parameters 方式 选择 GAV Parameters 1Group 组 id 就是要填写这个类库的 groupid 该 groupid 自动生成的该类库的 pom 文 件中 同时也会作为存储这个类库的第 1 级目录名称 1 一般情况直接使用 jar 的名称即可 不包含版本号 例 例 asm jar 那么 groupid 填写 asm 即可 1 但是有一些类库是由一组相关的 jar 功能组成的 例 例 commons io jar commons lang jar commons logging jar 都是apache common组件 因此他们的group需要定义成一致的 比如group都填写成 commons Ps 不要使用汉语拼音不要使用汉语拼音 2Artifact 上传的类库的标识 一般也直接使用jar文件的名称即可 不包含版本号 例 ojdbc14 jar 其Artifact 就填写 ojdbc14 即可 3Version 类库版本 需要填写这个类库的准确版本 4Packaging 选择上传的文件类型 照实选择即可 多为 jar 填写完后 就是选择要上传的文件 没啥可说 每选择一个文件后 点击 就会把文件插入带上传列表中 可以添加多个文件统 一上传 不过考虑到性能消耗 不要一次添加过多文件 一般不要超过 20 个 添加完毕后 点击页面下方的 的上传按钮即可 类库管理规范类库管理规范 1为了统一标准 最大限度避免重复上传 第为了统一标准 最大限度避免重复上传 第 3 方类库 公共类裤脚 上传权限统一控方类库 公共类裤脚 上传权限统一控 制 制 nexus 原则上由测试部负责控制原则上由测试部负责控制 admin 权限 权限 deploy 权限权限 2在确定当前所需要的类库在资源仓库中不存在 或者版本缺少的情况下 务必确认务必确认 可以提供一份类库清单以及类库文件 发给测试部的接口人 由测试部进行备案 并 进行上传工作 需要发布者权限 delopment 在上传前需要再次确认仓库中并没有存在在上传前需要再次确认仓库中并没有存在 相同的类库 测试部负责 相同的类库 测试部负责 类库清单文件格式 类库清单文件格式 commons commons io 1 2 commons commons util final concurrent concurrent 1 3 4 其中groupId artifactId version 就分别对应了上传时要填写 Group Artifact Version 该文件的格式与 maven 的依赖关系一致 在整理依赖关系时 就可以直接得出这个清单 不会造成重复劳动 重要事项 重要事项 对于仓库中不存在的类库 可以按照我们的规则自行指定 如果仓库中已存在该类库其他版本 则需要上传的类库的 groupId artifactId 必须与已 上传的资源保持一致 如果要上传类库在仓库中并不存在 但是属于 1 个组件的一部分 并且其他组成部分已经上传 到仓库中 那么上传时 需要保持与仓库中已上传的其他部分保持相同的 groupid 总结 除非太离谱的情况 否则务必要保证与已存在的资源保持一致性 哪怕错大家也要总结 除非太离谱的情况 否则务必要保证与已存在的资源保持一致性 哪怕错大家也要 一起错 对于依赖资源 保持一致性非常重要 出了问题也方便统一处理 一起错 对于依赖资源 保持一致性非常重要 出了问题也方便统一处理 对上传类库与已存在的资源一致性检查也需要测试部负责测试部负责 3类库所有查询 下载权限公开 可以匿名访问 4每个部门都有自己的内部项目 这些内部项目也可以通过 nexus 进行版本仓库管理 因此如果部门有需求 可以申请开通部门内部项目的仓库 一般包括发布版本 Release 与 快照版本 Snapshot 2 种版本的仓库 快照版本 发布版本的定义与应用请参看快照版本 发布版本的定义与应用请参看 hudson 项目持续集成操作指南项目持续集成操作指南 a 这个管理权限可以放开给各部门 每个部门开通单个账号 b 建立仓库 开通权限的工作需要由测试部统一控制 备案 c 类库管理方式与第 3 方类库保持一致 建立仓库 开通权限的步骤在下面详细说 明 添加新的仓库添加新的仓库 如何添加发布版本 快照版本的仓库呢 首先必须用仓库管理员的身份登录 这时点击右侧时 除了显示仓库列表外 还会出现操作选项 点击 Add 即可进入添加仓库的界面 一般选择第 1 个 Hosted Repository 然后填上写仓库的详细信息 Repository ID 仓库 ID 发布版本的仓库 部门标示 release 快照版本版本的仓库 部门标示 snapshot Repository Name 仓库名称 照实填写即可 与 ID 一样也可以 Provider Maven2 即可 暂时不会升级 Repository Policy 如果是发布版本就选 Release 如果是快照版本就选 Snapshot 192 168 22 253 上的目录地址 Override Local Storage Location E nexus work storage 与 Repository ID 相同的目录 会自 动创建目录 添加后的仓库会在 Repository 列表中显示出来 可以删除 或上传类库 仓库中维护类库 的流程与前面说的一致 我们创建 mmt release mmt snapshot2 个仓库 为了后面设置权限 以及方便管理 我们 还需要创建一个仓库组包含着 2 个仓库 还是 Add 这次选择 Repository Group Group ID 仓库组 ID 使用部门标示 repository Group Name 仓库组如实填写 与仓库组 ID 保持一致也可 Provider maven2 即可 Pulish URL True 最后重要的是要把组包含的仓库加入到列表中 我们选择 mmt release mmt snapshot 添加 到组中 管理权限管理权限 创建各部门内部仓库管理员账号 仓库管理员身份登录 点开左侧 Security 添加该部门仓库管理员的权限组添加该部门仓库管理员的权限组 该管理员权限限制只能管理本部门的仓库 例 我们建立了 mmt release mmt snapshot 的仓库 那么 mmt 开发部的仓库管理员只能有权限维护管理 mmt release mmt snapshot 这 2 个仓库 点击 Privilages 出现添加权限页面 点击 Add Name 权限组名称使用 仓库 id privilege 例 刚才我们创建了 mmt release mmt snapshot 因此分别添加这 2 个仓库的权限 Description 权限描述 如是填写即可 中文支持不太好 最好用英文 Repository 要创建权限的仓库 新建的仓库只需要创建 1 次 Repository Target 一般选择 Maven2 即可 点击 save 后会执行创建 创建完成后在权限列表中可以看到 PS 列表是按照字母顺序排序的 添加仓库管理员角色添加仓库管理员角色 点击 Roles 出现角色管理页面 点击 Add 选择 Nexus Role Role Id 角色 ID 命名为 部门标示 deployment Role Name 与 Role Id 保持一致即可 Description 如实填写即可 中文支持不太好 最好用英文 选择权限 这里需要添加的权限包括 Artifact Upload Search Repositries mmt release 的 read view create update delete mmt snapshot 的 read view create update delete PS 左侧权限列表其实很长选中列表可以通过滚轮滚动 添加管理员用户账号添加管理员用户账号 点击 User 添加用户即可 点击 Add 添加新用户 选择 Nexus User 即可 User ID 用户名推荐 部门标示 deployment Name 相当于姓名 中文支持不太好 最好用英文 Email 该管理员邮箱 Status 选