Maven 作为 Java 项目管理工具,它不仅可以用作包管理,还有许多的插件,可以支持整个项目的开发、打包、测试、部署等一系列行为。
而包管理又是其核心功能,除非是个人项目,我们获取包都是从中央仓库(或者 github 获取,但是公司项目呢,为了提供高速,一般都会搭建公司内部或者团队内部的 Maven 私服仓库。
首先要吐槽官网慢的一比,下载不下来。
地址:https://www.sonatype.com/
下载地址:https://www.sonatype.com/download-nexus-repo-oss
版本/收费/免费:Nexus Repository Manager 仓库管理有2个版本,专业版和oss版,oss版是免费的,专业版是收费的,我们使用oss版。
nexus是一个强大的maven仓库管理器,它极大的简化了本地内部仓库的维护和外部仓库的访问.
nexus是一套开箱即用的系统不需要数据库,它使用文件系统加Lucene来组织数据
nexus使用ExtJS来开发界面,利用Restlet来提供完整的REST APIs,通过IDEA和Eclipse集成使用
nexus支持webDAV与LDAP安全身份认证.
nexus提供了强大的仓库管理功能,构件搜索功能,它基于REST,友好的UI是一个extjs的REST客户端,占用较少的内存,基于简单文件系统而非数据库.
私服仓库的工作流程
Nexus 是用来搭建 Maven 私服的,可以说是最好的免费工具了,它的官网上是这样说的:“世界上第一个也是唯一的免费使用的仓库解决方案”。目前的最新版本是 OSS 3.x。提供了针对 Windows、Unix、OS X 三种系统的版本。
这里只简单说明 Linux 下的安装方式,如果是下载的最新版本,它对系统内存和 jdk 版本是有要求的,要求内存大于4G,jdk 最低是1.8版本。
下载包,并解压缩,运行命令
tar -zxvf nexus-version-unix.tar.gz
进入 nexus-version/bin/`` 目录,执行命令
./nexus start`
访问 默认的 8081 端口即可
没错,就是这么简单。
通常情况下,以上三步就可以完成安装,如果有问题,并且提示“ NOT RECOMMENDED TO RUN AS ROOT ”,可以通过修改 /bin/nexus
文件,在其中加入 RUN_AS_USER=root
,然后重新启动即可。
另外,如果是 docker 环境,可以直接获取 nexus 的镜像完成安装。https://hub.docker.com/r/sonatype/nexus3
mkdir nexus-data && chown -R 200 nexus-data
docker run -d -p 8081:8081 --name nexus -v nexus-data:/nexus-data sonatype/nexus3
当我们通过地址,在浏览器上访问 nexus 的首页,是下图这样子的:
默认的账号名是 admin
,密码是 再这个文件里**/nexus-data/admin.password**
。管理员登录后,可以在设置页面管理角色、用户等其他一系列的操作。例如创建一个角色,给角色设置某一仓库的管理权限,然后向这个角色中添加人员。具体操作不做过多介绍,一看就明白。
管理员还可以管理仓库,不过一般来说,默认的那几个仓库就可以了。默认有如下几个仓库:
proxy:这是代理方式,它是用来代理中央仓库的,例如我们依赖的包在本地仓库没有,就会到私服获取,私服没有的话,会到中央仓库先把包下载到这里,然后再下载到本地仓库;
hosted:指的是我们公司或团队内部的包,并且 hosted 类型的仓库会分为 releases 和 snapshots 两个,前者是正式版,后者一般是开发测试版;
group:它的目的就是把多个仓库组合起来,然后我们项目中只需要配置上这个类型的仓库地址,就可以把它里面组合的几个仓库都关联上。
我们前面讲到类型为hosted的为本地仓库,Nexus预定义了3个本地仓库,分别是Releases, Snapshots, 3rd Party. 分别讲一下这三个预置的仓库都是做什么用的:
Releases: 这里存放我们自己项目中发布的构建, 通常是Release版本的, 比如我们自己做了一个FTP Server的项目, 生成的构件为ftpserver.war, 我们就可以把这个构建发布到Nexus的Releases本地仓库. 关于符合发布后面会有介绍.
**Snapshots:**这个仓库非常的有用, 它的目的是让我们可以发布那些非release版本, 非稳定版本, 比如我们在trunk下开发一个项目,在正式release之前你可能需要临时发布一个版本给你的同伴使用, 因为你的同伴正在依赖你的模块开发, 那么这个时候我们就可以发布Snapshot版本到这个仓库, 你的同伴就可以通过简单的命令来获取和使用这个临时版本.
**3rd Party:**顾名思义, 第三方库, 你可能会问不是有中央仓库来管理第三方库嘛,没错, 这里的是指可以让你添加自己的第三方库, 比如有些构件在中央仓库是不存在的. 比如你在中央仓库找不到Oracle 的JDBC驱动, 这个时候我们就需要自己添加到3rdparty仓库。
maven-central:maven中央库,默认从https://repo1.maven.org/maven2/拉取jar
maven-releases:私库发行版jar
maven-snapshots:私库快照(调试版本)jar
maven-public:仓库分组,把上面三个仓库组合在一起对外提供服务,在本地maven基础配置settings.xml中使用。
如果不够用,自己也可以根据博文上面的仓库类型进行选用创建。
如果是普通项目成员,不需要向私服发布包的,只需要在 pom 文件中加入以下配置即可。
maven-public
maven-public
http://nexus.local:32768/repository/maven-public/
true
其中 id 要和你的仓库名称一致,url 就是私服的仓库地址,就是 type 为 group 的那个,它组合了一个 proxy 类型的和两个 hosted 类型的仓库。设置 snapshots 的 enabled 为ture,表示允许下载 snapshots 版本的包。
maven-public 默认配置 Group 。Members有顺序之分。
打开 maven 的配置文件 setting.xml
,找到 servers
节点,然后在其中添加一个 server
节点。
用户名和密码也可以是管理员账号,或者管理员新创建的账号,制药对仓库有添加权限即可。
nexus-releases
admin
admin123
nexus-snapshots
admin
admin123
请注意上面的 id,一会儿在 pom 文件中还会用到。
然后需要在 pom 文件中配置下面的内容:
nexus-releases maven-releases http://nexus.local:8081/repository/maven-releases/ nexus-snapshots maven-snapshots http://nexus.local:8081/repository/maven-snapshots/我们看到其中配置了一个 repository ,另外还有一个 snapshotRepository,上面表示的是 releases 版。同样注意 id 要和 setting.xml 里 server 下的 id 一致,不然会出现权限问题。url 分别指定 maven-releases 和 maven-snapshots 的地址。
只要在项目中配置 1.0-SNAPSHOT 这样,带有 SNAPSHOT 的就会到 snapshots 仓库,如果不加 SNAPSHOT 就会到 releases 仓库。
还有要注意的是,你要发布的包不应该是上级,也就是不能有 parent 依赖。否则在获取依赖的时候会有问题。
最后执行 mvn clean deploy
命令,即可发布包到私服仓库中。
通过以上配置和操作,就可以完成包的发布过程。
D:Maven
epository
nexus_release
admin
admin123
nexus_snapshots
admin
admin123
nexus
nexus_release
nexus_repo
http://192.168.1.13:8081/nexus/content/groups/public
default
true
never
warn
true
always
warn
nexus_release
Maven China Mirror
http://192.168.1.13:8081/nexus/content/groups/public
true
true
nexus
Nexus 3.x取消默认的deployment角色,需要手动添加deployment角色,只需要配置如下权限即可!
(1)针对指定仓库权限
nx-component-upload
nx-repository-view-maven2-maven-public-*
nx-repository-view-maven2-maven-releases-*
nx-repository-view-maven2-maven-snapshots-*
(2)针对所有仓库权限
nx-component-upload
nx-repository-view-maven2-*-add
nx-repository-view-maven2-*-browse
nx-repository-view-maven2-*-edit
nx-repository-view-maven2-*-read
kind: Deployment
apiVersion: apps/v1
metadata:
name: nexus3
labels:
app: nexus3
spec:
replicas: 1
selector:
matchLabels:
app: nexus3
template:
metadata:
labels:
app: nexus3
spec:
containers:
- name: nexus3
image: sonatype/nexus3
ports:
- name: nexus3-8081
containerPort: 8081
protocol: TCP
resources:
limits:
memory: 6G
cpu: 1000m
imagePullPolicy: IfNotPresent
volumeMounts:
- name: data
mountPath: /nexus-data
restartPolicy: Always
volumes:
- name: data
persistentVolumeClaim:
claimName: pvc-nexus3
readOnly: false
---
#PVC
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: pvc-nexus3
spec:
accessModes:
- ReadWriteOnce
storageClassName: pv-nexus3
resources:
requests:
storage: 50Gi
---
#PV
apiVersion: v1
kind: PersistentVolume
metadata:
name: pv-nexus3
spec:
capacity:
storage: 50Gi
accessModes:
- ReadWriteOnce
storageClassName: pv-nexus3
persistentVolumeReclaimPolicy: Retain
nfs:
path: /mnt/data/nfs/nexus3
server: 192.168.0.192
---
kind: Service
apiVersion: v1
metadata:
name: nexus3
labels:
app: nexus3
spec:
ports:
- name: nexus3-8081
protocol: TCP
port: 80
targetPort: 8081
selector:
app: nexus3
type: ClusterIP
# ------------------- App Ingress ------------------- #
kind: Ingress
apiVersion: networking.k8s.io/v1
metadata:
name: nexus3
annotations:
kubernetes.io/ingress.class: nginx
spec:
rules:
- host: nexus3.xxx.com
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: nexus3
port:
number: 80