Neus仓库操作手册.docx

《Neus仓库操作手册.docx》由会员分享，可在线阅读，更多相关《Neus仓库操作手册.docx（14页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、Nexus 仓库操作手册名目1 NEXUS 仓库11.1安装Nexus .1.1.2仓库简介和配置.3.1.3建仓库.6.2 添加第三方 JAR 包和 MAVEN 插件文件82.1通过web 系统的治理界面添加.8.2.2拷贝文件的方式.9.2.3查看上传的文件121 Nexus 仓库1.1 安装 NexusNexus 供给了两种安装方式，第一种是内嵌 Jetty 的 bundle，解压到安装名目中就能直接运行；其次种方式是 WAR，将其公布到 web 容器中即可使用。Nexus 要求jdk 版本为 1.7(假设版本不对，请调整环境变量 JAVA_HOME 指向 jdk1.7 的名目)。本工程

2、选择的是第一种安装方式，下载完 nexus 之后，将压缩包解压到你想要安装的名目即可。解压完成后，会得到如下两个子名目(例如 Nexus 版本为 2.7.0)：l nexus-2.7.0-06/：该名目包含了 Nexus 运行所需要的文件，如启动脚本，依靠 jar 包等。l sonatype-work/：该名目包含了 Nexus 生成的配置文件，日志文件，仓库文件等。用户只需调用对应操作系统的脚本就可以启动Nexus，本文主要介绍主流的Windows 和 Linux 平台上的启动方式，具体信息如下： Windows 系统：1. 用户需要进入到 nexus-2.7.0-06/bin/jsw/名目

3、，依据操作系统类型选择文件夹，进入后双击里面的 console-nexus.bat 启动 Nexus 。要停顿效劳， 可以在命令行按：Ctrl+C 键。例如，Win7 64 位系统，选择 windows-x86-64中的 console-nexus.bat 启动 Nexus。2. 在 nexus-2.7.0-06/bin/jsw/windows-x86-64 中还有其他的一些脚本： install-nexus.bat：将 Nexus 安装成 Windows 效劳； uninstall-nexus.bat：卸载 Nexus Windows 效劳； start-nexus.bat：启动 Nexus

4、 Windows 效劳；第 10 页 stop-nexus.bat：停顿 Nexus Windows 效劳； Linux 系统：1. 用户需要进入到 nexus-2.7.0-06/bin/jsw/名目，依据操作系统类型选择文件夹，进入后然后运行如下命令：$ ./nexus console。假设需要停顿 Nexus，可 以 使 用 Ctrl+C 键 。 例 如 ： Ubuntu32 位 系 统 ， 只 需 进 入 到nexus-2.7.0-06/bin/jsw/linux-x86-32/，然后运行上面的命令即可。2. 除 console 之外，Nexus 的 Linux 脚本还供给如下的命令：

5、./nexus start：启动后台 Neuxs 效劳； ./nexus stop：停顿后台 Neuxs 效劳； ./nexus status：查看后台 Nexus 效劳的状态； ./nexus restart：重启动后台 Nexus 效劳；启动完毕后，可以访问 Nexus 系统，访问地址： :/localhost:8081/nexus/，默认用户名/密码：admin/admin123。关于 Bundle 安装的一个常见问题是端口冲突。Nexus Bundle 默认端口是 8081， 假设端口已被占用或期望使用其他端口开放 Nexus 效劳， 可以编辑文件nexus-2.7.0-06/conf

6、/nexus.properties，找到属性 application-port 将默认值 8081 改成其他端口号，然后保存该文件，重启 Nexus 即可。Nexus 仓库初始页面，如以以下图所示：1.2 仓库简介和配置1.2.1 NEXUS 名目构造Nexus 仓库初始页面如上图所示，主要信息如下：一、左侧包含多个菜单，主要使用有以下两个菜单：1、“Repositories”，点击后显示所包含的全部仓库信息；2、“Advanced Search”，点击后进入搜寻页面，可依据关键字搜寻jar等；二、点击“Repositories”后，显示全部的仓库信息，仓库类型包含：l Hosted：本地仓库

7、，可部署自己的构件到这类型的仓库。比方公司的其次方库；l Proxy：代理仓库，被用来代理远程的公共仓库，如 maven 中心仓库；l Group：仓库组，用来合并多个 hosted/proxy 仓库，当工程需要引用多个 repository 资源时，只需要将这些资源放到一个group 中，引用这一个 group 即可；三、Nexus 中自带的仓库：1) Maven central 是 Maven 的中心仓库；2) central 是一个代理仓库；3) Releases 是用来存放自己工程中公布的构建, 通常是 Release 版本的；4) Snapshots 是公布那些非 release 版

8、本, 非稳定版本；5) 3rd Party 是一个第三方库,可以添加自己的第三方库； 四、Maven 仓库组：仓库组,马上多个仓库划分组治理。当需要引用多个仓库时候，假设将这些仓库参与到一个仓库组中，那么在 setting.xml 中，只需要引用这个仓库组即可。Nexus 中预设了 2 个仓库组：public repositories 和 public snapshot repositories。仓库组默认包含本地仓库 Releases, snapshots, 3rd party和代理仓库 Maven Central。可在Configuration 配置页添加仓库到这个仓库组。1.2.2 在

9、MAVEN 中使用 NEXUS为了能让本机全部的 Maven 工程都 使用 Nexus 本地仓库，需要 对settings.xml 文件进展修改,但 setting.xml 并不支持直接配置 repositories 和pluginRepositories，因此需要使用 Maven 供给的 Profile 机制，将仓库配置放到 setting.xml 中的 Profile 中。代码清单如下:该配置中使用了一个 id 为 dev 的 profile，这个 profile 包含了相关的仓库配置，同时配置中又使用 activeProfile 元素将 dev 这个 profile 激活，这样当执行ma

10、ven 构建的时候，激活后的profile 会将仓库配置应用到工程中去。repositories 和 pluginRepositories 标签分别是仓库及插件仓库配置，它们的 id都为 nexus，url 指向仓库访问地址，如以以下图所示。配置仓库及插件仓库的目的是开启对快照版本下载的支持，当 maven 需要下载公布版或快照版构件的时候， 它会首先检查 nexus，看该类型的构件是否支持。Setting.mxl 配置参数中的仓库访问url1.2.3 在工程中使用 NEXUS 查找依靠包在工程中需要查找 nexus 仓库中的 jar 包，步骤如下： 登陆到 nexus 的 web 治理页面，

11、选择左侧的“Advanced Search”进入到搜寻页面，如以以下图： 在上图中的搜寻框中，输入 jar 包的名称，点击搜寻，会列出查询结果列表，选择某一个结果，则会在最下面显示它的具体信息，如以以下图： 选到自己所需的 jar 后，选择上图右下角区域的 tab 选项“Maven”按钮， 将 XML 对应的文本框内容复制粘贴到工程的 pom.xml 文件中标签中即可。如以以下图：1.2.4 部署编译完成的 JAR 到 NEXUS 仓库在使用maven 过程中，我们在开发阶段常常性的会有很多公共库处于不稳定状态， 随时需要修改并公布，这时可以利用 Nexus 对不同状态的版本进展治理。Nexu

12、s 仓库包含两种，snapshot 快照仓库和 release 公布仓库。snapshot 快照仓库用于保存开发过程中的不稳定版本，release 正式仓库则是用来保存稳定的发行版本。工程中使用 maven 过程中，maven2 会依据模块的版本号(pom 文件中的 version) 中是否带有-SNAPSHOT 来推断是快照版本还是正式版本。假设是快照版本，那么在 mvn deploy 时会自动公布到快照版本库中；假设是正式公布版本，那么在 mvn deploy 时会自动公布到正式版本库中。具体操作步骤如下：1. 在 maven 的 setting.xml 增加认证信息，认证信息包含：对应仓

13、库的 id，登录用户名/密码，如以以下图：2. 在工程的 pom.xml 增加认证信息，认证信息包含：对应仓库的 id，name,url， 注：server 的 id 要与 repository 的 id 保持全都。如以以下图：3. 修改好配置后，执行下 maven 的 deploy 即可把的 jar 部署到 Nexus 上。1.3 建仓库依据工程的需求，可自定义多个仓库。操作步骤如下：1) 点击“Repositories”进入仓库信息页面，显示全部的仓库信息，同时可对仓库进展增、删除、更索引、修改信息等操作。如以以下图：2) 点 击 “ + ” 号 按 钮 ， 选 择 仓 库 类 型 :gr

14、oup ， 增public-maven-plugin-repositories 仓库，填写配置参数，然后点击保存即可。具体配置信息如下：3) 点击“+”号按钮，选择仓库类型:hosted，增 maven-plugins 仓库，填写配置参数，然后点击保存即可。具体配置信息如下：2 添加第三方 jar 包和 Maven 插件文件添加第三方 jar 包和 maven 插件文件有两种方式： 1：通过 web 系统的治理界面添加；2：直接拷贝文件夹放到对应的 Nexus 仓库的文件中；2.1 通过 web 系统的治理界面添加通过 Nexus 系统界面，向 3rd Party 第三方仓库添加 jar 包，

15、具体步骤如下： 1、 编写 pom.xml 文件，需要填写 jar 的坐标信息，例如要上传 r-taglib.jar，pom 内容如下：2、 点击“Repositories”进入仓库信息显示页面，选中“3rd Party”，并在最下面的 Tab 框中选择“Artifact Upload”，显示页面如下：3、 在上图所示的页面中，需要进展以下操作：第一步，“GAV Defintion”下拉框选择：“From POM”；其次步，选择“Select POM to Upload”按钮，选择已填好的 pom 文件上传到本系统；第三步，点击“Select Atrifact(s) to Upload”按钮，

16、将所需要上传的 jar 包上传到本系统，当上传完毕后，会自动填充Filename,Classifiler,Extension 三个输入框；第四步， 点击“Add Atrifact”按钮，会生成信息填充到 Atrifact 文本框中， 如以以下图所示：第五步，点击“Upload Atrifact(s)”按钮，上传 jar 包到第三方库。2.2 拷贝文件的方式2.2.1 MAVEN 插件文件Nexus 中用来存放插件文件的仓库是maven_plugins 仓库，假设Nexus 安装路径为： D: SOFT/Nexus/,则 maven_plugins 仓库所在的文件路径：D:SOFT/Nexus/

17、sonatype-work/nexus/storage/maven-plugins由于每个 maven 插件都有唯一的坐标信息，因此插件文件需要严格依据自己的坐标信息来选择对应的文件名目存放。maven 插件的完整存放路径为：maven_plugins 仓库文件名目 / 插件坐标信息对应的文件名目。例如，上传 maven-scm-plugin 插件，具体的操作步骤如下：1. 查看 maven-scm-plugin 插件的坐标信息，翻开 maven-scm-plugin 文件夹并选择进入 1.7 文件夹(1.7 表示：该插件的1.7 版本，假设存在多个版本，任意选择一个翻开进入即可)，然后查看里

18、面的 maven-scm-plugin-1.7.pom 文件。该pom 文件中包含有插件的坐标信息，如 groupId，artifactId，version 等信息。查看插件坐标信息的操作如以以下图所示：2. 使用文本编辑器翻开 maven-scm-plugin-1.7.pom，找到/project/groupId 的属性值，该属性值信息与插件的存放名目相映射。例如：maven-scm-plugin 插件的 groupId 的属性值为：org.apache.maven.plugins，则对应的文件存放名目：org/apache/maven/plugins/，那么该插件的完整存放路径为：D:/S

19、OFT/Nexus/sonatype-work/nexus/storage/maven_plugins/org/apache/maven/plug ins/pom.xml 中的信息如以下图：3. 依据第 2 步操作得到的插件文件存放路径，进入并翻开该路径下的最终一层文件夹。假设不存在该文件夹，则需要依据该路径的名目层级构造手动创立缺少的名目文件。该路径下的最终一层文件夹信息如以以下图所示：4. 将需要上传的插件：maven-scm-plugin 整个文件夹内容全部拷贝到第 3 步操作所翻开的文件夹中。假设插件文件已存在，则选择合并文件夹操作。插件文件上传完毕后，需要更 Nexus 的索引信息，

20、具体操作参考 2.2.3。2.2.2 JAR 文件nexus 仓库存放 jar 文件的路径，例如安装路径为 D:nexus-2.11.1-01-bundle/,则存放 jar 文件的路径如下：D:nexus-2.11.1-01-bundle/sonatype-work/nexus/storage/thirdparty/进入到以上的名目文件中后，将需要上传的 jar 文件拷贝进去即可。(留意：尽量不要将 plugins 文件复制进去)2.2.3 更索引将全部的 maven 插件文件和 jar 文件都复制完毕后，需要更仓库的索引信息。登陆 Nexus 仓库的 Web 系统，点击“Repositories”进入全部仓库信息，进展以下两部操作：1.选中“ 3rd party”，选择最下面的 Tab 选项框中的“ Browse Storge”点击“示：”按钮,选择“Browse Index”点击“”按钮，如图所2.选中“public-maven-plugin-repository”和“public-repository”仓库，分别右键点击“Repair Index”和“Update Index”，如以下图：2.3 查看上传的文件待第三方文件上传完毕后，可以到搜寻界面，搜寻刚上传的第三方文件，查看名称和版本是否正确，如以以下图所示：