Maven私服Nexus安装与使用

灰太狼 2020-06-18 09:16 894阅读 0赞

## Nexus介绍 ##

Nexus是Maven仓库管理器，如果你使用Maven，你可以从Maven中央仓库下载所需要的构件（artifact），但这通常不是一个好的做法，你应该在本地架设一个Maven仓库服务器，在代理远程仓库的同时维护本地仓库，以节省带宽和时间，Nexus就可以满足这样的需要。此外，他还提供了强大的仓库管理功能，构件搜索功能，它基于REST，友好的UI是一个extjs的REST客户端，它占用较少的内存，基于简单文件系统而非数据库。这些优点使其日趋成为最流行的Maven仓库管理器。除此之外，Nexus还可以管理Docker镜像。

## 私服的好处 ##

没有私服时：本地仓库没有，则去中央仓库下载

搭建私服后：本地仓库没有，再去私服下载，私服没有，再去中央仓库下载

*  减少网络带宽流量
 *  加速Maven构建
 *  部署第三方构件
 *  提高稳定性、增强控制
 *  降低中央仓库的负载

## 使用Docker安装Nexus私服 ##

> 注意：请先自行安装Docker

### 查找Nexus3镜像 ###

docker search nexus3

### 拉取Nexus3镜像 ###

docker pull sonatype/nexus3

> 注：最新版本的Nexus3.18在下载依赖时有点问题，建议安装3.17版本的Nexus
> 
> 具体报错是这样的：Caused by: org.apache.maven.wagon.authorization.AuthorizationException: Not authorized

### 查看镜像 ###

docker images

### 运行Nexus容器 ###

#进入/opt目录，创建宿主机挂载目录并设置权限
    cd /opt
    mkdir nexus-data
    chown -R 200 nexus-data
    #运行nuxus私服
    # -d：后台运行
    # -p：将容器内部端口向外映射，第一个参数是宿主机端口，第二个参数容器端口
    # --name：命名容器名称
    # --restart always在容器退出时总是重启容器
    # -v：将容器内配置、日志、数据文件等文件夹挂载到宿主机指定目录
    docker run -d --name nexus3 -p 8081:8081 --restart always -v /opt/nexus-data:/nexus-data sonatype/nexus3

如果没有设置权限，运行nexus时就会报如下错误

Warning:  Cannot open log file: ../sonatype-work/nexus3/log/jvm.log
    Warning:  Forcing option -XX:LogFile=/tmp/jvm.log
    Unable to update instance pid: Unable to create directory /nexus-data/instances
    /nexus-data/log/karaf.log (No such file or directory)
    Unable to update instance pid: Unable to create directory /nexus-data/instances
    mkdir: cannot create directory '../sonatype-work/nexus3/log': Permission denied
    mkdir: cannot create directory '../sonatype-work/nexus3/tmp': Permission denied
    OpenJDK 64-Bit Server VM warning: Cannot open file ../sonatype-work/nexus3/log/jvm.log due to No such file or directory

## 登录Nexus ##

访问web地址：`http://ip:8081`

![Nexus首次登录界面][Nexus]

从3.17版本开始默认密码不再是admin123，密码是随机生成。首次登录页面会显示admin用户的密码在/nexus-data/admin.password

> **注意**：我们刚才安装的时候把/nexus-data目录挂载到宿主机的/opt/nexus-data，所以密码在/opt/nexus-data/admin.password

执行命令vim /opt/nexus-data/admin.password，即可查看到如9c3ac7fb-4264-4457-8e48-4aa84c71e7ad这样的密码，然后登录即可。用户名：admin，密码：/opt/nexus-data/admin.password里面的密码

登录后会让用户设置新的密码。**这里把用户名和密码设置为admin/admin123**

登录后界面如下

![Nexus登录后界面][Nexus 1]

### 默认仓库说明 ###

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中使用

### 仓库类型 ###

Group：这是一个仓库聚合的概念，用户仓库地址选择Group的地址，即可访问Group中配置的，用于方便开发人员自己设定的仓库。maven-public就是一个Group类型的仓库，内部设置了多个仓库，访问顺序取决于配置顺序，3.x默认Releases，Snapshots，Central，当然你也可以自己设置。	
    Hosted：私有仓库，内部项目的发布仓库，专门用来存储我们自己生成的jar文件
    3rd party：未发布到公网的第三方jar (3.x去除了)
    Snapshots：本地项目的快照仓库
    Releases： 本地项目发布的正式版本
    Proxy：代理类型，从远程中央仓库中寻找数据的仓库（可以点击对应的仓库的Configuration页签下Remote Storage属性的值即被代理的远程仓库的路径），如可配置阿里云maven仓库
    Central：中央仓库
    Apache Snapshots：Apache专用快照仓库(3.x去除了)

## 配置阿里云公共仓库 ##

Nexus的maven-group的默认查找方式为：maven-releases --> maven-snapshots --> maven-central，我们在中间再加一个阿里云仓库，加快访问速度。

![配置阿里云公共仓库1][1]

选择proxy类型

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly90aGlua3dvbi5ibG9nLmNzZG4ubmV0_size_16_color_FFFFFF_t_70]

信息填写如下

> 仓库名字：maven-aliyun  
> 阿里云远程maven仓库地址：http://maven.aliyun.com/nexus/content/groups/public/  
> 其他选项：默认即可

![配置阿里云公共仓库3][3]

修改maven-public中的仓库引用及顺序：

![配置阿里云公共仓库4][4]

至此，配置完毕！我们在maven使用maven-public仓库地址的时候，会按照如下顺序访问：本地仓库 --> 私服maven-releases --> 私服maven-snapshots --> 远程阿里云maven仓库 --> 远程中央仓库。

## Maven配置使用Nexus私服 ##

### Maven配置私服下载依赖方式 ###

maven配置私服下载有两种方式

*  setting.xml：该文件配置的是全局模式
 *  pom.xml：该文件的配置的是项目独享模式

> 若pom.xml和setting.xml同时配置了，以pom.xml为准

#### setting.xml文件配置 ####

这个时候不需要再配置pom.xml文件，即可使用私服下载jar依赖包

##### 配置私服镜像 #####

<mirrors>   
        <mirror>
          
          <id>nexus-releases</id>
          
          <mirrorOf>*</mirrorOf>    
          
          <url>http://10.172.0.201:8081/repository/maven-public/</url>     
        </mirror>    
        <mirror>     
          <id>nexus-snapshots</id>     
          <mirrorOf>*</mirrorOf>     
          <url>http://10.172.0.201:8081/repository/maven-snapshots/</url>     
        </mirror>  
    </mirrors>

镜像的URL可以从页面中的copy按钮直接复制

![镜像的URL][URL]

##### 配置从私服下载jar包 #####

<profiles>
    
        <profile>
            
            <id>nexus</id>
            <repositories>
                <repository>
                    
                    <id>nexus-releases</id>
                    
                    <url>http://nexus-releases</url>
                    <releases>
                        
                        <enabled>true</enabled>
                    </releases>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                </repository>
                <repository>
                    <id>nexus-snapshots</id>
                    <url>http://nexus-snapshots</url>
                    <releases>
                        <enabled>true</enabled>
                    </releases>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                </repository>
            </repositories>
            <pluginRepositories>
                
                <pluginRepository>
                    
                    <id>nexus-releases</id>
                    <url>http://nexus-releases</url>
                    <releases>
                        <enabled>true</enabled>
                    </releases>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                </pluginRepository>
                <pluginRepository>
                    <id>nexus-snapshots</id>
                    <url>http://nexus-snapshots</url>
                    <releases>
                        <enabled>true</enabled>
                    </releases>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                </pluginRepository>
            </pluginRepositories>
        </profile>  
    
    </profiles>
    
    
    <activeProfiles>    
        <activeProfile>nexus</activeProfile>    
    </activeProfiles>

#### pom.xml文件配置 ####

如果你配置了pom.xml，则以pom.xml为准

<repositories>
    	<repository>
    		<id>maven-nexus</id>
    		<name>maven-nexus</name>
    		<url>http://10.172.0.201:8081/repository/maven-public/</url>
    		<releases>
    			<enabled>true</enabled>
    		</releases>
    		<snapshots>
    			<enabled>true</enabled>
    		</snapshots>
    	</repository>
    </repositories>

## 配置Maven连接私服打包上传项目 ##

第一步，修改setting.xml文件，指定releases和snapshots server的用户名和密码

<servers>
    	<server>
    		<id>releases</id>
    		<username>admin</username>
    		<password>admin123</password>
    	</server>
    	<server>
    		<id>snapshots</id>
    		<username>admin</username>
    		<password>admin123</password>
    	</server>
    </servers>

第二步，在项目的pom.xml文件中加入distributionManagement节点

> 注意：repository里的id需要和第一步里的server id名称保持一致

<distributionManagement>
    	<repository>
    		<id>releases</id>
    		<name>Releases</name>
    		<url>http://10.172.0.201:8081/repository/maven-releases/</url>
    	</repository>
    	<snapshotRepository>
    		<id>snapshots</id>
    		<name>Snapshot</name>
    		<url>http://10.172.0.201:8081/repository/maven-snapshots/</url>
    	</snapshotRepository>
    </distributionManagement>

第三步，执行发布

mvn deploy

登录Nexus，查看对应的仓库已经有相关的依赖包了。

注意以下几点：

>  *  若项目版本号末尾带有 -SNAPSHOT，则会发布到snapshots快照版本仓库
>  *  若项目版本号末尾带有 -RELEASES 或什么都不带，则会发布到releases正式版本仓库

## 上传第三方jar包 ##

![上传第三方jar包][jar]

[Nexus]: /images/1592471791160.png
[Nexus 1]: /images/1592471778832.png
[1]: /images/1592471766792.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly90aGlua3dvbi5ibG9nLmNzZG4ubmV0_size_16_color_FFFFFF_t_70]: /images/1592471752064.png
[3]: /images/1592471740160.png
[4]: /images/1592471728552.png
[URL]: /images/1592471714552.png
[jar]: /images/1592471699629.png