k8s+Jenkins+GitLab-自动化部署asp.net core项目

0、目录

---

整体架构目录：ASP.NET Core分布式项目实战-目录

k8s架构目录：Kubernetes(k8s)集群部署（k8s企业级Docker容器集群管理）系列目录

此文阅读目录：

1、闲聊

2、部署流程介绍

3、部署Harbor仓库

4、jenkins-slave镜像搭建

5、部署jenkins

6、jenkins+gitlab挂钩

7、k8s部署asp.net core项目

一、闲聊

---

现在基本上是隔几天写一篇文章，还是不够勤奋，努力把自己打造成勤奋的人，把工作上面所用到的技术点分享给大家。为了研究k8s自动化部署aspnet core项目，足足花费了我一个礼拜的时间，过程是痛苦的，但结果是美好的。

如果以下内容有不足的地方，请指出，我会第一时间更正。谢谢大家。

二、部署流程介绍

---

 1、先上一下手绘导图，大致的流程图如下：（不喜勿喷呀）

大致的部署流程是这样的：开发人员把做好的asp.net core项目代码通过git推送到gitlab，然后Jenkins通过 gitlab webhook （前提是配置好），自动从拉取gitlab上面拉取代码下来，然后进行build，编译、生成镜像、然后把镜像推送到Harbor仓库；然后在部署的时候通过k8s拉取Harbor上面的代码进行创建容器和服务，最终发布完成，然后可以用外网访问。（ps:看着我讲这么简单，但心里有许多小鹿在心里乱撞，没关系，下面将会好好的分享给大家）

当然啦，上面只是粗略的，请看下图才更加形象。

2、先介绍一下我的服务器IP和在各个服务器上面所安装的内容

ps:由于我的电脑配置有限，运行太多的虚拟机会导致内存空间不够用，因此就弄了三台，已经是极限了。

如果大家对于k8s怎么部署，请看我之前的文章有介绍。前提是要安装好docker环境、gitlab等

IP	角色
192.168.161.151	master1、Harbor、Jenkins
192.168.161.152	node1
192.168.161.153	node2、Gitlab

三、部署Harbor仓库

---

第一步：下载harbor二进制文件：https://github.com/goharbor/harbor/releases

第二步：安装 docker compose

命令：

sudo curl -L https://github.com/docker/compose/releases/download/1.22.0/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose

然后把下载的docker-compose 设置可执行权限

命令：chmod +x /usr/local/bin/docker-compose

第三步：此处应该设置自签证书的，即访问的时候是采用HTTPS进行访问的。此处略去，不影响我们接下去的部署。（后期会出一篇关于自签证书的文章，仅供参考）

第四步：将下载好的Harbor二进制包上传到服务器上面，然后解压出来

解压的命令为： tar xzvf 包名

第五步：进入解压出来的文件夹harbor中，有如下文件。

配置文件，vi harbor.cfg

把其中的hostname修改为：master1 的IP地址。

然后 修改harbor的登录密码：为了方便起见，我修改为123456,大家可自行修改

第六步：在当前文件夹中开启harbor

执行命令：

./prepare

./install.sh  (运行此处的时候需要一定的时间，请等待吧)

第七步：启动成功，查看一下（完美的运行）

docker-compose ps

用浏览器查看一下（出现以下内容，代表成功，完美）

进入到里面后，我先在用户管理中创建了一个用户  louie 。大家自行创建，为了后期需要把一些依赖镜像先推送到harbor仓库中。然后在项目中创建项目，如下：

所创建的项目，并且，我在每个项目中都加入了我刚才所创建的用户，方便后期登录并推送镜像

                            

此处介绍一下我的项目，coresdk 主要用来存放  asp.net core 所需要的sdk；ops主要是用来存放的jenkins镜像和jenkins-slave镜像；projectdemo 主要存放我的asp.netcore 项目的镜像，供k8s拉取。

至此，harbor部署完成。

四、jenkins-slave镜像搭建

---

操作服务器：node1

说明:jenkins-slave 主要是为了分担jenkins-master的压力。如下图所示：（在多任务运行的时候可以采用）

1、为了创建jenkins-slave镜像，我这边准备了三个文件

Dockerfile：构建jenkins-slave镜像

jenkins-slave：shell脚本（需要加入可执行权限 chmod +x jenkins-slave），在镜像构建时需要用到。

slave.jar: 启动脚本

---

Dockerfile 文件内容如下（如需源文件可加入QQ群获取），如下图所示：可以看到 jenkins-slave需要依赖java的一些环境。

2、配置java的基础环境。

配置 JDK和maven，把下载的二进制包放到如下目录（由于文件太大，可移步到群中下载）

apache-maven-3.5.3-bin.tar.gz解压到的地址为 /usr/local/maven里面。
jdk-8u45-linux-x64.tar.gz解压到的地址为 /usr/local/jdk里面。

3、准备好环境后，刚才构建镜像，如下：

执行命令：

构建完成后把镜像推送到Harbor仓库中。

在推送的过程中需要先登录到harbor仓库

执行命令： docker login 192.168.161.151

执行后发现及时输入账号和密码也无法登录，由于在node1中没有添加harbor仓库的IP地址导致无法登录，因此

执行命令： vi /etc/docker/daemon.json

把下图的红色圈的部分加入，然后重启一下docker。

执行 docker info ，看一下IP地址是否生效，发现已加入。好了，在试一下登录，发现登录成功，然后开始推送把。

当然harbor 上也给出了 镜像推送的语句

开始推送：docker push 192.168.161.151/ops/jenkins-slave

至此，jenkins-slave 镜像已推送完毕。

五、部署jenkins

---

部署jenkins时，我把jenkins的数据卷采用pv/pvc、nfs 进行挂载。

1、需要准备文件有

jenkins-service-account.yml :jenkins的服务账号创建

jenkins.yml : 创建容器和service 服务得。进行可以访问。

Dockerfile ：主要用来生成 jenkins 镜像的。

registry-pull-secret.yaml：主要是用来部署时可以直接登录harbor仓库来拉取镜像（在部署jenkins需要用到）

2、开始吧。

切换到node1服务器，把之前准备好的Dockerfile文件构建一下

命令：docker build -t 192.168.161.151/ops/jenkins:lts-alpine .

然后推送到Harbor仓库中，命令：docker push 192.168.161.150/ops/jenkins:lts-alpine

3、切换到master 服务器上

构建 jenkins-service-account.yml 和jenkins.yml  文件以及registry-pull-secret.yaml

特别注意registry-pull-secret.yaml 中的namespace,需要在k8s中创建，以及 data里面的64位认证信息（需要登录harbor仓库后生成的信息黏贴在这里）

生成方式为：可以在有登录的harbor 的node服务器上面执行以下命令生成认证信息
命令： cat ~/.docker/config.json |base64 -w0 即可生成信息

执行上上面的文件后，命令： kubectl create -f  文件名。

生成如下，发现jenkins已在运行，而且是运行在153节点上。那么开始用浏览器访问把

查看一下 service ，jenkins的外部访问端口为诶 30001.

4、输入访问地址：http://192.168.161.153:30001/

在第一次登陆的时候需要密码进行解锁jenkins，按照提示获取密码即可。

然后选择 “”插件来安装“”，如果需要特别的插件直接选择，否则直接安装即可。

5、要想把jenkins关联到k8s中需要安装几个插件

打开  “系统管理” =》“管理插件” 然后安装

Kubernetes Continuous Deploy、Kubernetes、Gitlab Hook 、GitLab、Build Authorization Token

6、安装完毕后就开始构建项目啦。

我新建一个项目，然后选择 流水线、然后点击确定。

7、创建完任务后先不进行配置，我们先要设置一下jenkins挂钩k8s的环境

点击 “系统管理”=》“系统设置”。一直往下滑动，点击“新增一个云”，选择k8s，如果这边没有出现k8s，则代表你的插件没有安装成功，请重新安装吧。

然后配置一下里面的内容，只要配置这两个地方就可以了。针对URL，我这边是采用kube-dns来做服务发现，不需要实际的ip地址进行输入。至此搞定。不过还得配置一下 “凭证”，即SSH密钥，方便可以从gitlab那边拉取代码，有玩过gitlab应该知道，拉取代码分为git和http。

此处如果发现测试不通过，请现在k8s中安装一下kube-dns.yaml，文件在群中k8s集群部署文件下面：直至在k8s中执行即可。

命令：kubectl create -f kube-dns.yaml

8、添加凭证

在这里我添加了两个凭证，一个是ssh，和k8s的凭证。这个可自行添加一下即可。这里要注意一下：凭证生成后，进入凭证里面会有一个自动生成的ID，此ID需要在asp.net core项目中的Jenkinsfile里面配置。

root中的密钥时私钥，并且在服务器上需要把公钥配置到gitlab上。

这下面是gitlab 上面配置ssh， ssh的私钥和公钥，直接在 node服务器上生成一下即可 ssh-keygen,  然后把里面的内容复制出来即可。

六、jenkins+gitlab挂钩

---

上面已经创建了一个任务。然后我们开始配置这个任务里面的内容并且与gitlab挂钩把

1、进入testproject里面配置。按照以下图配置完后即可。然后点击保存。这样就完成了任务配置，接下来就是要配置一下gitlab啦

2、配置gitlab

在gitlab中我创建了一个项目Testproject

然后进入到项目中，点击 “Settings”=》Integrations

把上面URL和Token复制到这边，然后点击保存即可。接下来就是测试一下这个配置是否可以用

将上面创建好的webhook 进行测试，gitlab会模拟代码推送事件，返回200就代表成功啦。

成功啦。

七、终于到了我们asp.net core项目啦

---

github地址：上面有完整的代码 https://github.com/LouieGuo/testproject,记得fork me哟。感谢感谢。

在这里我创建了一个asp.net core webapi 的项目，不做任何修改。然后在项目中加入了这几个部署文件。

deploy文件里面包含 Jenkinsfile 和deploy.yml(用来部署项目镜像的)

注：Jenkinsfile里面这两个地方需要配置为你们在Jenkins里面创建的两个授权的ID，ID内容可以进入到凭证里面看。切记，一定要改。

Dockerfile ：中是用来构建项目镜像 的

dockerfile 内容，当然里面的sdk我已经打包好了，已经上传到我的harbor仓库中。

---

到目前为止 我们就可以开始上传代码到gitlab上，然后自动触发构建啦。

上传后再这边会出现构建进行，我们可以查看 控制台输出

输出、以及构建成功

在master上面查看

发现已经运行我的项目啦，用浏览器访问以下。

查看一下外部发布的端口

运行成功啦。这篇文章写了好久，可能中间有漏掉的步骤，欢迎大家留言，后期补充。

---

github：fork me

asp.net Core 交流群：787464275 欢迎加群交流
如果您认为这篇文章还不错或者有所收获，您可以点击右下角的【推荐】按钮精神支持，因为这种支持是我继续写作，分享的最大动力！

作者：LouieGuo

声明：原创博客请在转载时保留原文链接或者在文章开头加上本人博客地址，如发现错误，欢迎批评指正。凡是转载于本人的文章，不能设置打赏功能，如有特殊需求请与本人联系！

微信公众号：欢迎关注                                                 QQ技术交流群： 欢迎加群