macOS Jenkins安装&配置

一、依赖环境

1. JavaSDK（Java SE Development Kit）

在终端命令行输入java -version命令，如果打印出java版本，则代表已安装，可以略过此步骤。
如果没有安装过，进入JavaSDK官网，接受协议，选择 & 下载对应系统的 安装包

下载完成，点击安装，安装完成再次在终端中执行上面的命令，可以看到已安装JavaSDK的版本

2. Apache

Mac系统自带，略过

二、安装Jenkins

1. 下载安装Jenkins

方法有多种，暂以下载dmg客户端为例
进入Jenkins官网，下载最新版本的Jenkins客户端

双击下载好的dmg文件进行安装，其将会自动生成全局变量jenkins
Jenkins默认安装路径：/Applications/Jenkins/jenkins.war
（如果下载.war格式文件，将文件复制到欲安装文件夹即可）
修改参数： jenkins + 相关参数，如
jenkins –httpPort=8888#更换端口号，当默认端口8080被占用，或指定特定端口时。

2. 启动Jenkins

如果是使用dmg文件安装的，安装完成之后，会自动启动jenkins，打开浏览器，进入网页 localhost:8080

终端命令

设置开机自启动：sudo launchctl load -w /Library/LaunchDaemons/org.jenkins-ci.plist
取消开机自启动：sudo launchctl unload -w /Library/LaunchDaemons/org.jenkins-ci.plist
手动启动：Java -jar jenkins.war
后台启动(默认端口)：nohup java -jar jenkins.war &
后台启动(指定端口)：nohup java -jar jenkins.war -httpPort=88 &
后台启动(HTTPS)：nohup java -jar jenkins.war -httpsPort=88 &

注：可能出现连接不到服务器的问题，原因就是Java环境有问题，重新配置Java环境即可。

三、配置Jenkins

1、重启电脑

重启电脑之后，你会发现Jenkins给你的电脑新增了一个用户，名字就叫Jenkins
打开localhost:8080，出现Unlock Jenkins(重设初始密码)界面
密码在/Users/userName/.jenkins/secrets/initialAdminPassword**文件(下图标注红色路径)中，打开文件，复制密码填到网页密码输入框中，继续

选择建议安装设置


安装中


等待Jenkins重启完成


创建管理员账号：输入用户名、密码、邮件等


创建完，进入Jenkins初始界面


2、管理插件

选择“系统管理”——“管理插件”，进入插件管理界面（可以安装、更新、卸载jenkins插件）

  • √ Git插件： Git plugin
  • √ Gitlab插件：GitLab Plugin 和 Gitlab Hook Plugin
  • ? iOS专用：Xcode integration
  • ? Android专用：Gradle plugin
  • GitBuckit插件：GitBuckit plugin
  • 签名证书管理插件：Credentials Plugin 和 Keychains and Provisioning Profiles Management
  • FTP插件：Publish over FTP
  • 脚本插件：Post-Build Script Plug-in
  • 修改Build名称/描述(二维码)：build-name-setter / description setter plugin
  • 获取仓库提交的commit log：Git Changelog Plugin
  • 自定义全局变量：Environment Injector Plugin
  • 自定义邮件插件：Email Extension Plugin
  • 显示代码测试覆盖率报表：Cobertura Plugin
  • 来展示生成的单元测试报表，支持一切单测框架，如junit、nosetests等：Junit Plugin
  • 其它：SSH Credentials Plugin

注：打√号的建议安装，? 号按系统和编辑器安装，其他 选择安装

3、系统设置

选择“系统管理”——“系统设置”，进入系统设置界面（可以管理全局属性、配置邮件通知）
全局属性下面，勾选Environment variables，增加一对键值对：

  • LANG = zh_CN.UTF-8
  • PATH = (终端中执行 echo $PATH 命令的输出，为一堆路径)

4、新建项目

点击“新建”或者“创建一个新任务”


输入新项目名称，选“新建一个自由风格的软件项目”


点击新建好的项目（第一次可能不需要吧，给忘记了，反正下一步是配置）


5、配置项目

点击“配置”


进入配置界面，配置项目参数

A. General配置

注：这里可以设置包（构建）的保留天数和保留的最大个数

B. 源码管理

由于现在我用到的是GitLab，先配置SSH Key

创建SSH证书：

  • 终端执行：ssh-keygen -t rsa -C "xxx@xxx.com"(邮箱)
  • 按回车保存到默认位置，再稍等出来提示输入passphrase密码短语，输完按回车要输两遍（它是用来加密私钥，也就是以后使用私钥的时候要输这个密码，如果输入，就需要记住，或者直接置空）
  • 创建成功的SSH 默认路径为 ~/.ssh 目录
  • id_rsa 文件存储密钥 ，id_rsa.pub存储公钥

添加SSH证书：

  • 在Jenkins管理页面，点击“Credentials”后的Add按钮
  • Domain 选择 “Global credentials (unrestricted)”
  • Kind 选择 “SSH Username with private key”，如下图所示
  • Username 随意，自己可看懂的标识
  • 复制id_rsa中的字符串到private key中，passphrase为创建SSH时，填写的passphrase秘密（如果为空，则直接设置为空）
  • 点击“Add”，把SSH添加到Jenkins中

配置SSH也可以参考配置Git代码仓库

然后在“Credentials”处选择刚添加的那个SSH配置。
如果配置正确的话，是不会出现下图中的那段红色的警告。如果有下图的提示，就说明Jenkins还没有连通GitLab或者SVN，那就请再检查SSH Key是否配置正确。


C. 构建触发器

构建触发器设置这里是设置自动化测试的地方。这里涉及的内容很多，暂时没有深入研究，有自动化测试需求的可以好好研究研究这里的设置。

  • Build when a change is pushed to GitHub
    当有数据推送到远程库中时构建
  • Poll SCM (poll source code management)
    轮询源码管理
    需要设置源码的路径才能起到轮询的效果。一般设置为类似结果： H/5 * * * * 每5分钟轮询一次
  • Build periodically (定时build)
    一般设置为类似： 00 20 * * * 每天 20点执行定时build

格式如下

分钟(0-59) 小时(0-23) 日期(1-31) 月(1-12) 周几(0-7,0和7都是周日) * 代表全部

D. 构建环境

iOS打包需要签名文件和证书，所以这部分我们勾选“Keychains and Code Signing Identities”。
这里我们又需要用到Jenkins的插件，在系统管理页面，选择“Keychains and Provisioning Profiles Management”。

进入Keychains and Provisioning Profiles Management页面，点击“浏览”按钮，分别上传自己的keychain和证书。上传成功后，我们再为keychain指明签名文件的名称。

  • Keychain路径
    /Users/userName/Library/keychains/login.keychain
  • Provisioning Profiles路径
    /Users/userName/Library/MobileDevice/Provisioning Profiles

点击“Add Code Signing Identity”，最后添加成功后如下图所示：


这样Adhoc证书和签名文件就在Jenkins中配置好了，接下来我们只需要在item设置中指定相关文件即可。

回到我们新建的item，找到构建环境，按下图选好自己的相关证书和签名文件。

E. 构建
①增加构建步骤：Execute shell

作用：改变项目中的build号

#---------------进入项目工程根目录----------------------------
cd $HOME/Home/workspace/${JOB_NAME}/xxx(工程名)
#---------------auto change versionNumber------------------
#/usr/bin/xcrun agvtool next-marketing-version -all
#---------------auto change buildNumber--------------------
/usr/bin/xcrun agvtool new-version -all $BUILD_NUMBER
②增加构建步骤：Execute shell

作用：打包，导出IPA
最好在xcode中设置scheme为shared，否则可能出现工程无scheme的错误

# 工程名
APP_NAME="xxx"  #替换成你的工程名
# 证书
CODE_SIGN_DISTRIBUTION="iPhone Distribution: xxx Co., Ltd. (xxxxxx)"  # 打包所用签名证书
# info.plist路径
project_infoplist_path="$HOME/Home/workspace/${JOB_NAME}/${APP_NAME}/${APP_NAME}/Info.plist"
#取版本号
bundleShortVersion=$(/usr/libexec/PlistBuddy -c "print CFBundleShortVersionString" "${project_infoplist_path}")
#获取日期
#DATE="$(date +%Y%m%d)"
ADHOC_PLIST_PATH="xxx/xxx/adhoc.plist"
#要上传的ipa文件路径
IPA_PATH="$HOME/Home/output/${JOB_NAME}/${bundleShortVersion}(${BUILD_ID})"
#创建IPA路径文件夹
mkdir $IPA_PATH
#archive文件路径
ARCHIVE_PATH="${IPA_PATH}/${APP_NAME}_${BUILD_ID}.xcarchive"

#进入工程目录
cd $HOME/Home/workspace/${JOB_NAME}/${APP_NAME}
# xcodebuild -list命令可以查看 工程的：Targets、Configurations、Schemes

echo "=================清理工程================="
xcodebuild clean -target "${APP_NAME}" -configuration 'Release'

echo "=================解锁钥匙串================="
#解决：codesign"seckey api returned: -25308,(null)"
# *** 是一般为电脑登录密码
security unlock-keychain -p "***" "${HOME}/Library/Keychains/login.keychain"

echo "=================生成xcarchive文件================="
# 在xcode中设置scheme为shared，否则可能出现工程无scheme的错误
# 还可以添加其他参数，不设置的都是默认使用项目Build Settings里面的配置，包括 CODE_SIGN_IDENTITY 和 PROVISIONING_PROFILE
xcodebuild archive -project "${APP_NAME}.xcodeproj" -scheme "${APP_NAME}" -sdk iphoneos -configuration "Release" -archivePath "${ARCHIVE_PATH}"

echo "=================打包IPA================="
xcodebuild -exportArchive -archivePath "${ARCHIVE_PATH}" -exportPath "${IPA_PATH}" -exportOptionsPlist "${ADHOC_PLIST_PATH}"

adhoc.plist 文件内容

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
    <dict>
        <key>method</key>
        <string>ad-hoc</string>
        <key>compileBitcode</key>
        <false/>
    </dict>
</plist>
F、构建后操作

增加构建后操作步骤：Execute a set of scripts
建议勾选 Execute script only if build succeeds 只有构建成功，才执行构建后命令
Build steps => Execute shell

# 解决中文乱码问题
export LANG="zh_CN.UTF-8" #zh_CN.UTF-8  en_US.UTF-8
# 解决 fir: command not found 问题（前提：安装fir命令行工具 - gem install fir（再前提：安装了ruby环境））
# /usr/local/bin/:  为fir工具安装路径（安装完成fir时会有打印出来）
export PATH="/usr/local/bin/:$PATH"

APP_NAME="xxx"
# info.plist路径
project_infoplist_path="$HOME/Home/workspace/${JOB_NAME}/${APP_NAME}/${APP_NAME}/Info.plist"
#取版本号
bundleShortVersion=$(/usr/libexec/PlistBuddy -c "print CFBundleShortVersionString" "${project_infoplist_path}")

cd $HOME/Home/workspace/${JOB_NAME}

log=`git show -s --format=%B $GIT_COMMIT`

cd "$HOME/Home/output/${JOB_NAME}/${bundleShortVersion}(${BUILD_ID})"

fileName=`find . -name "${APP_NAME}.ipa"`

# 上传IPA到fir平台
fir p "$fileName" -c ${log} -Q -m "./${APP_NAME}_${BUILD_ID}.xcarchive/dSYMs/工程名.app.dSYM/Contents/Resources/DWARF/工程名" -P <bughd project id> -T <fir token>

# 设置上传fir返回二维码图片名称为qrcode.png
mv "./fir-${$APP_NAME}.png" "./qrcode.png"

# 设置构建版本描述信息为二维码，扫码可下载该构建版本
# 此设置无效，错误信息如下：
# [WARN] Failed to authenticate with your SSH keys. Proceeding as anonymous
# ERROR: No such job 'DESCRIPTION=<p>扫码下载xxx(xx)</p><img src=./qrcode.png>'
# java -jar ${HOME}/Home/jenkins-cli.jar -s http://localhost:8080/ set-build-description DESCRIPTION="<p>扫码下载${bundleShortVersion}(${BUILD_ID})</p><img src=./qrcode.png>"

解决 fir: command not found 问题

  • 前提：安装fir命令行工具 - gem install fir（再前提：安装了ruby环境）
  • /usr/local/bin/: 为fir工具安装路径（安装完成fir时会有打印出来）
  • export PATH="/usr/local/bin/:$PATH"

配置set build description 可以使用 HTML标签
设置如下：

  1. Jenkins -> 系统管理 -> Configure Global Security
  2. Markup Formatter 选择 "Safe HTML"

解决Unable to access jarfile jenkins-cli.jar 问题

  • 进入 http://localhost:8080/cli/
    Jenkins主网址，8080是默认端口
  • 下载jenkins-cli.jar，并放到Jenkins的一个目录下
    1.右上角“可以下载jenkins-cli.jar”，点击链接即可下载
    2.比如我就放到了$HOME/Home目录中了
    3.修改文件拥有者和用户组为jenkins
  • java -jar jenkins-cli.jar 中 jenkins-cli.jar 文件名 替换为 jenkins-cli.jar 文件的全路径

注意：小心大坑，在Jenkins HOME目录下新建文件(夹)，权限要更改，否则会出现权限问题（Operation denied）

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 203,271评论 5赞 476
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 85,275评论 2赞 380
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 150,151评论 0赞 336
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 54,550评论 1赞 273
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 63,553评论 5赞 365
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 48,559评论 1赞 281
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 37,924评论 3赞 395
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 36,580评论 0赞 257
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 40,826评论 1赞 297
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,578评论 2赞 320
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,661评论 1赞 329
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,363评论 4赞 318
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 38,940评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,926评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,156评论 1赞 259
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 42,872评论 2赞 349
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,391评论 2赞 342

推荐阅读更多精彩内容