jenkins搭建

本文是基于宝塔面板的,如果自己搭建服务差别不大,根据自己的调整,这里不做展开。
如果需要安装宝塔面板,自行搜索。当然还必须要有一个云服务器,这个也自行查询如何解决。

jenkins要支持web网页,那么就要有web服务支持,一般都使用tomcat。在宝塔配置安装tomcat

安装完后 tomcat 目录在 www -> server -> tomcat
宝塔面板中放行 8080 端口,注意:还需在阿里云或者腾讯云放行 8080 端口

现在复制宝塔面板地址,端口改为8080,安装成功可以看到以下界面


image.png

安装 jenkins
安装Jenkins的方式有多种,可以运行对应系统类型的安装包,可以通过docker获取镜像,也可以直接运行war包。

我个人倾向于直接运行war包的形式,只需下载jenkins.war后,运行如下命令即可启动Jenkins。

http://updates.jenkins-ci.org/download/war/
我选择的版本是Jenkins 2.346.2

image.png

下载jenkins,得到 war 包后上传到 www -> server -> tomcat -> webapps

image.png

然后重启 apache,访问 宝塔面板ip:8080/jenkins 就能看到以下界面了,Jenkins的默认端口为8080

image.png

初始密码在/home/www/.jenkins/secrets/initialAdminPassword


image.png

获取到密码填入上面的网页,点击继续


image.png

Jenkins有非常多的插件,可以实现各种功能的扩展。如果空间足够,直接点击推荐插件,继续安装,


image.png
image.png
image.png

到这里jenkins就安装完毕了。

看一下存在的问题


image.png

上网搜了一下,多数的解答都是:系统管理–>系统设置里的Jenkins URL没有写对。首先检查一下这里配置,如果改过启动端口号,这里是需要保持一致的,并且IP需要设置为外网的IP,不能是localhost或127.0.0.1。不过我这里配置的没有问题,重启多次问题依旧。

本人是将jenkins.war放在tomcat容器中运行,访问Jenkins-系统管理,会提示“反向代理设置有误”
https://blog.nowcoder.net/n/1cc86e51337e4c0892ffd2ac36af12dc
这位博主提供了下面两种解决方法
在tomcat上部署jenkins的确有这一问题,可以直接点击【不再显示】就可以了,不会有什么影响
也可以换成java -jar来运行jenkins,就不会有这问题了

java 11

sudo yum search java-11
安装java 11
sudo yum install java-11-openjdk -y
安装完之后,并不会自动切换到11,
java -version
which java
发现还是1.8

通过alternatives选择版本,如下图,选择第三个,即我们刚安装的java11
sudo alternatives --config java
java -version 发现成功切换了


image.png
image.png
image.png

Jenkins插件

Jenkins插件
image.png

针对搭建的iOS/Android持续集成打包平台,我使用到了如下几个插件。

  • GIT plugin (默认已安装)
  • SSH Credentials Plugin
  • Git Changelog Plugin: 获取仓库提交的commit log
  • Git Parameter
  • Multiple SCMs 多个git项目
  • build-name-setter:用于修改Build名称
  • description setter plugin:用于在修改Build描述信息,在描述信息中增加显示QRCode(二维码)
  • PostBuildScript:在编译完成后通过执行脚本实现一些额外功能
  • Xcode integration: iOS专用(可选)
  • Gradle plugin: Android专用(可选 默认已安装)

安装方式也比较简单,直接在Jenkins的插件管理页面搜索上述插件,点击安装即可。安装完毕之后需要重启jenkins,即重新加载配置。

如果安装完插件,重启卡住了,因为我们是通过tomcat运行的,所以可以直接重载tomcat的配置即可。

flutter 打包环境搭建

官方告诉我们使用snap安装flutter,或者手动安装

sudo snap install flutter --classic

我们当然没有安装snap,所以查找snap安装教程安装对应系统版本,最后终于成功了。

cat /etc/centos-release 查看系统版本,对应的是centos7


image.png
image.png
$ sudo yum install epel-release
$ sudo yum install snapd
$ sudo systemctl enable --now snapd.socket
$ sudo ln -s /var/lib/snapd/snap /snap
$ sudo snap install flutter --classic

如果不形,安装一下sudo snap install snap-store

flutter sdk-path

很不幸的是没有发现flutter命令,我们看到snap/bin/底下已经有了flutter dart的软连接,也就是说只要把snap/bin/加入全局即可
vi .bash_profile

snap_bin_path="/snap/bin"

export PATH=$PATH:${snap_bin_path}

source .bash_profile

echo $PATH

flutter doctor -v

image.png

真正的flutter安装在snap/flutter/目录底下


image.png

android sdk

https://developer.android.google.cn/studio
如果不需要adnroid studio可以下载下面的commandlinetools,如果需要其他版本可以使用sdkmanager来安装

image.png

下载android sdk,选择一个目录存放,我这里选择/home/android
cd /home/android/

commandlinetools-linux-8512546_latest.zip 为当前最新可下载的SDK tools 版本
安装 SDK
cmd指令:wget https://dl.google.com/android/repository/commandlinetools-linux-8512546_latest.zip
其中commandlinetools-linux-8512546_latest.zip为上面截图中红色圈选的版本,安装时可根据官网最新版本进行替换下载

unzip commandlinetools-linux-8512546_latest.zip

cd cmdline-tools/


image.png

bin包含sdkmanager工具

其次,配置sdkmanager全局变量PATH

vi ~/.bash_profile

export SDK_HOME=/home/android
# 配置sdkmanager环境
export PATH=${SDK_HOME}/cmdline-tools/bin:$PATH 
# 配置通过cmdline-tools中的sdkmanager下载下来的tools中的sdkmanager
export PATH=${SDK_HOME}/tools/bin:$PATH  

执行 source ~/.bash_profile 重新加载配置文件后生效
最后,以上环境配置好之后,可以执行下面指令进行检查sdkmanager是否安装成功以及对应的版本信息

sdkmanager --sdk_root=/home/android/ --version

image.png

列出已安装和可用的软件包
sdkmanager --sdk_root=/home/android/ --list

我们项目选择的是android-31以及31.0.0

sdkmanager --sdk_root=/home/android/ "platform-tools" 
sdkmanager --sdk_root=/home/android/ "platforms;android-31" 
sdkmanager --sdk_root=/home/android/ "build-tools;31.0.0"

下载了platform-tools之后,我们就可以把adb也一块配置上去了
vi ~/.bash_profile

# 配置adb环境
export PATH=${SDK_HOME}/platform-tools:$PATH 

source ~/.bash_profile 重新加载配置文件后生效

image.png

至此,androidSdk即安装完成!

gradle下载

gradle 我们可以选一个目录存储,这里是/home/gradle/

https://services.gradle.org/distributions/

image.png

wget https://services.gradle.org/distributions/gradle-7.4-all.zip
unzip gradle-7.4-all.zip

vi ~/.bash_profile

export GRADLE_HOME=/home/gradle/gradle-7.4
# 配置gradle环境
export PATH=${GRADLE_HOME}/bin:$PATH 

执行 source ~/.bash_profile 重新加载配置文件后生效

image.png
image.png

创建项目(Job)

在Jenkins中,构建项目以Job的形式存在,因此需要针对每个项目创建一个Job。有时候,一个项目中可能有多个分支同时在进行开发,为了分别进行构建,也可以针对每个分支创建一个Job。

创建Job的方式有多种,本次只需要创建Freestyle project类型的即可。

Main page -> New Item -> Freestyle project

对于一个持续集成打包平台,每次打包都由4步组成:触发构建、拉取代码、执行构建、构建后处理。对应的,在每个Job中也对应了这几项的配置。

源码管理

选择Git管理填入git地址
添加项目的用户凭证
指定分支为:$branch,这里是引用的其他变量,用于分支的选择


image.png

要对项目进行构建,配置项目的代码仓库是必不可少的。由于当前我们的项目托管在GitHub私有仓库中,因此在此需要对Git进行配置。

【Source Code Management】配置栏目下,如果之前GIT plugin安装成功,则会出现Git选项。

配置Git代码仓库时,有三项是必须配置的:仓库URL地址(Repository URL)、仓库权限校验方式(Credentials),以及当前Job需要构建的代码分支(Branches to build)。

在配置Repository URL时,选择HTTPS URLSSH URL均可。不过需要注意的是,Credentials要和Repository URL对应,也就是说:

  • 如果Repository URLHTTPS URL形式的,那么Credentials就要采用GitHub用户名密码的校验方式;而且,如果在GitHub中开启了2FA(two-factor authentication),那么还需要在GitHub中创建一个Personal access token,输入密码时将这个Personal access token作为密码进行输入。
  • 如果Repository URLSSH URL形式的,那么就需要先在Jenkins所在的服务器上创建一个SSH秘钥对,并将公钥添加到GitHub的SSH keys中,然后在填写Credentials时,选择SSH Username with private key的校验方式,填入GitHub Username、SSH私钥、以及创建SSH秘钥对时设置的Passphrase

如果对Git权限校验的概念还比较模糊,可以参考《深入浅出Git权限校验》。

在配置Branches to build时,可以采用多种形式,包括分支名称(branchName)、tagNamecommitId等。其中分支名称的形式用的最多,例如,若是构建master分支,则填写refs/heads/master,若是构建develop分支,则填写refs/heads/develop

除了以上关于Git的必填配置项,有时根据项目的实际情况,可能还需要对Jenkins的默认配置项进行修改。

比较常见的一种情况就是对clone的配置进行修改。

在Jenkins的默认配置中,clone代码时会拉取所有历史版本的代码,而且默认的超时时限只有10分钟。这就造成在某些项目中,由于代码量本身就比较大,历史版本也比较多,再加上网络环境不是特别好,Jenkins根本没法在10分钟之内拉取完所有代码,超时后任务就会被自动终止了(错误状态码143)。

这种问题的解决方式也很简单,无非就是两种思路,要么少拉取点代码(不获取历史版本),要么提高超时时限。对应的配置在Advanced clone behaviours中:

  • Shallow clone:勾选后不获取历史版本;
  • Timeout (in minutes) for clone and fetch operation:配置后覆盖默认的超时时限。

对 Job 进行配置

在 General 配置中,选择 参数化构建过程 中的 Git Parameter 选项,然后按下面进行配置。

使用 Git Parameter 插件


image.png

配置完 Git Parameter 参数后,这里在源码管理选项中配置 Git 选项,输入 Git 项目 URL 地址,如果是私有 Git 项目的话还要配置凭据。最后配置分支选项,里面引用上面设置 Git Parameter 参数中设置的参数名,通过 ${参数名} 引用。

image
image.png

构建
在Execute shell中添加项目构建命令:

配置构建触发器

代码仓库配置好了,意味着Jenkins具有了访问GitHub代码仓库的权限,可以成功地拉取代码。

那Jenkins什么时候执行构建呢?

这就需要配置构建触发策略,即构建触发器,配置项位于【Build Triggers】栏目。

触发器支持多种类型,常用的有:

  • 定期进行构建(Build periodically)
  • 根据提交进行构建(Build when a change is pushed to GitHub)
  • 定期检测代码更新,如有更新则进行构建(Poll SCM)

构建触发器的选择为复合选项,若选择多种类型,则任一类型满足构建条件时就会执行构建工作。如果所有类型都不选择,则该Jenkins Job不执行自动构建,但可通过手动点击【Build Now】触发构建。

关于定时器(Schedule)的格式,简述如下:

MINUTE HOUR DOM MONTH DOW

  • MINUTE: Minutes within the hour (0-59)
  • HOUR: The hour of the day (0-23)
  • DOM: The day of the month (1-31)
  • MONTH: The month (1-12)
  • DOW: The day of the week (0-7) where 0 and 7 are Sunday.

通常情况下需要指定多个值,这时可以采用如下operator(优先级从上到下):

  • *适配所有有效的值,若不指定某一项,则以*占位;
  • M-N适配值域范围,例如7-9代表7/8/9均满足;
  • M-N/X*/X:以X作为间隔;
  • A,B,C:枚举多个值。

另外,为了避免多个任务在同一时刻同时触发构建,在指定时间段时可以配合使用H字符。添加H字符后,Jenkins会在指定时间段内随机选择一个时间点作为起始时刻,然后加上设定的时间间隔,计算得到后续的时间点。直到下一个周期时,Jenkins又会重新随机选择一个时间点作为起始时刻,依次类推。

为了便于理解,列举几个示例:

  • H/15 * * * *:代表每隔15分钟,并且开始时间不确定,这个小时可能是:07,:22,:37,:52,下一个小时就可能是:03,:18,:33,:48
  • H(0-29)/10 * * * *:代表前半小时内每隔10分钟,并且开始时间不确定,这个小时可能是:04,:14,:24,下一个小时就可能是:09,:19,:29
  • H 23 * * 1-5:工作日每晚23:00至23:59之间的某一时刻;

配置构建方式

触发策略配置好之后,Jenkins就会按照设定的策略自动执行构建。但如何执行构建操作,这还需要我们通过配置构建方式来进行设定。

常用的构建方式是根据构建对象的具体类型,安装对应的插件,然后采用相应的构建方式。例如,若是构建Android应用,安装Gradle plugin之后,就可以选择Invoke Gradle script,然后采用Gradle进行构建;若是构建iOS应用,安装Xcode integration插件之后,就可以选择Xcode,然后选择Xcode进行构建。

该种方式的优势是操作简单,UI可视化,在场景不复杂的情况下可以快速满足需求。不过缺点就是依赖于插件已有的功能,如果场景较复杂时可能单个插件还无法满足需求,需要再安装其它插件。而且,有些插件可能还存在一些问题,例如对某些操作系统版本或XCode版本兼容不佳,出现问题时我们就会比较被动。

我个人更倾向于另外一种方式,就是自己编写打包脚本,在脚本中自定义实现所有的构建功能,然后在Execute Shell中执行。这种方式的灵活度更高,各种场景的构建需求都能满足,出现问题后也能自行快速修复。

另外,对于iOS应用的构建,还有一个需要额外关注的点,就是开发者证书的配置。

如果是采用Xcode integration插件进行构建,配置会比较复杂,需要在Jenkins中导入开发证书,并填写多个配置项。不过,如果是采用打包脚本进行构建的话,情况就会简单许多。只要在Jenkins所运行的计算机中安装好开发者证书,打包命令在Shell中能正常工作,那么在Jenkins中执行打包脚本也不会有什么问题。

构建后处理

完成构建后,生成的编译成果物(ipa/apk)会位于指定的目录中。但是,如果要直接在手机中安装ipa/apk文件还比较麻烦,不仅在分发测试包时需要将好几十兆的安装包进行传送,体验用户在安装时也还需要通过数据线将手机与计算机进行连接,然后再使用PP助手或豌豆荚等工具进行安装。

当前比较优雅的一种方式是借助蒲公英(pgyer)fir.im等平台,将ipa/apk文件上传至平台后由平台生成二维码,然后只需要对二维码链接进行分发,体验用户通过手机扫描二维码后即可实现快速安装,效率得到了极大的提升。

上传安装包文件,生成二维码

不管是蒲公英还是fir.im,都有对应的Jenkins插件,安装插件后可以在Post-build中实现对安装包的上传。

除了使用Jenkins插件,fir.im还支持命令上传的方式,蒲公英还支持HTTP Post接口上传的方式。

我个人推荐采用命令或接口上传的方法,并在构建脚本中进行调用。灵活是一方面,更大的好处是如果上传失败后还能进行重试,这在网络环境不是很稳定的情况下极其必要。

Jenkins成功完成安装包上传后,pgyer/fir.im平台会生成一个二维码图片,并在响应中将图片的URL链接地址进行返回。

展示二维码图片

二维码图片的URL链接有了,那要怎样才能将二维码图片展示在Jenkins项目的历史构建列表中呢?

这里需要用到另外一个插件,description setter plugin。安装该插件后,在【Post-build Actions】栏目中会多出description setter功能,可以实现构建完成后设置当次build的描述信息。这个描述信息不仅会显示在build页面中,同时也会显示在历史构建列表中。

有了这个前提,要将二维码图片展示在历史构建列表中貌似就可以实现了,能直观想到的方式就是采用HTMLimg标签,将写入到build描述信息中。

这个方法的思路是正确的,不过这么做以后并不会实现我们预期的效果。

这是因为Jenkins出于安全的考虑,所有描述信息的Markup Formatter默认都是采用Plain text模式,在这种模式下是不会对build描述信息中的HTML编码进行解析的。

要改变也很容易,Manage Jenkins -> Configure Global Security,将Markup Formatter的设置更改为Safe HTML即可。

更改配置后,我们就可以在build描述信息中采用HTMLimg标签插入图片了。

另外还需要补充一个点。如果是使用蒲公英(pyger)平台,会发现每次上传安装包后返回的二维码图片是一个短链接,神奇的是这个短连接居然是固定的(对同一个账号而言)。这个短连接总是指向最近生成的二维码图片,但是对于二维码图片的唯一URL地址,平台并没有在响应中进行返回。在这种情况下,我们每次构建完成后保存二维码图片的URL链接就没有意义了。

应对的做法是,每次上传完安装包后,通过返回的二维码图片短链接将二维码图片下载并保存到本地,然后在build描述信息中引用该图片在Jenkins中的地址即可。

收集编译成果物(Artifacts)

每次完成构建后,编译生成的文件较多,但是并不是所有的文件都是我们需要的。

通常情况下,我们可能只需要其中的部分文件,例如.ipa/.app/.plist/.apk等,这时我们可以将这部分文件单独收集起来,并在构建页面中展示出来,以便在需要时进行下载。

要实现这样一个功能,需要在【Post-build Actions】栏目中新增Archive the artifacts,然后在Files to archive中通过正则表达式指定成果物文件的路径。

设置完毕后,每次构建完成后,Jenkins会在Console Output中采用设定的正则表达式进行搜索匹配,如果能成功匹配到文件,则会将文件收集起来。

你可能感兴趣的:(jenkins搭建)