Nexus安装和配置手册.doc

Nexus安装和配置手册修订记录：目录1. 简介11.1. 概述11.2. 适用范围与预期读者11.3. 参考资料21.4. 术语22. 安装22.1. 介质下载22.2. 软件安装52.3. 环境变量73. 运行83.1. 启动93.2. 停止104. 配置Nexus104.1. 创建RCMS仓库114.2. 配置Central仓库134.3. 修改public仓库组155. 用户管理165.1. 创建仓库权限165.2. 创建角色185.3. 创建用户226. 配置Maven256.1. 开发人员256.1.1. 配置settings.xml256.2. 版本发布人员266.2.1. 配置settings.xml266.3. 配置pom.xml267. 附录：部署第三方类库27图目录图 11 Nexus仓库1图 21 Nexus下载页面2图 22 Nexus介质下载页面3图 23 文件下载提示对话框3图 24 下载进度框4图 25 下载完成对话框4图 26 资源管理器5图 27 选择解压文件5图 28 解压对话框6图 29 解压后的资源管理器6图 210 重命名7图 211 NEXUS_HOME7图 31 Nexus运行文件8图 32 安装Nexus服务9图 33 Nexus主页面9图 41 Nexus登录页面10图 42 Nexus管理页面11图 43 Nexus仓库选择菜单11图 44 宿主仓库配置信息12图 45 创建过程12图 46 仓库列表12图 47 选择Central仓库13图 48 代理仓库配置信息13图 49 更改下载选项14图 410 设置代理14图 411 Public Repositories仓库组15图 412 添加仓库15图 51 Security 下拉菜单16图 52 权限列表17图 53 Target Privilege信息图17图 54 结果展示图17图 55 Security下拉菜单18图 56 角色列表19图 57 新建角色19图 58 角色信息19图 59 填写角色信息20图 510 权限对话框20图 511 搜索展示图21图 512 所需权限列表21图 513 创建角色22图 514 Security下拉菜单22图 515 用户信息23图 516 添加新用户23图 517 用户信息23图 518 填写用户信息24图 519 选择角色24图 520 授予用户权限25图 71 仓库列表27图 72 第三方类库27图 73 构件信息表28图 74 填写构件信息28图 75 选择上传构件29图 76 添加构件29图 77 上传构件30图 78 上传构件完成301. 简介1.1. 概述本文主要介绍Nexus的安装和配置。Nexus为Maven仓库管理器。Nexus提供了强大的仓库管理功能，构件搜索功能，它占用较少的内存，基于简单文件系统而非数据库。下图描述了项目组使用Nexus的结构。图 11 Nexus仓库图1中，Public为仓库组，包含了central、3rd party、rcms_release和rcms_snapshots。Central为代理仓库，通过代理访问中央仓库。3rd party为宿主仓库，用于存放第三方的构件；rcms_release和rcms_snapshots为宿主仓库，用于存放项目的构件。黄色的maven代表开发人员进行日常开发时，通过public下载开发过程中所需的构件，绿色的maven代表版本发布人员在版本发布时，直接将构件部署到项目仓库中。3rd party仓库的构件通过管理员在Nexus的控制台手工进行部署。1.2. 适用范围与预期读者适用于信息化项目研发人员参考使用。1.3. 参考资料1.4. 术语2. 安装2.1. 介质下载打开浏览器（本文以firefox为例），输入nexus的下载页面：/downloads页面显示如下：图 21 Nexus下载页面如上图示，单击DOWNLOAD NEXUS OSS，进入如下页面图 22 Nexus介质下载页面如上图示，单击NEXUS (ZIP)，浏览器将提示下载文件。图 23 文件下载提示对话框点击确定按钮，开始下载Nexus文件：图 24 下载进度框下载成功后，显示如下对话框图 25 下载完成对话框在下载完成对话框上，右键单击nexus-2.0.1-bundle.zip文件，选择打开所在文件夹菜单项，显示下图图 26 资源管理器2.2. 软件安装nexus是一种绿色软件，将下载的压缩文件解压到一个本地目录即完成安装。右键单击下载到的文件，如下图示图 27 选择解压文件选择解压文件菜单项，显示解压对话框图 28 解压对话框在解压对话框的目标路径中输入c:software，然后，单击确定按钮，完成解压。进入c:software目录，显示如下：图 29 解压后的资源管理器将nexus-2.0.1重命名为nexus201，如下图示：图 210 重命名2.3. 环境变量在系统中添加环境变量NEXUS_HOME，如下图示：图 211 NEXUS_HOME3. 运行Nexus安装目录下有nexus针对不同操作系统的运行脚本，对于Windows，运行脚本存放目录为%NEXUS_HOME%binjswwindows-x86-32，在该目录下，有以下文件： 图 31 Nexus运行文件这几个文件用途如下：nexus.bat：以独立进程启动Nexusinstall-nexus.bat：将Nexus安装成Windows服务start-nexus.bat：启动Nexus服务stop-nexus.bat：停止Nexus服务uninstall-nexus.bat：卸载Nexus Windows服务首先，右键单击install-nexus.bat，选择以管理员身份运行，如下图示图 32 安装Nexus服务将Nexus安装成Windows服务。3.1. 启动右键单击start-nexus.bat，选择以管理员身份运行，启动Nexus服务；也可以通过Windows服务管理器进行启动。Nexus启动后，在浏览器的地址栏输入http:/localhost:8081/nexus即显示Nexus主页面如下图 33 Nexus主页面3.2. 停止右键单击stop-nexus.bat，选择以管理员身份运行，执行完后，Nexus即停止了；也可以通过Windows服务管理器进行停止。4. 配置Nexus在Nexus主页面中，鼠标单击页面右上角的Log In图标，显示登录页面图 41 Nexus登录页面在Username右侧的输入框中输入admin在Password右侧的输入框中输入admin123然后，单击Log In按钮，进入Nexus管理页面。图 42 Nexus管理页面4.1. 创建RCMS仓库点击左侧导航栏中的Repositories链接，在右侧面板中选择“Add”，弹出下拉菜单，如下所示： 图 43 Nexus仓库选择菜单接着在下拉菜单中选择Host Repository，显示仓库的配置信息图 44 宿主仓库配置信息如上图示，在Repository ID以及Repository Name右侧的输入框输入rcms_release，其余保持默认值，点击“Save”按钮，显示如下：图 45 创建过程按照以上步骤，接着创建宿主仓库rcms_snapshots，创建完成后，点击刷新，显示最终的界面如下。图 46 仓库列表4.2. 配置Central仓库点击“Central”，如下图所示：图 47 选择Central仓库选择上图中“Configuration”，展开如下：图 48 代理仓库配置信息将“Download Remote Indexes”选项改为“True”，显示如下：图 49 更改下载选项展开上图中“Override HTTP Proxy Settings”选项，如下所示： 图 410 设置代理填写“Proxy Host”和“Proxy Port”，点击“Save”，完成代理设置。4.3. 修改public仓库组点击Public Repositories，显示如下： 图 411 Public Repositories仓库组选择上图中的“Configuration”，展开如下所示： 图 412 添加仓库 在仓库组中添加项目需要的仓库资源3rd party 为第三方类库Central为代理仓库rcms_realease以及rcms_snapshots为项目仓库5. 用户管理5.1. 创建仓库权限点击页面左侧导航栏中“Security”，弹出如下下拉菜单：图 51 Security 下拉菜单点击上图中的“Privileges”，显示下信息：图 52 权限列表点击上图中Add-Repository Target Privilege，弹出下图信息图 53 Target Privilege信息图分别填入Name，Description，选择所对应的仓库rcmc_release,以及Repository Target信息，如下图所示：图 54 结果展示图点击“Save”，完成了对应仓库rcms_release的权限创建，使用同样的办法完成对于rcms_snapshots的权限创建。5.2. 创建角色本节需要创建一个包含上节权限的角色。在左侧导航栏中选择“Security”，弹出下拉菜单，如下图所示：图 55 Security下拉菜单点击上图中的“Roles”，弹出信息如下图所示：图 56 角色列表选择Add-Nexus Role,如下图所示：图 57 新建角色弹出如下对话框：图 58 角色信息依次填入Role Id，Name信息，如下图所示：图 59 填写角色信息点击上图中“Add”，弹出如下对话框：图 510 权限对话框在Fliter中输入“rcms”搜素，我们需要的权限，展示如下图 511 搜索展示图选中需要添加的权限，如下图所示：图 512 所需权限列表点击“OK”，弹出如下界面：图 513 创建角色点击“OK”，完成角色和权限的绑定。5.3. 创建用户点击页面左侧导航栏中“Security”，弹出如下下拉菜单：图 514 Security下拉菜单点击上图中“Users”，弹出下图信息图 515 用户信息点击Add-Nexus User，如下图所示：图 516 添加新用户弹出对话框如下：图 517 用户信息填写用户、密码、邮箱等信息，如下图所示：图 518 填写用户信息点击上图“Add”按钮，为新建用户，授予角色，显示如下：图 519 选择角色点击“OK”，弹出如下信息图 520 授予用户权限点击“Save”，完成所有操作。6. 配置Maven本节主要介绍如何配置Maven，以便使用Nexus下载和部署构件。6.1. 开发人员打开maven的用户配置文件（.m2setting.xml）。6.1.1. 配置settings.xml在settings.xml文件中与之间，添加如下内容：nexusnexus34:8081/nexus/content/groups/public/*6.2. 版本发布人员版本发布人员除了需要进行开发人员的配置外，还需要进行以下配置：6.2.1. 配置settings.xml在setting.xml文件中与之间，添加如下用户认证信息：rcms_releasercms_snapshots其中，和要以实际的用户名和密码替换。6.3. 配置pom.xml打开项目中的pom.xml文件，在pom.xml文件中项目仓库： rcms_release rcms_release http:/localhost:8081/nexus/content/repositories/rcms_release/ rcms_snapshots rcms_snapshots http:/localhost:8081/nexus/content/repositories/rcms_snapshots/ 7. 附录：部署第三方类库在Nexus的管理页面中，点击左侧导航栏“Repositories”，显示如下：图 71 仓库