1. 程式人生 > >Jenkins Gitlab持續集成打包平臺搭建

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

定時器 占用 max ner run 後臺 nvi 所有 devops

http://www.cnblogs.com/skyseraph/p/5695021.html

1. 相關概念

Jenkins

  • Jenkins,一個用Java編寫的開源的持續集成工具,提供了軟件開發的持續集成服務,可監控並觸發持續重復的工作,具有開源,支持多平臺和插件擴展,安裝簡單,界面化管理等特點。更多介紹參考維基介紹.

Gitlab

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

持續集成

  • 持續集成, 簡稱CI(continuous integration).
  • CI作為敏捷開發重要的一步,其目的在於讓產品快速叠代的同時,盡可能保持高質量.
  • CI一種可以增加項目可見性,降低項目失敗風險的開發實踐。其每一次代碼更新,都要通過自動化測試來檢測代碼和功能的正確性,只有通過自動測試的代碼才能進行後續的交付和部署.
  • CI 是團隊成員間(產研測)更好地協調工作,更好的適應敏捷叠代開發,自動完成減少人工幹預,保證每個時間點上團隊成員提交的代碼都能成功集成的,可以很好的用於對Android/iOS項目的打包.

蒲公英

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

2. 流程結構

簡單繪制了下Jenkins的一個流程,如下圖:

技術分享

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

持續交互流程圖:

3.平臺搭建

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,設置如下如所示

技術分享Jenkis系統設置3

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

Jenkins Jobs配置

Jobs基礎配置

配置編譯參數

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

技術分享Jenkins編譯設置-參數設置2

你還可以配置一些其它參數,例如:

技術分享Jenkins編譯設置-參數設置3

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

技術分享Jenkins編譯設置-參數設置1

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

配置匿名用戶權限

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

技術分享Jenkins編譯設置-參數設置4.png

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和郵件通知配置,參考下圖

技術分享Jenkins項目設置-Archive-min

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

技術分享Jenkins項目設置-郵件-min

發布

  • FTP服務器, 最傳統的方式,可助蒲公英或者fir.im(安裝對應的Jenkins插件)。
  • 專業的Artifacts存儲倉庫, 比如Nexus, Artifactory等。
  • 對象存儲服務:比如阿裏雲OSS,AWS S3等,以阿裏雲為例,具體請參考此文 在Jenkins持續集成方案中使用阿裏雲OSS作為Artifacts倉庫

iOS的發布可能希望用到OTA,可參考此文

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

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

技術分享Jenkis發布1

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

Last Show

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

技術分享

4. 後記

簽名和證書問題(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”
  • 使用: java -jar jenkins.war –httpPort=-1 –httpsPort=8080 –httpsKeyStore=/目錄/keystore.jks –httpsKeyStorePassword=密碼。
  • 註意: 第一次使用時需要將”WEB”證書導入,導入步驟為:Chrome導出證書 -> 安裝證書 -> 設置證書”全部允許”, 圖解步驟可參考下面實用參考中的第5篇文章.

Certificate方式

  • 生成:
  1. openssl genrsa -out server.key 1024
  2. openssl req -new -key server.key -out server.csr
  3. openssl x509 -req -in server.csr -signkey server.key -out server.crt
  • 使用:java -jar jenkins.war –httpsPort=8088 –httpsCertificate=/path/server.crt –httpsPrivateKey=/path/server.key
  • 註意:①同上 ②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方式

5. 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發布

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