手把手搭建CI

第一个Build

CI Dojo的第二次课程,基于上次课程 CI基础 & Setup环境 搭建好的环境,通过Step by step的方式来搭建一个Jenkins CI

内容涵盖了两大部分, 配置JenkinsStep by step Build,Jenkins基础配置如下:

1. 配置系统环境。
2. 安装系统工具。
3. 安装实用Plugin。
4. 配置用户权限。

Step by step Build如下:

1. 构建触发策略。
2. 测试Success & Failure。
3. 测试报告。
4. 邮件通知。

配置Jenkins

夯实地基,方可建筑高楼

CI基础 & Setup环境 那节课程中,我们已经Setup了Jenkins CI,并成功启动了Jenkins服务,此时我们看到的只是一个非常基础的Jenkins,为了满足项目的需求,我们要对其做一些配置。比如邮件通知、用户权限配置,以及执行一些任务所用到的工具(GradleGitJDK等)。


配置系统环境

此时,我们所需要配置的系统环境并不复杂,所有配置都是在configuration页面完成,目录导航 Manage Jenkins -> Configure System,配置项包括:

1. Shell executable
2. E-mail notification
3. System Admin e-mail address

Shell Shell executable

将此项设置为bash,更加符合平时在Terminal上的操作习惯,个人习惯,属于建议项,配置如图:


E-mail notification

E-mail是一个很好的反馈通知机制,为build配置了Email通知,将会在build失败后第一时间通知相关人员,这也是CI反馈机制中的关键步骤,那么要启用邮件通知,需要我们配置全局的E-mail notification:

这里使用 网易126邮箱 的免费 SMTP 服务器,需要提供有效的邮箱账户,并且需要开启IMAP/SMTP服务,具体怎么开启,Google 或者 百度 中可以找到答案。

配置完成后,可以测试一下是否能够发送邮件,选中Test configuration by sending test e-mail,填上有效的邮箱地址,点击Test configuration即可,通常情况下,你会看到一些红色的异常信息,不要害怕,继续往 ⬇️ 看。


System Admin e-mail address

此项配置是为了保证E-mail通知的正常运行,因为Jenkins只允许系统管理员执行Email通知,所以只有系统管理员邮箱地址和发邮件的账户是一个账户是才可以成功发送邮件通知:


系统工具

全局的系统工具用来执行相关任务,比如Gradle执行编译、测试、打包等任务,Git去pull代码,JDK提供Java执行环境。在Jenkins中,我们可以通过GUI来配置一些基本的工具:Manage Jenkins->Global Tool Configuration

实践指导:
通常,我们不会在Jenkins Web GUI上配置安装这些工具,需要的工具我们会在Server机器上通过其他方式,比如:我们可以将安装命令放在provision的shell脚本中(可以使用Ansilbe脚本),在Vagrant up的时候进行自动化安装,此次Dojo我已经在 Dojo-ci 中提供了这个Shell脚本。


安装插件

工欲善其事必先利其器

Jenkins之所以强大并不是Jenkins自身有多么的强大,Jenkins提供了一个平台,因为它的易用性和开源,深受社区开发者的青睐,从而营造了一个良好的生态,各种实用插件的应运而生让Jenkins的功能变得越来越强大,几乎无所不能。就连Jenkins久遭诟病的外观,也有一款 Jenkins主题 插件来拯救它。所以插件是Jenkins中不可忽视的核心部分。

在Jenkins中,安装插件也是一件很容易的事情,导航到Manage Plugins页面(Manage Jenkins->Manage Plugins),在 Available Tab中搜索Jenkins,选中后点击安装。

此次Dojo,需要安装以下插件:

  • Simple Theme Plugin
    • 支持自定义Jenkins主题,从而美化Jenkins外观。推荐两个好用的主题:
  • Git plugin
    • 使用Git作为版本控制工具
  • Environment Injector Plugin
    • 给Build注入环境变量
  • Copy Artifact Plugin
    • 在某个project的build步骤中,复制其他project生成的artifact。
  • Build Pipeline plugin
    • 通常一个Build flow包含了多个Job,会有多个对应的project,此插件可以定义这些关联的project的执行顺序,并且可以定义触发下游project的条件(自动还是手动)。
  • Join plugin
    • 管理并行Job,能够保证当前project在所有直接的下游project完成后运行。
  • Build flow test aggregator
    • 将build flow中所有build的测试结果聚合展示出来,它提供的是post-build步骤。
  • Dependency Graph Viewer Plugin
    • 可视化project之间的依赖关系
  • JaCoCo plugin
    • 可以捕获由JaCoCo生成的代码覆盖率报告,而且会生成覆盖率趋势报告。

用户权限

Jenkins提供了用户权限控制,这其实是一个基础的配置。通常Jenkins上会包含一些敏感的信息和复杂的配置,以及手动一键部署的步骤,所以我们只允许拥有特定权限的用户才可以对Build执行相关操作,比如说匿名用户只有可读权限,sjyuan是管理员权限,use1只拥有 dojo-ci project的权限。

比较常用的认证方式是Matrix-based securityProject-based Matrix Authorization Strategy,前者配置的权限针对所有Project是一致的,而后者可以将用户权限绑定到某些具体的Project中。相对来说后者更加常用一些,这里以后者为例,sjyuan是管理员,在Global配置中分配了所有权限,而user1只拥有全局的Read Overall权限(这是前提条件,不然user1登陆后什么也看不到):

此时我们以sjyuan登录进去之后在dojo-ci-web project中给user1授予部分权限:

不管配置哪一种用户权限,我们使用的Security Realm都是Jenkins’ own user database:

实践指导:
第一次配置用户权限时,将当前用户设置为管理员权限,记得赋予admin权限,建议取消Allow users to sign up选项,统一由管理员给指定成员分配用户并授权。


Build in Action

基础的Jenkins已经配置就绪,我们来创建一个Build project来感受一下Jenkins的魅力。后面所有工作均可以在Web GUI上完成。

创建一个自由风格的工程,点击Home页面上New Itemlink进入创建页面:


基础配置

我们创建了一个名为 dojo-ci-web 的project,进入配置界面,来做一些基础的配置:

  1. 上述给user1赋予了该项目上的部分权限。
  2. 配置历史build的弃留策略。
  3. 配置了 Github project的url
  4. 另外还有一些配置,比如拷贝该项目Artifact的权限、环境准备、参数化项目等等,有兴趣的可以学习一下这些配置的用途,推荐 Jenkins Tutorial

配置Git Repository

Source code management栏配置Git Repository,需要提供一个Github账号,作为IT从业者,该账号应该不是问题,还没有的话可以到Github上注册一个


配置触发构建策略

Build Triggers栏配置触发构建策略:

Poll SCM,轮询Source Code Management,每个2分钟去检查Repository有没有新的提交,如果有,触发build,否则不做处理。轮询规则设置就是标准的Cron的规则,推荐一个在线调式的工具


运行测试

Build 栏添加build step,Add build step -> Execute shell

./gradlew clean test 命令是CI所配置的代码库中运行测试的gradle task,Gradle是一个用于Java工程的构建工具,做的事情跟Maven类似,只是目前更加受到Java Developer的青睐。

到这里我们先做一个保存,点击左下方的Save按钮,然后再次进入配置界面。


发布测试报告

运行测试完毕后,可以直观地看到测试状态 (绿色:成功,红色:失败),我们还可以在测试报告后发布测试报告,它的配置也很简单,只需要在 Post-build Actions栏中添加post-build操作,Add post-build action->Publish JUnit test result report


邮件通知

CI 不过夜,其实说的是要第一时间修复CI

通常,测试挂了,我们会希望第一时间通知相关人员去修复CI,不要让CI挂了还心安理得地过夜,这就需要一些有效的反馈机制了,此时我们会考虑引入邮件通知,前面我们已经配置好邮件服务器并测试通过了,此时需要添加一个Post-build ActionsAdd post-build action->E-mail Notification:

到此,一个可以报告测试状态的CI Build搭建起来,过程并不复杂,我们已经能够直观的看到CI的效果了。下一节课我们来讨论构建构建可持续部署Pipeline的策略并加以实践。

上节课内容回顾:CI基础 & Setup环境

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,951评论 6 497
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,606评论 3 389
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 160,601评论 0 350
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,478评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,565评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,587评论 1 293
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,590评论 3 414
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,337评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,785评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,096评论 2 330
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,273评论 1 344
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,935评论 5 339
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,578评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,199评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,440评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,163评论 2 366
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,133评论 2 352

推荐阅读更多精彩内容