【DevOps】Nexus制品库安装使用指南

目录

前言

安装

启动服务

使用与配置

上传构件包

---

前言

伴随着团队的微服务越来越多，测试团队也重视版本管理并要求 “所测即所得”，即SIT/UAT通过测试的二进制编译包即是上线部署包，而非重新拉取代码再打包。因此，要达到这个目标，开发这边需要做两个事情：

1、把配置从程序包中解耦。这块不是这篇文章的重点，我后续会开另外一篇说一下如何通过使用携程开源的配置中心Apollo进行解耦。（但是在2019GOPS上听到去哪儿的效能总监说，自从去哪儿和携程合并后内部也慢慢不用Apollo，而改用QConfig。）

2、编译包要通过制品库进行管理。目前用得比较多的是Nexus和Artifactory。因为本人公司主要是用Nexus的，因此就用Nexus进行讲解。

安装

1、下载地址：https://www.sonatype.com/download-oss-sonatype    （这里我使用3.16.0版本进行演示）

2、解压tar包并在解压后会多了两个文件夹

文件夹	作用
nexus-3.16.0-01	核心
sonatype-work	maven下载jar存放地址

 

 

 

 

[xxxx@localhost opt]# tar -zxvf /tmp/nexus-3.16.0-01-unix.tar.gz
nexus-3.16.0-01/.install4j/9d17dc87.lprop
nexus-3.16.0-01/.install4j/MessagesDefault
nexus-3.16.0-01/.install4j/build.uuid
nexus-3.16.0-01/.install4j/i4j_extf_0_17is1ik.utf8
.....
sonatype-work/nexus3/log/.placeholder
sonatype-work/nexus3/orient/plugins/studio.zip
sonatype-work/nexus3/tmp/.placeholder

[xxxx@localhost opt]# ls -alrt
total 0
dr-xr-xr-x. 17 root root 224 Mar 29 20:42 ..
drwxr-xr-x.  9 root root 163 Apr 12 22:59 nexus-3.16.0-01
drwxr-xr-x.  3 root root  20 Apr 12 22:59 sonatype-work

启动服务

1、进入Nexus的bin文件夹并启动服务。

[root@localhost nexus-3.16.0-01]# java -version
openjdk version "1.8.0_201"
OpenJDK Runtime Environment (build 1.8.0_201-b09)
OpenJDK 64-Bit Server VM (build 25.201-b09, mixed mode)
[root@localhost nexus-3.16.0-01]# ./bin/nexus start
WARNING: ************************************************************
WARNING: Detected execution as "root" user.  This is NOT recommended!
WARNING: ************************************************************
Starting nexus

2、如有你想忽略该警告，可以通过修改nexus配置。 

[root@localhost nexus-3.16.0-01]# vi bin/nexus

---------------------------------------------------------
# user to execute as; optional but recommended to set
#run_as_user=''
run_as_user=root

3、重启

[root@localhost nexus-3.16.0-01]# ./bin/nexus start
WARNING: ************************************************************
WARNING: Detected execution as "root" user.  This is NOT recommended!
WARNING: ************************************************************
Starting nexus
[root@localhost nexus-3.16.0-01]#

4、常见命令

bin/nexus {start|stop|run|run-redirect|status|restart|force-reload}

查看防火墙状态
查看防火墙状态 systemctl status firewalld
开启防火墙 systemctl start firewalld  
关闭防火墙 systemctl stop firewalld
开启防火墙 service firewalld start 
若遇到无法开启
先用：systemctl unmask firewalld.service 
然后：systemctl start firewalld.service

5、常见问题

5.1 即使nexus已经启动成功，但是web端访问还是报超时，一般情况就是端口没有开放。

#查询指定端口是否已开 （yes表示开启；no表示未开启）
firewall-cmd --query-port=666/tcp

#假若没有开启

#添加指定需要开放的端口：
firewall-cmd --add-port=666/tcp --permanent
#重载入添加的端口：
firewall-cmd --reload
#查询指定端口是否开启成功：
firewall-cmd --query-port=666/tcp

使用与配置

1、输入http://localhost:8081/，登录并显示以下界面证明Nexus安装并启动成功。

onboard

2、使用admin/admin123进行登录。

signed-in

3、然后创建三种不同类型的仓库（Hosted、Proxy、Group），每个仓库的格式为maven2或者maven1，同时仓库还有一个Policy（策略）的属性，它表示该仓库为发布（Release）版本仓库还是快照（Snapshot）版本仓库。最后两列的值为仓库的状态和路径。具体每种仓库的描述可以参考以下表格。

值得注意的是，仓库组所包含的仓库的顺序决定了仓库组遍历其所含仓库的次序，因此最好将常用的仓库放在前面，当用户从仓库组下载构件的时候，就能够尽快地访问到包含构件的仓库。

种类	作用
group(仓库组类型)	组仓库，用于方便开发人员自己设定的仓库
hosted(宿主类型)	内部项目的发布仓库，一般用于内部开发人员发布上去存放程序包的仓库。其中根据版本分为两类： Release：用于版本发布的仓库 Snapshot：用于开发、调试、测试的仓库
proxy(代理类型)	从远程中央仓库中寻找数据的仓库，一般用于从远程拉取jar包
virtual(虚拟类型)	虚拟仓库，一般不怎么用到

 

 

 

 

 

 

创建远程仓库

创建宿主快照仓库

创建宿主发布仓库

创建组合仓库

 

上传构件包

1、配置pom.xml与setting.xml。

setting.xml：配置nexus私库的登录账户与密码。

<server>
      <id>release</id>  <!--对应pom.xml的id=releases的仓库-->
      <username>XXXXX</username>
      <password>YYYYYYYY</password>
</server>
<server>
      <id>snapshot</id> <!--对应pom.xml中id=snapshots的仓库-->
      <username>XXXXX</username>
      <password>YYYYYYYY</password>
</server>

pom.xml：用于配置

<distributionManagement>
    <repository>
        <!--id的名字可以任意取，但是在setting文件中的属性<server>的ID与这里一致-->
        <id>release</id>
        <!--指向仓库类型为host(宿主仓库）的Release仓库，这里我仓库为team-release-->
        <url>http://{ip}:{port}/repository/team-release/</url>
    </repository>
    <snapshotRepository>
        <id>snapshot</id>
        <!--指向仓库类型为host(宿主仓库）的Snapshot仓库，这里我仓库为team-snapshot-->
        <url>http://{ip}:{port}/repository/team-snapshot/</url>
    </snapshotRepository>
</distributionManagement>

2、在项目的根目录下执行以下命令：

mvn clean source:jar package
mvn deploy -e

3、当命令执行成功后会看到以下日志：

另外：maven会判断版本后面是否带了-SNAPSHOT，如果带了就发布到snapshots仓库，否则发布到release仓库。

mvn deploy -e

4、通过日志发现该源代码包与程序包部署到nexus私服成功，并存到releas仓库。我们到私服查看确认无误。

该程序包已经被上传到Nexus的team-release仓库