概要
搭建一个 nexus 的 maven 仓库。
博客
博客地址:IT老兵驿站。
前言
今年开始深度编写 Java 代码,这样就势必会遇到搭建自己的 Maven 仓库,但是 Maven 这个东西,似乎不是那么简单,可以一蹴而就的,所以,需要好好记录一下学习的笔记。
本文记录一下使用 Nexus 来搭建 Maven 的仓库的笔记,感觉不是太好记,内容太多,先走一步,看一步吧,记录一下,总比不记录要好,看来记录笔记,是有很大的学问的。
正文
安装和启动
参考这里,安装和启动,和其他的 Java 项目一样,都是非常简单的。
Maven Repository Format 格式
Maven 仓库的格式的规范。
Version policy 版本策略
Release
Maven 仓库可以被配置为 Release 版本策略。
Snapshot
Snapshot 版本策略。
Mixed
混合策略。
Release 和 Snapshot 是 Maven 的一个概念,参考官网:
What is a SNAPSHOT version?
Notice the value of the version tag in the pom.xml file shown below has the suffix: -SNAPSHOT.
在 pom.xml 中会有带有-SNAPSHOT
后缀的标记。
<project xmlns="http://maven.apache.org/POM/4.0.0"
...
<groupId>...</groupId>
<artifactId>my-app</artifactId>
...
<version>1.0-SNAPSHOT</version>
<name>Maven Quick Start Archetype</name>
...
The SNAPSHOT value refers to the 'latest' code along a development branch, and provides no guarantee the code is stable or unchanging. Conversely, the code in a 'release' version (any version value without the suffix SNAPSHOT) is unchanging.
In other words, a SNAPSHOT version is the 'development' version before the final 'release' version. The SNAPSHOT is "older" than its release.
During the release process, a version of x.y-SNAPSHOT changes to x.y. The release process also increments the development version to x.(y+1)-SNAPSHOT. For example, version 1.0-SNAPSHOT is released as version 1.0, and the new development version is version 1.1-SNAPSHOT.
SNAPSHOT 表示开发分支的最后代码,不保证代码是固定的或者不变。而位于 release 版本里面的则表示不会被修改了。
Layout policy 层级策略
Maven 仓库定义了默认的目录结构,以下的参数表示允许不允许破坏这个默认的规则。
Permissive
允许。
Strict
严格遵守。
Proxying Maven Repositories 代理 Maven 仓库
A default installation of Nexus Repository Manager includes a proxy repository configured to access the Central Repository via HTTPS using the URL https://repo1.maven.org/maven2/. To reduce duplicate downloads and improve download speeds for your developers and CI servers, you should proxy all other remote repositories you access as proxy repositories as well.
Nexus 默认会包含一个代理仓库,可以配置去访问中心仓库 https://repo1.maven.org/maven2/。这样相当于是一级缓存,不用每次都去从远程去拉取。
Hosting Maven Repositories 自主 Maven 仓库
这个地方不知道怎么去翻译这个 hosting。
这个方式可以存放第三方的库。默认会有两个仓库 maven-releases 和 maven-snapshots, 和上面的原理一样。
Grouping Maven Repositories 对仓库分组
可以把代理的和自主的仓库通过这种方式统一暴露出去。
上述这几个过程,在这个帖子都配有图来讲解,这里就不再赘述。
配置客户端
把以下内容配置在~/.m2/settings.xml
文件中,这是配置访问你的仓库的凭证,并且告诉 mvn,你的仓库是作为中心仓库的一个镜像。
<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.1.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd">
<servers>
<server>
<id>nexus-snapshots</id>
<username>admin</username>
<password>admin123</password>
</server>
<server>
<id>nexus-releases</id>
<username>admin</username>
<password>admin123</password>
</server>
</servers>
<mirrors>
<mirror>
<id>central</id>
<name>central</name>
<url>http://your-host:8081/repository/maven-group/</url>
<mirrorOf>*</mirrorOf>
</mirror>
</mirrors>
</settings>
配置项目
配置项目依赖:
<project ...>
...
<repositories>
<repository>
<id>maven-group</id>
<url>http://your-host:8081/repository/maven-group/</url>
</repository>
</repositories>
</project>
配置发布(mvn deploy):
<project ...>
...
<distributionManagement>
<snapshotRepository>
<id>nexus-snapshots</id>
<url>http://your-host:8081/repository/maven-snapshots/</url>
</snapshotRepository>
<repository>
<id>nexus-releases</id>
<url>http://your-host:8081/repository/maven-releases/</url>
</repository>
</distributionManagement>
</project>
总结
至此,大体将这个过程梳理一遍,断断续续花了不少时间,Maven 的细节比较多,还是需要时间的。
参考
https://blog.sonatype.com/using-nexus-3-as-your-repository-part-1-maven-artifacts
https://help.sonatype.com/repomanager3/formats/maven-repositories#MavenRepositories-ProxyingMavenRepositories