Docker 安装Nexus3 快速搭建Maven私有仓库 (完整详细版)

Docker 安装 (完整详细版)

Docker 日常命令大全(完整详细版)

前言

Maven的基础示意图

通常，我们开发项目并没有使用到虚线标识的那两部分，基本都是通过本机的Maven直接访问中央仓库，下载jar包到本地仓库。现在我们需要搭建中间虚线部分。 

三种专门的Maven仓库管理软件可以用来帮助大家建立私服：Apache基金会的Archiva、JFrog的Artifactory和Sonatype的Nexus。而Nexus是当前最流行的Maven仓库管理工具。

简介

nexus是一个强大的maven仓库管理器,它极大的简化了本地内部仓库的维护和外部仓库的访问.

nexus是一套开箱即用的系统不需要数据库,它使用文件系统加Lucene来组织数据

nexus使用ExtJS来开发界面,利用Restlet来提供完整的REST APIs,通过IDEA和Eclipse集成使用

nexus支持webDAV与LDAP安全身份认证.

nexus提供了强大的仓库管理功能,构件搜索功能,它基于REST,友好的UI是一个extjs的REST客户端,占用较少的内存,基于简单文件系统而非数据库.

特点：

  • 节省外网带宽。
  • 加速Maven构建。
  • 部署第三方构件。
  • 提高稳定性，增强控制。
  • 降低中央仓库的负荷。
  • 控制和审计
  • 建立本地内部公用仓库

 1、寻找Nexus镜像

 Docker 官方镜像仓库

 查找镜像

docker search sonatype/nexus3

 拉取镜像

docker pull sonatype/nexus3

持久化目录

mkdir -p /home/nexus/data
chmod 777 -R /home/nexus/data

2、启动Nexus镜像 

 启动镜像

docker run -d --name nexus3 -p 8081:8081 --restart always -v /home/nexus/data:/nexus-data sonatype/nexus3

 日志查看

docker logs -f nexus3

稍等一下，出现 Started Sonatype Nexus OSS 表示启动好了。 

3、Nexus访问

安装完成后可访问管理平台：http://ip:8081，打开浏览器，访问 http://192.168.124.184:8081/

默认管理员用户名：admin 密码：admin123，如果提示密码不对，需要到容器里面查看管理员admin密码！！！

cat /home/nexus/data/admin.password

第一次登陆之后，一般提示修改密码！修改密码之后，重新登录！！！

4、配置Nexus

默认仓库说明

maven-central：maven中央库，默认从https://repo1.maven.org/maven2/拉取jar
maven-releases：私库发行版jar，初次安装请将Deployment policy设置为Allow redeploy
maven-snapshots：私库快照（调试版本）jar
maven-public：仓库分组，把上面三个仓库组合在一起对外提供服务，在本地maven基础配置settings.xml或项目pom.xml中使用

Nexus仓库类型介绍   

hosted：本地仓库，通常我们会部署自己的构件到这一类型的仓库。比如公司的第二方库。
proxy：代理仓库，它们被用来代理远程的公共仓库，如maven中央仓库。
group：仓库组，用来合并多个hosted/proxy仓库，当你的项目希望在多个repository使用资源时就不需要多次引用了，只需要引用一个group即可。

 5、创建Blob Stores

在创建repository之前，还需要先指定文件存储目录，便于统一管理。就需要创建Blob Stores，不创建则使用的是default

可以看到blob stores有两个，一个是系统默认的，一个是刚创建的。如果不想自己创建，使用系统默认的文件存储目录也是可以的。到时候创建repository时，存储目录选择default就可以了。新创建的目录，可以在/data/blobs/目录下面可以看到。

 6、Nexus仓库

 如图所示，代理仓库负责代理远程中央仓库，托管仓库负责本地资源，组资源库 = 代理资源库 + 托管资源库

 7、创建proxy repository代理仓库

 选择maven2(proxy)，代理仓库

设置代理仓库 

其他的可以采用默认，以后需要修改的可以再修改。

这里推荐几个远程仓库：

jboss的maven中央仓库地址：http://repository.jboss.com/maven2/
阿里云的maven中央仓库地址：http://maven.aliyun.com/nexus/content/groups/public/
apache的maven中央仓库地址：http://repo.maven.apache.org/maven2/

 8、创建hosted repository仓库

Hosted有三种方式：Releases、Snapshot、Mixed

Releases: 一般是已经发布的Jar包
Snapshot: 未发布的版本
Mixed：混合的

 上图的Hosted设置选项，选项中有三个值：

Allow redeploy：允许同一个版本号下重复提交代码, nexus以时间区分
Disable redeploy：不允许同一个版本号下重复提交代码
Read-Only：不允许提交任何版本
原生的maven-releases库是Disable redeploy设置， maven-snapshots是Allow redeploy。

9、创建group repository组仓库

为什么要注意顺序？？

官方文档中建议：

It is recommended practice to place hosted repositories higher in the list than proxy repositories. For proxy repositories, the repository manager needs to check the remote repository which will incur more overhead than a hosted repository lookup.

希望将hosted repositories【托管资源库】的顺序放在proxy repositories【代理资源库】之前，因为一个group【组资源库】中可以涵括这些托管资源库和代理资源库。而一整个的group是作为一个public，一个接口给别人使用的。所以当查找架包的时候，如果代理资源库在前面，那就是先从远程去查找jar，而不是先从托管资源库（本地仓库）去查找是否有jar。这样访问外网的消耗比起来在本地查找，当然是将托管资源库放在代理资源库之前的优先位置了。

10、Maven配置

Maven下的setting.xml文件和项目中的pom.xml文件的关系是：settting.xml文件是全局设置，而pom.xml文件是局部设置。pom.xml文件对于项目来说，是优先使用的。而pom.xml文件中如果没有配置镜像地址的话，就按照settting.xml中定义的地址去查找。

 如上图方式获取组仓库smart_group的仓库地址，修改setting.xml文件如下：

<!--nexus服务器,id为组仓库name-->
  <servers>  
    <server>  
        <id>custom_group</id>  
        <username>admin</username>  
        <password>admin123</password>  
    </server>   
  </servers>  
  <!--仓库组的url地址，id和name可以写组仓库name，mirrorOf的值设置为central-->  
  <mirrors>     
    <mirror>  
        <id>custom_group</id>  
        <name>custom_group</name>  
        <url>http://192.168.124.189:8081/repository/custom_group/</url>  
        <mirrorOf>central</mirrorOf>  
    </mirror>     
  </mirrors>

 修改后可以重新编译项目，必须添加参数-U,（-U,--update-snapshots，强制更新releases、snapshots类型的插件或依赖库，否则maven一天只会更新一次snapshot依赖）。代理仓库会从远程中央仓库下载jar包

mvn clean compile -U

新建SpringBoot项目，可以查看本地仓库，远程仓库的下载的Jar包

这个时候可以看到代理仓库已经从中央仓库下载了项目编译需要的jar包。同样地，在组仓库中也能看到所有的jar包，包括代理仓库和宿主仓库的。

11、管理平台上传三方jar包 

有些jar是第三方提供的，在中央仓库中是没有的，我们可以上传这些本地三方jar包到hosted repository宿主仓库中。

上传成功后，就可以看到hosted repository和group repository中已经有了刚上传的三方jar包 

然后项目中通过编译打包就可以下载jar包到本地repository中了，记住maven   clean、compile、package首次执行时加参数-U。 

 13、命令上传三方jar包

在setting.xml配置文件中添加hosted repository server

<!--id自定义，但是在使用命令上传的时候会用到-->
<server>  
    <id>custom_hosted</id>  
    <username>admin</username>  
    <password>admin123</password>  
</server>

 使用如下命令上传jar包：

mvn deploy:deploy-file -DgroupId=byd.ghy -DartifactId=portal-auth -Dversion=1.0.0 -Dpackaging=jar -Dfile=D:\workspace_byd\workspace_ghy\workspace_portal-backend\portal-backend-jar-v2\target\auth-server.jar -Durl=http://192.168.124.189:8081/repository/custom_hosted/ -DrepositoryId=custom_hosted

命令解释：
-DgroupId=byd.ghy            　　　　 　　　　　　　 自定义
-DartifactId=portal-auth    　　　 　　　　　　　　  自定义
-Dversion=1.0.0　　　　　 　　　　　　　　　　　　　　 自定义，三个自定义，构成pom.xml文件中的标识
-Dpackaging=jar　　　　　　　　　　　　　　　　　　　　传的类型是jar类型
-Dfile=D:\auth-server.jar　　　　　　　　　　　　　   jar包的本地磁盘位置
-Durl=http://ip:8081/repository/custom_hosted/　　　hosted资源库的地址
-DrepositoryId=custom_hosted　　　　　　　　　　　　　需要和setting.xml文件中配置的ID一致

上传成功后，hosted repository中已经可以看到了

14、deploy部署jar包到私服

release和snapshots jar包区别

SNAPSHOT版本代表不稳定（快照版本），还在处于开发阶段，随时都会有变化。
当上传同样的版本号jar包的时候，SNAPSHOT会在版本号的后面自动追加一串新的数字，即日志标签，
nexus会根据日志标签区分出不同的版本，在maven引用时，如果使用的是snapshot版本，
重新导入maven的时候，会去私库拉取最新上传的代码。

RELEASE则代表稳定的版本（发布版本），一般上线后都会改用RELEASE版本。
也就是说1.0，2.0这样的版本只能有一个，也就是说当前版本号下，不可能出现不同的jar。

 创建snapshot仓库

可以在nexus上添加一个snapshot仓库，专门用于存放snapshot版本的jar包。snapshot仓库也是hosted类型的，创建方式和hosted repository类型。创建好后，加入到组仓库里面就可以了。 

 一定要选择Deployment Policy为allow redeploy

 同样的操作，创建Release类型的仓库，并加入到组中 

15、项目pom.xml文件配置 

可以在项目的pom文件中设置具体的relaeses库和snapshots库。如果当前项目的版本号的后缀名中带着-SNAPSHOT，类似<version>***-SNAPSHOT</version>，就会将项目jar包提交到snapshots库中，没有带-SNAPSHOT的话会提交releases库中。

 在pom.xml文件中配置 distributionManagement 节点如下，在项目中执行deploy命令后，jar包将会被上传到nexus中。

setting.xml中配置

<server>  
    <id>custom_snapshots</id>  
    <username>admin</username>  
    <password>admin123</password>  
</server>
<server>  
    <id>custom_releases</id>  
    <username>admin</username>  
    <password>admin123</password>  
</server>

pom.xml配置

    <repositories>
        <repository>
            <id>custom_group</id>
            <name>Nexus Repository</name>
            <url>http://192.168.124.189:8081/repository/custom_group/</url>
            <snapshots>
                <enabled>true</enabled>
            </snapshots>
            <releases>
                <enabled>true</enabled>
            </releases>
        </repository>
    </repositories>
    <pluginRepositories>
        <pluginRepository>
            <id>custom_group</id>
            <name>Nexus Plugin Repository</name>
            <url>http://192.168.124.189:8081/repository/custom_group/</url>
            <snapshots>
                <enabled>true</enabled>
            </snapshots>
            <releases>
                <enabled>true</enabled>
            </releases>
        </pluginRepository>
    </pluginRepositories>
<!--项目分发信息，在执行mvn deploy后表示要发布的位置。有了这些信息就可以把网站部署到远程服务器或者把构件jar等部署到远程仓库。 -->
    <distributionManagement>
        <repository><!--部署项目产生的构件到远程仓库需要的信息 -->
            <id>custom_releases</id><!-- 此处id和settings.xml的id保持一致 -->
            <name>Nexus Release Repository</name>
            <url>http://192.168.124.189:8081/repository/custom_releases/</url>
        </repository>
        <snapshotRepository><!--构件的快照部署到哪里？如果没有配置该元素，默认部署到repository元素配置的仓库，参见distributionManagement/repository元素 -->
            <id>custom_snapshots</id><!-- 此处id和settings.xml的id保持一致 -->
            <name>Nexus Snapshot Repository</name>
            <url>http://192.168.124.189:8081/repository/custom_snapshots/</url>
        </snapshotRepository>
    </distributionManagement>

 默认地，maven编译打包不会下载SNAPSHOT版本的jar包，所以还需要在pom.xml文件中配置支持下载snapshot版本jar包。

mvn clean deploy -Dmaven.test.skip=true

 至此，nexus搭建完毕，支持本地部署依赖jar包！！！

16、问题排查

1、nexus.log日志中报错内容如下：

UNKNOWN com.sonatype.nexus.plugins.outreach.internal.outreach.SonatypeOutreach - Could not download page bundle
java.net.SocketException: Network is unreachable (connect failed)

 解决方法：

a） 访问Nexus管理站点，我这里是 http://192.168.124.184:8081，进入后，用管理员帐号登录。

b）点击 下图中上面的按钮，然后选择左侧Capabilities，然后点击右侧的 Outreach:Management

 c）点击【disable】按钮，关闭Outreach服务

或者给Outreach设定新的URL，可以在标签页 Settings 中的 Override Outreach Content URL项中设定。Nexus支持的URL有如下三个：

  • http://links.sonatype.com and https://links.sonatype.com
  • http://download.sonatype.com and https://download.sonatype.com
  • http://sonatype-download.global.ssl.fastly.net and https://sonatype-download.global.ssl.fastly.net
     

版权声明：本文为BThinker原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接和本声明。