@TOC

一，Jenkins概述

Jenkins 是一款流行的开源持续集成（Continuous Integration）工具，广泛用于项目开发，具有自动化构建、测试和部署等功能。Jenkins起源于Hudson（Hudson是商用的），主要用于持续、自动的构建/测试软件项目、监控外部任务的运行（这个比较抽象，暂且写上，不做解释）。Jenkins用Java语言编写，可在Tomcat等流行的servlet容器中运行，也可独立运行。通常与版本管理工具(SCM)、构建工具结合使用。常用的版本控制工具有SVN、GIT，构建工具有Maven、Ant、Gradle。

在这里插入图片描述

二，Jenkins安装

1. 下载Jenkins官网

2. 安装 JDK/Maven

export JAVA_HOME=/usr/java/jdk1.8.0_111
export MAVEN_HOME=/opt/apache-maven-3.3.9

• 四种安装方式：

1. 离线安装

## http://pkg.jenkins-ci.org/redhat/
wget http://pkg.jenkins-ci.org/redhat/jenkins-2.39-1.1.noarch.rpm ## 下载(也可以Windows下载再转过来)
sudo rpm --import http://pkg.jenkins-ci.org/redhat/jenkins.io.key ## 公钥
sudo yum -y install jenkins-*.noarch.rpm

2. 在线安装

## http://pkg.jenkins-ci.org/redhat/
sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat/jenkins.repo
sudo rpm --import https://pkg.jenkins.io/redhat/jenkins.io.key
sudo yum -y install jenkins

3. 基于 Tomcat 安装

• 安装并启动 Tomcat；
• 从官网下载 jenkins.war至 $CATALINA_BASE/webapps，Tomcat 会自动部署；
• 浏览器访问：http://centos:8080/jenkins/

4. 免安装方式

wget http://mirrors.jenkins.io/war-stable/latest/jenkins.war
sudo java -jar jenkens.war ## 启动服务，直至看到日志 `Jenkins is fully up and running`
curl http://localhost:8080/ ## Jenkins 已就绪

3. 调整配置文件

## sudo vim /etc/sysconfig/jenkins
JENKINS_USER="root" ## 原值 "jenkins" 必须修改，否则权限不足
JENKINS_PORT="8080" ## 原值 "8080" 可以不修改
## 还有开启 HTTPS 相关参数，此处不打算开启，故不作说明

安装目录: /usr/lib/jenkins
工作目录: /var/lib/jenkins(对应于环境变量 JENKINS_HOME)

4. 启动

sudo systemctl enable jenkins
sudo systemctl restart jenkins

查看日志文件: sudo tail -f /var/log/jenkins/jenkins.log

启动后会生成文件 hudson.model.UpdateCenter.xml，需要修改它，
否则浏览器首次进入时会卡在“Jenkins 正在启动，请稍后…”

## 原值: http://updates.jenkins-ci.org/update-center.json
## 新值: http://mirror.xmission.com/jenkins/updates/update-center.json
## 或者: http://mirror.xmission.com/jenkins/updates/current/update-center.json
sudo cat /var/lib/jenkins/hudson.model.UpdateCenter.xml
sudo sed -i 's/updates.jenkins-ci.org/mirror.xmission.com\/jenkins\/updates/g' /var/lib/jenkins/hudson.model.UpdateCenter.xml
sudo cat /var/lib/jenkins/hudson.model.UpdateCenter.xml
sudo systemctl restart jenkins

5. 防火墙放行

### sudo vim /etc/sysconfig/iptables
-A INPUT -m state --state NEW -m tcp -p tcp --dport 8080 -j ACCEPT
### 重启生效: sudo systemctl restart iptables

6. 卸载

如果要重装，或者本机不需要 Jenkins，可卸载：

sudo systemctl stop jenkins
sudo systemctl disable jenkins
sudo yum -y remove jenkins
sudo rm -rf /var/{lib,log,cache}/jenkins /usr/lib/jenkins /root/.jenkins
sudo rm -rf `sudo find /{etc,var,run} -name "jenkins*"`

7. mac 下安装

• 使用osx系统自带的homebrew来安装jenkins

1. 需要安装至少java1.8 ，如果没有安装会有提示，下载jdk1.8
   
   在这里插入图片描述
2. java安装完毕，继续下面步骤，链接 launchd 配置文件

$ ln -sfv/usr/local/opt/jenkins/*.plist ~/Library/LaunchAgents  
//如果要其他机器也可以访问，把ip地址改为广播地址:--httpListenAddress=0.0.0.0
$ launchctl load~/Library/LaunchAgents/homebrew.mxcl.jenkins.plist

3. 命令行启动Jenkins

$ jenkins

4. 一切顺利的话，打开浏览器输入：http://localhost:8080/
   就能看到jenkins已经运行起来了，如果你更换了端口就是你后来设置的端口。

接下来打开Jenkins后会让去一个填写password的页面如下图，存储password的地方就是图片上那行红色字体目录下，使用终端 cat + 红色字体路径就看到了

在这里插入图片描述

然后将我们得到的password输入到“Administrator password“中，即可进入如下界面，接着安装一些建议的插件（左边的），安装过程中，有的插件可能会安装失败，强烈建议点击右下角的重试，直到把建议安装的都装好。（因为我这边安装之后，在Jenkins插件管理安装插件一直失败，如果这一步没把有些必须的插件装好，如git，只能一个个下载上传插件就很麻烦）

在这里插入图片描述

插件安装完成后，可能会卡在如下界面，不会自动跳转，刷新下界面即可：

在这里插入图片描述

在刷新后的界面中注册，输入用户名和密码，建议输入后点蓝色按钮保存完成，如下：

在这里插入图片描述

注册成功后，点击”Start using Jenkins”

三，Jenkins配置

1. 登录

浏览器进入 http://centos:8080/
首次进入需要输入初始密码来解锁，初始密码查看方法: sudo cat /var/lib/jenkins/secrets/initialAdminPassword

在这里插入图片描述

在这里插入图片描述

2. 安全设置

默认情况下，任何用户都可以使用 Jenkins 进行发布。
可以进入相关设置：系统管理 / Configure Global Security,
选择 Jenkins专有用户数据库，不要选中 允许用户注册；
选择 登录用户可以做任何事，选中 Allow anonymous read access

3. 插件安装方法

• 离线安装：
  手工下载(*.hpi): http://updates.jenkins-ci.org/download/plugins/
  进入：系统管理 / 管理插件 / 高级，然后上传插件进行安装。
  无需重启 Jenkins 插件即生效。

• 在线安装：
  进入：系统管理 / 管理插件 / 可选插件
  查找并勾选所需插件，点击“直接安装”；
  无需重启 Jenkins 插件即生效。如遇失败可重试或离线安装。

  
  
  在这里插入图片描述

4. 工具设置

进入：系统管理 / Global Tool Configuration
JDK 下不勾选“自动安装”，指定别名=JDK-1.8.0.111, JAVA_HOME=/usr/java/jdk1.8.0_111
Maven 下不勾选“自动安装”，指定别名=Maven-3.3.9, MAVEN_HOME=/opt/apache-maven-3.3.9
点击 Save 按钮。
重启 Jenkins 后生效：sudo systemctl restart jenkins

在这里插入图片描述

5. 安装ios打包需要插件

1. 管理本地的keychain和iOS证书的插件Keychains and Provisioning Profiles Management
2. 用于xcode构建Xcode integration

安装方式：
方案一：在可选中搜索插件名 ，勾选安装。若安装报错（参照安装Jenkins时不能联网安装插件问题解决），如果还不行，直接进入方案二。

在这里插入图片描述

方案二：去Jenkins-plug官网下载插件，然后选择高级tab，上传.hpi文件

在这里插入图片描述

6. IOS 打包前配置

1. 配置Keychains and Provisioning Profiles Management
   接下来配置Keychains and Provisioning Profiles Management，根据顺序选择首页>系统管理>Keychains and Provisioning Profiles Management如图

   
   
   在这里插入图片描述
   
   

   需要上传login.keychain文件，该文件获取方法，在终端中输入：

cd ~/Library/Keychains

在终端键入ls详见下图

在这里插入图片描述

将login.keychain文件upload之后，会出现下图的界面，根据需要将证书添加进去即可，但是由于macOS10.12以及以后的系统里面没有login.keychain文件，只有login.keychain-db,可以复制出来删除-db，也可以创建一个快捷方式名字叫做login.keychain，upload就好了。（上传keychain，路径用自己改名后的那个）
关于code sign ident 这个怎么来的 其实只是在keychain中找到对应的证书完整复制名字贴进去即可

在这里插入图片描述

在这里插入图片描述

2. 配置任务
   然后创建一个任务，自由风格的任务，因为构建方法会有两种,除了共同的地方，构建会分为两部分解答，第一部分是macOS10.12以前的构建方法，但是由于Jenkins的Xcode和Mac的系统版本问题，所以建议使用第二种方法。

创建一个自由风格的任务，然后在选择丢弃旧的构建，至于天数和保持的最大个数，按照自己的需求来就好，如图

在这里插入图片描述

• 源码管理

在这里插入图片描述

Git: 支持主流的github 和gitlab代码仓库。因我们的研发团队使用的是gitlab，所以下面我只会对该项进行介绍。
Repository URL：仓库地址Credentials：凭证。可以使用HTTP方式的用户名密码，也可以是RSA文件。 但要通过后面的"ADD"按钮添加凭证。
Branches to build：构建的分支。*/master表示master分支，也可以设置为其他分支。
源码浏览器：你所使用的代码仓库管理工具，如github, gitlab. URL：填入上方的仓库地址即可。
Version: 8.7 这个是我们gitlab服务器的版本。
Subversion：就是SVN，这里不作介绍。

在Repository URL里面添加你的git地址，我这里添加的是http的，如果你的项目是使用的ssh的，那么就将git开头的地址填写上，然后店家Add添加你的git帐号，如果你的事ssh的，将ssh的密匙填写上，具体的自己百度一下就好咯，我就不多写了，结果如图

在这里插入图片描述

• 构建触发器
  构建触发器，顾名思义，就是构建任务的触发器

在这里插入图片描述

触发远程构建(例如，使用脚本): 该选项会提供一个接口，可以用来在代码层面触发构建。这里不做介绍，后期可能会用到。

Build after other projects are built： 该选项意思是"在其他projects构建后构建"。这里不作介绍，后期可能会用到该选项。

Build periodically： 周期性的构建。很好理解，就是每隔一段时间进行构建。日程表类似 linux crontab书写格式。如下图的设置，表示每隔30分钟进行一次构建。

Build when a change is pushed to GitLab：当有更改push到gitlab代码仓库，即触发构建。后面会有一个触发构建的地址，一般被称为webhooks。需要将这个地址配置到gitlab中，webhooks如何配置后面介绍。这个是常用的构建触发器。

Poll SCM：该选项是配合上面这个选项使用的。当代码仓库发生改动，jenkins并不知道。需要配置这个选项，周期性的去检查代码仓库是否发生改动。

构建触发器，也就是什么时候触发自动打包我这里填写的是H 20 * * 这个意思就是H小时然后，后面跟着数字，在后面就是日月年，代表的我认为是每次都触发，也就是每天每月每年，但是Jenkins的时间不是绝对的，一般都是在随机在半点，也就是设置20点，大概会在20:30分左右会触发，如果需要两个时间，那么格式可以这样H 20,22 * * *结果如图

在这里插入图片描述

• 构建环境
  在构建环境里面勾选Keychains and Code Signing Identities和Mobile Provisioning Profiles，Keychains and Code Signing Identities是打包需要的证书，Mobile Provisioning Profiles是打包需要的配置文件，都是可以自己选择的

在这里插入图片描述

7. iOS 打包构建

接下来就是构建了，因为Jenkins对新版的Xcode插件兼容不好，只能用脚本来打包，但是老版本的Xcode可以使用Jenkins的Xcode插件，下面将构建一为使用Xcode插件的，构建二是脚本的

7.1 使用Xcode插件

在构建里面点击增加构建步骤，然后点击Xcode.General build settings在Target里面填写你的项目名称，Clean before build勾选YES，勾选Pack application, build and sign .ipa?，然后会有新的选项Export method是你要打的包的类型，就是你在手动打包的时候选额的ad-hoc或者Appstore那四个选项，这个按照你要打的类型填写，.ipa filename pattern是你打出包ipa的名字，我的这里填写了项目名字和-$(BUILD_DATE)，意思就是在后面追加时间，Output directory是导出ipa的目录，如果不填写，会在Jenkins默认的目录.

在这里插入图片描述

Code signing & OS X keychain options勾选Unlock Keychain?,在Keychain path那里填写${HOME}/Library/Keychains/login.keychain,意思是找到你的login.keychain（登陆钥匙串），如果你的是复制出来改的名字，那么就填写你相对应的目录，Keychain password就是你电脑的登陆密码。详见图

在这里插入图片描述

Advanced Xcode build options勾选Clean test reports?，如果你使用了cocoapods那么填写Xcode Workspace File，如果没有使用cocoapods填写Xcode Project Directory，然后填写Build output directory就是你到处ipa的路径,

在这里插入图片描述

完成之后，回到任务操作页面，点击立即构建，如果配置没问题基本就能构建成功。

在这里插入图片描述

偶尔会出现报错，点击任务编号，也就是上图的#4#5#6，然后进入任务详情页，进入控制台输出看看哪里出了问题，我之前是报了profile文件不匹配的error（target填错了），然后改了就好了

在这里插入图片描述

对应目录生成了文件，所生成的内容也是需要自己选择配置的

对应目录生成了文件，所生成的内容也是需要自己选择配置的

7.2 使用脚本构建

蒲公英上传请参考：蒲公英
因为Jenkins对现在的Xcode9插件兼容性不好，打不了包，所以我们使用了xcodebuild打包，下面是脚本：

#!/bin/sh  #因为Jenkins打包可能是自动的，那么build号是不会自己再去修改然后push到git上面的，所以这个buildPlist就是修改build号的路径。 

buildPlist="/Users/apple/.jenkins/workspace/longxin_a/eCloud/Build/LongHu/Config/eCloud-Info.plist"  
#这个获取现在的 月日时分 用它来做build号 
buildNumber=$(date +"%m%d%H%M") 
 #修改plist文件需要/usr/libexec/PlistBuddy -c命令，CFBundleVersion是修改的这个build号，
# $buildNumber是你要修改的数值，$buildPlist是你修改哪个地方的plist文件。
 /usr/libexec/PlistBuddy -c "Set :CFBundleVersion $buildNumber" "$buildPlist" 
 #这个是获取当前的build号，本来是用来看看有没有修改成功的 #newBuildName=$(/usr/libexec/PlistBuddy -c "print :CFBundleVersion" "$buildPlist")
  #这个是打印，带自动换行的打印 
  echo $newBuildName  
   #因为我怕他修改plist的时候需要时间，所以索性在这里我让他等了3秒，当然你也可以去掉 sleep 3  
   #这个buildPath是到时候我生成xcarchive文件的路径和打ipa时候需要找到xcarchive的路径 
   buildPath="/Users/apple/.jenkins/workspace/longxin_a/build/Release-iphoneos/eCloud.xcarchive"  
   #这个路径是我生成ipa的路径 ipaPath="/Users/apple/Documents/longhuBuild/" 
    #这个是ExportOptions.plist的路径，有这个就不用在用脚本写证书了，这个plist你只要手动打过包，那么在生成ipa的文件夹里面就会有，找一个自己不经常修改的地方放在那里，写上这个路径就好，当然如果你不想这么做，想用shell语言设置证书，我会在 问题 列表里面有介绍 
    exportOptionsplistPath='/Users/apple/.jenkins/workspace/ExportOptions.plist'  
    #因为我使用了cocoapods所以这里用的-workspace，如果你没有使用cocoapods使用-project，下面的命令都一样 #这个命令主要是用来clean，clean的是Release的路径，clean的是/Users/app***eCloud.xcworkspace路径的eCloud， 
    xcodebuild -workspace /Users/apple/.jenkins/workspace/longxin_a/eCloud.xcworkspace -scheme eCloud -configuration "Release" clean 
     #这个是生成xcarchive，Release的 
     xcodebuild -workspace /Users/apple/.jenkins/workspace/longxin_a/eCloud.xcworkspace -scheme eCloud -archivePath ${buildPath} -configuration "Release" archive  
     #这个是将xcarchive文件打包成ipa 
     xcodebuild -exportArchive -archivePath ${buildPath} -exportPath ${ipaPath} -exportOptionsPlist ${exportOptionsplistPath} -allowProvisioningUpdates

8. 邮箱通知

Jenkins是有邮件通知的。现在开始设置，首先你已经安装了插件Email Extension Plugin，这个在插件那里直接安装就好这是第一步；然后进入系统管理->系统设置找到Jenkins Location模块，在系统管理员邮件地址填写你的系统管理邮箱，这个邮箱是你发送通知邮件的邮箱，然后找到Extended E-mail Notification模块

在这里插入图片描述

在这里插入图片描述

然后找到构建后操作，点击增加构建后的操作步骤点击Editable Email Notification，在Project From里面写上管理者邮箱，也就是发送邮件的邮箱，然后点击Advanced Setting;里面有三个选项，分别是你在系统设置里面勾选的那几个，根据需求填写就好，我这里填写的是Always，也就是无论构建成功还是失败,Recipient List是接收者的邮箱，这里多个邮箱用英文逗号隔开——’,’

在这里插入图片描述

9. 上传到fir

1. 先去下载fir插件
2. 然后在Jenkins里面点击系统管理->管理插件->高级，然后滑动到上传插件那里，选择刚才下载的插件，点击上传，等待上传成功后，进入到你的项目配置里面滑动到最下面，也就是找到构建后操作，点击增加构建后操作步骤，选择Upload to fir.im，打开你的浏览器，打开fir官方网站,获取方法见图

在这里插入图片描述

3. 然后输入你的IPA/APK Files (optional)这个是你ipa的路径，如果不选择，会是Jenkins默认的路径这里有fir的官方文档，根据fir的官方文档即可就可以Jenkins上传到fir文档到此为止关于Jenkins整合Xcode的配置项并自动上传到蒲公英差不多就说好了。

10. 修改密码

jenkins 密码错误去掉密码登录(mac路径为/Users/用户名/.jenkins)

Jenkins 修改登录密码

Jenkins 卸载

11. 相关配置

11.1 SSH Server配置

1. 登录jenkins -- 系统管理 -- 系统设置
2. 在这里插入图片描述
   
   

   SSH Servers: 由于jenkins服务器公钥文件我已经配置好，所以之后新增SSH Servers 只需要配置这一项即可。
   Name： 自定义，需要全局唯一。
   HostName: 主机名，直接用ip地址即可。
   Username: 新增Server的用户名，这里配置的是root。
   Remote Directory: 远程目录。jenkins服务器发送文件给新增的server默认是在这个目录。

四，IOS Jenkins打包

五，Jenkins打包

参考：大神：王克锋 https://kefeng.wang/2017/01/06/jenkins/

http://blog.csdn.net/u014641783/article/details/50866196

https://blog.x1be.win/index.php/2018/06/19/jenkins%E5%AE%89%E8%A3%85%E3%80%81%E9%85%8D%E7%BD%AE%E3%80%81%E6%9E%84%E5%BB%BA%E3%80%81%E8%84%9A%E6%9C%AC%E3%80%81%E9%85%8D%E7%BD%AE%E9%82%AE%E7%AE%B1%E3%80%81%E4%B8%8A%E4%BC%A0fir/