网站开发知乎,网站文章页做百度小程序,网站加入我们页面,松原网站建设公司电话Maven 使用 Nexus 创建私服 1️⃣ Nexus简介2️⃣ 安装 Nexus2.1 下载 Nexus2.2 Bundle 方式安装 Nexus2.3 WAR 方式安装 Nexus2.4 登录 Nexus 3️⃣ Nexus 的仓库与仓库组3.1 Nexus 内置的仓库3.2 Nexus 仓库分类的概念3.3 创建 Nexus 宿主仓库3.4 创建 Nexus 代理仓库3.5 创… Maven · 使用 Nexus 创建私服 1️⃣ Nexus简介2️⃣ 安装 Nexus2.1 下载 Nexus2.2 Bundle 方式安装 Nexus2.3 WAR 方式安装 Nexus2.4 登录 Nexus 3️⃣ Nexus 的仓库与仓库组3.1 Nexus 内置的仓库3.2 Nexus 仓库分类的概念3.3 创建 Nexus 宿主仓库3.4 创建 Nexus 代理仓库3.5 创建 Nexus 仓库组 4️⃣ Nexus 的索引与构件搜索5️⃣ 配置 Maven从 Nexus下载构件6️⃣ 部署构件至 Nexus6.1 使用 Maven 部署构件至 Nexus6.2 手动部署第三方构件至 Nexus 7️⃣ Nexus 的权限管理7.1 Nexus 的访问控制模型7.2 为项目分配独立的仓库 8️⃣ Nexus的调度任务9️⃣ 其他私服软件 总结 私服不是Maven 的核心概念它仅仅是一种衍生出来的特殊的Maven 仓库前面已经解释过了其概念和用途然而这还不够。通过建立自己的私服就可以降低中央仓库负荷、节省外网带宽、加速 Maven 构建、自己部署构件等从而高效地使用Maven。
有三种专门的Maven 仓库管理软件可以用来帮助大家建立私服 Apache 基金会的Archiva、JFrog 的 Artifactory 和 Sonatype 的 Nexus。 其中 Archiva 是开源的而 Artifactory 和 Nexus 的核心也是开源的因此大家可以自由选择使用。个人比较推崇 Nexus。事实上Nexus 也是当前最流行的 Maven 仓库管理软件。本文将介绍 Nexus的主要功能并结合图片帮助大家快速地建立起自己的 Maven 私服。
1️⃣ Nexus简介
2005年12月Tamas Cservenak 由于受不了匈牙利电信ADSL的低速度开始着手开发 Proximity—一个很简单的 Web 应用。它可以代理并缓存 Maven 构件当 Maven 需要下载构件的时候就不需要反复依赖于ADSL。 到2007年 Sonatype 邀请 Tamas 参与创建一个更酷的 Maven 仓库管理软件这就是后来的 Nexus。
Nexus 团队的成员来自世界各地它也从社区收到了大量反馈和帮助现在 Nexus 已经发布到了 3.60.0 版本它也正健康快速地成长着。Nexus分为开源版和专业版其中开源版本基于GPLx3 许可证其特性足以满足大部分 Maven用户的需要。
以下是一些 Nexus 开源版本的特性
较小的内存占用 (最少仅为28MB)基于 ExtJS 的友好界面基于 Restlet 的完全 REST API支持代理仓库、宿主仓库和仓库组基于文件系统不需要数据库支持仓库索引和搜索支持从界面上传Maven 构件细粒度的安全控制
Nexus专业版本是需要付费购买的除了开源版本的所有特性之外它主要包含一些企 业安全控制、发布流程控制等需要的特性。感兴趣的朋友可以访问该地址了解详情 https://help.sonatype.com/repomanager3/product-information/download
2️⃣ 安装 Nexus
Nexus是典型的Java Web应用它有两种安装包一种是包含 Jetty 容器的 Bundle 包 另一种是不包含 Web 容器的 war包。
2.1 下载 Nexus
首先从 Nexus下载地址 下载最新版本的 Nexus。大家可以根据需要下载对应安装包 nexus-3.60.0-02-win64.zip Windows系统 、nexus-3.60.0-02-unix.tar.gzLinux系统或者 nexus-3.60.0-02-mac.tgz MAC系统。
2.2 Bundle 方式安装 Nexus
2.X 旧版本的 Nexus 是 Bundle 安装包所以本节介绍下这种安装包的安装方式。Bundle 自带了Jetty 容器因此用户不需要额外的Web 容器就能直接启动 Nexus。首 先将 Bundle 文件解压解压后会得到如下两个子目录 nexus-xxx/该目录包含了Nexus 运行所需要的文件如启动脚本、依赖 jar包等。sonatype-work/该目录包含Nexus 生成的配置文件、日志文件、仓库文件等。
其中第一个目录是运行Nexus 所必需的而且所有相同版本 Nexus实例所包含的该目录内容都是一样的。而第二个目录不是必须的 Nexus 会在运行的时候动态创建该目录不过它的内容对于各个Nexus 实例是不一样的因为不同用户在不同机器上使用的 Nexus 会有不同的配置和仓库内容。当用户需要备份 Nexus 的时候默认备份sonatype-work/目录因为该目录 包含了用户特定的内容而 nexus-xxx 目录下的内容是可以从安装包直接获得的。
用户只需要调用对应操作系统的脚本就可以启动 Nexus, 这里介绍主流的在 Windows 和 Linux 平台上启动 Nexus 的方式。
在 Windows 操作系统上用户需进入 nexus-xxx/bin/jsw/windows-x86-32/ 子目录然后直接运行 start-nexus.bat 脚本就能启动 Nexus。运行 console-nexus.bat 脚本如果看到如下输出部分日志已省略就说明启动成功了
wrapper | -- Wrapper Started as Console
wrapper | Launching a JVM...
jvm 1 | Wrapper (Version 3.2.3) http://wrapper.tanukisoftware.org
jvm 1 | Copyright 1999-2006 Tanuki Software, Inc. All Rights Reserved.
jvm 1 |
...
jvm 1 | 2023-09-27 15:02:15,5390800 INFO [WrapperListener_start_runner] org.sonatype.nexus.bootstrap.ConfigurationBuilder - application-host0.0.0.0
jvm 1 | 2023-09-27 15:02:15,5390800 INFO [WrapperListener_start_runner] org.sonatype.nexus.bootstrap.ConfigurationBuilder - application-port8081
jvm 1 | 2023-09-27 15:02:15,5390800 INFO [WrapperListener_start_runner] org.sonatype.nexus.bootstrap.ConfigurationBuilder - bundleBasedirD:\MyApp\nexus-2.14.5-02-bundle\nexus-2.14.5-02
jvm 1 | 2023-09-27 15:02:15,5400800 INFO [WrapperListener_start_runner] org.sonatype.nexus.bootstrap.ConfigurationBuilder - java.awt.headlesstrue
jvm 1 | 2023-09-27 15:02:15,5400800 INFO [WrapperListener_start_runner] org.sonatype.nexus.bootstrap.ConfigurationBuilder - networkaddress.cache.ttl3600
jvm 1 | 2023-09-27 15:02:15,5400800 INFO [WrapperListener_start_runner] org.sonatype.nexus.bootstrap.ConfigurationBuilder - nexus-appD:\MyApp\nexus-2.14.5-02-bundle\nexus-2.14.5-02/nexus/WEB-INF
jvm 1 | 2023-09-27 15:02:15,5400800 INFO [WrapperListener_start_runner] org.sonatype.nexus.bootstrap.ConfigurationBuilder - nexus-webappD:\MyApp\nexus-2.14.5-02-bundle\nexus-2.14.5-02/nexus
jvm 1 | 2023-09-27 15:02:15,5400800 INFO [WrapperListener_start_runner] org.sonatype.nexus.bootstrap.ConfigurationBuilder - nexus-webapp-context-path/nexus
jvm 1 | 2023-09-27 15:02:15,5400800 INFO [WrapperListener_start_runner] org.sonatype.nexus.bootstrap.ConfigurationBuilder - nexus-workD:\MyApp\nexus-2.14.5-02-bundle\sonatype-work\nexus
jvm 1 | 2023-09-27 15:02:15,5400800 INFO [WrapperListener_start_runner] org.sonatype.nexus.bootstrap.ConfigurationBuilder - org.eclipse.ecf.provider.filetransfer.retrieve.readTimeout30000
...
jvm 1 | 2023-09-27 15:02:18,2530800 INFO [jetty-main-1] org.sonatype.nexus.NxApplication -
jvm 1 | -------------------------------------------------
jvm 1 |
jvm 1 | Initializing Nexus Repository Manager OSS 2.14.5-02
jvm 1 |
jvm 1 | -------------------------------------------------
jvm 1 | 2023-09-27 15:02:18,2540800 INFO [jetty-main-1] org.sonatype.nexus.NxApplication - Activating locally installed plugins...
jvm 1 | 2023-09-27 15:02:20,8170800 INFO [jetty-main-1] com.sun.jersey.server.impl.application.WebApplicationImpl - Initiating Jersey application, version Jersey: 1.17.1 02/28/2013 12:47 PM
jvm 1 | 2023-09-27 15:02:22,0510800 INFO [jetty-main-1] org.sonatype.nexus.plugins.bcprov.CryptoPlugin - Unlimited strength JCE policy detected
jvm 1 | 2023-09-27 15:02:23,7940800 INFO [jetty-main-1] org.sonatype.nexus.kazuki.KazukiPlugin - Kazuki version: 0.1.8
jvm 1 | 2023-09-27 15:02:26,2720800 INFO [jetty-main-1] org.sonatype.nexus.proxy.registry.DefaultRepositoryTypeRegistry - Registered Repository type RepositoryType(org.sonatype.nexus.proxy.repository.WebSiteRepository:site).
jvm 1 | 2023-09-27 15:02:26,5660800 INFO [jetty-main-1] org.sonatype.nexus.proxy.registry.DefaultRepositoryTypeRegistry - Registered Repository type RepositoryType(org.sonatype.nexus.proxy.repository.GroupRepository:npm-group).
jvm 1 | 2023-09-27 15:02:26,5660800 INFO [jetty-main-1] org.sonatype.nexus.proxy.registry.DefaultRepositoryTypeRegistry - Registered Repository type RepositoryType(org.sonatype.nexus.proxy.repository.Repository:npm-hosted).
jvm 1 | 2023-09-27 15:02:26,5660800 INFO [jetty-main-1] org.sonatype.nexus.proxy.registry.DefaultRepositoryTypeRegistry - Registered Repository type RepositoryType(org.sonatype.nexus.proxy.repository.Repository:npm-proxy).
jvm 1 | 2023-09-27 15:02:26,6910800 INFO [jetty-main-1] org.sonatype.nexus.proxy.registry.DefaultRepositoryTypeRegistry - Registered Repository type RepositoryType(org.sonatype.nexus.proxy.repository.ShadowRepository:nuget-shadow).
jvm 1 | 2023-09-27 15:02:26,6910800 INFO [jetty-main-1] org.sonatype.nexus.proxy.registry.DefaultRepositoryTypeRegistry - Registered Repository type RepositoryType(org.sonatype.nexus.proxy.repository.GroupRepository:nuget-group).
jvm 1 | 2023-09-27 15:02:26,6910800 INFO [jetty-main-1] org.sonatype.nexus.proxy.registry.DefaultRepositoryTypeRegistry - Registered Repository type RepositoryType(org.sonatype.nexus.proxy.repository.Repository:nuget-proxy).
jvm 1 | 2023-09-27 15:02:29,0920800 INFO [jetty-main-1] org.sonatype.nexus.proxy.registry.DefaultRepositoryTypeRegistry - Registered Repository type RepositoryType(org.sonatype.nexus.proxy.repository.GroupRepository:rubygems-group).
jvm 1 | 2023-09-27 15:02:29,0920800 INFO [jetty-main-1] org.sonatype.nexus.proxy.registry.DefaultRepositoryTypeRegistry - Registered Repository type RepositoryType(org.sonatype.nexus.proxy.repository.Repository:rubygems-hosted).
jvm 1 | 2023-09-27 15:02:29,0920800 INFO [jetty-main-1] org.sonatype.nexus.proxy.registry.DefaultRepositoryTypeRegistry - Registered Repository type RepositoryType(org.sonatype.nexus.proxy.repository.Repository:rubygems-proxy).
jvm 1 | 2023-09-27 15:02:30,4900800 INFO [jetty-main-1] org.sonatype.nexus.NxApplication - Plugin manager request ACTIVATE on plugin org.sonatype.nexus.plugins:nexus-atlas-plugin:2.14.5-02 was successful.
...
jvm 1 | 2023-09-27 15:02:31,1750800 INFO [jetty-main-1] org.sonatype.nexus.orient.DatabaseServerImpl - Activated
jvm 1 | 2023-09-27 15:02:31,1750800 INFO [jetty-main-1] org.sonatype.nexus.configuration.application.DefaultNexusConfiguration - Loading Nexus Configuration...
jvm 1 | 2023-09-27 15:02:31,1830800 INFO [jetty-main-1] org.sonatype.nexus.configuration.source.StaticConfigurationSource - Configuration loaded successfully.
...这时打开浏览器访问 http://localhost:8081/nexus/ 就能看到 Nexus 的界面如图所示。 要停止 Nexus, 可以在命令行按 ClrlC 键。在 nexus-xxx/bin/jsw/windows-x86-32/ 目录下还有其他一些脚本
install-nexus.bat将 Nexus 安装成 Windows 服务。uninstall-nexus.bat卸载 Nexus Windows 服务。start-nexus.bat启动 Nexus Windows 服务。stop-nexus.bat停止 Nexus Windows 服务。pause-nexus.bat暂停 Nexus Windows 服务。resume-nexus.bat恢复暂停的 Nexus Windows 服务。
借助 Windows 服务用户就可以让 Nexus 伴随着 Windows 自动启动非常方便。
在Linux系统上启动 Nexus也非常方便例如使用 Ubuntu32位系统那么只需要进入到nexus-xxx/bin/jsw/linux-x86-32/然后运行如下命令
$ . /nexus console同样地读者可以看到 Nexus启动的命令行输出并且可以使用 CtrlC键停止 Nexus。 除了console之外Nexus的Linux脚本还提供如下的命令
./nexus start: 在后台启动 Nexus服务。./nexus stop: 停止后台的 Nexus服务。./nexus status: 查看后台 Nexus服务的状态。./nexus restart: 重新启动后台的Nexus服务。
关于Bundle 安装的一个常见问题是端口冲突。Nexus Bundle默认使用的端口是8081, 如果该端口已经被其他应用程序占用或者你想使用80端口开放Nexus服务则编辑文件 nexus-xxx/conf/nexus.properties, 找到属性 application-port, 按需要将默认值 8081改成其他端口号然后保存该文件重启Nexus便可。 2.3 WAR 方式安装 Nexus
除了 Bundle, Nexus还提供一个可以直接部署到Web容器中的war包。该war包支持主流的Web容器如Tomcat、Glassfish、Jetty 和 Resin。
以Tomcat6为例我在 Vista机器上的目录为 D:\bin\apache-tomcat-6.0.20\, 那么只需要复制 Nexus war包至 Tomcat的部署目录 D:\bin\apache-tomcat-6.0.20\webapps\nexus.war, 然后转到 D:\bin\apache-tomcat-6.0.20\bin\目录运行脚本 startup.bat。这时便可以从Tomcat的 console输出中看到它部署nexus.war。 待Tomcat启动完成后访问 http://localhost:8080/nexus/ 就能看到Nexus的界面了。
2.4 登录 Nexus
Nexus拥有全面的权限控制功能默认的Nexus访问都是匿名的而匿名用户仅包含一些 最基本的权限要全面学习和管理Nexus, 就必须以管理员方式登录。可以单击界面右上角的 Log In进行登录 Nexus的默认管理员用户名和密码为 admin/admin123, 如图所示。
3️⃣ Nexus 的仓库与仓库组
作为Maven 仓库服务软件仓库自然是Nexus 中最重要的概念。 Nexus 包含了各种类型 的仓库概念包括代理仓库、宿主仓库和仓库组等。每一种仓库都提供了丰富实用的配置参数方便用户根据需要进行定制。
3.1 Nexus 内置的仓库
在具体介绍每一种类型的仓库之前先浏览一下 Nexus 内置的一些仓库。单击Nexus界 面左边导航栏中的 Repositories链接就能在界面右边看到如图所示的内容。 这个列表已经包含了所有类型的 Nexus 仓库。从中可以看到仓库有四种类型 group (仓库组)、 hosted (宿主)、 proxy (代理) 和 vitual (虚拟)。每个仓库的格式为 maven2 或者 maven1。 此外仓库还有一个属性为 Policy (策略), 表示该仓库为发布 (Release) 版本仓库还是快照 (Snapshot) 版本仓库。最后两列的值为仓库的状态和路径。
下面解释一下各个仓库的用途maven1 格式的仓库暂时省略。此外由于虚拟类型仓库的作用实际上是动态地将仓库内容格式转换换言之也是为了服务 maven1 格式因此省略。
Maven Central: 该仓库代理 Maven 中央仓库其策略为Release, 因此只会下载和缓 存中央仓库中的发布版本构件。Releases: 一个策略为Release 的宿主类型仓库用来部署组织内部的发布版本构件。Snapshots: 一个策略为Snapshot 的宿主类型仓库用来部署组织内部的快照版本构件。3rd party: 一个策略为Release 的宿主类型仓库用来部署无法从公共仓库获得的第三方发布版本构件。Apache Snapshots: 一个策略为Snapshot 的代理仓库用来代理Apache Maven仓库的快照版本构件。Codehaus Snapshots: 一个策略为Snapshot 的代理仓库用来代理 Codehaus Maven 仓库的快照版本构件。Google Code: 一个策略为 Release 的代理仓库用来代理 Google Code Maven 仓库的发布版本构件。java.net-Maven 2: 一个策略为Release 的代理仓库用来代理 java.net Maven 仓库的发布版本构件。Public Repositories: 该仑库组将上述所有策略为 Release 的仓库聚合并通过一致的地 址提供服务。Public Snapshot Repositories: 该仓库组将上述所有策略为Snapshot 的仓库聚合并通过一致的地址提供服务。
举一个简单的例子。假设某公司建立了Maven 项目X, 公司内部建立了Nexus 私服为 所有 Maven 项目提供服务。项目X 依赖于很多流行的开源类库如 JUnit 等这些构件都能从 Maven 中央仓库获得因此 Maven Central 代理仓库会被用来代理中央仓库的内容并在私服上缓存下来 X 还依赖于某个 Google Code的项目其构件在中央仓库中不存在只存在于Google Code的仓库中因此上述列表中的 Google Cole 代理仓库会被用来代理并缓存这样的构件。
X 还依赖于 Oracle的 JDBC 驱动由于版权的因素该类库无法从公共仓库获得 因此公司管理员将其部署到 3rd party宿主仓库中供X 使用。 X 的快照版本构件成功后会被部署到 Snapshots 宿主仓库中供其他项目使用。当X 发布正式版本的时候其构件会被部署到 Release宿主仓库中。由于X 用到了上述列表中的很多仓库为每个仓库声明 Maven 配置又比较麻烦因此可以直接使用仓库组 Publie Repositories 和 Public Snapshot Repositories, 当 X 需要 JUnit的时候它直接从 Public Repositories 下载Public Repositories会选择 Maven Central 提供实际的内容。
3.2 Nexus 仓库分类的概念
为了帮助理解宿主仓库、代理仓库和仓库组的概念下图用更为直观的方式展现了它们的用途和区别。 从图中可以看到 Maven 可以直接从宿主仓库下载构件 Maven 也可以从代理仓库下载构件而代理仓库会间接地从远程仓库下载并缓存构件最后为了方便 Maven 可 以从仓库组下载构件而仓库组没有实际内容(图中用虚线表示), 它会转向其包含的宿主 仓库或者代理仓库获得实际构件的内容。
3.3 创建 Nexus 宿主仓库
要创建一个宿主仓库首先单击界面左边导航栏中的Repositories链接在右边的面板中选择Add, 接着在下拉菜单中选择 Hosted Repository, 就会看到图示的配置界面。 根据自己的需要填入仓库的 ID 和名称下一字段Repository Type 表示该仓库的类型。 Provider用来确定该仓库的格式。 一般来说选择默认的 Maven2 Repository。 然后是 Repository Policy, 可以根据自己的需要来配置该仓库是发布版构件仓库还是快照版构件仓库。 Default Local Stornge Location表示该仓库的默认存储目录图中该字段的值为空待仓库创建好之后该值就会成为基于 sonatype-work 的一个文件路径如 sonatype-work/nexus/storage/repository-id/, Override Local Storage Location可以用来配置自定义的仓库目录位置。
在Access Settings小组中 Deployment Policy 用来配置该仓库的部署策略选项有只读 (禁止部署)、关闭重新部署(同一构件只能部署一次)以及允许重新部署。 Allow File Browsing表示是否允许浏览仓库内容 一般选True。 每个仓库(包括代理仓库和仓库组) 都有一个Browse Storage 选项卡用户以树形结构浏览仓库存储文件的内容如下图所示。 Include in Search 表示是否对该仓库进行索引并提供搜索我们会在后面文章详细讨论索 引和搜索。 Publish URL 用来控制是否通过URL 提供服务如果选 False, 当访问该仓库的地址时会得到 HTTP 404 Not Found 错误。配置中最后的 Not Found Cache TTL表示当一个文件没有找到后缓存这一不存在信息的时间。以默认值1440分钟为例如果某文件不存在那么在之后的1440分钟内如果 Nexus 再次得到该文件的请求它将直接返回不存在信息而不会查找文件系统。这么做是为了避免重复的文件查找操作以提升性能。
3.4 创建 Nexus 代理仓库
首先单击界面左边导航栏中的 Repositories 链接在右边的面板中选择 Add..., 接着在下拉菜单中选择 Proxy Repository, 就会看到如图所示的配置界面。 仓库的ID、 名称、Provider、Format、Policy、 默认本地存储位置和覆盖本地存储位置等 配置前面都已提过这里不再赘述。需要注意的是这里的 Repository Type 的值为 proxy。
对于代理仓库来说最重要的是远程仓库的地址即 Remote Storage Location,用户必须在这里输入有效的值。 Download Remote Indexes 表示是否下载远程仓库的索引有些远程仓库拥有索引下载其索引后即使没有缓存远程仓库的构件用户还是能够在本地搜索 和浏览那些构件的基本信息。 Checksum Policy 配置校验和出错时的策略用户可以选择忽略、记录警告信息或者拒绝下载。当远程仓库需要认证的时候这里的 Authentication 配置就能派上用处。
Access Settings的配置与宿主仓库类似在此不再赘述。 Expiration Settings 较宿主仓库多了Artifact Max Age 和 Metadata Max Age。其中前者表示构件缓存的最长时间后者表示 仓库元数据文件缓存的最长时间。对于发布版仓库来说 Artifact Max Age 默认值为 -1 , 表示构件缓存后就一直保存着不再重新下载。对于快照版仓库来说 Artifact Max Age 默认值为1440分钟表示每隔一天重新缓存代理的构件。
配置中最后两项为HTTP Request Settings 和 Override HTTP Proxy Settings, 其中前者用来配置Nexus 访问远程仓库时HTTP 请求的参数后者用来配置HTTP 代理。
3.5 创建 Nexus 仓库组
要创建一个仓库组首先单击界面左边导航栏中的Repositories 链接在右边的面板中选择Add, 接着在下拉菜单中选择 Repository Group, 就会看到图所示的配置界面。 配置中的 ID、Name 等信息这里不再赘述。需要注意的是仓库组没有 Release 和 Snapshot 的区别这不同于宿主仓库和代理仓库。在配置界面中用户可以非常直观地选择 Nexus 中仓库将其聚合成一个虚拟的仓库组。注意仓库组所包含的仓库的顺序决定了仓库组遍历其所含仓库的次序因此最好将常用的仓库放在前面当用户从仓库组下载构件的时候就能够尽快地访问到包含构件的仓库。
4️⃣ Nexus 的索引与构件搜索
既然 Nexus 能够维护宿主仓库并代理缓存远程仓库(如 Maven 中央库), 那么一个简单的需求就自然浮现出来了这就是搜索。 Maven 中央库有几十万构件供用户使用但有时 我们往往仅仅知道某个关键字如 Ehcache, 而不知道其确切的 Maven 坐标。 Nexus 通过维护仓库的索引来提供搜索功能能在很大程度上方便 Maven 用户定位构件坐标。
前面文章中介绍过了Sonatype提供的在线免费搜索服务其实用户可以很方便地自己维护一个Nexus 实例并提供搜索服务。
为了能够搜索Maven 中央库首先需要设置 Nexus 中的 Maven Central 代理仓库下载远 程索引如图所示。需要注意的是默认这个配置的值是关闭的。此外由于中央库的内容比较多因此其索引文件比较大 Nexus 下载该文件也需要比较长的时间需要耐心等待。 可以想象到 Nexus 在后台运行了一个任务来下载中央仓库的索引幸运的是用户可 以通过界面直接观察这一任务的状态。单击界面左边导航栏中的Scheduled Tasks 链接后 用户就能在界面的右边看到系统的调度任务如果 Nexus 正在下载中央仓库的索引用户就能看到一个任务其状态为RUNNING。 在索引下载完毕之后该任务就会消失。
有了索引用户即可搜索Maven 构件了。 Nexus 界面左边导航栏有一个快捷搜索框在 其中输入关键字后单击搜索按钮就能快速得到搜索结果。使用关键字进行搜索可以得到该关键字相关的结果结果中的每一行都表示了一类构件信息包括Groupld、Artifactld、最新版本以及最新版本的相关文件下载等。单击其中的某一行界面的下端会浮出一个更具体的构件信息面板。
该面板除了显示构件的坐标还包含了一段 XML 依赖声明用户可以直接复制粘贴到 项目的 POM 中。此外用户还能从该面板获知构件在仓库中的相对位置。单击 Artifact Information 还能看到文件具体的大小、更新时间、 SHA1 和 MD5 校验和以及下载链接。除了简单的关键字搜索 Nexus 还提供了GAV 搜索、类名搜索和校验和搜索等功能用户可以单击搜索页面左上角的下拉菜单选择高级搜索功能
GAV 搜索 (GAV Search) 允许用户通过设置 Groupld 、Artifactld 和 Version 等信息来进行更有针对性的搜索。类名搜索 (Classname Search) 允许用户搜索包含某个Java 类的构件。校验和搜索 (Checksum Search) 允许用户直接使用构件的校验和来搜索该构件。
当然用户也可以自己手动输入 Groupld、Artifactld 等信息来进行GAV 搜索。有了中央仓库的索引用户不仅能够搜索构件还能够直接浏览中央仓库的内容。这便是Nexus 的索引浏览功能。在Repositories 页面中选择 Browse Index 选项卡就能看到中央仓库内容的树形结构。
以上的搜索及浏览功能都是基于Nexus 索引而实现的确切地应该称之为 nexus-indexer。Nexus 能够遍历一个 Maven 仓库所有的内容搜集它们的坐标、校验和及所含的Java 类信息然后以 nexus-indexer的形式保存起来。中央仓库维护了这样的一个nexus-indexer, 因此本地的 Nexus 下载到这个索引之后就能在此基础上提供搜索和浏览等服务。需要注意的是不是任何一个公共仓库都提供 nexus-indexer, 对于那些不提供索引的仓库来说我们就无法对其进行搜索。
除了下载使用远程仓库的索引我们也能为宿主仓库和代理仓库建立索引。只需要在仓库上右击从弹出的快捷菜单中选择 ReIndex 即可。待索引编纂任务完成之后就能搜索该仓库所包含的构件。
对于宿主仓库来说 ReIndex 任务会扫描该仓库包含的所有构件建立索引。对于代理仓 库来说 Relndex 任务会扫描所有缓存的构件建立索引如果远程仓库也有索引则下载后与本地的索引合并。对于仓库组来说 Relndex 任务会合并其包含的所有仓库的索引。
5️⃣ 配置 Maven从 Nexus下载构件
前面文章中我们已经详细介绍了如何在 POM 中为Maven 配置仓库和插件仓库。例如当需要为项目添加 Nexus私服上的 public仓库时可以按以下代码所示配置。
projectrepositoriesrepositoryidnexus/idnameNexus/nameurlhttp://localhost:8081/nexus/content/groups/public//urlreleasesenabledtrue/enabled/releasessnapshotsenabledtrue/enabled/snapshots/repository/repositoriespluginRepositoriespluginRepositoryidnexus/idnameNexus/nameurlhttp://localhost:8081/nexus/content/groups/public//urlreleasesenabledtrue/enabled/releasessnapshotsenabledtrue/enabled/snapshots/pluginRepository/pluginRepositories
/project这样的配置只对当前Maven项目有效在实际应用中我们往往想要通过一次配置就能让本机所有的 Maven项目都使用自己的Maven私服。这个时候可能会想到settings.xml文件该文件中的配置对所有本机bMaven项目有效但是settings.xml并不支持直接配置repositories和 pluginRepositories。所幸Maven还提供了 Profile机制能让用户将仓库配置放到setting.xml中的 Profile中如代码所示。
settingsprofilesprofileidnexus/idrepositoriesrepositoryidnexus/idnameNexus/nameurlhttp://localhost:8081/nexus/content/groups/public//urlreleasesenabledtrue/enabled/releasessnapshotsenabledtrue/enabled/snapshots/repository/repositoriespluginRepositoriespluginRepositoryidnexus/idnameNexus/nameurlhttp://localhost:8081/nexus/content/groups/public//urlreleasesenabledtrue/enabled/releasessnapshotsenabledtrue/enabled/anapshots/pluginRepository/pluginRepositories/profile/profilesactiveProfilesactiveProfilenexus/activeProfile/activeProfiles
/settings该配置中使用了一个id为 nexus的 profile, 这个 profile包含了相关的仓库配置同时配 置中又使用 activeProfile元素将 nexus这个 profile激活这样当执行Maven构建的时候激活的profile会将仓库配置应用到项目中去。关于Maven Profile, 后面还会有专门的文章进一步介绍。
上面代码中的配置已经能让本机所有的Maven项目从Nexus私服下载构件。细心的朋友可能会注意到Maven除了从Nexus下载构件之外还会不时地访问中央仓库 central, 我们希望的是所有Maven下载请求都仅仅通过Nexus, 以全面发挥私服的作用。这个时候就需要借助于前面提到过的 Maven镜像配置了。可以创建一个匹配任何仓库的镜像镜像的地址为私服这样Maven对任何仓库的构件下载请求都会转到私服中。具体配置见代码
settingsmirrorsmirroridnexus/idmirrorof*/mirrorofurlhttp://localhost:8081/nexus/content/groups/public/url/mirror/mirrorsprofilesprofileidnexus/idrepositoriesrepositoryidcentral/idurlhttp://central/urlreleasesenabledtrue/enabled/releasessnapshotsenabledtrue/enabled/snapshots/repository/repositoriespluginRepositoriespluginRepositoryidcentral/idurlhttp://central/urlreleaseenabledtrue/enabled/releasessnapshotsenabledtrue/enabled/snapshots/pluginRepository/pluginRepositories/profile/profilesactiveProfilesactiveProfilenexus/activeProfile/activeProfiles
/settings关于镜像、profile及profile激活的配置不再赘述这里需要解释的是仓库及插件仓库配置它们的 id都为 central,也就是说覆盖了超级POM中央仓库的配置它们的 url已无关紧要因为所有请求都会通过镜像访问私服地址。配置仓库及插件仓库的主要目的是开启对快照版本下载的支持当Maven需要下载发布版或快照版构件的时候它首先检查central,看该类型的构件是否支持得到正面的回答之后再根据镜像匹配规则转而访问私服仓库地址。
6️⃣ 部署构件至 Nexus
如果只为代理外部公共仓库那么Nexus的代理仓库就已经能够完全满足需要了。对于另一类Nexus仓库——宿主仓库来说它们的主要作用是储存组织内部的或者一些无法从公共仓库中获得的第三方构件供大家下载使用。用户可以配置Maven自动部署构件至Nexus的宿主仓库也可以通过界面手动上传构件。
6.1 使用 Maven 部署构件至 Nexus
日常开发生成的快照版本构件可以直接部署到 Nexus中策略为 Snapshot的宿主仓库中项目正式发布的构件则应该部署到 Nexus中策略为 Release的宿主仓库中。下面代码列出了一段典型的配置。
projectdistributionManagementrepositoryidnexusreleases/idnameNexus Releases Repository/nameurlhttp://localhost:8081/nexus/content/repositories/releases//url/repositorysnapshotRepositoryidnexus-snapshots/idnameNexus Snapshots Repository/nameurlhttp://localhost:8081/nexus/content/repositories/snapshots//url/snapshotRepository/distributionManagement
/projectNexus的仓库对于置名用户是只读的。为了能够部署构件还需要在 settings.xml中配 置认证信息如代码所示。
settingsserversserveridnexus-releases/idusernameadmin/usernamepassword*****/password/serverserveridnexus-snapshots/idusernameadmin/usernamepassword*****/password/server/servers
/settings6.2 手动部署第三方构件至 Nexus
某些Java Jar文件(如Oracle)的JDBC驱动由于许可证的因素它们无法公开地放在公共仓库中。此外还有大量的小型开源项目它们没有把自己的构件分发到中央仓库中也没有维护自己的仓库因此也无法从公共仓库获得。这个时候用户就需要将这类构件手动下载到本地然后通过Nexus的界面上传到私服中。
要上传第三方构件首先选择一个宿主仓库如 3rd party, 然后在页面的下方选择Artifact Upload选项卡。在上传构件的时候Nexus要求用户确定其Maven坐标如果该构件是通过Maven构建的那么可以在 GAV Definition下拉列表中选择 From POM, 否则就选GAV Parameters。用户需要为该构件定义一个Maven坐标定义好坐标之后单击Select Artifact(s) to Upload按扭从本机选择要上传的构件然后单击Add Artifact按钮将其加入到上传列表中。Nexus允许用户一次上传一个主构件和多个附属构件(即Classifier)。最后单击页面最下方的Upload Artifact(s)按钮将构件上传到仓库中。
7️⃣ Nexus 的权限管理
在组织中使用Nexus的时候往往会有一些安全性需求例如希望只有管理员才能配置 Nexus, 只有某些团队成员才能部署构件或者更细一些的要求例如每个项目都有自己的 Nexus宿主仓库且只能部署项目构件至该仓库中。 Nexus 提供了全面的权限控制特性能 让用户自由地根据需要配置 Nexus用户、角色、权限等。
7.1 Nexus 的访问控制模型
Nexus是基于权限 (Privilege) 做访问控制的服务器的每一个资源都有相应的权限来控制因此用户执行特定的操作时就必须拥有必要的权限。管理员必须以角色 (Role) 的 方式将权限赋予Nexus用户。例如要访问 Nexus 界面就必须拥有 Status- (read) 这个权限而Nexus默认配置的角色UIBasic UI Privileges 就包含了这个权限再将这个角色分配给某个用户这个用户就能访问Nexus界面了。
用户可以被赋予一个或者多个角色角色可以包含一个或者多个权限角色还可以包含一个或者多个其他角色。
Nexus预定义了三个用户以admin登录后单击页面左边导航栏中的User链接就能看到所有已定义用户的列表。
这三个用户对应了三个权限级别
admin: 该用户拥有对Nexus服务的完全控制默认密码为admin123。deployment: 该用户能够访问Nexus, 浏览仓库内容搜索并且上传部署构件但是无法对Nexus进行任何配置默认密码为deployment123。anonymous: 该用户对应了所有未登录的匿名用户它们可以浏览仓库并进行搜索。
在Users页面中管理员还可以添加用户。单击上方的Add按钮选择Nexus User,然后在用户配置面板中配置要添加用户的 ID、名称、Email、状态、密码以及包含的角色最后单击Save按钮即可。
可以单击任何一个用户然后选择页面下方的Role Tree选项卡以树形结构详细地查看该用户所包含的角色以及进一步的权限。
理解各个角色的意义对于权限管理至关重要。Nexus预定义的一些常用且重要的角色 包 括
UI: Basic UI Privileges: 包含了访问Nexus界面必须的最基本的权限UI: Repository Browser: 包含了浏览仓库页面所需要的权限UI: Search: 包含了访问快速搜索栏及搜索页面所需要的权限Repo: All Repositories(Read): 给予用户读取所有仓库内容的权限没有仓库的读权限用户将无法在仓库页面上看到实际的仓库内容也无法使用Maven从仓库下载构件Repo: All Repositories(Full Control): 给予用户完全控制所有仓库内容的权限。用户不仅可以浏览、下载构件还可以部署构件及删除仓库内容。
Nexus 包含了一个特殊的匿名用户角色 (Nexus Anonymous Role)默认配置下没有登录 的用户都会拥有该匿名角色的权限。这个匿名用户角色实际包含了上述所列角色中除Repo: All Reposiories(Full Control)之外的所有角色所包含的权限。也就是说匿名用户可以访问基本的 Nexus 界面、浏览仓库内容及搜索构件。
除上述角色之外 Nexus 还预定义了很多其他角色它们往往都对应了一个 Nexus 的功能。例如UI: Logs and Config Files包含了访问系统日志文件及配置文件所需要的权限。
7.2 为项目分配独立的仓库
在组织内部如果所有项目都部署快照及发布版构件至同样的仓库就会存在潜在的冲突及安全问题我们不想让项目A 的部署影响到项目B, 反之亦然。解决的方法就是为每个项目分配独立的仓库并且只将仓库的部署、修改和删除权限赋予该项目的成员其 他用户只能读取、下载和搜索该仓库的内容。
假设项目名称为 foo, 首先为该项目建立两个宿主仓库 Foo Snapshots 和 Foo Releases, 分别用来部署快照构件和发布构件。具体步骤见 3.3节这里不再赘述。 有了仓库之后就需要创建基于仓库的增、删、改、查权限。在Nexus 中这样的权限是基于Repository Target 建立的 Repository Target 实际上是一系列正则表达式在访问仓库某路径下内容的时候 Nexus 会将仓库路径与 Repository Target 的正则表达式 — —匹配 以检查权限是否正确。
单击左边导航栏中的Repository Targets 链接选中一个 Repository Target, 在下方可以看到它包含了一个值为“.*”的正则表达式表示该 Repository Target 能够匹配仓库下的任何路径。
下一步就是基于该Repository Target和 Foo Releases、Foo Snapshots两个仓库建立权限。单击页面左边导航栏中的Privileges 链接进入权限页面然后单击Add按钮选择Repositury Target Privilege。
选择Foo Releases仓库和 All(Maven2), 表示创建匹配 Foo Releases仓库任何路径的权限。单击Save按钮之后就能在权限列表中看到相应的增、删、改、查权限。
然后遵循同样的步骤为Foo Snapshots 建立增、删、改、查权限。下一步是创建一个包含上述权限的角色。单击导航栏中的Roles进入角色页面再单击页面上方的Add 按钮并选择Nexus Role。将之前建立的权限加入到该角色中。
角色创建完成之后根据需要将其分配给Foo项目的团队成员。这样其他团队的成员默认只能读取Foo Releases和Foo Snapshots的内容而拥有Foo Deployer角色的用户就可以执行部署构件等操作。
8️⃣ Nexus的调度任务
Nexus提供了一系列可配置的调度任务来方便用户管理系统。用户可以设定这些任务运行的方式例如每天、每周、手动等。调度任务会在适当的时候在后台运行。当然用户还是能够在界面观察它们的状态的。
要建立一个调度任务单击左边导航栏中的Scheduled Tasks链接然后在右边的界面上方单击Add按钮接着就能用户可以根据自己的需要选择任务类型并配置其运行方式。
Nexus包含了以下几种类型的调度任务
Download Indexes: 为代理仓库下载远程索引。Empty Trash: 清空Nexus的回收站一些操作(如删除仓库文件)实际是将文件移 到了回收站中。Evict Unused Proxied Items From Repository Caches: 删除代理仓库中长期未被使用的构件缓存。Expire Repository Caches: Nexus为代理仓库维护了远程仓库的信息以避免不必要的网络流量该任务清空这些信息以强制Nexus 去重新获取远程仓库的信息。Publish Indexes: 将仓库索引发布成可供 m2eclipse 和其他Nexus 使用的格式。Purge Nexus Timeline: 删除 Nexus 的时间线文件该文件用于建立系统的RSS 源。Rebuild Maven Metadata Files: 基于仓库内容重新创建仓库元数据文件 maven-meta-data.xml, 同时重新创建每个文件的校验和md5 和 sha1。Reindex Repositories: 为仓库编纂索引。Remove Snapshots From Repository: 以可配置的方式删除仓库的快照构件。Synchronize Shadow Repository: 同步虚拟仓库的内容(服务于Maven 1)。
9️⃣ 其他私服软件
Nexus 不是唯一 的Maven 私服软件正如本文一开始所提到的用户还有另外两个选 择它们分别为 Apache 的 Archiva与 JFrog的 Artifactory。
Archiva 可能是历史最长的Maven 私服软件它早在2005年就作为 Apache Maven 的 一 个子项目存在到2008年3月成为了Apache 软件基金会的顶级项目。
大家可以访问 http://archiva.apache.org 以具体了解 Archiva, 其站点提供了一些入门指南及邮件列表等信息。Archiva 的 下载地址为 http://archiva.apache.org/download.html。
在 Nexus发布之前笔者曾一度是 Artifactory 的忠实用户当时它是唯一的支持从用户 界面配置仓库的私服。 Artifactory 的一大特点是使用数据库来存储仓库内容。读者可以自行访问JFrog站点以了解更多信息 http://www.jfog.org/products.php。 Artifactory 目前的最新版本为2.2.5, 其下载地址为 http://www.jfrog.org/download.php。 总结
建立并维护自己的私服是使用Maven 必不可少的一步Maven 私服软件有 Nexus、Archiva 和 Artifactory, 它们都提供了开源的版本供用户下载。本文详细介绍了Nexus 的安装和使用包括如何分辨各种类型的仓库、如何建立仓库索引和搜索构件、如何使用权限管理功能、如何使用调度任务功能等。除了这些功能之外 Nexus 还有很多有趣的特性如 RSS 源、日志浏览及配置等用户可以从友好的界面中学习使用。
除了Nexus本身本文还详述了如何配置Maven 从私服下载构件以及如何发布构件至私服供他人使用。结合了Nexus的帮助之后再使用Maven 时就会如虎添翼。 ⏪ 温习回顾上一篇点击跳转 《【Maven教程】七聚合与继承多模块项目实用特性介绍反应堆构建及裁剪 ~》 ⏩ 继续阅读下一篇点击跳转 《【Maven教程】九》
