Nexus:一站式私有仓库管理(NuGet、Maven、NPM、Docker)

我们在日常开发中经常需要使用到私有仓库,比如 dotNET 中的 NuGet、Java 中的 Maven、前端的 npm,还有 Docker 镜像,每一个私有仓库各自管理,维护起来比较麻烦,而 Nexus 可以将其统一起来。

本文将介绍 Nexus 的安装以及怎样进行 NuGet 、Maven、npm 和 Docker 镜像的管理。

环境

  • Nexus:3.29.2
  • NuGet:5.5.1
  • Maven:3.6.3
  • NPM:6.14.8
  • Docker:19.03.13
  • 操作系统:CentOS 7

安装

可以使用直接在服务器进行安装或者使用 Docker 镜像的方式安装,这里采用 Docker 镜像的方式安装。

1、执行下面的命令进行容器的构建。

1
docker run -d -p 8081:8081 -p 8082:8082 --name nexus_8081 -v /root/data/nexus:/nexus-data --restart=always sonatype/nexus3
  • 命令中的 -v /root/data/nexus:/nexus-data 是将 Nexus 的数据目录映射到本地;
  • nexus 目录需要给编辑的权限;
  • 8082 端口的映射目的是为了推送 docker 镜像。

2、执行下面命令开放端口。

1
2
firewall-cmd --zone=public --add-port=8081/tcp --permanent
firewall-cmd --reload

3、构建完后,需要等几十秒到几分钟不等,程序有一个初始化的过程,然后访问 http://ip:8081 ,可以出现下图界面:

4、根据弹窗的提示在映射的目录 /root/data/nexus 中找到 admin.password 中的内容就可以正常登录了。

NuGet

1、在 Repositories 功能中创建 NuGet 的私有仓库 NuGetTest ,仓库模板选择 nuget(hosted) 。

2、在 VS2019 中创建一个 NugetTest 的类库项目,在项目上点击右键→打包,在项目的 bin/Debug 目录中会生成 NugetTest.1.0.0.nupkg 文件。

3、点击「admin」→「NuGet API Key」,在该功能界面获取 key ,这个 key 在推送 NuGet 包时需要用到。

4、将 nuget.exe 程序文件也放到 bin/Debug 目录中,然后打开命令行进入到该目录,执行下面命令进行包的推送。

1
nuget.exe push NugetTest.1.0.0.nupkg dab3d4df-1eec-36e0-9b75-09b5b4b0ac41 -source http://10.211.55.6:8081/repository/NuGetTest

推送成功如下图:

5、在 VS2019 中的 NuGet 包管理器中添加源。

6、在引用时选择添加的 NuGetTest 源,如下图:

Maven

1、在 Repositories 功能中创建 Maven 的私有仓库 MavenTest ,仓库模板选择 maven(hosted),Deployment policy 需要设置为 Allow redeply,否则在推送时会报 400 的错误。

2、在 Maven 的配置文件 /apache-maven-3.6.3/conf/settings.xml 中的 Servers 节点添加 Server 配置,如下:

1
2
3
4
5
<server>
<id>releases</id>
<username>test</username>
<password>000000</password>
</server>
  • username 和 password 是在 Nexus 中创建的测试账户;
  • id 需要和 Maven 项目中的 pom.xml 文件中配置的 id 一致。

3、在 IntelliJ IDEA 中创建 Maven 项目 MavenTest,在项目中的 pom.xml 文件中添加如下内容:

1
2
3
4
5
6
7
<distributionManagement>
<repository>
<id>releases</id>
<name>releases</name>
<url>http://10.211.55.6:8081/repository/MavenTest/</url>
</repository>
</distributionManagement>
  • id:和上面的 settings.xml 文件中的 id 一致即可;
  • url:在 Nenux 中创建的 Maven 仓库的地址。

4、因为仓库创建的是 Release 版本的,如果 pom.xml 文件的 version 中包含 SNAPSHOT ,需要删除,否则在推送时会报 400 的错误。

5、在 IDEA 工具的 Maven 模块中进行 depoly 。

6、推送成功后,在 Nexus 中可以看到如下:

7、创建一个 spring boot 的项目,并修改 pom.xml 文件,在 dependencies 节点添加依赖,并添加 repositories 配置,如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
<dependencies>
<dependency>
<groupId>org.example</groupId>
<artifactId>MavenTest</artifactId>
<version>1.0</version>
</dependency>
</dependencies>
<repositories>
<repository>
<id>releases</id>
<name>releases</name>
<url>http://10.211.55.6:8081/repository/MavenTest/</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
</repositories>

8、在 IDEA 中的 build 模块中进行同步就可以将 maven 包拉取到项目中。

NPM

1、在 Repositories 功能中创建 npm 的私有仓库 NpmTest ,仓库模板选择 npm(hosted),Deployment policy 需要设置为 Allow redeply,否则在推送时会报 400 的错误。

2、使用 vue 创建一个项目 nexus-test 。

3、使用下面命令进行本地注册,后面的地址为创建的 npm 私有库的地址。

1
npm config set registry http://10.211.55.6:8081/repository/NpmTest/

4、想要将自己的 npm 包推送到私有仓库中,需要先使用下面的命令进行登录。

1
npm login –registry=http://10.211.55.6:8081/repository/NpmTest/

5、修改 vue 项目根目录中的 package.json 文件,将 private 设置为 false ,版本号 version 根据需要进行修改。

6、在 Nexus 的 Realms 模块进行设置,将 npm Bearer Token Realm 选到右边的 Active 栏中,此处不设置,在推送时会出现 401 的错误。

7、执行下面命令进行包的推送:

1
npm publish --registry=http://10.211.55.6:8081/repository/NpmTest

8、创建一个新的 vue 项目 nexus-test1 来进行私有仓库的使用,先进行仓库地址的注册。

1
npm config set registry http://10.211.55.6:8081/repository/NpmTest/

9、执行 npm install nexus-test 进行包的安装,安装成功如下图:

Docker

1、在 Repositories 功能中创建 docker 的私有仓库 DockerTest ,仓库模板选择 docker(hosted) 。

  • 勾选 http,设置端口为 9999 ;
  • 勾选允许匿名拉取镜像;
  • 勾选运行客户端通过 API 访问。

2、在 Nexus 的 Realms 模块进行设置,将 Docker Bearer Token Realm 选到右边的 Active 栏中。

3、在 CentOS 7 系统中安装 Docker ,然后再 /etc/docker/ 目录中创建 daemon.json 文件,内容如下:

1
2
3
{
"insecure-registries": ["10.211.55.6:9999"]
}

4、执行下面命令进行配置的加载。

1
2
systemctl daemon-reload
systemctl restart docker

5、在 root 目录中创建 nexus-docker 目录,目录中创建 Dockerfile 文件用来构建一个新的镜像,内容如下:

1
2
3
4
FROM nginx:latest
COPY . /usr/share/nginx/html/
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]

6、执行下面命令进行镜像的构建和推送到服务端。

1
2
3
4
5
6
7
8
# 构建镜像
docker build -t nexus-docker .
# 将镜像 tag 成服务端的地址
docker tag nexus-docker-test:latest 10.211.55.6:8082/nexus-docker-test:latest
# 进行登录
docker login -u test -p 000000 10.211.55.6:8082
# 推送镜像
docker push 10.211.55.6:8082/nexus-docker-test:latest

操作成功如下图所示:

7、使用镜像的时候,只要服务器进行了第三步中的地址注册,就可以使用 docker pull 10.211.55.6:8082/nexus-docker-test:latest 进行镜像拉取。

希望本文对您有所帮助!