掌握 Maven 私服

前言

在 Java EE 开发中,我们使用 Maven 构建工具主要来管理项目的第三方库的依赖,以及公司内部其他项目服务的依赖。因此 Maven 私服就是必不可少的一环,本文主要对 Maven 私服的三大方面进行介绍:

  • 什么是 Maven 私服
  • 如何搭建 Maven 私服
  • 如何使用 Maven 私服

本文面对的读者应有 Maven 使用经验,了解 Maven 的一些基本概念,如果不太熟悉可以参见文末的参考资料学习。

什么是 Maven 私服

在介绍 Maven 私服之前,我们首先清楚下什么是 Maven 仓库。

Maven 仓库:Maven 统一存储所有Maven项目依赖,插件,以及所上传项目的地方。

并且 Maven 仓库还分成两类:本地仓库和远程仓库。

  • 本地仓库,就是我们本地电脑安装Maven后,在 配置文件 setting.xml 里 localRepository 所需要指定目录的那个文件夹。
  • 远程仓库,就是在外部网络里(包括局域网)指定 URL 的专门存放 Java 库,Maven插件等的服务器,,例如中央仓库,就是一个典型的远程仓库,它包含了世界上绝大多数开源的 Java 库,类似的还有许多其他的公开库

而本文提到的私服,就是另一种特殊的远程仓库,它通常架设在局域网内的一台服务器上,用于代理所有外部的远程仓库,并且能接受内部项目的上传和获取。

而这些仓库又有是什么用呢?当 Maven 项目需要依赖一些其他项目的 Java 库时,Maven 首先会在本地仓库查找,如果存在对应的库,就直接使用;如果本地仓库不存在,Maven 就会去远程仓库查找,找到对应的 Java 库后下载到本地仓库再使用,以便于下次需要该Java库时,直接使用缓存在本地仓库的依赖库即可,省去了重复通过网络查找并下载的时间,对于 Maven 插件也是同样的过程。

通常情况下,中央仓库是Maven 默认的远程仓库,而当引入了私服后,本地仓库查找结束未找到所需要的依赖库时,就先从私服仓库开始查找,仍未找到的话,最后再去中央仓库查找,具体过程可以参考下图:

在这里我们再看下私服的作用有哪些:

  • 内网访问,节省外网带宽。
  • 一次外网下载,内网所有用户就可以只下载私服缓存,加速 Maven 项目构建。
  • 允许上传和下载私有库,并且不被外部访问,更加安全。
  • 减少外部网络因素,提供项目构建的稳定性。
  • 方便内部项目服务的依赖引用,而不需要其他项目的完整源代码。

这里对最后一小点的作用添加下具体描述:当我们有独立的两个Maven 项目,比如订单服务项目和会员服务项目,其中订单服务项目需要会员服务,依赖会员服务的 API 包,通过私服可以将编译后的会员服务的 API 包上传,然后订单服务程序直接下载引用私服上的会员服务 API 包即可,这样就不需要导入会员服务项目代码,也不用关心会员服务具体实现了,起到了内部服务项目轻度引用的作用,描述可参见下图。

搭建 Maven 私服

了解 Maven 私服之后,我们进一步学习。我们首先来搭建一个 Maven 私服。在这里我们使用最流行的开源 Maven 仓库管理软件 - Nexus,来快速搭建 Maven 私服,传统的搭建方式为在 Nexus 官网上下载开源版的 Nexus OSS 进行安装:https://www.sonatype.com/nexus-repository-oss。而本文将采用 Docker 方式安装 Nexus,不仅快速简单,而占用更少的机器资源。

如果对 Docker 不熟悉的同学,可以参见 10分钟快速掌握Docker必备基础知识 学习了解下,简单使用 Docker 也是十分容易的。

下载 Nexus 镜像

在终端控制台上使用 Docker 指令下载 Nexus 官方提供的Docker 镜像:

看到下图结果时,就表示镜像下载完成,可以通过 docker images 查看。

启动 Nexus 容器

使用下方指令启动 Nexus 容器:

在这里对输入的 Docker 指令的参数进行简单的说明:

  • -d 表示让容器后台运行。
  • -p 8081:8081 表示了容器启动时开放内部端口 8081(后者的8081) 映射主机端口的 8081 ,即通过 localhost:8081 可以访问到 Nexus 容器所提供的服务。
  • -v /Users/One/Desktop/Nexus/nexus-data:/nexus-data 表示将容器内部 /var/nexus-data 挂载到当前主机的指定目录,需要注意的是,-v 指定的外部路径必须为全路径。
  • --restart=always 比较简单,表示当 docker 服务启动时,该容器也跟着启动。

执行上述指令后,稍等片刻,访问 http://localhost:8081/ ,看到对应的 Nexus 后台就表示私服安装完成了,是不是很简单呢。

容器启动过程中,由于机器配置的不同,可能会出现启动慢的情况,只需耐心等待即可。

启动完成后,我们可以在所挂载的本机目录下查看 Nexus 容器运行产生的文件。

配置 Maven 私服

私服安装之后,我们首先进行登录操作,点击页面左上角的 Sign In 按钮,就会出现和下图一样的提示:

说明了 Nexus 默认登录账号为 admin,并且密码位于文件 /nexus-data/admin.password 下,我们只需在本地配置的挂载目录下查看该文件即可。

输入默认的账号密码之后成功登录之后,Nexus 就会强制要求修改 admin 的密码,并且设置基本访问权限,完成之后就正式进入了 Nexus 私服后台。

这里简单对界面元素进行介绍:

  1. 默认的浏览界面,可以搜索查看仓库的组件,以及进行上传操作。
  2. 用于管理私服程序的配置。
  3. 账户信息查看,允许修改密码。

进入私服程序的配置界面,我们需要对默认配置进行几点调整。

中央仓库的代理路径设置

将私服配置里中央仓库的代理仓库路径更新为阿里云仓库提供的代理地址:https://maven.aliyun.com/repository/central 这样一来可以更快速地访问在中央仓库上所需要的依赖和插件。

新建自定义的仓库

点击Create repository,然后选择类型为 maven2(hosted)

然后输入仓库名称 private-release,并在 Version policy 一栏中选择 Release,表示这个仓库的存储依赖为正式发布的组件,然后在 Deployment policy 一栏中选择 Allow redeploy,允许部署和更新私服上的组件。

最后点击蓝色按钮-Create repository 之后,就可以在仓库列表看到自定义的仓库了,有了 release 仓库,我们再按照同样方式操作添加一个 snapshot 仓库,只需在 Version policy 一栏调整为 Snapshot 即可。

添加角色

Nexus 默认只有两种角色:nx-anonymousnx-admin,前者只有浏览的权限,后者为管理员权限,一般情况下,我们还需要正对开发人员创建个角色。点击 Create Role,添加一个 Role ID 为 developer 的自定义角色, 并且只添加自定义仓库的使用权限,删除操作除外。

保存之后,新增的角色就展示在列表中,有了角色,就可以关联用户,进行权限分配了。

添加用户

跟权限类似,默认的用户只有两种:adminanonymous,我们同样需要创建属于开发者的用户对象。点击 Create local user,填入用户名,密码等必填信息之后,关联我们先前的创建的角色,并保存即可。

用户创建完成之后,我们就可以用新的用户登录私服,查看对应权限的内容了,例如我们用新建的用户登录,所能操作的只有查看和搜索自定义的私服仓库。

这样一来我们就创建好了自己的私服仓库,配置完成之后,开发者就可以在 Maven 项目开发中使用了。

使用 Maven 私服

有了私服和用于开发的账号,我们就需要在本地 Maven 配置文件 setting.xml 进行关联。

设置 server 账户信息:

设置私服仓库地址:(这里的地址,可以通过 Nexus 后台上仓库页面的 cpoy 按钮自动复制得到)

Maven 项目部署到私服

配置完成后,我们可以创建一个Maven工程,尝试下打包到 Maven 私服。利用 IDE 快速生成 Maven 项目,在 POM 文件添加 distributionManagement 节点,并且指定对应的私服仓库 id 和地址,如下:

最后只要执行部署命令 mvn clean deploy 或者利用 IDE 的 部署插件即可,当控制台出现 BUILD SUCCESS ,如下图类似时则说明部署完成。

从日志上可以看出,我们的项目上传都了 private- snapshot 仓库下,此时我们可以在私服网站上的 private- snapshot 仓库查看到上传的 jar。

如果部署过程中出现如下提示:带有 Access denied to 则说明在 setting.xml 配置的用户权限不足,无法将 jar 部署到对应私服仓库上去。

需要注意的是,对于一个Maven项目而言,如果项目的版本号中有 “SNAPSHOT” 字样,则表示当前处于开发版本,Maven 会将发布到 snapshotRepository 节点对应地址上去。否则,Maven则认为这是一个发布版本,将程序发布到 repository 节点对应的地址上。由于示例项目的版本为 1.0.0-SNAPSHOT ,所以最终项目上传到了 private-snapshot 这个 Snapshot 类型的仓库下。

接下来如果其他项目要依赖这个 jar 时,只需要在其 POM 文件引入对应的坐标即可。

将第三方 jar 包部署到 Maven 私服

这里说到了第三方 jar 包,不是平常所提到的开源库,更多的是来自其他第三方系统的 jar 包,由于项目需要,使用项目导入的方式来很不方便,更好的处理方式就是将第三方系统的 jar 包手动上传到 Maven 私服上,需要使用的项目直接从私服仓库中拉取即可。

这种方式实现起来也比较方便,分为两种:可视化界面操作和命令行操作。

可视化界面操作:就是在 Nexus 后台上进去,执行上传操作必须要对于的上传权限才可以,一般都是管理员账号进行操作,选择仓库后进去上传页面,指定本地需要上传的项目,自定义完坐标信息保存即可。

命令行方式:直接在终端输入下面指令即可:

  • -DgroupId 和 -DartifactId 构成了该jar包在 pom.xml 的坐标, 即对应依赖的 groupIdartifactId
  • -Dfile 表示需要上传的jar包的绝对路径
  • -Durl 为私服仓库的url精确地址
  • -DrepositoryId 为私服仓库定义的id
  • -Dversion 指定了版本号
  • -Dpackaging 指定了打包方式

当控制台日志出现 BUILD SUCCESS 信息时则表示打包成功,如果出现打包失败,很有可能是 Maven 配置文件里 server 元素下的用户权限不足导致,需要 Nexus 后台对用户角色进行上传权限的分配。

结语

在 Java 企业级项目开发中,建立并维护私服是使用 Maven 必不可少的一步,本文从 Maven 的简单介绍,到快速搭建和使用来进一步掌握 Maven 私服,为后续的企业微服务架构做好铺垫。

推荐阅读

参考资料

  • Maven入门,读完这篇就够了:https://juejin.im/post/5a4a5e2bf265da4322418d7f#heading-2
  • Maven 实战:https://book.douban.com/subject/5345682/
  • 私服 maven 仓库命令上传 jar 包: https://www.jianshu.com/p/ccd7b643624c
  • What is a Maven Repository:https://medium.com/@chris.shellenbarger/what-is-a-maven-repository-6fa22991fad9

原文地址:https://www.cnblogs.com/one12138/p/11426451.html

时间: 2024-10-09 04:29:16

掌握 Maven 私服的相关文章

maven私服nexus之checksums

maven是开源的项目构建工具. nexus可以用来搭建maven私服. checksum(校验和):用于校验数据的完整性和准确性. maven nexus中可以查看构件的Checksums:SHA1 checksum和MD5  checksum. 以spring-jdbc-4.0.0.RELEASE.jar为例说明,其maven dependency如下: <dependency> <groupId>org.springframework</groupId> <

Sonatype Nexus 搭建Maven 私服

1. 为什么使用Nexus 如果没有私服,我们所需的所有构件都需要通过maven的中央仓库和第三方的Maven仓库下载到本地,而一个团队中的所有人都重复的从maven仓库下载构件无疑加大了仓库的负载和浪费了外网带宽,如果网速慢的话,还会影响项目的进程.很多情况下项目的开发都是在内网进行的,连接不到maven仓库怎么办呢?开发的公共构件怎么让其它项目使用?这个时候我们不得不为自己的团队搭建属于自己的maven私服,这样既节省了网络带宽也会加速项目搭建的进程,当然前提条件就是你的私服中拥有项目所需的

Linux下Maven私服Nexus3.x环境构建操作记录【转】

Maven介绍Apache Maven是一个创新的软件项目管理和综合工具.Maven提供了一个基于项目对象模型(POM)文件的新概念来管理项目的构建,可以从一个中心资料片管理项目构建,报告和文件.Maven最强大的功能就是能够自动下载项目依赖库.Maven提供了开发人员构建一个完整的生命周期框架.开发团队可以自动完成项目的基础工具建设,Maven使用标准的目录结构和默认构建生命周期.在多个开发团队环境时,Maven可以设置按标准在非常短的时间里完成配置工作.由于大部分项目的设置都很简单,并且可重

使用nexus搭建maven私服

使用nexus搭建maven私服 国内访问maven仓库速度渣渣,公司访问外网速度不快,即使用阿里云镜像效果也不佳.在局域网内搭建Maven私服,除了能从私服加速下载jar包,还能将内部通用模块发布在私服上供其他同事使用.对内部项目部署很有帮助. 安装和启动nexus 下载nexus-2.14.2-01-bundle.tar.gz https://www.sonatype.com/download-oss-sonatype # 添加用户 adduser nexus passwd nexus su

CentOS中用Nexus搭建maven私服,为Hadoop编译提供本地镜像

系统: CentOS release 6.6 (Final) Nexus:nexus-2.8.1-bundle.tar.gz,下载地址:https://sonatype-download.global.ssl.fastly.net/nexus/oss/nexus-2.8.1-bundle.tar.gz Java: java version "1.7.0_80" 创建目录并进入目录:mkdir /usr/local/nexus 解压文件:tar -zxvf nexus-2.8.1-bun

nexus搭建maven私服及私服jar包上传和下载

nexus搭建maven私服及私服jar包上传和下载 标签: nexus管理maven库snapshot 2017-06-28 13:02 844人阅读 评论(0) 收藏 举报 分类: Maven(1) 版权声明:本文为博主原创文章,未经博主允许不得转载. 一.nexus搭建maven私服及相关介绍 1.下载nexus-2.12.0-01-bundle.zip(版本随意) 2.以管理员身份运行cmd,cd进入解压文件的bin目录,执行nexus.bat install 若未以管理员身份运行则安装

搭建Maven私服

为什么要搭建Maven私服? (1)有些公司不允许开发人员使用外网,于是我们需要搭建一个maven的服务器我们使用. (2)公司自己搭建私服,jar会下载到公司的服务器上,这样既节省了网络带宽也会加速项目搭建的进程. 这里是用Nexus来搭建Maven服务器 1.下载Nexus 下载地址:http://www.sonatype.org/nexus/  打开以后,进行如下操作: 点击红色标记部分,进入下载界面,选择对应的服务器系统版本进行下载 下载完后nexus.zip文件后,解压自己想放置的文件

Maven学习二:使用Nexus搭建Maven私服及相关配置

处于安全等原因的考虑,一些企业内部网络是不允许访问外部网络的,但是项目内部搭建的项目又是Maven架构,这样就需要企业在内部网络中搭建自己的Maven仓库服务,再者一些大型企业或者内部模块化组件化划分的比较清楚的企业开发的一些独立组件就需要使用Maven自建仓库来存放独立组件了. 使用Nexus搭建Maven私服主要有一下步骤: 1.首先需要准备好Java环境和Maven环境环境 2.到Nexus官方网站下载最新版本的Nexus https://www.sonatype.com/download

Maven 私服配置 转

1.配置Nexus为maven的私服 第一种方式:在项目的POM中如下配置 <repositories>     <repository>         <id>nexus_public</id>                 <url>http://localhost:8081/nexus/content/groups/public/</url>                 <releases>         

在linux中使用nexus搭建maven私服

首先介绍下为什么要搭建maven私服,简单点说就是就是把项目工程中的Jar包放在一个服务器上,每次Jar包的修改都能去私服上面Down到本地.可以对整个项目组的人形成一个统一的管理. 1.下载nexus,地址:http://www.sonatype.org/nexus/go 2.下载完之后就是这个了:我这个是目前最新的版本了,下载完之后就可以它传到Linux中了,可以先在linux中创建一个目录nexus # mkdir nexus # cd nexus # rz 上传文件 # tar  xzv