赞
踩
1、 为什么使用Nexus
如果没有私服,我们所需的所有构件都需要通过maven的中央仓库和第三方的Maven仓库下载到本地,而一个团队中的所有人都重复的从maven仓库下 载构件无疑加大了仓库的负载和浪费了外网带宽,如果网速慢的话,还会影响项目的进程。很多情况下项目的开发都是在内网进行的,连接不到maven仓库怎么 办呢?开发的公共构件怎么让其它项目使用?这个时候我们不得不为自己的团队搭建属于自己的maven私服,这样既节省了网络带宽也会加速项目搭建的进程, 当然前提条件就是你的私服中拥有项目所需的所有构件。
2、Nexus下载
下载地址:Download Archives - Repository Manager 3
3、Nexus启动
我下载的是zip包,解压后进入\nexus-2.1.2-bundle\nexus-2.1.2\bin\jsw\,根据操作系统类型选择文件夹,我选的是windows-x86-32文件夹,进入后可看到如下所示bat文件。
双击console-nexus.bat运行。游览器中输入http://127.0.0.1:8081/nexus/,出现图下所示就代表nexus已经启动成功。
8081为默认的端口号,要修改端口号可进入nexus-2.1.2-bundle\nexus-2.1.2\conf\打开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,则只需修改maven\conf\setting.xml文件就可以了,如果只想对用户单独配置maven,只需将conf\setting.xml文件复制到C:\Documents and Settings\Administrator\.m2文件夹下(我这里假设系统装在c盘,用户为Administrator)。
2) 打开setting.xml文件,可以看到如下代码:
- <!-- localRepository
- | The path to the local repository maven will use to store artifacts.
- |
- | Default: ~/.m2/repository
- <localRepository></localRepository>
- -->
表示如果不设置localRepository,maven会默认将本地仓库建到/.m2/repository文件夹下。
设置localRepository如下代码所示:
<localRepository>F:\myCenterRepository</localRepository>
表示在myCenterRepository文件夹下建立本地仓库。个人建议不要采用默认的仓库地址,因为项目如果很多的话,那么本地仓库所占的磁盘空间就比较多了,所以指定仓库地址到其他盘符,更方便管理。
5.2、在POM文件中配置Nexus仓库
在项目的pom文件中添加如下代码:
- <repositories>
- <repository>
- <id>nexus</id>
- <name>my-nexus-repository</name>
- <url>http://127.0.0.1:7788/nexus/content/groups/public/</url>
- <releases>
- <enabled>true</enabled>
- </releases>
- <snapshots>
- <enabled>false</enabled>
- </snapshots>
- </repository>
- </repositories>
- <pluginRepositories>
- <pluginRepository>
- <id>nexus</id>
- <name>my-nexus-repository</name>
- <url>http://127.0.0.1:7788/nexus/content/groups/public/</url>
- <releases>
- <enabled>true</enabled>
- </releases>
- <snapshots>
- <enabled>false</enabled>
- </snapshots>
- </pluginRepository>
- </pluginRepositories>
在pom文件中配置只对当前项目有效,而实际开发中不可能在每个项目中重复配置信息,所以不建议在pom文件中配置。
5.3、在setting.xml文件中配置Nexus仓库
1)maven提供了profile来配置仓库信息,如下所示:
- <profiles>
- <profile>
- <id>myprofile</id>
- <repositories>
- <repository>
- <id>central</id>
- <url>http://central</url>
- <releases>
- <enabled>true</enabled>
- </releases>
- <snapshots>
- <enabled>true</enabled>
- </snapshots>
- </repository>
- </repositories>
- <pluginRepositories>
- <pluginRepository>
- <id>central</id>
- <url>http://central</url>
- <releases>
- <enabled>true</enabled>
- </releases>
- <snapshots>
- <enabled>false</enabled>
- </snapshots>
- </pluginRepository>
- </pluginRepositories>
- </profile>
- </profiles>
2) 激活profile
- <activeProfiles>
- <activeProfile>myprofile</activeProfile>
- </activeProfiles>
3)配置镜像
- <mirrors>
- <mirror>
- <id>nexus</id>
- <url>http://127.0.0.1:7788/nexus/content/groups/public/</url>
- <mirrorOf>*</mirrorOf>
- </mirror>
- </mirrors>
6、部署构件到Nexus仓库
6.1、maven部署
1) 修改pom文件
在pom文件中添加如下配置:
- <distributionManagement>
- <repository>
- <id>my-nexus-releases</id>
- <url>http://127.0.0.1:7788/nexus/content/repositories/releases/</url>
- </repository>
-
- <snapshotRepository>
- <id>my-nexus-snapshot</id>
- <url>http://127.0.0.1:7788/nexus/content/repositories/snapshots/</url>
- </snapshotRepository>
- </distributionManagement>
2)在setting.xml文件中添加认证信息:
- <servers>
- <server>
- <id>my-nexus-releases</id>
- <username>admin</username>
- <password>admin123</password>
- </server>
- <server>
- <id>my-nexus-snapshot</id>
- <username>admin</username>
- <password>admin123</password>
- </server>
- </servers>
上面的配置中我用的是超级管理员的账户,开发项目中可以改为具有部署构件权限的用户就可以了。
3)执行部署
测试的构件项目信息如下:
- <groupId>com.ez</groupId>
- <artifactId>TestJar</artifactId>
- <version>1.0</version>
- <packaging>jar</packaging>
- <name>TestJar</name>
从上面的信息中可以看出构件为发布版本,所以部署构件的话会自动部署至releases仓库中。
在命令行中执行:mvn clean deploy
如果之前没用执行过该命令,maven会自动到中央仓库中下载部署所需的插件。最后在命令行中看到如下所示就代表构件已经部署成功。
到nexus的releases仓库中查看刚刚部署好的构件信息如下所示:
如果部署失败的要检查一下用户是否有部署的权限,目标仓库是否允许部署,是否缺少部署所需的构件。
6.2、手动部署
手动部署构件则更为简单了,在nexus的仓库列表中点击要部署的目标仓库,然后点击Artifact Upload选项卡看到下图所示:
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中修改如下:
- <servers>
- <server>
- <id>nexus</id>
- <username>admin</username>
- <password>123456</password>
- </server>
- </servers>
-
- <mirrors>
- <mirror>
- <id>nexus</id>
- <mirrorOf>*</mirrorOf>
- <url>http://域名/nexus/repository/maven-public/</url>
- </mirror>
- </mirrors>
-
- <profiles>
- <profile>
- <id>nexus</id>
- <repositories>
- <repository>
- <id>Nexus</id>
- <url>http://域名/nexus/repository/maven-public/</url>
- <releases>
- <enabled>true</enabled>
- <updatePolicy>always</updatePolicy>
- </releases>
- <snapshots>
- <enabled>true</enabled>
- <updatePolicy>always</updatePolicy>
- </snapshots>
- </repository>
- </repositories>
- <activation>
- <activeByDefault>true</activeByDefault>
- <jdk>1.8</jdk>
- </activation>
- <properties>
- <maven.compiler.source>1.8</maven.compiler.source>
- <maven.compiler.target>1.8</maven.compiler.target>
- <maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
- </properties>
- </profile>
- </profiles>
-
- <activeProfiles>
- <activeProfile>nexus</activeProfile>
- </activeProfiles>
6.修改工程的pom.xml
如果要发布自己的jar到私服,就需要修改工程的pom.xml,添加如下内容,否则什么都不用做:
- <distributionManagement>
- <repository>
- <id>nexus</id>
- <name>Releases</name>
- <url>http://域名/nexus/repository/maven-releases</url>
- </repository>
- <snapshotRepository>
- <id>nexus</id>
- <name>Snapshot</name>
- <url>http://域名/nexus/repository/maven-snapshots</url>
- </snapshotRepository>
- </distributionManagement>
注意:上面的repository的id值一定要跟settings.xml文件中配置的server一致。上传到Nexus上,使用 mvn deploy 即可,开发的时候请使用snapshot版本,也就是version的后缀必须是-SNAPSHOT。
这时候已经搭建好了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中配置:
- <repositories>
- <repository>
- <id>maven-central</id>
- <name>maven-central</name>
- <url>http://192.168.1.28:8081/repository/maven-central/</url>
- <snapshots>
- <enabled>true</enabled>
- </snapshots>
- <releases>
- <enabled>true</enabled>
- </releases>
- </repository>
- </repositories>
Snapshot包的管理
1.先修改Maven的settings.xml文件,加入认证机制
- <servers>
- <server>
- <id>nexus</id>
- <username>admin</username>
- <password>admin123</password>
- </server>
2.修改工程的Pom文件
- <distributionManagement>
- <snapshotRepository>
- <id>nexus</id>
- <name>Nexus Snapshot</name>
- <url>http://192.168.1.28:8081/repository/maven-snapshots/</url>
- </snapshotRepository>
- <site>
- <id>nexus</id>
- <name>Nexus Sites</name>
- <url>dav:http://192.168.1.28:8081/repository/maven-snapshots/</url>
- </site>
- </distributionManagement>
注意事项:
上面修改的Pom文件如截图中的名字要跟/usr/local/maven/conf/settings.xml文件中的名字一定要对应上。
3.上传到Nexus上
先配置POM文件的头部, 根据需要自己配置版本是shapshot
- <groupid>com.woasis</groupid>
- <artifactid>test-nexus</artifactid>
- <version>1.0.0SHAPSHOT</version>
- <packaging>jar</packaging>
使用mvn deploy命令运行即可(运行结果在此略过)
最后因为Snapshot是快照版本,默认他每次会把Jar加一个时间戳,做为历史备份版本。
Releases包的管理
- <repository>
- <id>nexus</id>
- <name>Nexus Snapshot</name>
- <url>http://192.168.1.28:8081/repository/maven-releases/</url>
- </repository>
- <groupId>com.woasis</groupId>
- <artifactId>test-nexus</artifactId>
- <version>1.0.0</version>
- <packaging>jar</packaging>
现在就看我目前的配置文件就行, 亲测好使
- <settings>
- <!-- 暂不知作用 -->
- <pluginGroups>
- <pluginGroup>org.sonatype.plugins</pluginGroup>
- </pluginGroups>
-
- <!-- 必填 -->
- <servers>
- <server>
- <id>nexus</id>
- <username>admin</username>
- <password>admin123</password>
- </server>
- </servers>
-
- <mirrors>
- <mirror>
- <id>nexus</id>
- <mirrorOf>*</mirrorOf>
- <url>http://localhost:8081/repository/mygroup</url>
- </mirror>
- </mirrors>
注意: 这个地址是参照我nexus建的分组地址, 我认为分组检索比较省事, 这样写就是能够让maven直接检索我的分组里的仓库, 把需要检索的仓库都扔里就好了
下图, 把需要的仓库扔仓库组里面
- <!-- 这个就是说可以免去每个项目配置发布目录的意思, 但是需要最后activeProfiles激活-->
- <profiles>
- <profile>
- <id>nexus</id>
- <repositories>
- <repository>
- <id>central</id>
- <url>http://central</url>
- <releases>
- <enabled>true</enabled>
- </releases>
- <snapshots>
- <enabled>true</enabled>
- </snapshots>
- </repository>
- </repositories>
-
- <pluginRepositories>
- <pluginRepository>
- <id>central</id>
- <url>http://central</url>
- <releases>
- <enabled>true</enabled>
- </releases>
- <snapshots>
- <enabled>true</enabled>
- </snapshots>
- </pluginRepository>
- </pluginRepositories>
- </profile>
- </profiles>
-
- <activeProfiles>
- <activeProfile>nexus</activeProfile>
- </activeProfiles>
-
-
- </settings>
上传第三方jar到私服
mvn:deploy在整合或者发布环境下执行,将最终版本的包拷贝到远程的repository,使得其他的开发者或者工程可以共享。
以将ojdbc14传到nexus中的thirdparty为例
我的例子: nexus3 中 将ojdbc14 传到自己 建设的 3rdLibs库中
一 、配置settings.xml
因为nexus是需要登陆操作,当然可以通过配置免登陆,这是后话。
在maven的 settings.xml的<servers> </servers>中配置
- <server>
- <id>thirdparty</id>
- <username>admin</username>
- <password>admin123</password>
- </server>
如果进行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是检索分组的地址, 例如我的配置就是检索一组仓库,那么一定注意,一定要把三方库加入到分组中去
Copyright © 2003-2013 www.wpsshop.cn 版权所有,并保留所有权利。