上海做外贸网站的公司,南宁市西乡塘区建设局网站,设迹官网,免费的网络推广软件下载文章目录Nexus是什么Nexus下载和安装1. 进入 Nexus 2.x 下载页面#xff0c;根据本机操作系统#xff0c;选择对应的版本进行下载#xff0c;如下图所示。2. 将下载 Nexus 安装包解压到本地磁盘#xff0c;可获得 nexus-2.14.20-02 和 sonatype-work 2 个目录#xff0c;如…
文章目录Nexus是什么Nexus下载和安装1. 进入 Nexus 2.x 下载页面根据本机操作系统选择对应的版本进行下载如下图所示。2. 将下载 Nexus 安装包解压到本地磁盘可获得 nexus-2.14.20-02 和 sonatype-work 2 个目录如下图。3. nexus-2.14.20-02 中包含以下目录及文件。4. .进入 \nexus-2.14.20-02\bin\jsw 文件夹根须操作系统版本选择合适的目录由于我的操作系统是 Windows 10 64 位所以我选择 windows-x86-64 目录如下图所示。5. 进入 windows-x86-64 目录后可以看到如下文件。6. 双击运行 install-nexus.bat 安装 Nexus 服务然后运行 start-nexus.bat 启动服务。7. 访问 http://localhost:8081/nexus结果如下图则表示服务启动成功否则表示服务启动失败。8. 点击首页右上角的“Log In”按钮在登录页面输入用户名和密码默认分别为admin 和 admin123 )最后点击“Log In”按钮登录。9. 登录成功后结果如下图。Nexus仓库属性和分类Nexus 仓库属性Nexus 仓库分类Nexus创建仓库1. 点击左边导航栏中的 Repositories如下图。2. 点击 Nexus 仓库列表上方的 Add... 按钮在下拉菜单中选择 Hosted Repository如下图。3. 在宿主仓库配置界面填写对应信息然后点击 Save 按钮进行保存如下图。4. 查看 Nexus 仓库列表可以看到自定义的宿主仓库已经创建完成如下图。创建 Nexus 代理仓库创建 Nexus 仓库组Nexus索引与构件搜索索引下载索引构件搜索从Nexus下载构件在 pom.xml 中配置部署构件到Nexus使用 Maven 部署构件到 Nexus1. 配置项目的 POM 文件2. 在 setting.xml 中配置认证信息3. 使用 mvn 命令部署构件1打开命令行窗口跳转到 test-upload-snapshot 项目得目录下执行如下 Maven 命令。2) Maven 命令执行结果如下图。手动上传构件1. 打开命令行窗口跳转到 App-Core-lib 的目录下执行如下 mvn 命令对项目进行打包。2.打包完成后进入 App-Core-lib\target 目录可以看到 Maven 已经将该项目打包成了一个 jar 文件如图 2 所示。3. 在 Nexus 界面的仓库列表中选择 3rd party 仓库在下方选择 Artifact Upload 选项卡其中 GAV Definition 用于定义上传构件的坐标信息。4. 在仓库列表中选中 3rd party 宿主仓库在下方的 Browse Index 选项卡中可以看到构件已经被部署到该仓库中如图 5 所示。Nexus3的使用下载 Nexus 31. 进入 Nexus 3.x 下载页面目前最新版是 3.30.0-01根据操作选择相应的版本进行下载。2. 将下载的安装包解压到本地可获得 nexus-3.30.0-01 和 sonatype-work 两个目录如图 2。启动 nexus 服务访问 nexus 3.xNexus离线更新中央仓库索引文件下载1. 浏览器访问 https://repo.maven.apache.org/maven2/.index/ 下载 nexus-maven-repository-index.gz 和 nexus-maven-repository-index.properties 两个文件一般位于列表的末尾如图 1 所示。2. 浏览器访问 http://mvnrepository.com/搜索 Indexer CLI选择 Maven :: Indexer CLI如图 2 所示。3. 建议选择 5.1.1 版本如图 3 所示。4. 在 Indexer CLI » 5.1.1 版本详情页点击 View All查看该版本包含的所有文件。5. 在文件列表中点击 indexer-cli-5.1.1.jar 下载该文件如图 5 所示。解压1. 将 nexus-maven-repository-index.gz 、nexus-maven-repository-index.properties 以及 indexer-cli-5.1.1.jar 三个文件都存放到 index目录的名称及位置均为自定义没有特殊规定目录下如图 6 所示。2. 打开命令行窗口跳转到 index 目录执行以下命令解压索引文件。3. 解压完成后在 index 中会生成一个名为 indexer 的目录该目录中存放的就是中央仓库离线索引文件如图 8 所示。更新并验证索引1. 将所有索引文件不包含目录全部拷贝到“Nexus\sonatype-work\nexus\indexer\central-ctx”目录中如图 9 所示。2. 重启 Nexus在仓库列表中选中 Central 代理仓库然后点击 Browse Index 选项卡结果如图 10 所示。3. 点击 browse Remote 选项卡结果如图 11 所示。4. 对比 Browse Index 和 Browse Remote 中的索引若两者完全一致则表示离线索引更新成功。Nexus是什么
Nexus 读音/ˈneksəs/是 Sonatype 公司发布的一款仓库Repository管理软件常用来搭建 Maven 私服所以也有人将 Nexus 称为“Maven仓库管理器”。 Maven 私服其实并不是 Maven 的核心概念它仅仅是一种衍生出来的特殊的仓库但这并不代表它不重要相反由于私服具有降低中央仓库负荷、节省外网带宽、以及提高项目稳定性等优点使得私服在实际开发过程中得到了相当普遍地使用。
能够帮助我们建立私服的软件被称为 Maven 仓库管理器主要有以下 3 种
Apache ArchivaJFrog ArtifactorySonatype Nexus
其中Sonatype Nexus 是当前最流行使用最广泛的 Maven 仓库管理器。Nexus 分为开源版和专业版其中开源版足以满足大部分 Maven 用户的需求。
Nexus 开源版具有以下特性
占用内存小28 M 左右具有基于 ExtJs 得操作界面用户体验较好使用基于 Restlet 的完全 REST API支持代理仓库、宿主仓库和仓库组基于文件系统不需要依赖数据库支持仓库索引以及搜索支持在界面上上传构件安全控制
Nexus 专业版需要付费购买它主要包含一些企业级的高级特性详情请参考 Sonatype Nexus 官方文档。
Nexus下载和安装
目前 Nexus 分为 Nexus 2.x 和 Nexus 3.x 两个大版本它们是并行的关系目前使用最多运行最稳定的是 Nexus 2.x下面我们以 Nexus 2.x 为例演示 Nexus 的安装过程。
1. 进入 Nexus 2.x 下载页面根据本机操作系统选择对应的版本进行下载如下图所示。 图1Nexus 2.x 下载页面
2. 将下载 Nexus 安装包解压到本地磁盘可获得 nexus-2.14.20-02 和 sonatype-work 2 个目录如下图。 图2Nexus 2.x 目录 其中
nexus-2.14.20-02该目录中包含了 Nexus 2.x 运行所需要的文件如启动脚本、依赖 jar 包等。sonatype-work该目录中包含了 Nexus 2.x 生成的配置文件、日志文件等。
3. nexus-2.14.20-02 中包含以下目录及文件。 图3nexus-2.14.20-02 目录及文件列表 nexus-2.14.20-02 目录说明如下表所示。
子目录说明bin命令中心启动命令关闭命令conf配置中心管理着仓库列表、日志配置以及安全设置libNexus 的库文件Nexus 运行时需要的 jar 包所在的目录logs存放日志文件nexusNexus 应用程序tmp存放Nexus 运行时产生的临时文件
4. .进入 \nexus-2.14.20-02\bin\jsw 文件夹根须操作系统版本选择合适的目录由于我的操作系统是 Windows 10 64 位所以我选择 windows-x86-64 目录如下图所示。 图4nexus-2.14.20-02\bin\jsw 目录列表
5. 进入 windows-x86-64 目录后可以看到如下文件。 图5Nexus 启动文件列表
其中
console-nexus.bat启动 Nexus 并在 DOS 命令行中展示启动过程。install-nexus.bat将 Nexus 安装为 Windows 服务开机自动启动。start-nexus.bat启动 Nexus。stops-nexus.bat停止 Nexus。uninstall-nexus.bat与 install-nexus.bat 相对应负责卸载 Nexus 服务。
6. 双击运行 install-nexus.bat 安装 Nexus 服务然后运行 start-nexus.bat 启动服务。
注意
运行 install-nexus.bat 安装服务若提示”wrapper | OpenSCManager failed - 拒绝访问。 (0x5)“只要关闭窗口以管理员身份运行即可解决。运行 start-nexus.bat 启动服务若提示”wrapper | OpenSCManager failed - 拒绝访问。 (0x5)“只要关闭窗口以管理员身份运行即可解决。
7. 访问 http://localhost:8081/nexus结果如下图则表示服务启动成功否则表示服务启动失败。 图6Nexus 首页
8. 点击首页右上角的“Log In”按钮在登录页面输入用户名和密码默认分别为admin 和 admin123 )最后点击“Log In”按钮登录。 图7Nexus 登录界面
9. 登录成功后结果如下图。 图8Nexus 登录成功
Nexus仓库属性和分类
Nexus 作为一款 Maven 仓库管理器仓库Repository自然是 Nexus 最核心的概念。Nexus 中提供了许多仓库概念如代理仓库、宿主仓库以及仓库组等。Nexus 为每一种仓库都提供了丰富的配置参数方便我们根据自身需要进行定制。
Nexus 仓库属性
点击左边导航栏中的 Repositories可以看到 Nexus 自带的几个内置仓库如下图所示。 图1Nexus 内置仓库列表猛击图片可以查看原图
在仓库列表中每个仓库都具有一系列属性
Type仓库的类型Nexus 中有 4 中仓库类型group仓库组、hosted宿主仓库、proxy代理仓库以及 virtual虚拟仓库。Format仓库的格式。Policy仓库的策略表示该仓库是发布Release版本仓库还是快照Snapshot版本仓库。Repository Status仓库的状态。Repository Path仓库的路径。
由图 1 可知Nexus 2.x 默认创建了 6 个仓库我们称它们为 Nexus 内置仓库。
Maven Central该仓库用来代理 Maven 中央仓库其策略为 Release只会下载和缓存中央仓库中的发布版本的构件。Releases策略为 Release 的宿主仓库用来部署公司或组织内部的发布版本构件。Snapshots策略为 Snapshot 的宿主仓库用来部署公司或组织内部的快照版本构件。3rd party策略为 Release 的宿主仓库用来部署第三方发布版本构件这些构件一般无法从任何远程仓库中获得。Public Repositories该仓库组将上述所有存储策略为 Release 的仓库聚合并通过统一的地址提供服务。
Nexus 仓库分类
Nexus 仓库按照类型Type区分主要分为以下 3 个类型
代理仓库proxy用来代理远程公共仓库如 Maven 中央仓库、JBoss 远程仓库。宿主仓库hosted又称 Nexus 本地仓库该仓库通常用来部署本地项目所产生的构件。仓库组group用来聚合代理仓库和宿主仓库为这些仓库提供统一的服务地址以便 Maven 可以更加方便地获得这些仓库中的构件。
为了更加直观的理解仓库组、代理仓库和宿主仓库的概念我们通过下图展示它们的用途和区别。 图2 Nexus仓库分类
由上图可知
Maven 可以直接从宿主仓库中下载构件。Maven 也可以从代理仓库中下载构件代理仓库会从远程仓库下载并缓存构件。Maven 还可以从仓库组中下载构件仓库组会从其包含的宿主仓库和代理仓库中获取构件。
Nexus创建仓库
首先我们需要创建两个宿主仓库分别用来存储从本地上传到 Nexus 的 Snapshot 和 Release 版本的构件操作步骤如下。
1. 点击左边导航栏中的 Repositories如下图。 图1Nexus 导航
2. 点击 Nexus 仓库列表上方的 Add… 按钮在下拉菜单中选择 Hosted Repository如下图。 图2添加宿主仓库
3. 在宿主仓库配置界面填写对应信息然后点击 Save 按钮进行保存如下图。 图3配置宿主仓库
宿主仓库配置如下
配置说明Repository ID仓库 ID。Repository Name仓库名称。Repository Type仓库的类型如 hosted、proxy 等等。Provider用来确定仓库的格式一般默认选择 Maven2。Repository Policy仓库的策略。Default Local Storage Location仓库默认存储目录例如 D:\nexus-2.14.20-02-bundle\sonatype-work\nexus\indexer\bianchengbang_Snapshot_hosted_ctx。Override Local Storage Location自定义仓库存储目录。Deployment Policy仓库的部署策略。Allow File Browsing用来控制是否允许浏览仓库内容一般选择 true。Include in Search用来控制该仓库是否创建索引并提供搜索功能。Publish URL用来控制是否通过 URL 提供服务。Not Found Cache TTL缓存某构件不存在信息的时间默认取值为 1440表示若某一个构件在仓库中没有找到在 1440 分钟内再次接收到该构件的请求则直接返回不存在信息不会再次查找。
4. 查看 Nexus 仓库列表可以看到自定义的宿主仓库已经创建完成如下图。 图4Nexus 仓库列表猛击图片查看原图
重复以上步骤再创建一个名称为 bianchengbang_Release_hosted 策略为 hosted 的宿主仓库。 图5Nexus 仓库列表-宿主仓库猛击图片查看原图
创建 Nexus 代理仓库
下面我们创建一个代理仓库用来下载和缓存中央仓库的构件操作步骤如下。
点击 Nexus 仓库列表上方的 Add… 按钮在下拉菜单中选择 Proxy Repository如图 5 所示。 图5添加代理仓库
在代理仓库配置界面填写对应信息然后点击 Save 按钮进行保存如图 6 所示。 图6Nexus 代理仓库配置界面
代理仓库配置中仓库 ID、仓库名称、Provider、Policy 以及 Default Local Storage Location 等配置的含义与宿主仓库相同不再赘述。需要注意的是代理仓库的 Repository Type 的取值是 proxy。
代理仓库配置如下表。
配置说明Remote Storage Location远程仓库或中央仓库的地址它是 Nexus 代理仓库最重要得配置必须输入有效值通常取值为 https://repo1.maven.org/maven2/。Download Remote Indexes 是否下载远程仓库的索引。Auto Blocking Enabled是否启用自动阻止即当 Nexus 无法连接中央仓库或远程仓库时是否一直等待。取值为 true 表示不再等待直接通知客户端无法连接并返回。File Content Validation是否启用文件内容校验。Checksum Policy配置校验和出错时的策略用户可以选择忽略、警告、记录警告信息或拒绝下载等多种策略。Artifact Max Age 构件缓存的最长时间对于发布版本仓库来说默认值为 -1表示构件缓存后就一直保存着不再重新下载。对于快照版本仓库来说默认值为 1440 分钟表示每隔一天重新缓存一次代理的构件。Metadata Max Age仓库元数据缓存的最长时间。Item Max Age项目缓存的最长时间。
创建 Nexus 仓库组
下面我们将创建一个仓库组并将刚刚创建的 3 个仓库都聚合起来操作步骤如下。
点击仓库列表上方的 Add… 按钮在下拉菜单中选择 Repository Group如下图。 图7Nexus 添加仓库组
在仓库组配置界面填写对应信息并将 bianchengbang_central_proxy、bianchengbang_Release_hosted 和 bianchengbang_Snapshot_hosted 3 个仓库添加到仓库组中最后点击 Save 按钮进行保存如下图。 图8Nexus 仓库组配置
查看 Nexus 仓库列表可以看到 bianchengbang_repository_group 仓库组已经创建完成如下图。 图9Nexus 仓库列表-仓库组猛击图片查看原图
Nexus索引与构件搜索
我们知道Maven 中央仓库为用户提供了多达数十万构件而 Nexus 可以代理所有的远程仓库包括 Maven 中央仓库可见 Nexus 仓库中构件的数量相当庞大。用户想要在这么多构件中快速的查找自己所需的构件一个最直接有效的方式就是搜索。
Nexus 作为一款成熟的仓库管理工具它通过维护仓库的索引提供了构件搜索功能以便帮助用户方便快速地找到所需构件。
我们将详细为您介绍 Nexus 索引以及构件搜索功能。
索引
Nexus 能够遍历仓库的所有内容搜集它们的坐标校验和以及所包含的 Java 类等信息然后以索引 nexus-indexer 的形式保存起来。Nexus 索引保存在 Nexus 安装目录下 \sonatype-work\nexus\indexer 目录中该目录下每个子目录都代表 Nexus 中的一个仓库用来存放各个仓库的索引 如下图所示。 图1Nexus 索引目录
大多数的远程公共仓库例如中央仓库都维护了一个这样的索引因此本地的 Nexus 在下载到这个索引后就能在此基础上为用户提供构件搜索和浏览等服务。需要注意的是并不是所有的公共仓库都提供了索引 对于那些没有提供索引的仓库来说我们是无法对其进行搜索的。
下载索引
Nexus 索引下载功能默认是关闭的如果想在 Nexus 中搜索远程仓库中的构件就需要先开启索引下载功能。
以 bianchengbang_central_proxy 代理仓库代理 Maven 中央仓库为例在图 2 所示的位置就可以控制它的索引下载功能true 表示开启索引下载false 表示关闭索引下载。 图2远程索引下载
开启索引下载功能后点击导航栏中 Scheduled Tasks 链接查看调度任务列表。若 Nexus 正在下载索引我们就能看到如图 3 所示的任务其任务状态为 Running。在索引下载完毕后该任务就会消失。 图3Nexus 调度任务列表猛击图片查看原图 由于 Maven 中央仓库的内容较多其索引文件比较大因此 Nexus 下载该文件所需的时间较长需要我们耐心等待。 索引下载完成后点击仓库列表中的 bianchengbang_central_proxy 代理仓库然后在列表下方选择 Browse Index 选项卡我们可以看到该仓库内容的树形结构如图 4 所示。 图4Nexus 仓库索引树形结构图
构件搜索
Nexus 通过维护索引为用户提供了关键字搜索、类名搜索、坐标搜索等多种搜索功能通过这些功能页面中能够清晰地展示出结果构件的坐标以及所属仓库。用户可以直接下载相应的构件也可以直接复制构件的 XML 依赖声明到项目中使用。
在 Nexus 界面左边导航栏中有一个搜索框在搜索框内输入所需构件的关键字单击搜索按钮就能快速得到搜索结果如图 5 所示。 图5Nexus 搜索功能猛击图片查看原图
搜索结果页中的每一行代表一类构件其中包含了 Group、Artifact、版本、流行版本、以及下载链接等信息。点击其中某一行下方就会出现该构件的详细信息其中不但包含构件的坐标等基本信息还包含一段 XML 依赖声明我们可以将这段 XML 依赖声明直接复制到项目的 POM 中使用如图 6 所示。 图6Nexus 搜索结果详情
点击右侧的 Artifact 选项卡还能看到构件的大小、上传时间、最后修改时间、仓库中的相对位置、校验和等信息如图 7 所示。 图7Nexus 搜索详情页 Artifact
除了关键字搜索外Nexus 还提供了一些高级搜索功能例如类名搜索、GAV 搜索以及“校验和”搜索。我们可以通过点击搜索页左上角的下拉菜单选择高级搜索功能。 图8Nexus 高级搜索功能
Nexus 还具有以下高级搜索功能
类名搜索Keyword Search:搜索包含某个 Java 类的构件。GAV 搜索GAV Search:通过设置 Group、Artifact、版本等信息进行搜索。校验和搜索Checksum Search:通过使用“校验和”搜索构件。
这些搜索功能的使用都十分的简单我们可以根据自己的需求选择合适的搜索功能。
从Nexus下载构件
Nexus 作为最流行的 Maven 私服之一使用它主要目的之一代理远程仓库即当 Maven 需要下载构件到本地仓库使用时不再请求外部的远程仓库而直接从 Nexus 中下载。我们将介绍如何配置 Maven 从 Nexus 下载构件。
将 Nexus 的代理仓库配置到 Maven 项目中用它们代替外部的远程仓库即可实现 Maven 从 Nexus 下载构件。
在 pom.xml 中配置在 setting.xml 中配置
在 pom.xml 中配置
在 Maven 项目的 pom.xml 中增加以下配置可以为当前项目配置 Nexus 上的 bianchengbang_central_proxy 代理仓库。
!--声明一个或多个远程仓库 --
repositories!-- 声明一个 Nexus 私服上的仓库 --repository!--仓库id --idnexus/id!-- 仓库的名称 --namenexus/name!--仓库的地址 --urlhttp://localhost:8082/nexus/content/repositories/bianchengbang_central_proxy//url!-- 是否开启该仓库的 release 版本下载支持 --releasesenabledtrue/enabled/releases!-- 是否开启该仓库的 snapshot 版本下载支持 --snapshotsenabledtrue/enabled/snapshots/repository
/repositories
!-- 声明一个或多个远程插件仓库 --
pluginRepositories!--声明一个 Nexus 私服上的插件仓库 --pluginRepository!--插件仓库 id --idnexus/id!--插件仓库 名称 --namenexus/name!-- 配置的插件仓库的地址 --urlhttp://localhost:8082/nexus/content/repositories/bianchengbang_central_proxy//url!-- 是否开启该插件仓库的 release 版本下载支持 --releasesenabledtrue/enabled/releases!-- 是否开启该插件仓库的 snapshot 版本下载支持 --snapshotsenabledtrue/enabled/snapshots/pluginRepository
/pluginRepositories其中在 repositories 元素下可以使用 repository 子元素声明一个或多个远程仓库一个 repository 元素对应一个远程仓库。
repository 各个子元素含义如下表。
子元素含义id仓库的唯一标识。需要注意的是Maven 中央仓库的 id 为 central如果其他的仓库也使用该 id就会覆盖中央仓库的配置。name仓库的名称。url仓库的地址该地址一般都是基于 HTTP 协议的通过浏览器即可访问该地址浏览仓库中的构件。releases/snapshots用来控制 Maven 对于发布和快照版本构件的下载。它们都有一个 enabled 子元素enabled 的取值为 true表示开启发布版或快照版的下载支持否则表示关闭下载支持。
在 pluginRepositories 元素下可以使用 pluginRepository 子元素声明一个或多个远程插件仓库包括私服上的仓库一个 pluginRepository 元素对应一个远程插件仓库。pluginRepository 下所有子元素的含义均与与 repository 的子元素相同这里就不再做过多赘述了。 示例 1 将以上配置加入 Maven 项目 Root 的 POM 文件中并手动清空本地仓库的所有依赖构件目的是为了让 Maven 重新获取构件。
打开命令行窗口跳转到 Root 所在的目录下执行以下 mvn 命令。
mvn clean install执行结果如下。 图1 使用 Nexus 私服构建结果
由图 1 的构建过程可以看出Root 项目构建所需的构建是从 Nexus 私服的 banchengbang_central_proxy 代理仓库中下载的而不是从 Maven 中央仓库去下载。 在 setting 中配置 在 pom.xml 中配置 Nexus 只对当前项目有效在实际应用中我们往往希望能够通过一次配置就能让本机中的所有 Maven 项目都使用 Nexus。此时您可能会想到在 Maven 的 setting.xml 文件中进行配置但 setting.xml 是不支持直接配置 repositories 和 pluginRepositories 。所幸 Maven 提供了 profile 机制能够让我们将仓库配置放在 profile 中。
profilesprofileidnexus/id!--声明一个或多个远程仓库 --repositories!-- 声明一个 Nexus 私服上的仓库 --repository!--仓库id --idnexus/id!-- 仓库的名称 --namenexus/name!--仓库的地址 --urlhttp://localhost:8082/nexus/content/repositories/bianchengbang_central_proxy//url!-- 是否开启该仓库的 release 版本下载支持 --releasesenabledtrue/enabled/releases!-- 是否开启该仓库的 snapshot 版本下载支持 --snapshotsenabledtrue/enabled/snapshots/repository/repositories!-- 声明一个或多个远程插件仓库 --pluginRepositories!--声明一个 Nexus 私服上的插件仓库 --pluginRepository!--插件仓库 id --idnexus/id!--插件仓库 名称 --namenexus/name!-- 配置的插件仓库的地址 --urlhttp://localhost:8082/nexus/content/repositories/bianchengbang_central_proxy//url!-- 是否开启该插件仓库的 release 版本下载支持 --releasesenabledtrue/enabled/releases!-- 是否开启该插件仓库的 snapshot 版本下载支持 --snapshotsenabledtrue/enabled/snapshots/pluginRepository/pluginRepositories/profile
/profiles
activeProfilesactiveProfilenexus/activeProfile
/activeProfiles以上配置中使用了一个 id 为 nexus 的 profile这个 profile 中包含了与仓库相关的配置同时配置中还使用了一个 activeProfiles 元素将 id 为 nexus 的 profile 激活。当本机有 Maven 项目构建时profile 中的仓库配置就会应用到项目中。 示例 2 将以上配置分别添加到 Maven 安装目录\conf 和本地仓库目录下的 setting.xml 中并将 Root 项目 POM 文件中的 repositories 和 pluginRepositories 等仓库设置删除。
打开命令行窗口跳转到 Root 项目下执行以下 mvn 命令。 mvn clean install
执行结果如下。 图2Nexus 全局配置仓库 setting.xml 中添加镜像 Nexus 私服通常会与镜像mirror结合使用使 Nexus 成为所有远程仓库的私服这样不仅可以从 Nexus 中获取所有所需构件还能将配置集中到 Nexus 私服中简化 Maven 本身的配置。
我们可以创建一个匹配任何仓库的镜像镜像的地址为 Nexus 中仓库的地址这样 Maven 对于任何构件的下载请求都会被拦截跳转到 Nexus 私服中其具体配置如下。
mirrorsmirroridnexus/idnamenexus name/namemirrorOf*/mirrorOfurlhttp://localhost:8082/nexus/content/groups/bianchengbang_repository_group//url/mirror
/mirrors
profilesprofileidnexus/idrepositoriesrepositoryidcentral/idurlhttp://localhost:8082/nexus/content/repositories/bianchengbang_central_proxy//urlreleasesenabledtrue/enabled/releasessnapshotsenabledtrue/enabled/snapshots/repository/repositoriespluginRepositoriespluginRepositoryidcentral/idurlhttp://localhost:8082/nexus/content/repositories/bianchengbang_central_proxy//urlreleasesenabledtrue/enabled/releasessnapshotsenabledtrue/enabled/snapshots/pluginRepository/pluginRepositories/profile
/profiles
activeProfilesactiveProfilenexus/activeProfile
/activeProfiles仓库和插件仓库的配置中它们的 id 取值都是 central即它们的设置覆盖了 Maven 中央仓库但此时这里的 URL 已经无法起到任何作用因为镜像的匹配规则是 *所有的请求都已经被拦截跳转到 Nexus 私服的地址。
部署构件到Nexus
如果仅仅是为了代理远程的公共仓库那么 Nexus 的代理仓库就完全能够满足需要但是我们知道Nexus 除了代理仓库外还有另一种仓库宿主仓库。
宿主仓库的主要作用是存储公司或组织内部的构件以及一些无法从公共仓库获取的第三方构件JDBC 驱动供用户下载使用。用户可以通过配置 Maven 将构件自动部署到 Nexus 宿主仓库也可以在 Nexus 界面手动上传构件。
使用 Maven 部署构件到 Nexus
日常开发中快照版本构件可以直接部署到 Nexus 中策略为 Snapshot 的宿主仓库中而最终发布的版本则应该部署到 Nexus 中策略为 Release 的宿主仓库中。
使用 Maven 将构件部署到 Nexus 宿主仓库中主要分为 3 步
配置项目的 POM 文件。在 setting.xml 中配置认证信息。使用 mvn 命令部署构件。
下面我们通过一个实例来详细介绍如何使用 Maven 部署构件到 Nexus 宿主仓库。
1. 配置项目的 POM 文件
创建一个名为 test-upload-snapshot 的 Maven 项目并在其 POM 文件中添加如下配置。
project...distributionManagementrepositoryidbianchengbang_Release_hosted/idurlhttp://localhost:8082/nexus/content/repositories/bianchengbang_Release_hosted//url/repositorysnapshotRepositoryidbianchengbang_Snapshot_hosted/idurlhttp://localhost:8082/nexus/content/repositories/bianchengbang_Snapshot_hosted//url/snapshotRepository/distributionManagement
/project以上配置说明如下
distributionManagement 元素负责将指定的构件部署到 Nexus 指定的仓库中。repository 元素distributionManagement 的子元素用于定义部署 Release 版本的构件被部署的仓库。它有 2 子元素id 和 url 其中 id 为 Nexus 仓库的唯一标识url 为 Nexus 宿主仓库的 url。snapshotRepository 元素distributionManagement 的子元素用于定义部署 Snapshot 版本的构件被部署的仓库。它也有 2 子元素id 和 url 且与 repository 中含义一致。
2. 在 setting.xml 中配置认证信息
最初版本的 Nexus 没有为宿主仓库提供任何的安全措施。如果宿主仓库开启了部署功能任何人可以连接并部署构件至这个仓库这显然是极不安全的。因此现在的 Nexus 中增加了权限认证Nexus 对于匿名用户是只读的若想部署构件到 Nexus 中则需要在 setting.xml 中配置如下认证信息。
settings...serversserveridbianchengbang_Release_hosted/idusernameadmin/usernamepasswordadmin123/password/serverserveridbianchengbang_Snapshot_hosted/idusernameadmin/usernamepasswordadmin123/password/server/servers
/settings注意以上配置中server 元素中的 id 必须和 pom.xml 中 distributionManagement 元素对应仓库的 id 保持一致。Maven 在部署构件时会先根据 id 查找用户名称和密码进行认证和登录然后将构件部署到对应得宿主仓库。
3. 使用 mvn 命令部署构件
完成以上配置之后就可以使用 Maven 命令将构件部署到宿主仓库了操作步骤如下。
1打开命令行窗口跳转到 test-upload-snapshot 项目得目录下执行如下 Maven 命令。
mvn clean deploy2) Maven 命令执行结果如下图。
[INFO] Scanning for projects...
[INFO]
[INFO] --------------- net.biancheng.www:test-upload-snapshot ---------------
[INFO] Building test-upload-snapshot 0.0.1-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- maven-clean-plugin:2.5:clean (default-clean) test-upload-snapshot ---
[INFO] Deleting D:\eclipse workSpace 3\test-upload-snapshot\target
[INFO]
[INFO] --- maven-resources-plugin:2.6:resources (default-resources) test-upload-snapshot ---
[INFO] Using UTF-8 encoding to copy filtered resources.
[INFO] Copying 0 resource
[INFO]
[INFO] --- maven-compiler-plugin:3.1:compile (default-compile) test-upload-snapshot ---
[INFO] Nothing to compile - all classes are up to date
[INFO]
[INFO] --- maven-resources-plugin:2.6:testResources (default-testResources) test-upload-snapshot ---
[INFO] Using UTF-8 encoding to copy filtered resources.
[INFO] Copying 0 resource
[INFO]
[INFO] --- maven-compiler-plugin:3.1:testCompile (default-testCompile) test-upload-snapshot ---
[INFO] Nothing to compile - all classes are up to date
[INFO]
[INFO] --- maven-surefire-plugin:2.12.4:test (default-test) test-upload-snapshot ---
[INFO]
[INFO] --- maven-jar-plugin:2.4:jar (default-jar) test-upload-snapshot ---
[INFO] Building jar: D:\eclipse workSpace 3\test-upload-snapshot\target\test-upload-snapshot-0.0.1-SNAPSHOT.jar
[INFO]
[INFO] --- maven-install-plugin:2.4:install (default-install) test-upload-snapshot ---
[INFO] Installing D:\eclipse workSpace 3\test-upload-snapshot\target\test-upload-snapshot-0.0.1-SNAPSHOT.jar to D:\myRep
ository\repository\net\biancheng\www\test-upload-snapshot\0.0.1-SNAPSHOT\test-upload-snapshot-0.0.1-SNAPSHOT.jar
[INFO] Installing D:\eclipse workSpace 3\test-upload-snapshot\pom.xml to D:\myRepository\repository\net\biancheng\www\te
st-upload-snapshot\0.0.1-SNAPSHOT\test-upload-snapshot-0.0.1-SNAPSHOT.pom
[INFO]
[INFO] --- maven-deploy-plugin:2.7:deploy (default-deploy) test-upload-snapshot ---
Downloading from bianchengbang_Snapshot_hosted: http://localhost:8082/nexus/content/repositories/bianchengbang_Snapshot_
hosted/net/biancheng/www/test-upload-snapshot/0.0.1-SNAPSHOT/maven-metadata.xml
Downloaded from bianchengbang_Snapshot_hosted: http://localhost:8082/nexus/content/repositories/bianchengbang_Snapshot_h
osted/net/biancheng/www/test-upload-snapshot/0.0.1-SNAPSHOT/maven-metadata.xml (787 B at 9.2 kB/s)
Uploading to bianchengbang_Snapshot_hosted: http://localhost:8082/nexus/content/repositories/bianchengbang_Snapshot_host
ed/net/biancheng/www/test-upload-snapshot/0.0.1-SNAPSHOT/test-upload-snapshot-0.0.1-20210322.030343-5.jar
Uploaded to bianchengbang_Snapshot_hosted: http://localhost:8082/nexus/content/repositories/bianchengbang_Snapshot_hoste
d/net/biancheng/www/test-upload-snapshot/0.0.1-SNAPSHOT/test-upload-snapshot-0.0.1-20210322.030343-5.jar (2.1 kB at 28 k
B/s)
Uploading to bianchengbang_Snapshot_hosted: http://localhost:8082/nexus/content/repositories/bianchengbang_Snapshot_host
ed/net/biancheng/www/test-upload-snapshot/0.0.1-SNAPSHOT/test-upload-snapshot-0.0.1-20210322.030343-5.pom
Uploaded to bianchengbang_Snapshot_hosted: http://localhost:8082/nexus/content/repositories/bianchengbang_Snapshot_hoste
d/net/biancheng/www/test-upload-snapshot/0.0.1-SNAPSHOT/test-upload-snapshot-0.0.1-20210322.030343-5.pom (2.4 kB at 36 k
B/s)
Downloading from bianchengbang_Snapshot_hosted: http://localhost:8082/nexus/content/repositories/bianchengbang_Snapshot_
hosted/net/biancheng/www/test-upload-snapshot/maven-metadata.xml
Downloaded from bianchengbang_Snapshot_hosted: http://localhost:8082/nexus/content/repositories/bianchengbang_Snapshot_h
osted/net/biancheng/www/test-upload-snapshot/maven-metadata.xml (297 B at 11 kB/s)
Uploading to bianchengbang_Snapshot_hosted: http://localhost:8082/nexus/content/repositories/bianchengbang_Snapshot_host
ed/net/biancheng/www/test-upload-snapshot/0.0.1-SNAPSHOT/maven-metadata.xml
Uploaded to bianchengbang_Snapshot_hosted: http://localhost:8082/nexus/content/repositories/bianchengbang_Snapshot_hoste
d/net/biancheng/www/test-upload-snapshot/0.0.1-SNAPSHOT/maven-metadata.xml (787 B at 14 kB/s)
Uploading to bianchengbang_Snapshot_hosted: http://localhost:8082/nexus/content/repositories/bianchengbang_Snapshot_host
ed/net/biancheng/www/test-upload-snapshot/maven-metadata.xml
Uploaded to bianchengbang_Snapshot_hosted: http://localhost:8082/nexus/content/repositories/bianchengbang_Snapshot_hoste
d/net/biancheng/www/test-upload-snapshot/maven-metadata.xml (297 B at 5.2 kB/s)
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 2.342 s
[INFO] Finished at: 2021-03-22T11:03:4408:00
[INFO] ------------------------------------------------------------------------在 Nexus 界面的仓库列表选中 bianchengbang_Snapshot_hosted 宿主仓库在下方的 Browse Index 选项卡中可以看到 test-upload-snapshot 构件已经被部署到该仓库中如图 1 所示。 图1使用 Maven 部署构件到 Nexus
手动上传构件
有些 Jar 文件如 Oracle 的 JDBC 驱动由于许可证等原因无法存放在公开仓库中。此外还有一些小型的开源项目它们没有将自己的构件分发到公共仓库中也没有维护自己的仓库因此这些构件是无法从公共仓库中获得的。若 Maven 项目中需要这类构件我们就需要将构件下载到本地然后手动上传到 Nexus 私服。
我们还是以 Maven 项目 App-Core-lib 为例将其打包后手动上传到 Nexus 内置宿主仓库 3rd party 中具体步骤如下。
1. 打开命令行窗口跳转到 App-Core-lib 的目录下执行如下 mvn 命令对项目进行打包。
mvn clean package2.打包完成后进入 App-Core-lib\target 目录可以看到 Maven 已经将该项目打包成了一个 jar 文件如图 2 所示。 图2Maven 打包生成 jar 文件
3. 在 Nexus 界面的仓库列表中选择 3rd party 仓库在下方选择 Artifact Upload 选项卡其中 GAV Definition 用于定义上传构件的坐标信息。
GAV Definition 中提供了两种定义构件坐标的方式
若该构件通过 Maven 构建产生的则可以选择 From POMNexus 会自动从 POM 中获取构件的坐标。若该构件来自第三方则只能选择 GAV Parameters手动定义构件的坐标。
以上 2 种方式操作时会略有不同下面我们分别对它们进行介绍。 From POM 若该构件是通过 Maven 构建产生的那么可以在 GAV Definition 下拉列表中选择 From POM然后指定该构件所属项目的 pom.xmlNexus 会自动从 pom.xml 中获取构件的坐标。最后点击页面最下方的 Upload Artifact(s) 按钮将构件上传到仓库中如图 3 所示。 图3Nexus 手动上传构件 GAV Paramters 若构件不是通过 Maven 构建的而是来自第三方例如 Oracle 的 JDBC 驱动则只能在 GAV Definition 下拉列表中选择 GAV Parameters 手动定义构件的坐标。
定义好坐标后点击 Select Artifact(s) to Upload… 按钮选择要上传的构件然后点击 Add Artifact 按钮将其加入上传列表中。最后点击页面最下方的 Upload Artifact(s) 按钮将构件上传到仓库中如图 4 所示。 图4Nexus 第三方构件手动上传
4. 在仓库列表中选中 3rd party 宿主仓库在下方的 Browse Index 选项卡中可以看到构件已经被部署到该仓库中如图 5 所示。 图5第三方构件手动上传到Nexus
Nexus3的使用
目前 Nexus 分为 Nexus 2 和 Nexus 3 两个大版本它们是并行的关系。与 Nexus 2 相比Nexus 3 具有很多优势例如支持更多的仓库格式、优化了用户的使用界面以及更加强大的搜索功能等等。
目前使用最多的运行最稳定是 Nexus 2但随着 Nexus 3 对 Maven 的支持越来越稳定很多公司和组织都陆续开始使用 Nexus 3。
本节我们将介绍 Nexus 3 的安装和访问过程。
下载 Nexus 3
1. 进入 Nexus 3.x 下载页面目前最新版是 3.30.0-01根据操作选择相应的版本进行下载。 图1Nexus 下载页面
2. 将下载的安装包解压到本地可获得 nexus-3.30.0-01 和 sonatype-work 两个目录如图 2。 图2Nexus 解压 其中
nexus-3.30.0-01此目录包含 Nexus 运行所需要的文件以及所有必需的其他组件如启动脚本、依赖 jar 包等。sonatype-work该目录包含所有由 Nexus 存储和管理的仓库组件和其他数据。
启动 nexus 服务
我们可以在 nexus-3.30.0-01\bin 目录下发现一个名称位 nexus.exe 的可执行文件它是在 Windows 平台上运行 Nexus 的启动脚本该脚本包含了启动服务、停止服务、创建服务和删除服务等命令。
打开命令行窗口跳转到 nexus-3.30.0-01\bin 目录下执行以下命令启动 Nexus 服务。
nexus /run执行结果结果如图 3 所示则表示 Nexus 启动完成。 图3Nexus 3 启动完成
访问 nexus 3.x
启动完成后在浏览器地址栏输入 http://localhost:8081/访问 Nexus 界面如图 4 所示。 图4Nexus 3 用户界面
点击 Nexus 3.x 首页右上角的“Sign in”按钮在登录页面输入用户名和 密码默认用户名为 admin默认密码则保存在 /sonatype-work/nexus3 目录下的 admin.password 文件中)点击“Sign in”按钮登录如图 5 所示。 图5Nexus 3 登录界面
登录成功后结果如图 6 所示。 图6Nexus 3 登录成功
Nexus离线更新中央仓库索引
我们知道 Nexus 可以远程下载和缓存中央仓库索引但是对于国内用户来说Nexus 远程更新索引使用的站点位于国外且部分索引文件较大经常会出现下载速度缓慢或索引文件不完整等情况。下面我们将介绍一种更加快捷可靠的索引更新方式离线更新中央仓库索引。
离线更新中央仓库索引顾名思义就是直接将索引文件下载然后拷贝至 Nexus 工作目录中以达到离线更新索引的目的。
离线更新中央仓库索引主要分为以下 3 步
文件下载解压更新并验证索引
文件下载
首先我们需要下载以下 3 个文件
nexus-maven-repository-index.gznexus-maven-repository-index.propertiesindexer-cli-5.1.1.jar
1. 浏览器访问 https://repo.maven.apache.org/maven2/.index/ 下载 nexus-maven-repository-index.gz 和 nexus-maven-repository-index.properties 两个文件一般位于列表的末尾如图 1 所示。 图1Nexus 中央仓库离线索引下载列表
2. 浏览器访问 http://mvnrepository.com/搜索 Indexer CLI选择 Maven :: Indexer CLI如图 2 所示。 图2Nexus 索引生成器
3. 建议选择 5.1.1 版本如图 3 所示。 图3选择 Indexer CLI 版本
4. 在 Indexer CLI » 5.1.1 版本详情页点击 View All查看该版本包含的所有文件。 图4Nexus indexer-cli 5.1.1 详情
5. 在文件列表中点击 indexer-cli-5.1.1.jar 下载该文件如图 5 所示。 图5Nexus indexer-cli 文件列表
解压
1. 将 nexus-maven-repository-index.gz 、nexus-maven-repository-index.properties 以及 indexer-cli-5.1.1.jar 三个文件都存放到 index目录的名称及位置均为自定义没有特殊规定目录下如图 6 所示。 图6Nexus 中央仓库离线索引文件
2. 打开命令行窗口跳转到 index 目录执行以下命令解压索引文件。
java -jar indexer-cli-5.1.1.jar -u nexus-maven-repository-index.gz -d indexer解压过程大约需要 10 分钟左右请耐心等待解压完成后结果如图 7 所示。 图7Nexus 中央仓库离线索引解压
3. 解压完成后在 index 中会生成一个名为 indexer 的目录该目录中存放的就是中央仓库离线索引文件如图 8 所示。 图8Nexus 离线索引文件
更新并验证索引
1. 将所有索引文件不包含目录全部拷贝到“Nexus\sonatype-work\nexus\indexer\central-ctx”目录中如图 9 所示。 图9Nexus 中央仓库索引目录
2. 重启 Nexus在仓库列表中选中 Central 代理仓库然后点击 Browse Index 选项卡结果如图 10 所示。 图10Nexus 离线索引
3. 点击 browse Remote 选项卡结果如图 11 所示。 图11Nexus 远程索引
4. 对比 Browse Index 和 Browse Remote 中的索引若两者完全一致则表示离线索引更新成功。 需要注意的是目前只有 Nexus 2.x 可以通过以上方式离线更新中央仓库索引Nexus 3.x 暂不支持该功能。若想在 Nexus 3.x 中使用离线索引我们建议您先在 Nexus 2.x 中离线更新索引后再将数据迁移到 Nexus 3.x 中。
