我们先过一遍部署 Jenkins 服务的步骤,因为网上讲这块内容的资料很多,所以我只说一些重点步骤和需要出错的点。我的需求是实现一个局域网内可用的 Jenkins 服务,部署步骤会相对简单,首先需要一台长时间开机的服务主机,这里以 Window 为例。
localhost:7777
。需要在其他局域网主机访问时,先使用 ipconfig
查看本机 ip,再使用 ip:7777
访问,然后用 第 5 步 的管理员账号登录。即可进入 Jenkins Web 界面:
完成以上步骤后,一个简单的 Jenkins 服务就部署好了。
在真正开始你的 Jenkins 任务时,你还需要先做一些额外的配置工作,顺便你可以了解一下 Jenkins 的操作界面和相关概念。
Jenkins 可以通过插件进行扩展,你可以直接使用 Jenkins 插件中心现有的插件,搭建属于你的持续集成流程。
进入插件中间可以看到 “可更新 - 可选插件 - 已安装” 这几项,“可更新” 的列表习惯性保持更新即可。小彭的项目和下面的示例会用到 GitLab、Qy Wechat Notification 这两个插件,那你顺便在 “可选插件” 中下载安装 GitLab 的插件吧,勾选插件后点击底部的 Install 按钮执行安装。
安装过程中可以勾选 “安装完成后重启 Jenkins(空闲时)”,因为有些插件需要重启 Jenkins 服务才会生效,我们索性保持重启的习惯。需要手动重启可以,直接访问:ip:7777/reload
。
Jenkins 可以与第三方应用平台(Github / GitLab)进行交互,这些应用通常都会做权限控制,因此你需要在 Jenkins 上配置身份凭证(credentials)。目前,Jenkins 可以存储下面几种类型的凭证:
凭证 | 描述 |
---|---|
Secret text | API Token(例如:GitHub 的个人 access token) |
Username with password | username:password 格式的字符串(例如:GitHub的用户名和密码) |
Secret file | 文件形式的加密内容 |
SSH Username with private key | SSH 私钥(例如:在 GitHub 上配置 SSH 公钥,在 Jenkins 上配置 SSH 私钥) |
Certificate | PKCS#12 证书文件和可选的密码 |
Docker Host Certificate Authentication | Docker 主机证书身份验证凭证 |
具体添加凭证的操作步骤参考这篇文章,非常详细清晰:Jenkins:添加 SSH 全局凭证
Global Tool Configuration 用于配置构建工具的安装路径,或自动安装程序,比如这里配置自动安装 Gradle 工具:
Configure System 用于配置全局可用的构建配置,例如 Jenkins URL、全局环境变量等:
这里我们需要配置 ANDROID_SDK_ROOT 和 GRADLE_USER_HOME 两个环境变量,否则后面在执行构建任务时会出错:
* What went wrong:
Could not determine the dependencies of task ':app:compileDebugJavaWithJavac'.
> SDK location not found. Define location with an ANDROID_SDK_ROOT environment variable or by setting the sdk.dir path in your project's local properties file at 'C:\ProgramData\Jenkins\.jenkins\workspace\JenkinsTest2\local.properties'.
> Could not resolve all files for configuration ':app:debugRuntimeClasspath'.
> Failed to transform appcompat-1.2.0.aar (androidx.appcompat:appcompat:1.2.0) to match attributes {artifactType=android-compiled-dependencies-resources, org.gradle.category=library, org.gradle.dependency.bundling=external, org.gradle.libraryelements=aar, org.gradle.status=release, org.gradle.usage=java-runtime}.
> Execution failed for AarResourcesCompilerTransform: C:\Windows\System32\config\systemprofile\.gradle\caches\transforms-2\files-2.1\b9972f23873aac7b9a345e4f8f7b8547\appcompat-1.2.0.
> Android resource compilation failed
ERROR:: AAPT: C:\Windows\System32\config\systemprofile\.gradle\caches\transforms-2\files-2.1\f05998388cdecf8820753332a73f5edf\androidx.appcompat: error: 系统找不到指定的文件。(2)
准备工作做好后,现在我们可以开始搭建自己的构建项目了。从首页 “New Items” 可以进入创建项目页面,其中 Freestyle 和 Pipeline 这两种项目类型最常用多,我们先从简单的 Freestyle 自由风格的项目开始。其实 Jenkins 可以玩的非常多,我们今天只讲最主要的内容。学习一个新东西要用先整体到局部的策略,避免一开始就陷入到细枝末节中。
先构想下我们的第一个 Jenkins 项目需要实现的能力:编译构建 Android 项目,并在构建成功后通知到企业微信。 一步步来吧:
assembleDebug
。需要特别注意要使用与工程相同的 Gradle 版本,也可以直接使用 Use Gradle Wrapper 选项,Jenkins 会自动下载项目所需的 Gradle 版本。
到这里,一个 Jenkins 的 Demo 项目就搭建好了,在项目面板的 Build with Parameters 中可以看到参数配置界面:
6、触发构建: 你可以直接点击界面按钮来触发构建,也可以使用 第 3 步 设置的远程触发器,直接在浏览器访问:
http://ip:7777/job/91160AndroidDaily/build?token=myToken
http://ip:7777/job/91160AndroidDaily/buildWithParameters?token=myToken&BRANCH=feature_user
进入构建任务详情,还可以在 “控制台输出” 可以查看日志:
Jenkins 可以实现自动化执行构建任务,你可以选择不同的构建触发器来设置触发条件,有些触发器需要安装特别的 Jenkins 插件才有。我将常见的 Jenkins 的构建触发器归纳为 3 类:手动触发 - 周期触发 - 关联触发,并举了一些例子:
类别 | 触发器举例 | 描述 |
---|---|---|
手动触发 | 触发远程构建(例如,使用脚本) | 通过访问特定的 URL 链接来触发,URL 中会拼接身份验证令牌(Token)来做身份确认 |
周期触发 | Build periodically | 间隔一个周期触发 |
周期构建 | Poll SCM | 周期性检查源码仓库变化,如果变化则触发(注意:因为需要对比整个 CVS 工作空间,这是个相对耗时的操作) |
关联触发 | Build after other projects are built | 在其它 projects 构建后触发(例如在构建后触发自动化测试的构建任务) |
关联构建 | GitHub hook trigger for GITScm polling | 向 GitHub 提交代码时触发构建 |
这里着重总结一下 Build periodically 触发器的日程表语法,其他触发器在实践中用到再讲吧。
日程表其实就是配置构建周期 / 频率,语法上分为 5 个参数,每个参数中间由一个空格分隔:
例如:
H 9 * * *
表示每天 9 点随机分钟执行0 1 1 * *
表示每月 1 号的 1 点执行0 1 * * 1-5
表示每周 1 到周五 1点执行0 1-12/3 * * *
表示每天 1 点到 12点,间隔 3 小时执行一次其中 * 表示 “全部”,比如月参数 * 号,则表示从 1 月到 12 月
其中 - 表示区间,比如星期参数 1-5,则表示周 1 到周 5
其中 / 表示间隔,比如日参数 1-12/3,则表示 1 点到 12 点每间隔 3 小时
到这里,Jenkins 的入门教程就讲完了,你学会了吗?有少部分比较聪明的小伙伴就会问了:你这讲的东西太少了,什么 Pipeline 流水线、多渠道打包这些东西都没讲到。是的,首先我认为 Jenkins 说到底只是一个效率工具,工具能够掌握到解决问题的程度即可,不要本末倒置。其次,我们完成了 Jenkins 的主线任务,接下来再去做支线任务就游刃有余了。期待下续集,我们下次见。