亲历的企业级微服务的完整构建过程-系列文章目录
本人参与了这次的企业级微服务的完整构建,想要记录下来以便以后复习,同时也想分享给小伙伴们,抛砖引玉,欢迎大家提出自己的意见和建议,大家一起探讨一起成长。以下为该系列所有文章的链接:
- 搭建和使用Maven私有仓库(Nexus)(更新完毕)
- API网关(待发布)
- 认证中心(更新中)
- Redis框架(待发布)
- RabbitMQ(待发布)
- MyBatis(待发布)
- Web模块(待发布)
- 低代码(待发布)
- Core
- 监控和告警(待发布)
- MongoDB(待发布)
搭建和使用Maven私有仓库(Nexus)-系列文章目录
说明:
- 以下模块中的一小部分,绝大多数人,在日常工作中都是用不到的,所以我就没有介绍,毕竟时间是最重要的成本,没必要花大量时间在我们用不到的内容上。
- 下面的“1 通用”章节,系列文章中的每一篇内容都相同,介绍一些背景、约定和官网链接等,大家只要知道这些内容了,就不用每篇文章都去看了。
- 安装步骤
- 登录和界面
- 备份和恢复
- 管理:讲述了Nexus的管理功能,包括用户管理、权限管理、任务管理等
- 使用Nexus仓库:讲述了使用(而非管理) Nexus Repository 的方方面面的知识
- 仓库管理器概念:使用 Nexus 需要先理解一些概念,该节内容提供了必要的背景和知识
- 用户界面概述
- 搜索组件(暂时用不到,略)
- 浏览仓库和仓库组
- 管理当前登录用户的资料
- 上传组件
- 查看标签(仅可用于Pro版本,略)
- 集成(主要讲述了如何使用 APIs 和 集成外部工具)(暂时用不到,略)
- Maven中配置和使用Nexus
正文
1 通用
1.1 前言
在构建微服务之前,需要先做一些准备工作,比如Maven私有仓库的管理。因为有些微服务模块是作为公共组件被其他微服务引用的,这些公共的微服务,就要设置为依赖,并用Maven仓库管理起来,将自定义的依赖上传到Maven中央仓库并不是一个明智的选择。原因有3个:
- 最重要的是隐私和安全问题,我们不可能把企业内部开发的组件上传到公共网络,让所有人能够随便下载;
- 上传很麻烦,上传方法详见 https://blog.csdn.net/agonie201218/article/details/124800163;
- 可能不允许上外网,则无法上传;
- 可能会有网络延迟、上传缓慢的问题。
- 降低了中央仓库的负担。
综上,我们最好是搭建自己的私有Maven仓库,而当前最流行的就是 Sonatype Nexus Repository Manager
,以下简称 Nexus
。
1.2 约定
- 我使用的版本是
OSS 3.40.1-01
,整个系列的文章都是在该版本上展开介绍,你们可能使用的是 Pro 版,少数模块是我的 OSS 版上没有的。不过一般使用的话,OSS 版已经够用了 - 文中出现的
Repository
,中文称之为“仓库” - 文中出现的变量
$install-dir
,值为/opt/sonatype/nexus
- 文中出现的变量
$data-dir
,值为/opt/sonatype/sonatype-work/nexus3
,或/nexus-data
,两者都是在docker容器nexus中的路径,一个是软链接,一个是实际路径 - 文中出现的变量
${jetty.etc}
,值为/opt/sonatype/nexus/etc/jetty
- NXRM:Nexus Repository Manager,即 Nexus 仓库管理器
- RBAC:Role-Based Access Control,即 基于角色的访问控制
1.3 官方文档
提供Nexus的官方文档:https://help.sonatype.com/repomanager3/
官方文档包含了系统要求、搭建方法,以及各种操作方法等,内容已经非常全面了。
2 安装步骤
首先,我安装的当前的最新版 :OSS 3.40.1-01。
官方文档中介绍了2种安装Nexus的方法,一种是下载安装包,然后安装、运行;另一种是直接运行Docker镜像中的Nexus。
我测试了下,发现官方提供的下载路径根本下载不了,可能是国内防火墙拦截了,所以使用了第二种方法,简单又省事。
第二种方法参考链接:https://hub.docker.com/r/sonatype/nexus3/
下面简单说下步骤:
# 1 下载docker镜像(可以省略,第二步会自动下载)
docker pull sonatype/nexus3
# 2.1 要运行,将暴露的端口 8081 映射到主机端口8081(也可以自定义端口号)
# nexus启动时间有点长,可能需要2-3分钟,请耐心等待
$ docker run -d -p 8081:8081 --name nexus sonatype/nexus3
# 2.2 运行且持久化数据
# 创建一个docker卷
docker volume create --name nexus-data
# 运行时挂载nexus的数据目录到该docker卷
# 注:-v参数中, nexus-data是volume名称,冒号后的 /nexus-data 是容器中对应的挂载路径
docker run -d -p 8081:8081 --name nexus -v nexus-data:/nexus-data sonatype/nexus3
# 3 停止时,请务必留出足够的时间让数据库完全关闭
docker stop --time=120 <CONTAINER_NAME>
# 4 测试是否启动成功
$ curl http://localhost:8081/
# 5 服务在新容器中启动可能需要一些时间(2-3 分钟)。我们可以跟踪日志以确定 Nexus 是否准备就绪
docker logs -f nexus
# 6 连接到nexus容器命令行界面
docker exec -it nexus bash
注:上述创建的docker卷的信息如下,尤其注意其实际路径为 /var/lib/docker/volumes/nexus-data/_data
:
docker volume inspect nexus-data
[
{
"CreatedAt": "2022-06-29T12:58:45+08:00",
"Driver": "local",
"Labels": {},
"Mountpoint": "/var/lib/docker/volumes/nexus-data/_data",
"Name": "nexus-data",
"Options": {},
"Scope": "local"
}
]