背景
本文介绍nexus的安装、配置和使用,之后通过案例的方式演示使用过程。
1.下载和安装
本文使用Nexus 3.x版本进行演示
下载地址:Download Nexus Repository OSS | Sonatype
国外网站下载速度较慢,也可以通过百度网盘下载(提取码:9999): nexus-3.37.3-02-unix.tar.gz。
2.安装
Nexus使用Java开发的项目,确保环境上已安装JDK
2.1 创建用户
建议使用非root用户启动Nexus(使用root时Nexus会提示不安全),这里可以提前创建一下nexus用户:
#创建nexus群组
groupadd nexus
#创建nexus用户,并指定群组为nexus
useradd nexus -g nexus
2.2 解压缩文件
准备将Nexus安装至/home/seong/nexus/
目录下,将下载的资源包上传到该目录下后,执行解压缩文件:
cd /home/seong/nexus/
tar -zxvf nexus-3.37.3-02-unix.tar.gz#更改属组
chown -R /home/seong/nexus/ nexus:nexus
得到的目录结构如下:
可以看到解压缩后有nexus-${version}
和sonatype-work
两个文件夹,前者负责存放Nexus运行时的数据(理解为数据库),后者负责功能实现(理解为程序)。
2.3 配置Nexus
配置文件在nexus文件夹下, 只需要配置两处即可:
可在etc目录下的nexus-default.properties
配置服务的监听端口,此时配置为9001:
[root@VM-4-6-centos etc]# cat nexus-default.properties
# 服务端口
application-port=9001
application-host=0.0.0.0
nexus-args=${jetty.etc}/jetty.xml,${jetty.etc}/jetty-http.xml,${jetty.etc}/jetty-requestlog.xml
# 服务路径
nexus-context-path=/# Nexus section
nexus-edition=nexus-pro-edition
nexus-features=nexus-pro-feature
nexus.hazelcast.discovery.isEnabled=true
JVM运行相关的参数以及数据存储路径可以在bin/nexus.vmoptions
文件中进行配置,此时配置堆内存使用1G, 其他使用的默认配置:
-Xms1024m
-Xmx1024m
-XX:MaxDirectMemorySize=2703m
-XX:+UnlockDiagnosticVMOptions
-XX:+LogVMOutput
-XX:LogFile=../sonatype-work/nexus3/log/jvm.log
-XX:-OmitStackTraceInFastThrow
-Djava.net.preferIPv4Stack=true
-Dkaraf.home=.
-Dkaraf.base=.
-Dkaraf.etc=etc/karaf
-Djava.util.logging.config.file=etc/karaf/java.util.logging.properties
-Dkaraf.data=../sonatype-work/nexus3
-Dkaraf.log=../sonatype-work/nexus3/log
-Djava.io.tmpdir=../sonatype-work/nexus3/tmp
-Dkaraf.startLocalConsole=false
-Djdk.tls.ephemeralDHKeySize=2048
-Djava.endorsed.dirs=lib/endorsed
2.3 运行Nexus
进入bin目录,执行运行Nexus的指令:
cd bin# 切换用户后,再启动Nexus
su nexus
./nexus start
nexus除了接收start-启动命令外,还接收stop-停止命令、restart-重启命令。
另外,调试Nexus时,可以通过./nexus run运行Nexux,可以交互式地查看启动日志。
2.4 通过页面配置Nexus
当步骤2.3中启动Nexus成功后,可通过http://ip:9001/访问Nexus:
用户名为admin, 首次登录时按照提示在服务器上得到密码,登录后需要修改密码:
输入密码后,建议选择Disable anonymous access
禁止匿名访问:
重新输入用户名和密码,再次登录即可完成安装步骤。
3.配置仓库镜像地址
按下图步骤进入Nexus的仓库配置页面:
可以看到Nexus已经帮我们创建了四个仓库:
【1】maven-central: maven中央仓库,存放第三方库依赖包(proxy类型);
【2】maven-releases:本地(私服)的发布仓库, 存放本地发布包(hosted类型);
【3】maven-snapshots:本地的快照仓库,存放本地快照包(hosted类型);
【4】maven-public:public比较特殊,是一个分组(group类型), 包括了maven-central和maven-releases和maven-snapshots,如下所示:
用户可以只依赖这个public仓库,实现在三个仓库中下载资源。逻辑是:当下载请求到达Nexus仓库时,如果是本地包,会依次尝试从maven-releases和maven-snapshots中下载;如果是第三方库,则会尝试从maven-central仓库下载,如果当前maven-central仓库已有依赖的资源,如:logback-classic:ch.qos.logback:1.2.3
已存在,则将资源返回给客户端;如果当前maven-central仓库不存在该依赖包,则Nexus会从配置的仓库下载依赖资源缓存在本地,然后再将资源返回给客户端。
maven-central仓库默认的地址为Maven中央仓库,地址在国外。因此需要为其配置镜像:
这里使用的阿里云的镜像地址: http://maven.aliyun.com/nexus/content/groups/public/.
至此,Nexus环境已经安装和配置完成。
4.本地配置Nexus仓库
在本地Maven的settings文件中配置Nexus:
<servers><server><id>nexus</id><username>admin</username><password>Nexus登录密码</password></server></servers><mirrors><mirror><id>nexus</id><name>nexus maven</name><mirrorOf>*</mirrorOf><url>http://服务器地址:9001/repository/maven-public/</url></mirror></mirrors>
配置后,以下将结合一个上传和下载案例测试Nexus是否可以正常工作。
5.案例
5.1 下载案例
由于环境是全新安装,此时maven-central仓库中没有资源:
本地创建一个maven项目, 仅添加一个日志依赖logback-classic:ch.qos.logback:1.2.3
:
<dependency><artifactId>logback-classic</artifactId><groupId>ch.qos.logback</groupId><version>1.2.3</version>
</dependency>
执行mvn clean package时,将通过本地->nexu->阿里云镜像的顺序下载依赖:
下载完成后,再次查看maven-central仓库:
此时已经将依赖资源缓存到了本地。
5.2 下载案例
新环境没有本地包上传记录,因此maven-releases和maven-snapshots记录为空:
继续5.1中的案例,将案例项目的坐标信息修改为:
<groupId>com.seong</groupId>
<artifactId>EwenFileSystem</artifactId>
<version>1.0.0</version>
并在pom.xml中添加distributionManagement指定快照和release版本包对应上传仓库的地址:
<distributionManagement><repository><id>nexus</id><name>nexus-releases</name><url>http://服务器IP:9001/repository/maven-releases/</url></repository><snapshotRepository><id>nexus</id><name>nexus-snapshots</name><url>http://服务器IP:9001/repository/maven-snapshots/</url></snapshotRepository>
</distributionManagement>
案例完整的pom文件如下:
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><groupId>com.seong</groupId><artifactId>EwenFileSystem</artifactId><version>1.0.0</version><dependencies><dependency><artifactId>logback-classic</artifactId><groupId>ch.qos.logback</groupId><version>1.2.3</version></dependency></dependencies><distributionManagement><repository><id>nexus</id><name>nexus-releases</name><url>http://服务器IP:9001/repository/maven-releases/</url></repository><snapshotRepository><id>nexus</id><name>nexus-snapshots</name><url>http://服务器IP:9001/repository/maven-snapshots/</url></snapshotRepository></distributionManagement>
</project>
执行mvn clean package打包完成后,再执行mvn deploy操作:
由于当前项目的坐标不是快照版本,deploy会将包推送至maven-releases仓库;通过Nexus网页查看仓库信息:
可以看到案例包已经成功推送到了Nexus,后续其他客户端可以从Nexus上下载EwenFileSystem依赖包。