Skip to content

Docker compose 搭建 Maven Nexus私服

什么是 Nexus

概述

Nexus 是一个强大的仓库管理器,极大地简化了内部仓库的维护和外部仓库的访问。

2016 年 4 月 6 日 Nexus 3.0 版本发布,相较 2.x 版本有了很大的改变:

  • 对低层代码进行了大规模重构,提升性能,增加可扩展性以及改善用户体验。
  • 升级界面,极大的简化了用户界面的操作和管理。
  • 提供新的安装包,让部署更加简单。
  • 增加对 Docker, NeGet, npm, Bower 的支持。
  • 提供新的管理接口,以及增强对自动任务的管理。

基于 Docker 安装 Nexus

我们使用 Docker 来安装和运行 Nexus,docker-compose.yml 配置如下:

version: '3.1'
services:
  nexus:
    restart: always
    image: sonatype/nexus3
    container_name: nexus
    ports:
      - 7081:8081
    volumes:
      - /usr/local/docker/nexus/data:/nexus-data

注: 启动时如果出现权限问题可以使用:chmod 777 /usr/local/docker/nexus/data赋予数据卷目录可读可写的权限

登录控制台验证安装

地址:http://ip:port/用户名:admin密码:admin123在这里插入图片描述

Maven 仓库介绍

代理仓库(Proxy Repository)

意为第三方仓库,如:

  • maven-central
  • nuget.org-proxy 版本策略(Version Policy):
  • Release: 正式版本
  • Snapshot: 快照版本
  • Mixed: 混合模式 布局策略(Layout Policy):
  • Strict:严格
  • Permissive:宽松

宿主仓库(Hosted Repository)

存储本地上传的组件和资源的,如:

  • maven-releases
  • maven-snapshots
  • nuget-hosted 部署策略(Deployment Policy):
  • Allow Redeploy:允许重新部署
  • Disable Redeploy:禁止重新部署
  • Read-Only:只读

仓库组(Repository Group)

通常包含了多个代理仓库和宿主仓库,在项目中只要引入仓库组就可以下载到代理仓库和宿主仓库中的包,如:

  • maven-public
  • nuget-group

在项目中使用 Maven 私服

配置认证信息

Maven settings.xml中添加 Nexus 认证信息(servers节点下):

<server>
  <id>nexus-releases</id>
  <username>admin</username>
  <password>admin123</password>
</server>

<server>
  <id>nexus-snapshots</id>
  <username>admin</username>
  <password>admin123</password>
</server>

Snapshots 与 Releases 的区别

  • nexus-releases: 用于发布 Release 版本
  • nexus-snapshots: 用于发布 Snapshot 版本(快照版) Release 版本与 Snapshot 定义如下:
Release: 1.0.0/1.0.0-RELEASE
Snapshot: 1.0.0-SNAPSHOT
12

在项目pom.xml中设置的版本号添加SNAPSHOT标识的都会发布为 SNAPSHOT 版本,没有SNAPSHOT标识的都会发布为 RELEASE 版本。

  • Release版本的发布号1.0.0不能改变,只能换新的
  • SNAPSHOT版本会自动加一个时间作为标识,如:1.0.0-SNAPSHOT 发布后为变成 1.0.0-SNAPSHOT-20180522.123456-1.jar。如果再发布第二次,就会变成 1.0.0-SNAPSHOT-20180522.123456-2.jar

这里注意,idea 的 maven 设置中Always update snapshots要打上勾,总是使用最新的快照版本 [图片]

配置自动化部署

pom.xml中添加如下代码:

<distributionManagement>  
  <repository>  
    <id>nexus-releases</id>  
    <name>Nexus Release Repository</name>  
    <url>http://127.0.0.1:8081/repository/maven-releases/</url>  
  </repository>  
  <snapshotRepository>  
    <id>nexus-snapshots</id>  
    <name>Nexus Snapshot Repository</name>  
    <url>http://127.0.0.1:8081/repository/maven-snapshots/</url>  
  </snapshotRepository>  
</distributionManagement>

注意事项:

  • ID 名称必须要与 settings.xml 中 Servers 配置的 ID 名称保持一致。
  • 项目版本号中有 SNAPSHOT 标识的,会发布到 Nexus Snapshots Repository, 否则发布到 Nexus Release Repository,并根据 ID 去匹配授权账号。

部署到仓库

mvn deploy

上传第三方 JAR 包

Nexus 3.0 不支持页面上传,可使用 maven 命令:

# 如第三方JAR包:aliyun-sdk-oss-2.2.3.jar ^
mvn deploy:deploy-file  ^
  -DgroupId=com.aliyun.oss  ^
  -DartifactId=aliyun-sdk-oss ^
  -Dversion=2.2.3 ^
  -Dpackaging=jar ^
  -Dfile=D:\aliyun-sdk-oss-2.2.3.jar ^
  -Durl=http://192.168.206.133:8081/repository/maven-releases/ ^
  -DrepositoryId=nexus-releases

注意事项:

  • 建议在上传第三方 JAR 包时,创建单独的第三方 JAR 包管理仓库,便于管理有维护。(maven-3rd)
  • -DrepositoryId=nexus-releases对应的是 settings.xml中 Servers 配置的 ID 名称。(授权)

PS:

  • windows 在 cmd 脚本中的连接符是“^”
  • Linux 在 sh 脚本中实现的同样功能的连接符是“\”

配置代理仓库

<repositories>
    <repository>
        <id>nexus</id>
        <name>Nexus Repository</name>
        <url>http://127.0.0.1:8081/repository/maven-public/</url>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
        <releases>
            <enabled>true</enabled>
        </releases>
    </repository>
</repositories>
<pluginRepositories>
    <pluginRepository>
        <id>nexus</id>
        <name>Nexus Plugin Repository</name>
        <url>http://127.0.0.1:8081/repository/maven-public/</url>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
        <releases>
            <enabled>true</enabled>
        </releases>
    </pluginRepository>
</pluginRepositories>

文章来源于自己总结和网络转载,内容如有任何问题,请大佬斧正!联系我