来源:juejin.im/post/599fd5d151882524397f9fd3
- 前言
- 研究过程
- 效果图
- 安装jenkins
- 安装 xcode
- 安装 Android studio
- 安装git
- 安装source tree
- 配置jenkins环境
- 增加计划
- 总结
前言
本文可能是网上最全的一篇全端jenkins部署解决方案介绍的文章,一直以来,领导都想解决代码提交和打包问题,尤其是小公司,打包流程混乱,造成线上版本和代码库git或svn中代码不一致问题。加入jenkins阵营,解决众多发包难题,显得刻不容缓。
研究过程
刚开始,我一直在docker下安装jenkins,按时长租用阿里的主机,用阿里容器服务做实验,反复创建docker容器,建立多个jenkins节点。结果发现,在容器中配置各种变量比较复杂,各种开发环境不易快速部署,当然啦,是刚开始的对jenkins研究过少造成的。后来我采用了windows主机,配java、maven、Android环境,踩了一路坑,终于搞定了。但是我知道ios开发和编译必须使用mac系统,本来想增加一个jenkins节点来实现ios的编译。当配置好之后,我突然改变了主意,与其两台电脑开着,不如索性把整个jenkins部署到mac系统下(毕竟我们公司暂时没有c#工程)。于是,所有的操作,所有的环境我又折腾了一遍。下面我逐一讲解最终mac下实现全端jenkins持续集成,当然不包含c#,一路踩坑下来,我觉得这都不是事,流程都差不多。
效果图
jenkins首页
构建历史
安装jenkins
我个人比较喜欢新事物,所以建议使用较高版本,我使用的2.61,目前最新版是2.75。mac下使用brew安装,终端执行
代码语言:javascript复制brew install jenkins复制代码
等安装完成后,终端运行jenkins即可启动。
代码语言:javascript复制jenkins复制代码
安装 xcode
这个比较简单,直接从appstore下载最新版即可。安装后,将公司项目拉入xcode,先保证项目在本机编译,这里我登录了app开发者帐号,以便下载各种证书及发布。
安装 Android studio
这个到这里下载www.android-studio.org/
同理将本地项目拉入,运行。这一步主要是怕开发环境引起的坑,先把项目跑起来,后面坑会少点。
设置
进入设置,复制出sdk文件路径,后面需要使用。我这里是/Users/Shaolei/Library/Android/sdk
sdk路径
安装git
因为我们公司用的是git,如果贵公司使用svn,则同理,只需保git或者svn命令可以敲出来即可。我这里的版本比较老,尽量使用新的,我懒得换了。
代码语言:javascript复制mac:~ shaolei$ git version
git version 2.11.0复制代码
安装source tree
这是一个非常好用的git可视化工具,改天会具体介绍它的强大功能。这款软件不是必须的,只是为了方便项目拉取,所以,你可以跳过此步骤。
配置jenkins环境
这里才是至关重要的一项,本文的核心
配置插件
下载插件
- Android Emulator Plugin
Starts an Android emulator with given properties before a build, then shuts it down after.复制代码
- build timeout plugin
This plugin allows builds to be automatically terminated after the specified amount of time has elapsed.复制代码
- Email Extension Plugin
This plugin is a replacement for Jenkins's email publisher 复制代码
- Gradle Plugin
This plugin allows Jenkins to invoke Gradle build scripts directly.复制代码
- Keychains and Provisioning Profiles Management
This plugin integrates management of keychain and provisioning files for iOS and OSX projects.复制代码
- Maven Integration plugin
This plug-in provides, for better and for worse, a deep integration of Jenkins and Maven: Automatic triggers between projects depending on SNAPSHOTs, automated configuration of various Jenkins publishers (Junit, ...). 复制代码
- Pipeline
A suite of plugins that lets you orchestrate automation, simple or complex. See Pipeline as Code with Jenkins for more details. 复制代码
- Pipeline: GitHub Groovy Libraries
Allows Pipeline Grrovy libraries to be loaded on the fly from GitHub.复制代码
- SSH Slaves plugin
Allows to launch agents over SSH, using a Java implementation of the SSH protocol.复制代码
- Subversion Plug-in
- Timestamper
Adds timestamps to the Console Output复制代码
- Workspace Cleanup Plugin
This plugin deletes the project workspace after a build is finished.复制代码
- Xcode integration
This plugin provides builders to build xcode projects, invoke agvtool and package .ipa files复制代码
其中Android Emulator Plugin、Gradle Plugin是安卓必须插件;其中Keychains and Provisioning Profiles Management、Pipeline、Xcode integration是ios编译必须插件;其中Maven Integration plugin、SSH Slaves plugin是maven项目必须插件,其他的Email Extension Plugin这个是为了编译失败的时候通知具体提交代码开发人员邮件
配置系统设置
系统设置
Local Maven Repository为maven仓库地址;如果本机没有安装maven,可能需要增加maven仓库;下面需要加入安卓环境变量,即上文中提到的那个sdk地址;
这里配置github地址,邮件用户名密码,注意发件人的邮箱必须上面jenkins注册是管理员邮箱是一个,否则一直失败,这里是个坑。
增加计划
Android 项目job
创建安卓job
创建安卓项目
配置项目的git库地址
配置项目的git库地址
下面配置触发器,每隔1分钟检查一次git库,也可以使用subscribe订阅,这里暂不做讲解。
配置触发器
设置编译后,将文件拷贝到一个文件目录。这里使用smb协议连接到了一个内网文件服务器上,方便测试部门测试。
配置编译及邮件通知
至于具体为何执行2次拷贝,是因为项目同时编译测试环境地址和真实环境地址,只有连接的服务器地址不通,其他代码都相同,具体实现可看另外一篇博文juejin.im/post/684490…
ios项目job
和安卓相同的源代码管理及触发器不做介绍,请参照安卓,下文同理。
这里需要配置ios项目的tagert,可以通过xcode打开查看,勾选Pack application and build .ipa?,使jenkins生成ipa包
配置证书地址和密码,这里指的是 Keychain Keychain path默认地址为/Users/shaolei/Library/Keychains/login.keychain,其中shaolei为mac登录的用户名,密码就是登录密码。失败时邮件发送至影响代码的配置请参照安卓,下文同理。同时编译两个ipa包请查看juejin.im/post/684490…
java项目job
因为公司人员少,项目版本如果让开发去控制,比较繁琐,每个开发得不停的增加版本号,这里我使用jenkins去控制版本号,这样也方便查询和回滚代码。当然啦,实现war的升级和回滚可看另外一篇文章juejin.im/post/684490…
代码语言:javascript复制cd ${WORKSPACE}
mvn clean
cd ${WORKSPACE}/******/src/main/resources/
echo ${BUILD_NUMBER} >ver.xml复制代码
当然了,这里用到了几个关键词变量,是jenkins特有的,更多变量参照下文:
代码语言:javascript复制CHANGE_AUTHOR
For a multibranch project corresponding to some kind of change request, this will be set to the username of the author of the proposed change, if supported; else unset.
CHANGE_AUTHOR_DISPLAY_NAME
For a multibranch project corresponding to some kind of change request, this will be set to the human name of the author, if supported; else unset.
CHANGE_AUTHOR_EMAIL
For a multibranch project corresponding to some kind of change request, this will be set to the email address of the author, if supported; else unset.
CHANGE_TARGET
For a multibranch project corresponding to some kind of change request, this will be set to the target or base branch to which the change could be merged, if supported; else unset.
BUILD_NUMBER
The current build number, such as "153"
BUILD_ID
The current build ID, identical to BUILD_NUMBER for builds created in 1.597 , but a YYYY-MM-DD_hh-mm-ss timestamp for older builds
…………………………………………等等复制代码
h5项目job
这里我就用了zip打包,部署时使用zip解压到指定目录即可。
代码语言:javascript复制cd ${WORKSPACE}
echo ${BUILD_NUMBER} >ver.txt
zip -r h5.zip ./ -x .git* -x README.md -x .project -x .gitignore
cp ${WORKSPACE}/h5.zip /Volumes/***/H5/h5-${BUILD_NUMBER}.zip复制代码
总结
本文全面讲解了jenkins各项目持续继承方案,因为涉及环境过多,坑还是比较多的,希望自行填坑。