ABP vNext微服务架构详细教程——镜像推送

1. Jenkins搭建

为实现容器化部署，我们需要将代码打包成镜像并推送至容器仓库，我们可以选择自建容器仓库或者使用公有云服务商提供的镜像仓库。这里我们使用阿里云提供的免费镜像仓库。

代码打包和镜像仓库推送有很多种方式，在实际项目中，我推荐使用Jenkins实现自动化打包推送。

我们这里我们使用Docker部署Jenkins，首先，安装Docker，这里我使用的Ubuntu系统，并使用一键安装脚本：

curl -sSL https://get.daocloud.io/docker | sh

之后我们需要开启Docker的2375端口方法如下：

vim /usr/lib/systemd/system/docker.service

#修改ExecStart行为下面内容：
ExecStart=/usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock -H tcp://0.0.0.0:2375 -H unix://var/run/docker.sock

加载配置项并重启Docker

systemctl daemon-reload
systemctl restart docker

之后使用Jenkins官方文档提供的部署命令如下：

docker run  -u root  --rm  -d  -p 8080:8080 -p 50000:50000 -v jenkins-data:/var/jenkins_home  -v /var/run/docker.sock:/var/run/docker.sock  jenkinsci/blueocean 

运行成功后访问8080端口，可以进入Jenkins页面。

这里我们需要在宿主机上运行一下命令进入Jenkins控制台：

docker exec 【Jenkins容器ID】 -it /bin/bash

进入容器后使用以下命令获取第一次登录所需秘钥：

cat /var/jenkins_home/secrets/initialAdminPassword

登录后，依照默认选项配置Jenkins组件，并设置用户名密码，下次登录可使用新的用户名密码登录。

配置完成后进入管理面板，找到Manage Jenkins→插件管理→可选插件，搜索Docker，并安装。

安装完成后，在Manage Jenkins→系统配置中找到Cloud选项卡，点击“a separate configuration page.”并点击“Add a new cloud”按钮，选择docker。

点击“Docker Cloud details……”按钮，在Docker Host URI选项中填入docker地址如下：

tcp://【宿主机IP】:2375

点击“Test Connection”测试，通过后点击Save保存。

2. 配置Dockerfile

以基础服务中的产品服务为例，这里我们使用.Net官方提供的构建方式构建镜像，即将代码拷贝到.Net 6 SDK容器中执行打包和发布，再将发布后的文件拷贝到项目运行镜像中。

在Jenkins官方提供的Docker组件中，只能指定Dockerfile的目录，无法指定执行构建镜像的目录，所以我们需要让镜像构建的目录和Dockerfile一致。

在src\service\productmanager目录下添加Dockerfile文件内容如下：

 1 FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
 2 WORKDIR /app
 3 EXPOSE 80
 4
 5 FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
 6 WORKDIR /src
 7 COPY . .
 8 WORKDIR /src/host/Demo.ProductManager.HttpApi.Host
 9 RUN dotnet restore -nowarn:msb3202,nu1503
10 RUN dotnet build --no-restore -c Release -o /app
11
12 FROM build AS publish
13 RUN dotnet publish --no-restore -c Release -o /app
14
15 FROM base AS final
16 WORKDIR /app
17 COPY --from=publish /app .
18 ENTRYPOINT ["dotnet", "Demo.ProductManager.HttpApi.Host.dll"]

这里需要注意第3行端口号和我们定义的服务端口号一致，第8行WORKDIR中/src后面的路径是启动项相对于Dockerfile所在目录的路径，第18行的dll为启动项的dll文件。

Demo中其他项目Dockerfile内容格式和此项目一致。

3. Jenkins配置

在Jenkins主菜单点击“New Item”创建单个服务发布流程

输入项目名称为productmanager并选择“Freestyle project”并点击“确定”。

在源代码管理中选择Git并在Repository URL处配置源代码git地址，这里我使用Demo在Gitee中的地址：https://gitee.com/lightnehum/abp-microservice-demo

如果GIt地址需要用户名密码，则在Credentials选项卡中点击添加，输入用户名密码并选择此项。

在“构建”选项卡中点击“增加构建步骤”，并选择“Build/Publish Docker Image”。

在Directory for Dockerfile输入框中输入：

/var/jenkins_home/workspace/productmanager/src/service/productmanager

此地址是Dockerfile在Jenkins容器中的地址，其中/var/jenkins_home/workspace为固定目录，productmanager为Jenkins地址，后面为启动项所在目录（Dockerfile所在目录）相对于总项目目录的地址。

“Cloud”选择我们在第一章节中配置的“Docker”。

这里我使用阿里云提供的免费镜像仓库，登录阿里云控制台，进入容器镜像服务，在实例列表中选择个人实例。

在仓库管理→命名空间中添加自己的命名空间。

在仓库管理→镜像仓库中添加镜像仓库名称为projectmanager，命名空间选择刚才创建的命名空间，仓库类型选择私有，点击“下一步”，代码源选择“本地仓库”，并点击“创建镜像仓库”。

创建完成后在仓库的基本信息中找到公网地址，并将内容复制到Jenkins之前步骤“构建”选项卡的Image输入框中。

继续编辑Jenkins“构建”选项卡，在Registry Credentials选项中，我们需要添加并选择阿里云镜像仓库的用户名密码。

将选项卡中的复选框：Push image、Clean local images、Attempt to remove images when jenkins deletes the run、Disable caching、Pull base image全部勾选。

点击保存完成Jenkins中产品管理服务发布配置。

点击“立即构建”可从git中拉取代码并将产品管理服务推送到阿里云镜像仓库。

其他服务可依照相同方法创建Jenkins发布流程将镜像推送至镜像仓库。