Jenkins Gitlab持續集成打包平臺搭建

相關概念

Jenkins

• Jenkins，一個用Java編寫的開源的持續集成工具，提供了軟件開發的持續集成服務，可監控並觸發持續重複的工作，具有開源，支持多平臺和插件擴展，安裝簡單，界面化管理等特點。更多介紹參考[維基](https://en.wikipedia.org/wiki/Jenkins_(software)介紹.

Gitlab

• GitLab是一個利用Ruby on Rails開發的開源應用程序，實現一個自託管的Git項目倉庫，可通過Web界面進行訪問公開的或者私人項目，更多介紹參考維基介紹.

持續集成

• 持續集成, 簡稱CI（continuous integration）.

• CI作爲敏捷開發重要的一步，其目的在於讓產品快速迭代的同時，儘可能保持高質量.

• CI一種可以增加項目可見性，降低項目失敗風險的開發實踐。其每一次代碼更新，都要通過自動化測試來檢測代碼和功能的正確性，只有通過自動測試的代碼才能進行後續的交付和部署.

• CI 是團隊成員間（產研測）更好地協調工作，更好的適應敏捷迭代開發，自動完成減少人工干預，保證每個時間點上團隊成員提交的代碼都能成功集成的，可以很好的用於對Android/iOS項目的打包.

蒲公英

• 蒲公英(pgyer)爲移動開發者提供App免費測試分發應用的服務平臺，支持iOS與Android，簡單兩步分發應用。類似的還有fir.im等.

流程結構

簡單繪製了下Jenkins的一個流程，如下圖：

IBM Developer上也有一個看似更復雜一點的圖，如下圖 

持續交互流程圖： 

平臺搭建

Jenkins安裝和啓動

官網： https://jenkins.io/index.html 
下載： http://mirrors.jenkins-ci.org/war/latest/jenkins.war

安裝：

• 依賴於Java環境，首先安裝和配置Java環境

• 到官網下載Jenkins,雙擊安裝，如果是Mac電腦，會自動生成全局變量jenkins

• 修改參數： jenkins + 相關參數，如 
  jenkins –httpPort=8888 #更換端口號，當默認端口8080被佔用，或指定特定端口時。

啓動

• 手動啓動： java -jar jenkins.war

• 後臺啓動(默認端口)： nohup java -jar jenkins.war &

• 後臺啓動(指定端口)： nohup java -jar jenkins.war -httpPort=88 &

• 後臺啓動(HTTPS)： nohup java -jar jenkins.war -httpsPort=88 &

• 瀏覽：http://localhost:8080/ , localhost可配置

Jenkins插件安裝

插件安裝

操作： Manage Jenkins -> Manage Plugins -> Available -> Search -> Click to install，如下圖所示

實用插件

• iOS專用：Xcode integration

• Android專用：Gradle plugin

• Gitlab插件：GitLab Plugin 和 Gitlab Hook Plugin

• Git插件： Git 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

• 獲取當前登錄用戶信息： build-user-vars-plugin

• 顯示代碼測試覆蓋率報表： Cobertura Plugin

• 來展示生成的單元測試報表，支持一切單測框架，如junit、nosetests等： Junit Plugin

• 其它： GIT plugin / SSH Credentials Plugin

Jenkins系統設置

操作： Manage Jenkins -> Configure System

• Jenkins內部shell UTF-8 編碼設置，如下圖所示

• Jenkins Location和Email設置，如下圖所示

• E-mail Notification，設置如下如所示

SMTP詳細配置請參考 How to send Email at every build with Jenkins

Jenkins Jobs配置

Jobs基礎配置

配置編譯參數

例如，如果需要打包者自行選擇打包類型，如需要編譯Release/Debug/Test等不同版本的包，那需要配置Jobs的編譯參數，配置方法如下圖所示：

你還可以配置一些其它參數，例如：

配置完後，build界面中就會出現，如下如所示：

How to configure a single Jenkins job to make the release process from trunk or branches?

配置匿名用戶權限

後面打包的應用發佈時，如果懶得自己搭建服務器，就用Jenkins的，但發佈出去的鏈接需要登錄才能訪問，這時候你可以設置匿名用戶的訪問權限，這樣匿名用戶可以下載訪問你提供的應用鏈接了，非常取巧的方法，如下圖：

Jobs源碼庫配置(Gitlab爲例)

配置SSH

操作： Manage Jenkins -> Credentials -> Global credentials (unrestricted) -> Add Credentials

1. 本機生成SSH：ssh-keygen -t rsa -C “Your email” ， 生成過程中需設置密碼，最終生成id_rsa和id_rsa.pub(公鑰)

2. 本機添加祕鑰到SSH：ssh-add 文件名（需輸入管理密碼）

3. Gitlab上添加公鑰：複製id_rsa.pub裏面的公鑰添加到Gitlab

4. Jenkins上配置密鑰到SSH：複製id_rsa.pub裏面的公鑰添加到Jenkins（private key選項）

新建Job

在Jenkins中，所有的任務都是以”Job”爲單位的。在進行操作前，你需要新建一個Job，Job新建比較簡單，只需要在Jenkins管理的首頁左側，點擊“New Job”，一般選擇free-style software project，再輸入Job的名字即可。

配置Gitlab

在新建的任務（Jobs）中，Gitlab源碼配置如下圖：需要輸入Git倉庫和build分支，公鑰使用上面配置SSH生成的公鑰。

Jobs觸發條件配置

Jenkins支持多種觸發器配置，包括：

• 定期進行構建（Build periodically），定時器使用示例如下：

  H(25-30) 18 * * 1-5： 工作日下午6點25到30分之間進行build 
  H 23 * * 1-5：工作日每晚23:00至23:59之間的某一時刻進行build 
  H(0-29)/15 * * * *：前半小時內每隔15分鐘進行build（開始時間不確定） 
  H/20 * * * *：每隔20分鐘進行build（開始時間不確定）

• 根據提交進行構建（Build when a change is pushed to GitHub）

• 定期檢測代碼更新，如有更新則進行構建（Poll SCM）

Jobs構建方式/編譯 配置

Jenkins支持多種編譯配置方式，包括：

• Xcode: iOS編譯配置（安裝Xcode integration插件）

• Invoke Gradle script： Android編譯配置(安裝Gradle plugin插件)

• Exceute Shell： 腳本方式

對於iOS應用的構建，如果選擇Xcode方式構建，需要配置好開發者證書，具體參考後面簽名和整數問題。 
推薦使用Exceute Shell方式，簡單有效。

Jobs構建後處理

Artifacts和郵件通知配置，參考下圖

可藉助Email Extension Plugin 插件進行詳細配置，具體可參考此文

發佈

• FTP服務器, 最傳統的方式，可助蒲公英或者fir.im（安裝對應的Jenkins插件）。

• 專業的Artifacts存儲倉庫, 比如Nexus, Artifactory等。

• 對象存儲服務：比如阿里雲OSS，AWS S3等，以阿里云爲例，具體請參考此文 在Jenkins持續集成方案中使用阿里雲OSS作爲Artifacts倉庫

iOS的發佈可能希望用到OTA，可參考此文

這裏分享一個我寫的shell腳本模板(已開源)，可以用於iOS的plist文件自動創建以及OTA簡單發佈頁面的自動創建，參考此鏈接獲取源碼, 歡迎Star.

自動生成一個簡單HTML界面，如下圖，點擊Install即可安裝：

注意，這裏iOS7.1以後限定必須要要用https，所以需要對jenkins設置下https，參考下面”後記” 中的Jenkins Https設置

Last Show

構建成功後最終的結果如下如所示：

後記

簽名和證書問題(iOS)

• Set up code signing for iOS projects

• 安裝JENKINS到發佈IPA中的那些坑

Jenkins Https Support

查詢Jenkins Https相關命令： 
Java -jar jenkins.war –help | grep -i https

說明：下面以Mac爲例.

KeyStore方式

• 生成：

keytool -genkey -keyalg RSA -alias selfsigned -keystore keystore.jks -storepass 密碼 -dname "cn=WEB" 11

• 使用：

java -jar jenkins.war --httpPort=-1 --httpsPort=8080 --httpsKeyStore=/目錄/keystore.jks --httpsKeyStorePassword=密碼11

• 注意： 第一次使用時需要將”WEB”證書導入，導入步驟爲：Chrome導出證書 -> 安裝證書 -> 設置證書”全部允許”， 圖解步驟可參考下面實用參考中的第5篇文章.

Certificate方式

• 生成：

1. openssl genrsa -out server.key 10242. openssl req -new -key server.key -out server.csr3. openssl x509 -req -in server.csr -signkey server.key -out server.crt123123

• 使用：

java -jar jenkins.war --httpsPort=8088 --httpsCertificate=/path/server.crt --httpsPrivateKey=/path/server.key 11

• 注意：①同上 ②iOS手機需要導入cer證書

實用參考

• Starting and Accessing Jenkins 官網說明

• Jenkins: Switch to SSL/ HTTPS mode 支持HTTPS的兩種方式

• Installing and Configuring Jenkins KeyStore方式

• Generating a self-signed SSL certificate using the Java keytool command (2004193) KeyStore方式

• Setup Self-Signed Certificates & Trusting them on OS X Certificate方式

• 免費openssl生成ssl證書 Certificate方式

Refs

• Using Jenkins

• Building a software project

• Auto build and deploy iOS apps using Jenkins

• Continuous Integration for iOS with Jenkins

• GitLab Documentation

• Setup Jenkins + TestFlight for iOS apps

• Installing Jenkins on OS X Yosemite

• 基於 Jenkins 快速搭建持續集成環境

• Jenkins入門

• jenkins中集成OTA發佈