1、 为什么使用Nexus
如果没有私服,我们所需的所有构件都需要通过maven的中央仓库和第三方的Maven仓库下载到本地,而一个团队中的所有人都重复的从maven仓库下 载构件无疑加大了仓库的负载和浪费了外网带宽,如果网速慢的话,还会影响项目的进程。很多情况下项目的开发都是在内网进行的,连接不到maven仓库怎么 办呢?开发的公共构件怎么让其它项目使用?这个时候我们不得不为自己的团队搭建属于自己的maven私服,这样既节省了网络带宽也会加速项目搭建的进程, 当然前提条件就是你的私服中拥有项目所需的所有构件。
2、Nexus下载
下载地址:Download Archives - Repository Manager 3
3、Nexus启动
我下载的是zip包,解压后进入nexus-2.1.2-bundlenexus-2.1.2binjsw,根据操作系统类型选择文件夹,我选的是windows-x86-32文件夹,进入后可看到如下所示bat文件。
双击console-nexus.bat运行。游览器中输入http://127.0.0.1:8081/nexus/,出现图下所示就代表nexus已经启动成功。
8081为默认的端口号,要修改端口号可进入nexus-2.1.2-bundlenexus-2.1.2conf打开nexus.properties文件,修改application-port属性值就可以了。
默认的用户名和密码:admin/admin123,登录后看到图下所示:
4、Nexus仓库
nexus的仓库类型分为以下四种:
group: 仓库组
hosted:宿主
proxy:代理
virtual:虚拟
首次登陆nexus后可以看到以下一个仓库组和多个仓库。
Public Repositories: 仓库组 3rd party: 无法从公共仓库获得的第三方发布版本的构件仓库 Apache Snapshots: 用了代理ApacheMaven仓库快照版本的构件仓库 Central: 用来代理maven中央仓库中发布版本构件的仓库 Central M1 shadow: 用于提供中央仓库中M1格式的发布版本的构件镜像仓库 Codehaus Snapshots: 用来代理CodehausMaven 仓库的快照版本构件的仓库 Releases: 用来部署管理内部的发布版本构件的宿主类型仓库 Snapshots:用来部署管理内部的快照版本构件的宿主类型仓库
4.1、创建Nexus宿主仓库
在Repositories选项页的菜单栏上点击Add按钮会出现如下所示,选择要添加的仓库类型。
这里我点击添加宿主类型的仓库,在仓库列表的下方会出现新增仓库的配置,如下所示:
点击save按钮后就会在仓库列表中看到刚才新增的仓库。
4.2、创建Nexus代理仓库
点击菜单栏上的Add按钮后选择Proxy Repository,看到如下所示配置界面:
4.3、创建Nexus仓库组
仓库组和仓库关系是一对多的关系,一个仓库组可以指向多个仓库。
点击菜单栏上的Add按钮选择Repository Group就可以看到仓库组的配置界面,如下所示:
点击save后就可在仓库列表中看到新增的仓库组了,项目中如果要下载构件的话,配置文件中一般都用仓库组的URL。
5、修改Maven配置文件从Nexus下载构件
1)如果想对操作系统的所有用户统一配置maven,则只需修改mavenconfsetting.xml文件就可以了,如果只想对用户单独配置maven,只需将confsetting.xml文件复制到C:Documents and SettingsAdministrator.m2文件夹下(我这里假设系统装在c盘,用户为Administrator)。
2) 打开setting.xml文件,可以看到如下代码:
表示如果不设置localRepository,maven会默认将本地仓库建到/.m2/repository文件夹下。
设置localRepository如下代码所示:
F:myCenterRepository
表示在myCenterRepository文件夹下建立本地仓库。个人建议不要采用默认的仓库地址,因为项目如果很多的话,那么本地仓库所占的磁盘空间就比较多了,所以指定仓库地址到其他盘符,更方便管理。
5.2、在POM文件中配置Nexus仓库
在项目的pom文件中添加如下代码:
nexus my-nexus-repository http://127.0.0.1:7788/nexus/content/groups/public/ true false nexus my-nexus-repository http://127.0.0.1:7788/nexus/content/groups/public/ true false
在pom文件中配置只对当前项目有效,而实际开发中不可能在每个项目中重复配置信息,所以不建议在pom文件中配置。
5.3、在setting.xml文件中配置Nexus仓库
1)maven提供了profile来配置仓库信息,如下所示:
myprofile central http://central true true central http://central true false
2) 激活profile
myprofile
3)配置镜像
nexus http://127.0.0.1:7788/nexus/content/groups/public/ *
6、部署构件到Nexus仓库
6.1、maven部署
1) 修改pom文件
在pom文件中添加如下配置:
my-nexus-releases http://127.0.0.1:7788/nexus/content/repositories/releases/ my-nexus-snapshot http://127.0.0.1:7788/nexus/content/repositories/snapshots/
2)在setting.xml文件中添加认证信息:
my-nexus-releases admin admin123 my-nexus-snapshot admin admin123
上面的配置中我用的是超级管理员的账户,开发项目中可以改为具有部署构件权限的用户就可以了。
3)执行部署
测试的构件项目信息如下:
com.ez TestJar1.0 jar TestJar
从上面的信息中可以看出构件为发布版本,所以部署构件的话会自动部署至releases仓库中。
在命令行中执行:mvn clean deploy
如果之前没用执行过该命令,maven会自动到中央仓库中下载部署所需的插件。最后在命令行中看到如下所示就代表构件已经部署成功。
到nexus的releases仓库中查看刚刚部署好的构件信息如下所示:
如果部署失败的要检查一下用户是否有部署的权限,目标仓库是否允许部署,是否缺少部署所需的构件。
6.2、手动部署
手动部署构件则更为简单了,在nexus的仓库列表中点击要部署的目标仓库,然后点击Artifact Upload选项卡看到下图所示:
linux安装部署:1.下载解压
wget http://download.sonatype.com/nexus/3/nexus-3.21.1-01-unix.tar.gz tar -zxf nexus-3.21.1-01-unix.tar.gz
2.配置
2.1端口及上下文路径
vim nexus/nexus-3.21.1-01/etc/ nexus-default.properties application-port=8081 application-host=192.168.1.129 nexus-args=${jetty.etc}/jetty.xml,${jetty.etc}/jetty-http.xml,${jetty.etc}/jetty-requestlog.xml nexus-context-path=/nexus # Nexus section nexus-edition=nexus-pro-edition nexus-features= nexus-pro-feature
2.2使用root运行
vim nexus/nexus-3.21.1-01/bin/nexus.rc run_as_user=root #使用root运行
2.3JVM参数
vim nexus/nexus-3.21.1-01/bin/nexus.vmoptions -Xms256m -Xmx1024m -XX:MaxDirectMemorySize=2703m -XX:+UnlockDiagnosticVMOptions -XX:+LogVMOutput -XX:LogFile=../sonatype-work/nexus3/log/jvm.log -XX:-OmitStackTraceInFastThrow -Djava.net.preferIPv4Stack=true -Dkaraf.home=. -Dkaraf.base=. -Dkaraf.etc=etc/karaf -Djava.util.logging.config.file=etc/karaf/java.util.logging.properties -Dkaraf.data=../sonatype-work/nexus3 -Dkaraf.log=../sonatype-work/nexus3/log -Djava.io.tmpdir=../sonatype-work/nexus3/tmp -Dkaraf.startLocalConsole=false # # additional vmoptions needed for Java9+ # # --add-reads=java.xml=java.logging # --add-exports=java.base/org.apache.karaf.specs.locator=java.xml,ALL-UNNAMED -Djava.util.logging.config.file=etc/karaf/java.util.logging.properties -Dkaraf.data=../sonatype-work/nexus3 -Dkaraf.log=../sonatype-work/nexus3/log -Djava.io.tmpdir=../sonatype-work/nexus3/tmp -Dkaraf.startLocalConsole=false # # additional vmoptions needed for Java9+ # # --add-reads=java.xml=java.logging # --add-exports=java.base/org.apache.karaf.specs.locator=java.xml,ALL-UNNAMED # --patch-module=java.base=lib/endorsed/org.apache.karaf.specs.locator-4.2.6.jar # --patch-module=java.xml=lib/endorsed/org.apache.karaf.specs.java.xml-4.2.6.jar # --add-opens=java.base/java.security=ALL-UNNAMED # --add-opens=java.base/java.net=ALL-UNNAMED # --add-opens=java.base/java.lang=ALL-UNNAMED # --add-opens=java.base/java.util=ALL-UNNAMED # --add-opens=java.naming/javax.naming.spi=ALL-UNNAMED # --add-opens=java.rmi/sun.rmi.transport.tcp=ALL-UNNAMED # --add-exports=java.base/sun.net.www.protocol.http=ALL-UNNAMED # --add-exports=java.base/sun.net.www.protocol.https=ALL-UNNAMED # --add-exports=java.base/sun.net.www.protocol.jar=ALL-UNNAMED # --add-exports=jdk.xml.dom/org.w3c.dom.html=ALL-UNNAMED # --add-exports=jdk.naming.rmi/com.sun.jndi.url.rmi=ALL-UNNAMED # # comment out this vmoption when using Java9+ #
2.4修改环境变量
vim /etc/profile export NEXUS_HOME=/alidata/server/nexus/nexus-3.21.1-01 export PATH=$PATH:$NEXUS_HOME/bin source /etc/profile
2.5设置开机自启动
ln -s /alidata/server/nexus/nexus-3.21.1-01/bin/nexus /etc/init.d/nexus3 chkconfig --add nexus3 chkconfig nexus3 on
2.6修改 nexus3 启动时要使用的 jdk 版本
vim /alidata/server/nexus/nexus-3.21.1-01/bin 第 14 行: INSTALL4J_JAVA_HOME_OVERRIDE=/alidata/server/jdk1.8.0_152
2.7修改 nexus3 数据以及相关日志的存储位置 (可选):
vim nexus/nexus-3.21.1-01/bin/nexus.vmoptions -XX:LogFile=./sonatype-work/nexus3/log/jvm.log -Dkaraf.data=./sonatype-work/nexus3 -Djava.io.tmpdir=./sonatype-work/nexus3/tmp
2.8启动
bin/nexus start
2.9服务器开放Nexus私服端口
(1)firewall-cmd --zone=public --add-port=8081/tcp --permanent
(2)阿里云服务器安全组配置
3.nginx代理nexus
server { listen 80; server_name 域名; location /nexus { proxy_pass http://127.0.0.1:8081; proxy_redirect off; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; client_max_body_size 300M; } }
# 重启nginx
./nginx -s reload
4.配置仓库
安装成功后有两个默认账号admin、anonymous,其中admin具有全部权限;anonymous作为匿名用户,只具有查看权限。
pepositories name属性说明 maven-central:maven中央库,默认从https://repo1.maven.org/maven2/拉取jar maven-releases:私库发行版jar maven-snapshots:私库快照(调试版本)jar maven-public:仓库分组,把上面三个仓库组合在一起对外提供服务,在本地maven基础配置settings.xml中使用。 pepositories type属性说明 group(仓库组类型):又叫组仓库,用于方便开发人员自己设定的仓库 hosted(宿主类型):内部项目的发布仓库(内部开发人员,发布上去存放的仓库) proxy(代理类型):从远程中央仓库中寻找数据的仓库(可以点击对应的仓库的Configuration页签下Remote Storage Location属性的值即被代理的远程仓库的路径) virtual(虚拟类型):虚拟仓库(这个基本用不到,重点关注上面三个仓库的使用) 一般,访问我们使用maven-public http://域名/nexus/repository/maven-public/
由于访问中央仓库有时候会比较慢,这里我添加一个阿里云的代理仓库,然后优先级放到默认中央库之前, 阿里云的maven仓库url为http://maven.aliyun.com/nexus/content/groups/public
然后再public组里面讲这个aliyun-proxy仓库加入,排在maven-central之前即可。
创建Blob Stores
文件存储的地方,创建一个目录的话,对应文件系统的一个目录,可供仓库上传文件使用,如图所示:
5. 本地Maven使用私服
在maven的默认配置settings.xml中修改如下:
nexus admin 123456 nexus * http://域名/nexus/repository/maven-public/ nexus nexus true Nexus http://域名/nexus/repository/maven-public/ true always true always 1.8 1.8 1.8 1.8
6.修改工程的pom.xml
如果要发布自己的jar到私服,就需要修改工程的pom.xml,添加如下内容,否则什么都不用做:
nexus Releases http://域名/nexus/repository/maven-releases nexus Snapshot http://域名/nexus/repository/maven-snapshots
注意:上面的repository的id值一定要跟settings.xml文件中配置的server一致。上传到Nexus上,使用 mvn deploy 即可,开发的时候请使用snapshot版本,也就是version的后缀必须是-SNAPSHOT。
仓库类型, nexus最重要的概念
这时候已经搭建好了Nexus,要做操作前先登录,默认用户名admin,默认密码admin123。来看看各个Repository。点击左侧Repositories。
hosted:本地仓库,通常我们会部署自己的构件到这一类型的仓库。比如公司的第二方库。
所有我们自己jar包都在这种类型的仓库中.
proxy:代理仓库,它们被用来代理远程的公共仓库,如maven中央仓库。
如果本地nexus仓库中没有的jar包, 会从代理仓库中取, 就是这个意思, 当然maven中央仓库在nexus中只是代理仓库中的一个, 可以设定多个代理仓库, 比如阿里云, 比较快.
group:仓库组,用来合并多个hosted/proxy仓库。
这个就是检索一组仓库, 取jar包, 这个貌似有缓存的, 我在后面的上传jar包时被坑了n个小时. 就是明明组里有设定其他hosted类型仓库, 就是不去检索那个仓库, 导致我自己上传的jar包在hosted仓库中, 明明有缺不检索, pom一直报错.
下面这张图, copy的作用, 是用来配置文件里粘贴仓库地址的(例如第三方jar上传的路径) 花圈的部分, maven项目发布时. 有一些第三方的jar或者公司的jar, 如果pom.xml里的version是带snapshots的, 会自动发布到maven-snapshots目录(jar名字后会带有时间戳,代表不同快照版本)
下面是配置
pom中配置:
maven-central maven-central http://192.168.1.28:8081/repository/maven-central/ true true
Snapshot包的管理
1.先修改Maven的settings.xml文件,加入认证机制
nexus admin admin123
2.修改工程的Pom文件
nexus Nexus Snapshot http://192.168.1.28:8081/repository/maven-snapshots/ nexus Nexus Sites dav:http://192.168.1.28:8081/repository/maven-snapshots/
注意事项:
上面修改的Pom文件如截图中的名字要跟/usr/local/maven/conf/settings.xml文件中的名字一定要对应上。
3.上传到Nexus上
先配置POM文件的头部, 根据需要自己配置版本是shapshot
com.woasis test-nexus1.0.0SHAPSHOT jar
使用mvn deploy命令运行即可(运行结果在此略过)
最后因为Snapshot是快照版本,默认他每次会把Jar加一个时间戳,做为历史备份版本。
Releases包的管理
- 与Snapshot大同小异,只是上传到私服上的Jar包不会自动带时间戳
- 与Snapshot配置不同的地方,就是工程的POM文件,加入repository配置
nexus Nexus Snapshot http://192.168.1.28:8081/repository/maven-releases/ - 发布版记得打包的时候需要把Snapshot去掉
com.woasis test-nexus1.0.0 jar 现在就看我目前的配置文件就行, 亲测好使
- 本地maven库配置settings.xml
org.sonatype.plugins nexus admin admin123 nexus * http://localhost:8081/repository/mygroup 注意: 这个地址是参照我nexus建的分组地址, 我认为分组检索比较省事, 这样写就是能够让maven直接检索我的分组里的仓库, 把需要检索的仓库都扔里就好了
下图, 把需要的仓库扔仓库组里面
nexus nexus central http://central true true central http://central true true
上传第三方jar到私服
mvn:deploy在整合或者发布环境下执行,将最终版本的包拷贝到远程的repository,使得其他的开发者或者工程可以共享。
以将ojdbc14传到nexus中的thirdparty为例
我的例子: nexus3 中 将ojdbc14 传到自己 建设的 3rdLibs库中
一 、配置settings.xml
因为nexus是需要登陆操作,当然可以通过配置免登陆,这是后话。
在maven的 settings.xml的
thirdparty admin admin123
如果进行deploy时返回Return code is: 401错误,则需要进行用户验证或者你已经验证的信息有误。
二、 cmd输入命令
mvn deploy:deploy-file -DgroupId=com.xy.Oracle -DartifactId=ojdbc14 -Dversion=10.2.0.4.0 -Dpackaging=jar -Dfile=E:ojdbc14.jar -Durl=http://localhost:9090/nexus-2.2-01/content/repositories/thirdparty/ -DrepositoryId=thirdparty
亲测: 笔记本好使的cmd命令, 我自己传的一个拼音转换jar包
mvn deploy:deploy-file -DgroupId=com.xy.pinyin -DartifactId=pinyin4j -Dversion=2.5.0 -Dpackaging=jar -Dfile=E:pinyin4j-2.5.0.jar -Durl=http://localhost:8081/repository/3rdLibs/ -DrepositoryId=nexus
DgroupId和DartifactId构成了该jar包在pom.xml的坐标,项目就是依靠这两个属性定位。自己起名字也行。 Dfile表示需要上传的jar包的绝对路径。 Durl私服上仓库的位置,打开nexus——>repositories菜单,可以看到该路径。 DrepositoryId服务器的表示id,在nexus的configuration可以看到。 Dversion表示版本信息,怎样得到一个jar包准确的版本呢? 解压该包,会发现一个叫MANIFEST.MF的文件,这个文件就有描述该包的版本信息。 比如Manifest-Version: 1.0可以知道该包的版本了。
上传成功后,在nexus界面点击3rd party仓库可以看到这包。
三、 一些问题
发现问题
在敲击该命令的时候,有时候看到提示需要POM文件,但上传包是不需要pom文件的。
可能原因
最大可能是你语句打错了如多了一个空格和换行,这样语句直接截断到换行前面,cmd就找它可以认识的语句执行,比如直接执行mvn,而mvn是对项目打包,是要pom文件的。
解决办法
耐心把命令重新敲一遍。还有如果是miror中配置了nexus是检索分组的地址, 例如我的配置就是检索一组仓库,那么一定注意,一定要把三方库加入到分组中去