4.Docker Compose 部署 Nexus

什么是 Nexus

Nexus 是一个强大的 Maven 仓库管理器，极大地简化了内部仓库的维护和外部仓库的访问。2016 年 4 月 6 日 Nexus 3.0 版本发布，相较 2.x 版本有了很大的改变

• 对低层代码进行了大规模重构，提升性能，增加可扩展性以及改善用户体验。
• 升级界面，极大的简化了用户界面的操作和管理。
• 提供新的安装包，让部署更加简单。
• 增加对 Docker, NeGet, npm, Bower 的支持。
• 提供新的管理接口，以及增强对自动任务的管理。

部署 Nexus

我们使用 Docker 来安装和运行 Nexus，docker-compose.yml 配置如下：

1. version: '3.1'
2. services:
3.  nexus:
4.    restart: always
5.    image: sonatype/nexus3
6.    container_name: nexus
7.  ports:
8.    - 80:8081
9.  volumes:
10.    - data:/nexus-data
12.  volumes:
13.    data:

验证安装是否成功

• 地址： http://ip:port/
• 用户名： admin
• 密码： admin123

注意： 新版本密码在 cat /var/lib/docker/volumes/nexus_data/_data/admin.password

Maven 仓库介绍

代理仓库(Proxy Repository)

• 第三方仓库
  • maven-central
  • nuget.org-proxy
• 版本策略(Version Policy)
  • Release： 正式版本
  • Snapshot： 快照版本
  • Mixed： 混合模式
• 布局策略(Layout Policy)
  • Strict： 严格
  • Permissive： 宽松

宿主仓库(Hosted Repository)

• 存储本地上传的组件和资源的
  • maven-releases
  • maven-snapshots
  • nuget-hosted
• 部署策略(Deployment Policy)
  • Allow Redeploy： 允许重新部署
  • Disable Redeploy： 禁止重新部署
  • Read-Only： 只读

仓库组(Repository Group)

通常包含了多个代理仓库和宿主仓库，在项目中只要引入仓库组就可以下载到代理仓库和宿主仓库中的包

• maven-public
• nuget-group

在项目中使用 Nexus

配置认证信息

在 Maven settings.xml 中添加 Nexus 认证信息 (servers 节点下)

1. <server>
2.  <id>nexus-releases</id>
3.  <username>admin</username>
4.  <password>admin123</password>
5. </server>
7. <server>
8. <id>nexus-snapshots</id>
9. <username>admin</username>
10. <password>admin123</password>
11. </server>

Snapshots 与 Releases 的区别

• nexus-releases： 用于发布 Release 版本
• nexus-snapshots： 用于发布 Snapshot 版本（快照版）

Release 版本与 Snapshot 定义

1. Release: 1.0.0/1.0.0-RELEASE
2. Snapshot: 1.0.0-SNAPSHOT

• 在项目 pom.xml 中设置的版本号添加 SNAPSHOT 标识的都会发布为 SNAPSHOT 版本，没有 SNAPSHOT 标识的都会发布为 RELEASE 版本。
• SNAPSHOT 版本会自动加一个时间作为标识，如：1.0.0-SNAPSHOT 发布后为变成 1.0.0-SNAPSHOT-20180522.123456-1.jar

配置自动化部署

在 pom.xml 中添加如下代码

1. <distributionManagement>
2.  <repository>
3.    <id>nexus-releases</id>
4.    <name>Nexus Release Repository</name>
5.    <url>http://127.0.0.1:8081/repository/maven-releases/</url>
6.  </repository>
7.  <snapshotRepository>
8.    <id>nexus-snapshots</id>
9.    <name>Nexus Snapshot Repository</name>
10.    <url>http://127.0.0.1:8081/repository/maven-snapshots/</url>
11.  </snapshotRepository>
12. </distributionManagement>

注意事项

• ID 名称必须要与 settings.xml 中 Servers 配置的 ID 名称保持一致
• 项目版本号中有 SNAPSHOT 标识的，会发布到 Nexus Snapshots Repository， 否则发布到 Nexus Release Repository，并根据 ID 去匹配授权账号

部署到仓库

1. mvn deploy

配置代理仓库

1. <repositories>
2.   <repository>
3.     <id>nexus</id>
4.     <name>Nexus Repository</name>
5.     <url>http://127.0.0.1:8081/repository/maven-public/</url>
6.     <snapshots>
7.      <enabled>true</enabled>
8.     </snapshots>
9.     <releases>
10.       <enabled>true</enabled>
11.     </releases>
12.  </repository>
13. </repositories>
14. <pluginRepositories>
15.   <pluginRepository>
16.    <id>nexus</id>
17.    <name>Nexus Plugin Repository</name>
18.    <url>http://127.0.0.1:8081/repository/maven-public/</url>
19.    <snapshots>
20.      <enabled>true</enabled>
21.    </snapshots>
22.    <releases>
23.      <enabled>true</enabled>
24.    </releases>
25.   </pluginRepository>
26. </pluginRepositories>

扩展阅读

手动上传第三方依赖

Nexus 3.1.x 开始支持页面上传第三方依赖功能，以下为手动上传命令

1. # 如第三方JAR包：aliyun-sdk-oss-2.2.3.jar
2. mvn deploy:deploy-file
3. -DgroupId=com.aliyun.oss
4. -DartifactId=aliyun-sdk-oss
5. -Dversion=2.2.3
6. -Dpackaging=jar
7. -Dfile=D:aliyun-sdk-oss-2.2.3.jar
8. -Durl=http://127.0.0.1:8081/repository/maven-3rd/
9. -DrepositoryId=nexus-releases

注意事项

• 建议在上传第三方 JAR 包时，创建单独的第三方 JAR 包管理仓库，便于管理有维护。（maven-3rd）
• -DrepositoryId=nexus-releases 对应的是 settings.xml 中 Servers 配置的 ID 名称。（授权）