服务器环境搭建-5 Nexus搭建与使用介绍

news2024/9/21 19:53:45

背景

本文介绍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依赖包。