使用 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 插件，来看一下：

运行一下：