一、私库的需求
在一个公司中,后端程序员通常几十上百个。在没有镜像私库的情况下,每当引入新库时,大家都会从maven中央仓库下载一遍这个库。这样无疑十分浪费。再加之国家的防火墙政策,许多人下载lib包可能还会十分缓慢。不同程序员会配置不同的国内镜像,有些缺乏经验的小伙伴会因为配错而程序跑不起来,这都大大降低了项目组开发的效率。
有时,公司自己会开发一些自家公司专属的lib包,推高公司的技术力。这些lib包并不想让其他公司的竞争者使用,这时通常会把这种lib包放在公司内网。我们不希望在IDEA里手动引用这些lib包,想让这些lib包和其他maven的引用方法一致。
这时,nexus就应运而生。
二、nexus的安装
2.1 下载安装
首先,我们可以去官网下载,下载后的包名叫nexus-3.72.0-04-unix.tar.gz。
把这个包拷贝到linux机器的/WORK/DOWNLOADS中
bash
cd /WORK/DOWNLOADS
tar -xzvf nexus-3.72.0-04-unix.tar.gz -C "/WORK/SOFTWARE"
cd /WORK/SOFTWARE
mkdir nexus
#然后,把那两个包移动到nexus里,一个改名为3.72,一个改名为sonatype-work
此时,已经安装好了。
2.2 配置启动
首先,先介绍一下nexus的一些重要配置文件
文件路径 | 作用 |
---|---|
3.72/bin/nexus | nexus的启动脚本 |
3.72/bin/nexus.vmoptions | nexus的JVM配置 |
3.72/etc/nexus-default.properties | nexus的配置 |
2.2.1 nexus-default.properties配置
bash
application-port=8889 #端口,这个得改了,8081
application-host=0.0.0.0
nexus-args=${jetty.etc}/jetty.xml,${jetty.etc}/jetty-http.xml,${jetty.etc}/jetty-requestlog.xml
nexus-context-path=/nexus #这个也很重要,为了配置到nginx后面
# Nexus section
nexus-edition=nexus-pro-edition
nexus-features=\
nexus-pro-feature
2.2.2 nginx配置
/WORK/APP/nginx/conf/nginx.conf
bash
location /nexus/ {
proxy_pass http://127.0.0.1:8889;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_read_timeout 90;
# 解决Nexus重定向问题,将 /nexus/ 路径传递给Nexus
#proxy_redirect http://localhost:8889/ /nexus/;
}
启动程序
bash
sysyemctl reload openresty
cd /WORK/SOFTWARE/nexus/3.72/bin
nexus start
2.2.3 自启动配置
bash
useradd nexus
passwd nexus
vim /lib/systemd/system/nexus.service
做如下配置
bash
[Unit]
Description=Nexus Repository Manager
After=network.target
[Service]
WorkingDirectory=/WORK/SOFTWARE/nexus/3.72
Type=forking
User=nexus # Nexus运行的用户,建议使用专用用户
Group=nexus # Nexus运行的用户组
# 设置Nexus安装目录和启动脚本
ExecStartPre=/bin/bash -c 'source /etc/profile'
ExecStart=/bin/bash -c 'source /etc/profile && /WORK/SOFTWARE/nexus/3.72/bin/nexus start'
ExecStop=/WORK/SOFTWARE/nexus/3.72/bin/nexus stop
Restart=on-abort
[Install]
WantedBy=multi-user.target
bash
systemctl daemon-reload
2.2.4 配置阿里云镜像
由于国内有墙的原因,可以加一个阿里云镜像
在管理界面,新增一个仓库
选择maven2 proxy类型的
而后把url设置为:https://maven.aliyun.com/repository/public
然后,修改maven-public中的组,把阿里云的放在最上面
三、私库实践
3.1 试试从私库下载
首先,我们设置一下nexus下载jar包的位置,我把位置设置在/WORK/SDK/JAVA/nexus的位置下
记得更改文件夹的所属权限(因为我用nexus用户启动的)
bash
chown -R nexus /WORK/SDK/JAVA/nexus
更改maven的配置
我的maven放在/WORK/SOFTWARE/maven
maven的配置文件做如下修改:
注意:我这里jenkins和nexus放在一个服务器里的,所以用localhost。如果不是的话,建议使用内网ip:端口
xml
<mirrors>
<mirror>
<id>nexus-repo</id>
<mirrorOf>*</mirrorOf>
<name>nexus. private maven repository</name>
<url>http:localhost:8889/nexus/repository/maven-public</url>
</mirror>
</mirrors>
<servers>
<!--该账号是普通开发者用的-->
<server>
<id>nexus-repo</id>
<username>developer</username>
<password>???@1314</password>
</server>
<!--该账号是向私库上传包用的-->
<server>
<id>nexus-repo-main</id>
<username>main-developer</username>
<password>???@1314</password>
</server>
</servers>
<profiles>
<profile>
<repositorys>
<repository>
<id>nexus-repo</id>
<url>http://localhost:8889/nexus/repository/maven-public/</url> <!-- Nexus 私库的地址 -->
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
</repositorys>
</profile>
</profiles>
为了验证是否生效,我们把本地仓库的jar包全删了
bash
rm -r /WORK/SDK/JAVA/reposity/*
再次使用jenkins编译项目,观察现象。
可以发现,jar包均从私库下载了
3.2 study2024 改造
本次,我们打算把core包分离成一个单独的项目,并且把编译好的包传到私库。
其他应用的服务,直接引用私库的core包即可,使业务开发人员不比关心那些底层细节
由于篇幅原因,本节不便赘述,还是请大家移步码云
这是原先的core包
这里多说一点,all包,仅仅就是把所有的包引用一下,方便应用程序引用
这是原先的业务包
3.3 把study2024的core包传上私库
3.3.1 zhifa-engine的pom配置
只需要在织法引擎项目中的根pom里,加入如下配置,使其中的服务id和打包机上maven配置的服务Id对应上。
如果我们设置的版本号,是snapshot时,deploy就会自动走snapshot模式。
由于本系列是学习用的,就不那么讲究了,全用正式的。当改代码时,如果没升版本,记得把本地仓库的jar包删删,不然可能会出错
xml
<distributionManagement>
<repository>
<id>nexus-repo-main</id>
<url>http://localhost:8889/nexus/repository/maven-releases/</url>
</repository>
<snapshotRepository>
<id>nexus-repo-main</id>
<url>http://localhost:8889/nexus/repository/maven-snapshots/</url>
</snapshotRepository>
</distributionManagement>
3.3.2 jenkins 管线命令
勾选This project is parameterized,添加如下参数
参数名 | 默认值 | 描述 |
---|---|---|
module | all | 上传哪个模块,可选项有common,enum-memo,mp-enhance,all |
gitTag | master | git分支 |
python
node{
stage("拉取代码"){
git branch: "${gitTag}", credentialsId: 'gitSec', url: 'https://gitee.com/hataksumo/study2024-class005.git'
}
stage("编译项目"){
sh """
cd zhifa-engine
mvn clean package -pl ${module} -am -Dmaven.test.skip=true
"""
}
stage("上传私库"){
if(module == "all"){
sh """
cd zhifa-engine
mvn deploy
"""
}else{
sh """
cd zhifa-engine
mvn deploy -pl ${module}
"""
}
}
}