某小型公司持续集成工具jenkins实践（JAVA WEB、Android、IOS、html）

前言

本文多是网上最全的一篇全端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安装，终端执行

brew install jenkins复制代码

等安装完成后，终端运行jenkins便可启动。

jenkins复制代码

安装 xcode

这个比较简单，直接从appstore下载最新版便可。
安装后，将公司项目拉入xcode，先保证项目在本机编译，这里我登陆了app开发者账号，以便下载各类证书及发布。

安装 Android studio

这个到这里下载www.android-studio.org/

同理将本地项目拉入，运行。这一步主要是怕开发环境引发的坑，先把项目跑起来，后面坑会少点。

设置

进入设置，复制出sdk文件路径，后面须要使用。我这里是/Users/Shaolei/Library/Android/sdk

sdk路径

安装git

由于咱们公司用的是git，若是贵公司使用svn，则同理，只需保git或者svn命令能够敲出来便可。
我这里的版本比较老，尽可能使用新的，我懒得换了。

mac:~ shaolei$ git version
git version 2.11.0复制代码

安装source tree

这是一个很是好用的git可视化工具，改天会具体介绍它的强大功能。
这款软件不是必须的，只是为了方便项目拉取，因此，你能够跳过此步骤。

配置jenkins环境

这里才是相当重要的一项，本文的核心

配置插件

下载插件

1. Android Emulator Plugin

   Starts an Android emulator with given properties before a build, then shuts it down after.复制代码

2. build timeout plugin

   This plugin allows builds to be automatically terminated after the specified amount of time has elapsed.复制代码

3. Email Extension Plugin

   This plugin is a replacement for Jenkins's email publisher 复制代码

4. Gradle Plugin

   This plugin allows Jenkins to invoke Gradle build scripts directly.复制代码

5. Keychains and Provisioning Profiles Management

   This plugin integrates management of keychain and provisioning files for iOS and OSX projects.复制代码

6. 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, ...).    复制代码

7. Pipeline

   A suite of plugins that lets you orchestrate automation, simple or complex. See Pipeline as Code with Jenkins for more details.    复制代码

8. Pipeline: GitHub Groovy Libraries

   Allows Pipeline Grrovy libraries to be loaded on the fly from GitHub.复制代码

9. SSH Slaves plugin

   Allows to launch agents over SSH, using a Java implementation of the SSH protocol.复制代码

10. Subversion Plug-in

11. Timestamper

    Adds timestamps to the Console Output复制代码

12. Workspace Cleanup Plugin

    This plugin deletes the project workspace after a build is finished.复制代码

13. 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/59302a…

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/59648b…

java项目job

由于公司人员少，项目版本若是让开发去控制，比较繁琐，每一个开发得不停的增长版本号，这里我使用jenkins去控制版本号，这样也方便查询和回滚代码。
固然啦，实现war的升级和回滚可看另一篇文章 juejin.im/post/59633a…

cd ${WORKSPACE}
mvn clean
cd ${WORKSPACE}/******/src/main/resources/
echo ${BUILD_NUMBER} >ver.xml复制代码

固然了，这里用到了几个关键词变量，是jenkins特有的，更多变量参照下文：

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解压到指定目录便可。

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各项目持续继承方案，由于涉及环境过多，坑仍是比较多的，但愿自行填坑。