Maven之Nexus局域网私服的搭建以及上传下载的测试

Maven之Nexus局域网私服的搭建

公司在自己的局域网内搭建自己的远程仓库服务器，称为私服，私服服务器即是公司内部的maven远程仓库，每个员工的电脑上安装maven软件并且连接私服服务器，员工将自己开发的项目打成jar并发布到私服服务器，其它项目组从私服服务器下载所依赖的构件（jar）。

私服还充当一个代理服务器，当私服上没有jar包会从互联网中央仓库自动下载，如下图：

                

 

搭建私服环境

• 下载nexus

Nexus 是Maven仓库管理器，通过nexus可以搭建maven仓库，同时nexus还提供强大的仓库管理功能，构件搜索功能等。

下载Nexus， 下载地址：http://www.sonatype.org/nexus/archived/

                   下载：nexus-2.12.0-01-bundle.zip

                

 

• 安装nexus

解压nexus-2.12.0-01-bundle.zip如下：

解压好后，我们进入bin目录进行安装，执行：nexus.bat install

安装成功在服务中查看有nexus服务：

 

• 卸载nexus

1. cmd进入nexus的bin目录，执行：nexus.bat uninstall
2. 之后查看window服务列表nexus已被删除。

• 启动nexus

方法1：

        cmd进入bin目录，执行nexus.bat start

方法2：

        直接启动nexus服务

        

Nexus启动后我们可以看一下他的配置文件

 

# Jetty section

application-port=8081   # nexus的访问端口配置

application-host=0.0.0.0  # nexus主机监听配置(不用修改)

nexus-webapp=${bundleBasedir}/nexus  # nexus工程目录

nexus-webapp-context-path=/nexus  # nexus的web访问路径



# Nexus section

nexus-work=${bundleBasedir}/../sonatype-work/nexus   # nexus仓库目录

runtime=${bundleBasedir}/nexus/WEB-INF  # nexus运行程序目录

 

• 访问私服：打开浏览器输入如下地址

1. http://localhost:8081/nexus/

        使用Nexus 内置账户admin/admin123登陆：

        点击右上角的Log in，输入账号和密码 登陆

        登陆成功：

nexus的仓库有4种类型：

1. hosted，宿主仓库，部署自己的jar到这个类型的仓库，包括releases和snapshot两部分，Releases公司内部发布版本仓库、 Snapshots 公司内部测试版本仓库
2. proxy，代理仓库，用于代理远程的公共仓库，如maven中央仓库，用户连接私服，私服自动去中央仓库下载jar包或者插件。
3. group，仓库组，用来合并多个hosted/proxy仓库，通常我们配置自己的maven连接仓库组。
4. virtual(虚拟)：兼容Maven1 版本的jar或者插件

nexus仓库默认在sonatype-work目录中：

• central：代理仓库，代理中央仓库

• apache-snapshots：代理仓库

          存储snapshots构件，代理地址https://repository.apache.org/snapshots/

• central-m1：virtual类型仓库，兼容Maven1 版本的jar或者插件
• releases：本地仓库，存储releases构件。
• snapshots：本地仓库，存储snapshots构件。
• thirdparty：第三方仓库
• public：仓库组

 

 

将项目发布到私服

• 需求：

1. 企业中多个团队协作开发通常会将一些公用的组件、开发模块等发布到私服供其它团队或模块开发人员使用。
2. 本例子假设多团队分别开发dao、service、web，某个团队开发完在dao会将dao发布到私服供service团队使用，本例子会将dao工程打成jar包发布到私服。

 

 

• 配置：

第一步：需要在客户端即部署dao工程的电脑上配置 maven环境，并修改 settings.xml 文件，配置连接私服的用户和密码。

此用户名和密码用于私服校验，因为私服需要知道上传都 的账号和密码 是否和私服中的账号和密码 一致。

在Maven的settings.xml文件中的<services></services>标签之间加入下面内容：

 <server>

    <id>releases</id>

    <username>admin</username>

    <password>admin123</password>

</server>

<server>

    <id>snapshots</id>

    <username>admin</username>

    <password>admin123</password>

</server>

releases 连接发布版本项目仓库

snapshots 连接测试版本项目仓库

 

第二步： 配置项目pom.xml

配置私服仓库的地址，本公司的自己的jar包会上传到私服的宿主仓库，根据工程的版本号决定上传到哪个宿主仓库，如果版本为release则上传到私服的release仓库，如果版本为snapshot则上传到私服的snapshot仓库

<distributionManagement>

    <repository>

        <id>releases</id>

        <url>http://localhost:8081/nexus/content/repositories/releases/</url>

    </repository> 


    <snapshotRepository>

        <id>snapshots</id>

        <url>http://localhost:8081/nexus/content/repositories/snapshots/</url>

    </snapshotRepository> 

</distributionManagement>

 

注意：pom.xml这里<id> 和 settings.xml 配置 <id> 对应！

• 测试：

将项目dao工程打成jar包发布到私服：

        1、首先启动nexus

        2、对dao工程执行deploy命令

• 根据本项目pom.xml中version定义决定发布到哪个仓库，如果version定义为snapshot，执行deploy后查看nexus的snapshot仓库，如果version定义为release则项目将发布到nexus的release仓库，本项目将发布到snapshot仓库：

• 然后我们到私服的解压目录下的仓库目录就可以看到，我们上传的dao模块的jar包

• 也可以通过http方式查看：

http://localhost:8081/nexus/content/repositories/snapshots/org/westos/daomodule/1.0-SNAPSHOT/

 这个http地址可以从控制台复制

 

从私服下载jar包 

• 需求：

没有配置nexus之前，如果本地仓库没有，去中央仓库下载，通常在企业中会在局域网内部署一台私服服务器，有了私服本地项目首先去本地仓库找jar，如果没有找到则连接私服从私服下载jar包，如果私服没有jar包私服同时作为代理服务器从中央仓库下载jar包，这样做的好处是一方面由私服对公司项目的依赖jar包统一管理，一方面提高下载速度，项目连接私服下载jar包的速度要比项目连接中央仓库的速度快的多。

本例子测试从私服下载dao 工程jar包。

• 管理仓库组：

nexus中包括很多仓库，hosted中存放的是企业自己发布的jar包及第三方公司的jar包，proxy中存放的是中央仓库的jar，为了方便从私服下载jar包可以将多个仓库组成一个仓库组，每个工程需要连接私服的仓库组下载jar包。

打开nexus配置仓库组，如下图：

上图中仓库组包括了本地仓库、代理仓库等。

• 在Maven的setting.xml中配置仓库：

在客户端的setting.xml中配置私服的仓库，由于setting.xml中没有repositories的配置标签需要使用profile定义仓库。

<profile>   

<!--profile的id-->

    <id>dev</id>   

    <repositories>   

      <repository>  

<!--仓库id，repositories可以配置多个仓库，保证id不重复-->

        <id>nexus</id>   

<!--仓库地址，即nexus仓库组的地址-->

        <url>http://localhost:8081/nexus/content/groups/public/</url>   

<!--是否下载releases构件-->

        <releases>   

          <enabled>true</enabled>   

        </releases>   

<!--是否下载snapshots构件-->

        <snapshots>   

          <enabled>true</enabled>   

        </snapshots>   

      </repository>   

    </repositories>  

 <pluginRepositories>  

     <!-- 插件仓库，maven的运行依赖插件，也需要从私服下载插件 -->

        <pluginRepository>  

         <!-- 插件仓库的id不允许重复，如果重复后边配置会覆盖前边 -->

            <id>public</id>  

            <name>Public Repositories</name>  

            <url>http://localhost:8081/nexus/content/groups/public/</url>  

        </pluginRepository>  

    </pluginRepositories>  

  </profile>  



使用profile定义仓库需要激活才可生效。



  <activeProfiles>

    <activeProfile>dev</activeProfile>

  </activeProfiles>

如图：

 

• 测试从私服下载jar包：

测试1：局域网环境或本地网络即可

        在service工程中添加以上配置后，添加dao工程的依赖，删除本地仓库中dao工程，同时在IDEA中删除dao模块。

观察控制台：

Downloading:http://localhost:8081/nexus/content/groups/public/cn/itcast/ssh/ssh-dao0423/0.0.1-SNAPSHOT/ssh-dao0423-0.0.1-20160702.123702-1.jar

 

项目先从本地仓库找dao，找不到从私服找，由于之前执行deploy将dao部署到私服中，所以成功从私服下载dao并在本地仓库保存一份。

如果此时删除私服中的dao，执行update project之后是否正常？

如果将本地仓库的dao和私服的dao全部删除是否正常？

如图：

删除了dao模块后 如下图：

我们再把本地仓库中的dao的jar包也删掉

现在我们运行项目，service模块要依赖于dao模块，dao模块已经被我们从本地删掉了

那么项目就会从私服上去找dao的jar包，然后把dao的jar包再下载到本地仓库，那么项目同样是能正常运行的

 

我们看一下本地仓库，刚才被我们删掉的dao 又从私服下载回来了