maven Nexus私库安装使用总结
大纲
- nexus安装总结
- nexus使用总结
- 域名配置
- admin账号密码修改
- 创建仓库组
- 创建仓库
- 创建权限
- 创建角色
- 创建用户
- mvn deploy 部署配置
nexus安装总结
本例子使用的是常见的nexus2.x版本 注意需要先安装JDK
Nexus 专业版是需要付费的，这里我们下载开源版 Nexus OSS。Nexus 提供两种安装包，一种是包含 Jetty 容器的 bundle 包，另一种是不包含容器的 war 包
相关的nexus-2.14.5-02-bundle.zip 以上传到百度云盘
nexus2.x 下载地址 https://help.sonatype.com/repomanager2/release-notes/2022-release-notes
nexus3.x 下载地址 https://help.sonatype.com/repomanager3/product-information/download
安装步骤
解压zip包
解压完以后会得到两个目录：
- nexus-2.14.5-02 (放的是nexus程序)
- sonatype-work (放的是nexus各种数据例如仓库，jar包 日志等)
sonatype-work 放的是nexus各种数据例如仓库，jar包 日志等
修改配置
可以修改nexus启动的端口，主要是修改 conf/nexus.properties
启动nexus
启动脚本保存在bin文件夹下 nexus命令， 此命令可以带多个参数 stop restart start等
如果是ROOT用户启动的话，会报错If you insist running as root, then set the environment variable RUN_AS_USER=root before running this script.
需要修改nexus命令指定RUN_AS_USER=root
启动成功后访问 http://ip:端口/nexus 默认账号密码 admin /admin123
nexus使用总结
域名配置
域名配置可以实现使用域名访问私库
点击server菜单 修改域名
保存后即可
账号密码修改
右上角的下拉菜单，点击后选择profile 可以修改admin的账号密码
创建仓库组
nexus安装完成后默认创建 Public Repositories组，我们在pom.xml配置中可以使用这个组，就可以拉取默认4个仓库的内容
例如创建一个 jim自定义组 这个组无法获取 3rd party库
分别访问
http://repositiry.neuxs.com/nexus/content/groups/jim/
http://repositiry.neuxs.com/nexus/content/groups/public/
可以看到自定义组 Jim Repositories没有三方库中的包
在项目pom.xml中可以添加repository (注意如果setting.xml中配置了mirror 则以下配置无效)
<repositories>
<repository>
<id>my-maven</id>
<name>my-maven</name>
<url>http://repositiry.neuxs.com/nexus/content/groups/jim/</url>
<layout>default</layout> <!--此配置可以不用配置 默认default default（默认）legacy（遗留 对应maven.1.x）->
<snapshots>
<enabled>true</enabled> <!--可以从这个仓库下载snapshots版本-->
<updatePolicy>always</updatePolicy> <!-- 仓库更新策略 always 或者 never -->
</snapshots>
<releases>
<enabled>true</enabled> <!--可以从这个仓库下载releases版本-->
</releases>
</repository>
</repositories>
updatePolicy可以配置仓库的更新策略 【always | daily | interval | never】
- always 是每次都去远程仓库查看是否有更新，
- daily 是只在第一次的时候查看是否有更新，当天的其它时候则不会查看；
- interval 允许设置一个分钟为单位的间隔时间，在这个间隔时间内只会去远程仓库中查找一次，
- never 是不会去远程仓库中查找
创建仓库
Nexus 2.x 默认创建了 6 个仓库，我们称它们为 Nexus 内置仓库：
- Maven Central：该仓库用来代理 Maven 中央仓库，其策略为 Release，只会下载和缓存中央仓库中的发布版本的构件
- Releases：策略为 Release 的宿主仓库，用来部署公司或组织内部的发布版本构件 （程序每一次正常版本发布都应该发布到Release库中）
- Snapshots：策略为 Snapshot 的宿主仓库，用来部署公司或组织内部的快照版本构件
- 3rd party：策略为 Release 的宿主仓库，用来部署第三方发布版本构件，这些构件一般无法从任何远程仓库中获得 （所以由公司内部人员手动上传到maven）
- Public Repositories：该仓库组将上述所有存储策略为 Release 的仓库聚合并通过统一的地址提供服务
仓库的策略：
- Release
- Snapshots
每个仓库都具有一系列属性：
- Type：仓库的类型，Nexus 中有 4 中仓库类型：group（仓库组）、hosted（宿主仓库）、proxy（代理仓库）以及 virtual（虚拟仓库）。
- Format：仓库的格式。
- Policy：仓库的策略，表示该仓库是发布（Release）版本仓库还是快照（Snapshot）版本仓库。
- Repository Status：仓库的状态。
- Repository Path：仓库的路径。
(1)hosted 类型的仓库，内部项目的发布仓库 此类仓库数据保存在安装nexus的集群上
(2)releases内部的模块中release模块的发布仓库
(3)snapshots发布内部的SNAPSHOT模块的仓库
(4)3rd party第三方依赖的仓库，这个数据通常是由内部人员自行下载之后发布上去
(5)proxy 类型的仓库，从远程中央仓库中寻找数据的仓库
(6)group 类型的仓库，组仓库用来方便我们开发人员进行设置的仓库
配置每个仓库的上传下载，是否可以部署等配置
例如创建一个Mytest 仓库类型为hosted（宿主仓库）
在项目pom.xml中可以添加repository即可使用Mytest ( 注意如果setting.xml中配置了mirror 则以下配置无效)
<repositories>
<repository>
<id>my-test</id>
<name>my-test</name>
<url>http://repositiry.neuxs.com/nexus/content/repositories/Mytest/</url>
</repository>
</repositories>
创建权限
可以给自定义的仓库创建权限 例如：给Mytest库创建
创建完成后可以看到出现对Mytest库 CRUD权限
可以基于这些新建的权限创建角色
创建角色
nexus默认创建了多种role用于管理仓库
- Nexus开头的都是关于nexus的权限
- Repo开头的都是关于仓库的权限
- UI开头的都是关于UI界面的权限
例如：
UI:Basic UIPrivileges：让用户拥有访问Nexus界面必须的最基本的权限。
UI:Repository Browser：让用户拥有访问Nexus界面浏览仓库页面所需要的权限。
Repo:All Repositories (Read)：给予用户读取所有仓库内容的权限。
没有仓库的读权限用户将无法在仓库页面看到实际的仓库内容，也无法使用Maven从仓库下载构件。
Repo:All Repositories (Full Control)：给予用户完全控制所有仓库内容的权限。
用户不仅可以浏览、下载构件，还可以部署构件及删除仓库内容。
创建自定义角色test 只能对MyTest仓库进行操作
注意：如果要mvn deploy 必须要配置create update权限
创建用户
可以创建用户，不同的用户可以有不同的操作权限
用户创建成功后可以在列表中查看用户信息，修改密码
使用新创建的用户liuyijiang登录，可以看到权限受到控制
部署发布配置
日常开发过程中常用到mvn deploy将自身的项目发布到nexus上供其他人使用
实现mvn deploy前需要注意三个点
- 1 Nexus仓库配置
- 2 项目中的pom.xml配置
- 3 maven settings.xml配置
Nexus仓库配置
注意仓库策略配置
- 1 Repository Policy
- 2 Deployment Policy
Repository Policy
- Snapshot 只能上传快照版 (即项目pom.xml中 version 字段必须是-SNAPSHOT结尾)
- Release 只能上传Release版 （version字段任意）
Deployment Policy
-
Allow Redeploy 允许重复deploy
Allow Redeploy及同一个版本号可以重复提交，一般仓库策略是Snapshot（快照版）可以允许重复deploy
-
Disable Redeploy 禁止重复deploy
Disable Redeploy及同一个版本号不能重复提交，一般仓库策略是Release，使用禁止重复deploy
-
Read Only 禁止deploy
如果不匹配Repository策略和Deployment策略 deploy时会出现 status: 400 Bad Request错误
项目中的pom.xml配置
项目的pom.xml文件中需要添加配置，用于指定发布到哪个仓库
<distributionManagement>
<repository>
<id>Mytest</id> <!--注意id 这个id在settings.xml中需要使用-->
<url>http://repositiry.neuxs.com/nexus/content/repositories/Mytest/</url> <!--配置对应的仓库地址-->
</repository>
</distributionManagement>
maven settings.xml配置
需要在maven settings.xml配置文件加入拥有对应库操作权限的用户账号密码
注意： id 就是pom.xml文件中配置的id
注意：如果账号密码配置错误或账号没有权限 deploy时会出现 status: 403 Forbidden
可以给团队每个用户创建对应的账号，配合nexus的 System Feeds 功能查看最近的deploy是哪个用户什么时候发布的
其他一些配置
配置通知邮箱
配置定时任务
常见的一些定时任务
Download Indexs：为代理仓库下载远程索引。
Empty Trash：清空Nexus的回收站，一些操作实际是将文件移到了回收站中。
Evict UnusedProxied Items From Repository Caches：删除代理仓库中长期未被使用的构件缓存。
Expire RepositoryCache：Nexus为代理仓库维护了远程仓库的信息以避免不必要的网络流量，该任务清空这些信息以强制Nexus去重新获取远程仓库的信息。
Publish Indexs：将仓库索引发布成可供m2eclipse和其他Nexus使用的格式。
Purge NexusTimeline：删除Nexus的时间线文件，该文件用于建立系统的RSS源。
Rebuild MavenMetadata Files：基于仓库内容重新创建仓库元数据文件maven-metadata.xml，同时重新创建每个文件的校验和md5与sha1。
ReIndexRepositories：为仓库编纂索引。
Remove SnapshotsFrom Repositories：以可配置的方式删除仓库的快照构件。
Synchronize ShadowRepository：同步虚拟仓库的内容（服务基于Maven1）。
mirror 与 Repository的区别
可以在maven settings.xml 配置mirror
例如在setting.xml 配置了mirror 则优先使用此次的配置
<mirrors>
<mirror>
<id>nexus</id>
<mirrorOf>*</mirrorOf>
<name>Nexus</name>
<url>http://nexus.medcrab.com/content/groups/public/</url>
</mirror>
</mirrors>
mirror相当于一个拦截器，它会拦截maven对remote repository的相关请求，把请求里的remote repository地址，重定向到mirror里配置的地址，所以如果settings.xml 中配置了mirror那么项目中的pom.xml Repository配置无效
标签里面放置的是要被镜像的Repository ID
Maven还支持更高级的镜像配置：
<mirrorOf>*</mirrorOf>
匹配所有远程仓库。
<mirrorOf>repo1,repo2</mirrorOf>
匹配仓库repo1和repo2，使用逗号分隔多个远程仓库。
<mirrorOf>*,!repo1</miiroOf>
匹配所有远程仓库，repo1除外，使用感叹号将仓库从匹配中排除。
