什么是 Jenkins
????Jenkins 是一款由 Java 編寫(xiě)的可擴(kuò)展的開(kāi)源的持續(xù)集成工具。它提供了軟件開(kāi)發(fā)的持續(xù)集成服務(wù)鸡挠,其運(yùn)行在 Servlet 容器中(例如:Apache Tomcat)廊勃,支持軟件配置管理(SCM)工具冗栗。
Jenkins 的特性
-
持續(xù)集成和持續(xù)交付
Jenkins 可以用作簡(jiǎn)單的 CI 服務(wù)器或變成任何項(xiàng)目的持續(xù)交付中心
-
簡(jiǎn)易安裝
只要把
jenkins.war
部署到servlet
容器 -
易于配置
Jenkins 可以通過(guò)其 Web 界面輕松設(shè)置和配置,其中包括即時(shí)錯(cuò)誤檢查和內(nèi)置幫助供搀。
-
插件
憑借更新中心的數(shù)百個(gè)插件,Jenkins 與持續(xù)集成和持續(xù)交付工具鏈中的幾乎所有工具集成钠至。
-
可擴(kuò)展
Jenkins 可以通過(guò)其插件架構(gòu)進(jìn)行擴(kuò)展
-
分散式
Jenkins 可以輕松地在多臺(tái)機(jī)器上分配工作葛虐,幫助更快地跨多個(gè)平臺(tái)推動(dòng)構(gòu)建、測(cè)試和部署棉钧。
CI 工作流
????典型的 CI 工作流是一組可自動(dòng)化的步驟屿脐,在將代碼變更推送到代碼倉(cāng)庫(kù)后會(huì)自動(dòng)運(yùn)行。這整套流程包括自動(dòng)構(gòu)建宪卿、代碼分析的诵、運(yùn)行測(cè)試、存檔等等佑钾,甚至可通過(guò)腳本來(lái)自定義流程西疤,以確保整個(gè)流程按照?qǐng)F(tuán)隊(duì)預(yù)定的要求來(lái)執(zhí)行。
無(wú) Jenkins 遠(yuǎn)程服務(wù)器休溶,基于 Mac 電腦的 Jenkins 安裝
一般來(lái)說(shuō)代赁,Jenkins 依賴(lài)于 Java 環(huán)境扰她,需要前往 http://www.java.com 安裝
Homebrew 安裝
????官網(wǎng)推薦在 Mac 電腦中使用 Homebrew 包管理器安裝 Jenkins,Jenkins 分為兩個(gè)版本 Jenkins LTS 和 * Jenkins Weekly*芭碍,安裝命令如下:
Jenkins LTS 的安裝
- 安裝最新的版本
brew install jenkins-lts
-
啟動(dòng) Jenkins 服務(wù)
brew services start jenkins-lts
-
重啟 Jenkins 服務(wù)
brew services restart jenkins-lts
Jenkins Weekly 的安裝
-
安裝最新的版本
brew install jenkins
-
啟動(dòng) Jenkins 服務(wù)
brew services start jenkins
-
重啟 Jenkins 服務(wù)
brew services restart jenkins
Docker 容器安裝(推薦)
????參考Jenkins-docker徒役,使用如下命令:
docker run -d -p 8080:8080 -p 50000:50000 --restart always -v jenkins_home:/var/jenkins_home jenkins/jenkins:lts-jdk11
使用 pgk 安裝包安裝
????Download the latest package,使用安裝器安裝窖壕,按照流程安裝即可忧勿。此安裝方式會(huì)在 Mac 系統(tǒng)里創(chuàng)建一個(gè)名為 jenkins
用戶(hù),jenkins
服務(wù)就部署在這個(gè)用戶(hù)下瞻讽。
使用 war包 安裝
????Downloading Jenkins 下載 war 包鸳吸,將其放在 Servlet 容器(例如:Tomcat)運(yùn)行 或者 執(zhí)行下面命令:
java -jar jenkins.war --httpPort=8080
????war 包自帶 jetty 服務(wù)器,以上命令會(huì)自動(dòng)啟服務(wù)器卸夕,并完成部署层释。此種方式安裝,會(huì)在當(dāng)前用戶(hù)的根路徑或相應(yīng)的容器下創(chuàng)建 .jenkins
隱藏文件快集,并產(chǎn)生多余的配置文件贡羔,需手動(dòng)管理,且不方便卸載个初。
安裝后設(shè)置向?qū)?/h4>
端口號(hào)沖突的可以自行修改相應(yīng)端口號(hào)乖寒,Homebrew 安裝需要在目錄下找到 homebrew.mxcl.jenkins-lts.plist
文件進(jìn)行修改。
端口號(hào)沖突的可以自行修改相應(yīng)端口號(hào)乖寒,Homebrew 安裝需要在目錄下找到 homebrew.mxcl.jenkins-lts.plist
文件進(jìn)行修改。
????下載安裝并運(yùn)行Jenkins后院溺,即將開(kāi)始進(jìn)入安裝向?qū)ч灌摇.?dāng)?shù)谝淮卧L問(wèn)新的Jenkins實(shí)例時(shí),系統(tǒng)會(huì)要求使用自動(dòng)生成的密碼對(duì)其進(jìn)行解鎖珍逸。
-
瀏覽到
http://localhost:8080
(或安裝時(shí)為Jenkins配置的任何端口)逐虚,并等待 解鎖 Jenkins 頁(yè)面出現(xiàn),按照提供的路徑將密碼復(fù)制并粘貼到下面輸入框谆膳。
-
自定義 jenkins 插件
在 Customize Jenkins 頁(yè)面內(nèi)叭爱, 有兩個(gè)選項(xiàng):
- 安裝推薦的插件 - 安裝推薦的一組插件,這些插件基于最常見(jiàn)的用例.
-
選擇插件來(lái)安裝 - 選擇安裝的插件集漱病。當(dāng)?shù)谝淮卧L問(wèn)插件選擇頁(yè)面時(shí)买雾,默認(rèn)選擇建議的插件。
可以選擇 安裝推薦的插件 杨帽,之后可以通過(guò) Jenkins 中的Manage Jenkins > Manage Plugins 頁(yè)面在稍后的時(shí)間點(diǎn)安裝(或刪除)其他 Jenkins 插件 漓穿。
設(shè)置向?qū)э@示正在配置的Jenkins的進(jìn)程以及您正在安裝的所選Jenkins插件集。這個(gè)過(guò)程可能需要幾分鐘的時(shí)間
-
創(chuàng)建第一個(gè)管理員用戶(hù)
Jenkins 要求創(chuàng)建第一個(gè)管理員用戶(hù)注盈。 出現(xiàn)“ 創(chuàng)建第一個(gè)管理員用戶(hù) ”頁(yè)面時(shí)晃危, 請(qǐng)?jiān)诟鱾€(gè)字段中指定管理員用戶(hù)的詳細(xì)信息,然后單擊 保存完成 老客。
-
實(shí)例配置
Jenkins URL 用于給各種 Jenkins 資源提供絕對(duì)路徑鏈接的根地址山害。 例如:郵件通知纠俭、PR狀態(tài)更新以及提供給構(gòu)建步驟的
BUILD_URL
環(huán)境變量。
有 Jenkins 遠(yuǎn)程服務(wù)器浪慌,配置 Mac 子節(jié)點(diǎn)
準(zhǔn)備
- 首先冤荆,要確保安裝Jenkins的遠(yuǎn)程服務(wù)器、本地Mac電腦在同一網(wǎng)絡(luò)環(huán)境下权纤。
- 本地 Mac 電腦需要設(shè)置允許遠(yuǎn)程登錄钓简,位于系統(tǒng)偏好設(shè)置->共享->遠(yuǎn)程登錄,Jenkins 才能登錄訪問(wèn)Mac電腦汹想。
- Mac 配置提供給遠(yuǎn)程用戶(hù)工作目錄的讀寫(xiě)權(quán)限
Jenkins 新增節(jié)點(diǎn)
- Jenkins 系統(tǒng)管理->管理節(jié)點(diǎn)-> 新建節(jié)點(diǎn)
- 配置節(jié)點(diǎn)外邓,涉及名稱(chēng)、遠(yuǎn)程工作目錄古掏、啟動(dòng)方式(Mac 電腦 ip 地址损话,用戶(hù)名和密鑰)
- 節(jié)點(diǎn)屬性,涉及環(huán)境變量槽唾、工具位置
節(jié)點(diǎn)啟動(dòng)
- 將新增的節(jié)點(diǎn)重啟代理
Jenkins 配置構(gòu)建部署 iOS 項(xiàng)目
???? jenkins 里最常用的功能就是 job 的構(gòu)建丧枪,即任務(wù)的構(gòu)建,通過(guò)配置 job 完成 iOS 項(xiàng)目的構(gòu)建部署庞萍。根據(jù)需要選擇不同的任務(wù)類(lèi)型拧烦,這里以自定義 FreeStyle Item 為示例 。
環(huán)境配置
證書(shū)和描述文件
????Xcode 構(gòu)建依賴(lài)于證書(shū)和描述文件钝计,如果當(dāng)前電腦上有證書(shū)和描述文件需要在構(gòu)建時(shí)使用 security unlock-keychain $KEYCHAIN
解鎖恋博,當(dāng)電腦上沒(méi)有證書(shū)和描述文件時(shí),可以通過(guò)手動(dòng)配置私恬。
????還有另外一個(gè)辦法就是使用 Keychains and Provisioning Profiles Management 插件债沮,它會(huì)將 iOS 和 OSX 項(xiàng)目的鑰匙串和移動(dòng)配置文件管理集成到 Jenkins 中。只需上傳鑰匙串和配置文件并配置您的構(gòu)建作業(yè)以使用它們本鸣。執(zhí)行構(gòu)建時(shí)疫衩,鑰匙串和配置文件會(huì)自動(dòng)分發(fā)到 Jenkins 節(jié)點(diǎn)(主節(jié)點(diǎn)或從節(jié)點(diǎn))。無(wú)需在每個(gè) Jenkins 節(jié)點(diǎn)上手動(dòng)管理這些文件永高。
- 將
~/Library/Keychains/login.keychain-db
拷貝到桌面,并將其改名為login.keychain
- 在 Upload Keychains and Provisioning Profiles Management 處選擇
login.keychain
上傳 - 配置 Code Signing Identity
- 上傳描述文件提针,默認(rèn)安裝后的描述文件在
~/Library/MobileDevice/Provisioning Profiles
注:需使用 2.263.4 的版本才可以上傳鑰匙串和配置文件命爬,無(wú)多個(gè)節(jié)點(diǎn)的情況可以不考慮
構(gòu)建流程
??????一般地,使用 jenkins 是為了自動(dòng)觸發(fā)或者手動(dòng)觸發(fā)執(zhí)行下面流程得到最終產(chǎn)物:
- 獲取最新代碼
- 參數(shù)化構(gòu)建
- 上傳服務(wù)器
- 分發(fā)
參數(shù)化構(gòu)建
在構(gòu)建過(guò)程中辐脖,可能會(huì)需要選擇分支饲宛、標(biāo)簽以及不同的環(huán)境選擇,可以通過(guò)勾選 參數(shù)化構(gòu)建過(guò)程嗜价,配置相應(yīng)的參數(shù)艇抠。
這里以 Git 參數(shù)為例幕庐,配置相應(yīng)變量名稱(chēng),描述家淤、參數(shù)類(lèi)型和默認(rèn)值:
需安裝git parameter 插件
源碼管理
????配置相應(yīng)的源碼倉(cāng)庫(kù)异剥,分支通過(guò)變量參數(shù)獲取,Jenkins 會(huì)在觸發(fā)時(shí)拉取指定分支的代碼
構(gòu)建觸發(fā)器
通過(guò)調(diào)用 Jenkins REST API 觸發(fā)遠(yuǎn)程構(gòu)建絮重,Jenkins REST API可以通過(guò) http://localhost:port/job/api/ 查看
可以通過(guò)其它 job 構(gòu)建后觸發(fā)
通過(guò)定時(shí)構(gòu)建
通過(guò)提交代碼觸發(fā)
構(gòu)建
構(gòu)建 可以使用 fastlane 或者 Shell 腳本冤寿,參考即可
總結(jié)
????在 iOS 開(kāi)發(fā)者,Jenkins 更適用于單獨(dú)一個(gè) Mac 電腦作為打包機(jī)提供給團(tuán)隊(duì)進(jìn)行自動(dòng)化構(gòu)建青伤,如果已有 Jenkins 服務(wù)器督怜,可以將 Mac 作為其從子節(jié)點(diǎn),并可以利用 Jenkins REST API 及其他技術(shù)等等搭建一個(gè)自動(dòng)化構(gòu)建平臺(tái)狠角,從而減少團(tuán)隊(duì)開(kāi)發(fā)因構(gòu)建号杠、部署和分發(fā)而浪費(fèi)的時(shí)間。