Jenkins持续集成学习-Windows环境进行.Net开发4

Jenkins持续集成学习-Windows环境进行.Net开发4

目录

• Jenkins持续集成学习-Windows环境进行.Net开发4
  • 目录
  • 前言
  • 目标
  • Github持续集成
    • 提交代码到Github
    • 从Github更新代码
    • git上显示构建状态
    • 自动触发构建
      • 手工模式
      • 自动模式
  • Gitlab持续集成
    • 安装插件
    • 配置Gitlab账号
      • 添加Token
      • 添加凭据
    • 配置Git地址
    • 配置钩子
    • 通知Gitlab状态
  • 结语
  • 参考文档

---

目录

Jenkins持续集成学习-Windows环境进行.Net开发1
Jenkins持续集成学习-Windows环境进行.Net开发2
Jenkins持续集成学习-Windows环境进行.Net开发3
Jenkins持续集成学习-Windows环境进行.Net开发4
Jenkins持续集成学习-搭建jenkins问题汇总

前言

前面三篇介绍了使用SVN的持续集成，本篇就来学习如何使用git进行持续集成。

目标

探究 .net + git + jenkins方案的持续集成。

前面3篇文章总结的最终流程如下。

我们需要修改3个方面。

1. 代码提交到Git上
2. 提交到Git上自动触发构建
3. 从Git上更新代码

Github持续集成

Jenkins需要先需要安装Github相关插件Github plugin。

提交代码到Github

首先新建一个git仓库

提交前需要把obj目录下的project.assets.json排出忽略，obj其他的文件添加忽略。

关于project.assets.json的作用可以查看Jenkins持续集成学习-Windows环境进行.Net开发2

同时要把源代码管理中的插件修改为Git

最后提交即可。

从Github更新代码

在jenkins我们也新添加一个项目，名称为gittest,为了方便，直接从svn的测试项目复制,这样我们可以最大程度的减少重复配置。

将项目设置为Github项目，Job的菜单就会显示Github项。

将源代码管理Subversion改为Git

由于我之前git的插件都已经安装好，因此这里没有碰到任何问题。

添加git凭据，暂时使用用户名和密码

暂时先通过手动构建，测试一下流程是否通畅，暂时先把Build Triggers的钩都去掉

配置完后Job的左边的菜单就会出现Github项，点击就会调转到配置的Github项目的仓库中。

点击构建

构建成功,git日志如下

10:55:27 由用户 jake 启动
10:55:27 构建中 在工作空间 D:\Program Files (x86)\Jenkins\workspace\gittest 中
10:55:27  > git.exe rev-parse --is-inside-work-tree # timeout=10
10:55:27 Fetching changes from the remote Git repository
10:55:27  > git.exe config remote.origin.url https://Github.com/GuojieLin/Jenkins.Core.git # timeout=10
10:55:27 Fetching upstream changes from https://Github.com/GuojieLin/Jenkins.Core.git
10:55:27  > git.exe --version # timeout=10
10:55:27 using GIT_ASKPASS to set credentials git账号
10:55:27  > git.exe fetch --tags --progress https://Github.com/GuojieLin/Jenkins.Core.git +refs/heads/*:refs/remotes/origin/*
10:55:34  > git.exe rev-parse "refs/remotes/origin/master^{commit}" # timeout=10
10:55:34  > git.exe rev-parse "refs/remotes/origin/origin/master^{commit}" # timeout=10
10:55:34 Checking out Revision 75be92d4a4c131924a4601504cde7ba613f57b9f (refs/remotes/origin/master)
10:55:34  > git.exe config core.sparsecheckout # timeout=10
10:55:34  > git.exe checkout -f 75be92d4a4c131924a4601504cde7ba613f57b9f
10:55:34 Commit message: "同上"
10:55:34  > git.exe rev-list --no-walk da3b7456cf40552cdc66daf2d2db4ed43762c8e4 # timeout=10
10:55:34 Path To MSBuild.exe: D:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\MSBuild\15.0\Bin\MSBuild.exe
...
 
10:55:43 [WS-CLEANUP] Deleting project workspace...
10:55:43 [WS-CLEANUP] done
10:55:43 Finished: SUCCESS

git上显示构建状态

在Build中添加Set build status to "pending on Github commit"，在构建前可以更新Git的提交的状态为pending

若构建时上面步骤出现异常错误为ERROR: [Github Commit Status Setter] Failed to update commit state on Github. Ignoring exception [Cannot retrieve Git metadata for the build]，则检查Git和GitClient插件的版本,下面的rc版本有bug会导致无法更新状态待git，使用后面的版本即可。

在Post-build Action添加Set Github commit status(universal)

修改圈中的项，构建成功后就会更新对应的状态到Git。

通过上面配置完后就可以显示Jenkins的构建状态了

自动触发构建

Jenkins支持2种配置方式

1. 手工模式
   手工模式需要在git人工配置jenkins的webhook的通知接收地址，地址格式为$JENKINS_BASE_URL/Github-webhook/，如：http://127.0.0.1:8080/Github-webhook/。
2. 自动模式
   自动模式会通过Github的api自动创建webhook

详细文档可以查看Github Plugin插件文档。

手工模式

在Build Triggers选择Github hook trigger for GITScm polling

Github上面需要添加一个钩子，用于代码push完成后通知jenkins构建。
在设置中点击Webhooks

点击添加Webhooks

由于Github需要通知到我本地的jenkins服务,因此Jenkins的钩子回调地址必须能被Github访问到，我用花生壳做了内网穿透。

将Jenkins的钩子地址配置到Github的webhooks中。只需要push事件即可。

自动模式

在系统设置中找到Github服务器，添加一个凭证，点击连接测试。若显示Credentials verified for user XXXX, rate limit: XXXX即表示连接成功，由于Github有访问限制具体查看Understanding rate limits for Github Apps。
然后点击Advanced后可以修改hook的url，我在本地默认是127.0.0.1的地址，Github肯定是访问不到的，需要修改为正确的可被外部访问到的外网地址。

设置完后当修改Job的配置保存时就会触发创建Github的钩子。

但是发现通过Github无法通知到我本地的jenkens,一值显示超时。

测试了下通知地址外网是可以访问到的，因此怀疑是不是由于某些原因导致Github无法访问进来。

Gitlab持续集成

由于在国内Github访问速度不是很理想，大部分公司都会搭建私有的Git仓库，比如Gitlab。

为了方便，我直接将Github的项目导入到了Gitlab中，具体导入方法可以查看如何从Github迁移到Gitlab？

同时我需要在VS项目中添加Gitlab的远程库。
在VS团队资源管理器-存储库中添加一个远程。

安装插件

安装必要的插件Gitlab Authentication plugin 、Gitlab Hook Plugin、Gitlab Plugin。

需要注意的是安装Gitlab Hook Plugin插件的时候，若Jenkins的安装目录路径存在空格,则可能安装失败。原因是因为Gitlab Hook Plugin 依赖于ruby-runtime,而ruby-runtime不支持有空格的路径。因此解决办法是将jenkins迁移到无空格的路径下，如我本来安装的目录是D:\Program Files (x86)\Jenkins,将其迁移到D:\Jenkins。具体步骤如下：

1. 打开任务管理器或到windows服务中找到Jenkins，关闭Jenkins服务。
2. 将Jenkins整个复制到D:\Jenkins。
3. 去注册表计算机\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Jenkins修改Jenkins服务路径。为D:\Jenkins。

4. 启动Jenkins服务

Gitlab Hook Plugin插件可能有个安全问题会提示警告。

通过上述步骤Gitlab Hook Plugin插件就能安装成功了

配置Gitlab账号

在Jenkins系统设置中找到Gitlab的配置

钩起Enable authentication for '/project' end-point，这样在Gitlab通知时需要身份验证，保证安全性。

添加Token

到Gitlab右上角的用户头像点击右键找到Setting

然后找到Access Token生成一个Token，只需要勾选api权限即可。

添加凭据

将生成好的Token复制下来，回到Jenkins配置

添加一个凭据，选择Gitlab API token，使用刚才生成的token添加即可。

添加完成后测试连通性显示Success即可。
在Gitlab connections我们需要增加如何连接Gitlab,和Github一样，我们需要增加一个token，用于授权Jenkins的访问。

配置Git地址

修改Git路径。选择刚才添加的Gitlab连接。

修改源码管理中的项目路径

我们可以使用用户名密码或者token的方式访问Gitlab

配置钩子

在Build Triggers中勾选Build when a change is pushed to Gitlab,后面会生成钩子路径，如果是本地注意将后面的回环地址ip改为本地ip。
在Secret token点击生成一个token，这个token是用于授权web hook访问的。若没有配置在钩子触发是可能会返回403错误码。

到Gitlab添加一个web钩子，在Setting-Integrations中配置
将刚才的钩子通知地址输入，我本地无需SSL，因此去除了勾选，只有在Push的时候才需要触发。然后添加钩子。

添加完成点击Push events发起一个测试，

返回200则表明触发成功。

通知Gitlab状态

在Job的配置中Post-build action添加Publish build status to Gitlab,构建完后就可通知到Gitlab上构建状态。

结语

本章完成了使用Github和Gitlab进行源代码管理进行持续集成。但是Github由于无法通知到我本地的jenkins所以无法自动构建。

无论使用SVN还是GIT进行源码管理，整体流程不变，自动通知的关键都是代码提交后通知Jenkins触发构建。

SVN	Git
通过客户端或SVN服务器钩子，代码提交后执行脚本通知Jenkins。	代码push后，Git通过web hook通知Jenkins

参考文档

1. 手把手教你搭建Jenkins+Github持续集成环境
2. Webhooks Guide
3. Understanding rate limits for Github Apps
4. 使用Github的webhooks进行网站自动化部署
5. Jenkins详细实践:SpringBoot+Jenkins+Gitlab+Docker-Maven插件
6. Github Commit Status Setter - Cannot retrieve Git metadata

---

微信扫一扫二维码关注订阅号杰哥技术分享
本文地址：https://www.cnblogs.com/Jack-Blog/p/10346032.html
作者博客：杰哥很忙
欢迎转载，请在明显位置给出出处及链接