如何利用Jenkins + TFS为.Net Core实现持续集成/部署详解

前言

在前后端分离开发的项目当中为了避免重复构建发布，我们需要部署一个持续发布环境，而目前的开发环境服务器都是基于 centos 的，因此每次在本地发布之后还需要打包，上传，部署，十分繁琐。故这里采用了比较成熟的jenkins 作为持续部署环境。

为了方便安装，我们这里使用了 docker 来进行安装，至于 docker 安装的步骤这里不在赘述，详情可以参考。

上面安装的是一个较老的版本，这里推荐参考docker 官方文档来进行安装。

安装好 docker 之后，拉取 jenkins 的官方镜像。执行如下命令:

docker pull jenkins/jenkins

拉取完毕之后我们基于这个镜像封装一个新的镜像出来，可能会问为什么不能直接使用呢？因为这儿的 jenkins镜像并不包含 docker 环境，所以我们需要封装一个新的镜像让其能够访问宿主机的 docker 程序。

构建 dockerfile 内容如下：

from jenkins/jenkins:latest
user root
#清除了基础镜像设置的源，切换成阿里云的源
run echo '' > /etc/apt/sources.list.d/jessie-backports.list \
 && echo "deb http://mirrors.aliyun.com/debian jessie main contrib non-free" > /etc/apt/sources.list \
 && echo "deb http://mirrors.aliyun.com/debian jessie-updates main contrib non-free" >> /etc/apt/sources.list \
 && echo "deb http://mirrors.aliyun.com/debian-security jessie/updates main contrib non-free" >> /etc/apt/sources.list
#更新源并安装缺少的包
run apt-get update && apt-get install -y libltdl7
arg dockergid=999

run echo "docker:x:${dockergid}:jenkins" >> /etc/group \
user jenkins

完成之后执行如下命令构建新的 docker 镜像:

docker build -t docker/jenkins .

下面我们就开始运行我们的 jenkins 容器了:

docker run -d -p 8080:8080 -p 50000:50000 \
 --name=jenkins -v /root/docker/jenkins:/var/jenkins_home \
 -v /var/run/docker.sock:/var/run/docker.sock \
 -v $(which docker):/usr/bin/docker \
 docker/jenkins

这里我们将 jenkins 镜像里面的 /var/jenkins_home 映射到了宿主机的 /root/docker/jenkins 文件夹，在这个文件夹里面都存放的是 jenkins 的一些配置项等。

注意，这里可能会出现如下错误：

touch: cannot touch ‘/var/jenkins_home/copy_reference_file.log': permission denied
can not write to /var/jenkins_home/copy_reference_file.log. wrong volume permissions?

这是因为在 docker 内部的 jenkins user 用户没有权限，因为映射的 /root/docker/jenkins/ 文件夹属于root 用户的，而 jenkins user 的 uid 为 1000,执行如下命令:

sudo chown -r 1000:1000 /home/docker/jenkins

之后再次运行 jenkins 的容器,访问 http://服务器ip:8080/ 站点，会提示你输入密钥:

我们来到宿主机执行以下 shell 命令:

docker container logs jenkins

就可以看到密钥其实已经输出在终端了，复制过来，粘贴进去就可以了。之后就是选择你需要安装的插件，选择第一个默认即可，可能这里因为网络原因会安装失败，可以多重试几次，或者直接忽略掉，后面我们会将如何解决。

安装完成之后输入用户名密码，就可以开始使用了，可能你刚才会因为网络等原因造成插件安装失败，这里我们来到

jenkins>>系统管理>>管理插件>>高级

然后将 升级站点 地址改为 http://mirror.xmission.com/jenkins/updates/current/update-center.json。之后安装之前缺失的插件。

这里我们项目使用的是 tfs 进行源代码管理，所以我们需要安装 tfs 插件，在 manage jenkins 的 manage plugin 里面我们找到 team foundation server plug-in 插件，勾选，点击 download now and install after restart 按钮，勾选 restart jenkins when installation is complete and no jobs are running 。

安装完成之后 jenkins 会重启，等待重启完毕之后，来到 jenkins>>manage jenkins>>configure system 查看 tfs/team services 然后添加你的 tfs collection。

保存之后我们就可以新建项目了。

首先，我们来到首页，选择 new item:

然后选择*风格项目，填上名称.

在 source code management 上选择 tfs，并且填入你的 tfs 服务器地址，项目路径，与你的账号密码:

然后你就可以尝试构建一下，构建成功之后就会在 workspace 看到你的项目文件被拉下来了。

那么我们的代码如何构建并且部署呢？因为我们之前在 jenkins 的 docker 镜像启动的时候挂载了宿主机的 docker 程序，我们现在就可以直接基于微软的 dotnetcore 镜像来构建我们的项目。所以，我们先拉取微软的 dotnetcore 镜像，运行如下命令：

docker pull microsoft/dotnet:latest

拉取镜像之后，我们来编写一个 dockerfile 文件来让 jenkins 来执行 shell 构建。

如果你还不知道如何编写 dockerfile 文件，可以参考 。

from microsoft/dotnet:latest
workdir /app
copy ./ .
env aspnetcore_urls http://+:5000
expose 5000

run cd ./hkerp.identityserver.host \
 && dotnet restore \
 && dotnet build

workdir /app/hkerp.identityserver.host
entrypoint ["dotnet","run"]

然后将这个 dockerfile 放在你的项目里面，类似于这样：

然后我们再回到刚才 jenkins 里面，配置刚才项目，新建一个 shell step，就像这样：

代码如下：

#!/bin/sh
cd /var/jenkins_home/workspace/api_identityserver
docker container prune << eof
y
eof
docker container ls -a | grep "api_identityserver"
if [ $? -eq 0 ];then
 docker container stop api_identityserver
 docker container rm api_identityserver
fi
docker image prune << eof
y
eof
docker build -t api_identityserver .
docker run -d -p 8083:5000 --name=api_identityserver api_identityserver

步骤就是首先清理掉 docker 处于终止状态的容器，然后判断有没有叫 api_identityserver 的容器在运行，如果有就直接停掉，然后清除所有的虚悬镜像，使用当前目录的 dockerfile 构建一个新的 api_identityserver 镜像，使用 api_identityserver 镜像运行一个新的容器。

这儿我安装了 jenkins 的一个 blue ocean 插件，来看一下：

运行一下：

总结

以上就是这篇文章的全部内容了，希望本文的内容对大家的学习或者工作具有一定的参考学习价值，如果有疑问大家可以留言交流，谢谢大家对的支持。