你的支持对我意义重大!
🔥 Hi,我是小彭。本文已收录到 GitHub · Android-NoteBook 中。这里有 Android 进阶成长路线笔记 & 博客,有志同道合的朋友,欢迎跟着我一起成长。(联系方式在 GitHub)
前言
- Jenkins 是一个基于 Java 开发的持续集成工具,能够很简单地作为一个可扩展的自动化服务器,为项目提供持续集成(Continuous Integration)的能力;
- 这篇文章里,我将手把手带你搭建 Jenkins 局域网服务,并实现一个简单的 Jenkins 项目。希望让你对 Jenkins 有一个基本的印象,知道搭建一个 Jenkins 项目大概的模型是怎么样的,就够了。如果能帮上忙,请务必点赞加关注,这真的对我非常重要。
1. 部署 Jenkins 局域网服务
我们先过一遍部署 Jenkins 服务的步骤,因为网上讲这块内容的资料很多,所以我只说一些重点步骤和需要出错的点。我的需求是实现一个局域网内可用的 Jenkins 服务,部署步骤会相对简单,首先需要一台长时间开机的服务主机,这里以 Window 为例。
-
1、下载 Jenkins 安装程序,并执行程序:官方网站
-
2、安装过程-选择登录权限分配类型: 这里选择 “Run server as LocalSystem” 选项(不推荐,但够满用):
-
3、安装过程-选择端口号: 选择一个闲置的端口即可,如果将来需要修改端口号,可以参考这篇文章修改:Jenkins教程:修改Jenkins端口号 —— .NET开发菜鸟 著
-
4、解锁 Jenkins: 在浏览器输入 localhost:7777,首次启动 Jenkins 需要解锁,根据提示操作即可:
-
5、创建管理员账户: 额外创建一个管理员账户,可以共享给小组的同学来登录 Jenkins 服务:
-
6、在其他主机访问 Jenkins 服务: 本机访问 Jenkins 服务可以访问
localhost:7777
。需要在其他局域网主机访问时,先使用ipconfig
查看本机 ip,再使用ip:7777
访问,然后用 第 5 步 的管理员账号登录。即可进入 Jenkins Web 界面:
完成以上步骤后,一个简单的 Jenkins 服务就部署好了。
2. 管理 Jenkins 环境
在真正开始你的 Jenkins 任务时,你还需要先做一些额外的配置工作,顺便你可以了解一下 Jenkins 的操作界面和相关概念。
2.1 下载 Jenkins 插件
Jenkins 可以通过插件进行扩展,你可以直接使用 Jenkins 插件中心现有的插件,搭建属于你的持续集成流程。
进入插件中间可以看到 “可更新 - 可选插件 - 已安装” 这几项,“可更新” 的列表习惯性保持更新即可。小彭的项目和下面的示例会用到 GitLab、Qy Wechat Notification 这两个插件,那你顺便在 “可选插件” 中下载安装 GitLab 的插件吧,勾选插件后点击底部的 Install 按钮执行安装。
安装过程中可以勾选 “安装完成后重启 Jenkins(空闲时)”,因为有些插件需要重启 Jenkins 服务才会生效,我们索性保持重启的习惯。需要手动重启可以,直接访问:ip:7777/reload
。
2.2 添加凭证(Credentials)
Jenkins 可以与第三方应用平台(Github / GitLab)进行交互,这些应用通常都会做权限控制,因此你需要在 Jenkins 上配置身份凭证(credentials)。目前,Jenkins 可以存储下面几种类型的凭证:
凭证 | 描述 |
---|---|
1、Secret text | API Token(例如:GitHub 的个人 access token) |
2、Username with password | username:password 格式的字符串(例如:GitHub的用户名和密码) |
3、Secret file | 文件形式的加密内容 |
4、SSH Username with private key | SSH 私钥(例如:在 GitHub 上配置 SSH 公钥,在 Jenkins 上配置 SSH 私钥) |
5、Certificate | PKCS#12 证书文件和可选的密码 |
6、Docker Host Certificate Authentication | Docker 主机证书身份验证凭证 |
具体添加凭证的操作步骤参考这篇文章,非常详细清晰:Jenkins:添加 SSH 全局凭证 —— .NET开发菜鸟 著
2.3 全局工具配置(Global Tool Configuration)
Global Tool Configuration 用于配置构建工具的安装路径,或自动安装程序,比如这里配置自动安装 Gradle 工具:
2.4 系统配置(Configure System)
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)
3. 第一个 Jenkins 项目
准备工作做好后,现在我们可以开始搭建自己的构建项目了。从首页 “New Items” 可以进入创建项目页面,其中 Freestyle 和 Pipeline 这两种项目类型最常用多,我们先从简单的 Freestyle 自由风格的项目开始。其实 Jenkins 可以玩的非常多,我们今天只讲最主要的内容。学习一个新东西要用先整体到局部的策略,避免一开始就陷入到细枝末节中。
先构想下我们的第一个 Jenkins 项目需要实现的能力:编译构建 Android 项目,并在构建成功后通知到企业微信。 一步步来吧:
-
1、参数化项目: Jenkins 支持在构建时增加入参(This project is parameterized),这里我们增加了一个 BRANCH 参数(默认值为 develop):
-
2、源码管理: 关联源码仓库,这里我们关联的是托管在 Gitlab 上的工程,在 “指定分支” 的地方使用了前面定义的参数 BRANCH。其中 Pengxr Window 是事先加好的 Jenkins 凭证,具体添加步骤可以回顾 2.2 添加凭证(Credentials)。
-
3、配置构建触发器: 触发器决定了构建任务触发的时机,允许同时设置多个触发器,只要其中一个触发器满足条件就会执行构建任务。这里先配置了最简单的 手动远程触发,其他触发器我们在 第 4 节 再讲。
-
4、定义构建任务: 构建任务定义了真正需要的构建逻辑,这里我们使用 invokeGradle 类型,具体的任务只是简单的
assembleDebug
。需要特别注意要使用与工程相同的 Gradle 版本,也可以直接使用 Use Gradle Wrapper 选项,Jenkins 会自动下载项目所需的 Gradle 版本。
-
5、定义构建后操作: 构建结束后可以做一些通知,比如向企业微信 / 钉钉发送一条消息。这里我们使用 Qy Wechat Notification 插件来向企业微信群发送消息:
到这里,一个 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
进入构建任务详情,还可以在 “控制台输出” 可以查看日志:
4. 构建触发器(Build Triggers)
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 个参数,每个参数中间由一个空格分隔:
- 分钟: 取值 0~59,特殊值 H 表示随机
- 小时: 取值 0~23
- 日: 取值 1~31
- 月: 取值 1~12
- 星期: 取值 0~7(0 和 7 是周日)
例如:
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 小时
5. 总结
到这里,Jenkins 的入门教程就讲完了,你学会了吗?有少部分比较聪明的小伙伴就会问了:你这讲得东西太少了,什么 Pipeline 流水线、多渠道打包这些东西都没讲到。是的,首先我认为 Jenkins 说到底只是一个效率工具,工具能够掌握到解决问题的程度即可,不要本末倒置。其次,我们完成了 Jenkins 的主线任务,接下来再去做支线任务就游刃有余了。期待下续集,我们下次见。
参考资料
- 开始使用 Jenkins —— 官方文档
- Jenkins:添加 SSH 全局凭证 —— .NET开发菜鸟 著
- Jenkins教程:修改Jenkins端口号 —— .NET开发菜鸟 著
你的点赞对我意义重大!微信搜索公众号 [彭旭锐],希望大家可以一起讨论技术,找到志同道合的朋友,我们下次见!
更多推荐
你的第一个 Jenkins 项目,从这里开始
发布评论