目 录CONTENT

文章目录

Maven私服仓库nexus使用入门

大T
2022-02-10 / 0 评论 / 0 点赞 / 68 阅读 / 0 字

Maven私服仓库nexus使用入门

一、什么是nexus

1.1什么是maven私服仓

maven私服仓是指私有服务器,是架设在局域网的一种特殊的远程仓库,目的是代理远程仓库及部署第三方构建。有了私服之后,当 Maven 需要下载构件时,直接请求私服,私服上存在则下载到本地仓库;否则,私服请求外部的远程仓库,将构件下载到私服,再提供给本地仓库下载。

image

1.2 nexus是什么

nexus全称:Sonatype Nexus,是专门搭建私服的 Maven 仓库管理软件,常见的Maven仓库管理软件还有:Apache Archiva,Artifactory。

Nexus 专业版是需要付费的,这里我们使用开源版 Nexus OSS。

Nexus 提供两种安装包,一种是包含 Jetty 容器的 bundle 包,另一种是不包含容器的 war 包。

二、nexus本地搭建

2.1 准备

nexus下载地址:http://www.sonatype.org/nexus/go

下载Nexus Repository OSS版本,下载之前有个表格需要随便填一填。

image

2.2 安装步骤

下载解压后如下有两个目录:

nexus-3.37.3-02 (安装文件目录)

sonatype-work (工作目录,日志等内容)

image

  1. 将bin目录添加到环境变量,可以方便启动和退出Nexus。
  2. 修改配置文件端口号:\nexus-3.37.3-02\etc\nexus-default.properties ,修改端口号为自己想要的,这里我改为18081。

image

  1. 启动nexus,如下:nexus /run,在3.37版本中其他命令都不对!

image 启动成功控制台输出如下:

image 使用浏览器访问:http://127.0.0.1:18081/

image

  1. 执行 nexus /install 将Nexus安装为Windows服务。

image

  1. 通过运行services.msc查看服务,可将服务启动方式设为随机自动启动。

image

  1. 运行日志位置: \nexus-3.37.3-02-win64\sonatype-work\nexus3\log

三、nexus的使用

3.1 nexus登陆

访问http://127.0.0.1:18081/,后登陆,首次登陆用户为admin,密码默认在:nexus-3.37.3-02-win64\sonatype-work\nexus3\admin.password 。

密码是明文,直接复制,不要直接修改文件中的密码,修改后无效!!

image

使用初始化密码登录之后修改密码为自己想要的密码:

image

3.2 nexus 仓库说明

image

  1. Repositories name的一些说明:

1)maven-central:maven中央库,默认从https://repo1.maven.org/maven2/拉取jar

2)maven-releases:私库发行版jar

3)maven-snapshots:私库快照(调试版本)jar

4)maven-public:仓库分组,把上面三个仓库组合在一起对外提供服务,在本地maven基础配置settings.xml中使用。

  1. Nexus默认的仓库类型有以下四种:

1)group(仓库组类型):又叫组仓库,用于方便开发人员自己设定的仓库;

2)hosted(宿主类型):内部项目的发布仓库(内部开发人员,发布上去存放的仓库);

3)proxy(代理类型):从远程中央仓库中寻找数据的仓库(可以点击对应的仓库的Configuration页签下Remote Storage Location属性的值即被代理的远程仓库的路径);

4)virtual(虚拟类型):虚拟仓库(这个基本用不到,重点关注上面三个仓库的使用);

  1. 3.Policy(策略):

表示该仓库为发布(Release)版本仓库还是快照(Snapshot)版本仓库;

  1. Public Repositories下的仓库

1)3rd party: 无法从公共仓库获得的第三方发布版本的构件仓库,即第三方依赖的仓库,这个数据通常是由内部人员自行下载之后发布上去;

2)Apache Snapshots: 用了代理ApacheMaven仓库快照版本的构件仓库

3)Central: 用来代理maven中央仓库中发布版本构件的仓库

4)Central M1 shadow: 用于提供中央仓库中M1格式的发布版本的构件镜像仓库

5)Codehaus Snapshots: 用来代理CodehausMaven 仓库的快照版本构件的仓库

6)Releases: 内部的模块中release模块的发布仓库,用来部署管理内部的发布版本构件的宿主类型仓库;release是发布版本;

7)Snapshots:发布内部的SNAPSHOT模块的仓库,用来部署管理内部的快照版本构件的宿主类型仓库;snapshots是快照版本,也就是不稳定版本

所以自定义构建的仓库组代理仓库的顺序为:Releases,Snapshots,3rd party,Central。也可以使用oschina放到Central前面,下载包会更快。

  1. Nexus默认的端口是8081

可以在etc/nexus-default.properties配置中修改。

  1. 当遇到奇怪问题时,重启nexus,重启后web界面要1分钟左右后才能访问。
  2. Nexus的工作目录是sonatype-work(路径一般在nexus同级目录下)

四、Nexus和maven集成

这部分主要讲怎么和Maven做集成,集成的方式主要分以下种情况:代理中央仓库、Snapshot包的管理、Release包的管理、第三方Jar上传到Nexus上。

4.1 代理中央仓

只要在PMO文件中配置私服的地址(比如http://127.0.0.1:18081)即可,配置如下:

  <repository>
            <id>maven-central</id>
            <name>maven-central</name>
            <url>http://127.0.0.1:18081/repository/maven-central/</url>
            <snapshots>
                <enabled>true</enabled>
            </snapshots>
            <releases>
                <enabled>true</enabled>
            </releases>
        </repository>

4.2 Snapshot包的管理

修改Maven的settings.xml文件,加入认证机制。

 <server>
            <id>myserver</id>
            <username>admin</username>
            <password>123456</password>
        </server>
修改pom.xml文件

    <distributionManagement>
             <snapshotRepository>
            <!-- id 要和maven/conf/settings.xml中配置的一致-->
            <id>myserver</id>
            <url>http://127.0.0.1:18081/repository/maven-snapshots/</url>
        </snapshotRepository>
    </distributionManagement>

4.3 上传SNAPSHOT(开发版本)到Nexus上

  1. 项目编译成的jar是Snapshot(POM文件的头部)

 <groupId>com.devtao</groupId>
    <artifactId>test-everything</artifactId>
    <version>1.1.4-SNAPSHOT</version>
    <name>TestEveryThing</name>
    <description>测试Everything</description>
2. 用mvn deploy命令运行即可。

image

  1. 因为Snapshot是快照版本,默认他每次会把Jar加一个时间戳,做为历史备份版本。

image

4.4 上传Release 版本到Nexus上

  1. 与Snapshot大同小异,只是上传到私服上的Jar包不会自动带时间戳
  2. 与Snapshot配置不同的地方,就是工程的PMO文件,加入repository配置

 <distributionManagement>
        <repository>
            <!-- id 要和maven/conf/settings.xml中配置的一致-->
            <id>myserver</id>
            <url>http://127.0.0.1:18081/repository/maven-releases/</url>
        </repository>
  </distributionManagement>
3. 打包的时候需要把Snapshot去掉。 这里我使用maven-release-plugin来自动完成该步骤。

   <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-release-plugin</artifactId>
                <configuration>
                    <tagBase>${project.artifactId}-${project.version}</tagBase>
                    <!-- tag分支的名称,project.version只包含版本,不包含SNAPSHOT后缀 -->
                    <tagNameFormat>v@{project.version}</tagNameFormat>
                    <!-- 升级子模块 -->
                    <autoVersionSubmodules>true</autoVersionSubmodules>
                    <!-- 是否生成release-pom.xml-->
                    <generateReleasePoms>false</generateReleasePoms>
                    <!-- 跳过单元测试 -->
                    <arguments>-DskipTests</arguments>
                    <!-- 执行目标是install还是deploy,install安装本地,deploy部署到nexus仓 -->
                    <goals>deploy</goals>
                </configuration>
            </plugin>
注意:goals属性,执行目标是install还是deploy,install安装本地,deploy部署到nexus仓,若是install,执行mvn release:perform后不会发布到nexus仓库。

发布完成之后查看nexues的maven release仓库。

image

4.5 第三方Jar上传到Nexus

mvn deploy:deploy-file -DgroupId=org.jasig.cas.client -DartifactId=cas-client-core -Dversion=3.1.3 -Dpackag

注意事项:

-DrepositoryId=nexus 对应的就是Maven中settings.xml的认证配的名字。

五、问题处理

4.1 windows nexus启动无反应

启动命令错了,正确的是nexus.exe /run,不加斜杠没有任何反应。

4.2 nexus的登陆密码是什么

网上很多说是admin123的,其实从3.17版本后已经不是了,密码在nexus-3.37.3-02-win64\sonatype-work\nexus3\admin.password ,是明文密码,首次登陆需要登陆后通过页面进行修改,直接改配置文件无效。

0

评论区